当前文档版本为 v0.4.1，您可以访问当前页面的 开发中 版本以获取最近可能的更新。

Bluetooth: Mesh Echo

1 功能概述

此sample为针对智能音箱Amazon Echo的演示项目，可以完成入网及控制开关。

2 环境要求

  • board: pan1080a_afld_evb

  • uart (option): 显示串口log

  • Amazon Echo: 测试音箱

  • 测试软件: PanMesh 或 nRF Mesh

3 编译和烧录

项目位置：zephyr\samples_panchip\bluetooth\mesh_echo

目前可使用ZAL工具或quick build脚本进行编译和下载。

脚本位置：quick_build_samples\bluetooth\mesh_echo.bat。

打开脚本后默认会编译项目，编译完成时，可输入字符进行后续下载等操作:

Input the keyword to continue:
  'b' build                         编译项目
  'r' make clean and rebuild        重新编译项目
  'f' flash download                下载
  'e' erase chip                    擦除芯片
  'o' open project by VS Code       打开 `VS Code`，可查看源码，执行编译下载等
  others exit                       退出
wait input:

4 演示说明

  1. 根据Zephyr编译环境搭建VSCode开发环境

  2. 搭建Echo测试环境，不同板子需要更新不同的DEV UUID

  3. 下载即可验证Echo入网的功能，在app端显示为Plug

5 开发说明

5.1 KCONFIG宏说明

  1. flash相关，应用在快速重启擦除入网信息

CONFIG_BT_SETTINGS=y
CONFIG_FLASH=y
CONFIG_FLASH_MAP=y
CONFIG_NVS=y
CONFIG_SETTINGS=y

  1. 调试LOG宏，不建议全开，log较多占一定ram

CONFIG_BT_DEBUG_LOG=y

CONFIG_BT_MESH_DEBUG=y
CONFIG_BT_DEBUG_CONN=y
CONFIG_BT_MESH_DEBUG_BEACON=y
CONFIG_BT_MESH_DEBUG_PROV=y
CONFIG_BT_MESH_DEBUG_ADV=y
CONFIG_BT_MESH_DEBUG_PROXY=y
CONFIG_BT_MESH_DEBUG_MODEL=y
CONFIG_BT_MESH_DEBUG_ACCESS=y
CONFIG_BT_MESH_DEBUG_TRANS=y
CONFIG_BT_MESH_DEBUG_KEYS=y
CONFIG_BT_MESH_DEBUG_NET=y

  1. 广播相关参数

CONFIG_BT_DEVICE_NAME_DYNAMIC=y      # dynamic dev name
CONFIG_BT_DEVICE_NAME="echo"         # dev name
CONFIG_BT_MESH_UNPROV_BEACON_INT=2   # pb adv interval（s）

5.2 MAIN函数说明

main函数包括3部分

  1. flash相关的配置擦除, 包括函数ps_settings_init，short_time_multireset_bt_mesh_unprovisioning

  2. bt_enable() 初始化蓝牙

  3. bt_ready() 初始化MESH

  4. 蓝牙回调接口

    static void connected(struct bt_conn *conn, uint8_t err)
{
	if (err) {
		printk("Connection failed (err 0x%02x)\n", err);
	} else {
		printk("Connected\n");
	}
}

static void disconnected(struct bt_conn *conn, uint8_t reason)
{
	printk("Disconnected (reason 0x%02x)\n", reason);
}

BT_CONN_CB_DEFINE(conn_callbacks) = {
	.connected = connected,
	.disconnected = disconnected,
};

5.3 ble_mesh说明

ble/mesh相关操作:

  1. static const struct bt_mesh_prov prov 配置入网参数

  2. struct bt_mesh_model root_models[] 配置mesh model

  3. UUID生成方式：静态数组static uint8_t dev_uuid_echo[16]

  4. 入网认证方式：no oob（Echo选择的，因此不需要类似天猫小度的三元组静态oob）

  5. 入网beaer选择：bt_mesh_prov_enable(BT_MESH_PROV_ADV | BT_MESH_PROV_GATT);

5.4 其他说明

  1. light model和config model，health model请参考[Mesh开发指南](../../dev_guides/Developing Bluetooth Mesh Applications.md)。

  2. 目前只添加了 Generic Onoff Model，其它灯控相关的CTL，HSL等将在后续版本中添加。

  3. 入网方式为Pb gatt，通过连接方式进行入网，入网后每次连接会进行proxy configuration 和 filter add等操作。