Matter Telink All Clusters Minimal 示例基于 Zephyr 的 B91/B92/W91 构建、烧录、配网与 OTA 实战指南【免费下载链接】connectedhomeipMatter (formerly Project CHIP) creates more connections between more objects, simplifying development for manufacturers and increasing compatibility for consumers, guided by the Connectivity Standards Alliance.项目地址: https://gitcode.com/GitHub_Trending/co/connectedhomeip本文是 MatterConnected Home over IP现由 Connectivity Standards Alliance 维护开源 SDK 中Telink 平台的 All Clusters Minimal 示例应用的完整技术指南。该示例在三个端点上实现了多种 ZCL 集群是开发者基于 Telink TLSR 系列 SoC 打造自有 Matter 设备的最佳参考起点。读完本文你将掌握在 Docker 构建环境下用west为 Telink 开发板编译并烧录固件、通过 UART 与按键进行调试与工厂复位、使用 chip-tool 通过 BLE Thread 完成配网以及用 Linux OTA Provider 为设备实现完整的 OTA 固件升级链路。示例应用概述Matter Telink All Clusters Minimal 示例应用源码位于 examples/all-clusters-minimal-app/telink在一个设备上填充了多个ZCLZigbee Cluster Library集群这些集群分布在三个端点上。其定位是最小化但覆盖广相比完整的 all-clusters-app它保留了多集群覆盖能力同时裁剪掉非核心逻辑便于作为创建自有应用的模板。从构建脚本 CMakeLists.txt 可以看到该示例的组成结构数据模型由chip_configure_data_model基于 ZAP 文件 all-clusters-minimal-app.zap 生成同时依赖src/app/chip_data_model.cmake接入 SDK 的数据模型构建流程平台公共逻辑复用了examples/platform/telink下的common.cmake包括mainCommon.cpp、AppTaskCommon.cpp、LEDManager、PWMManager、ButtonManager、ThreadUtil以及zephyr_ext下的按键/灯池/PWM/WS2812 等 Zephyr 适配层示例特有逻辑集中在 src/AppTask.cpp初始化时调用InitBindingHandlers()配置绑定binding能力并注册StaticSupportedModesManager为ModeSelect 集群提供静态支持的运行模式管理。示例的 Kconfig 入口在 Kconfig它通过rsource引入config/telink/chip-module/Kconfig.defaults中的平台公共默认配置再叠加本示例自身的配置。支持设备与构建目标该示例支持 Telink 的 B91、B92、W91 三个系列开发板每个板卡对应一个或多个 Zephyrwest build -b构建目标板卡 / SoC构建目标说明B91TLSR9518ADK80DTLSR951x 系列tlsr9518adk80d、tlsr9518adk80d-mars、tlsr9518adk80d-usbB91 通用入门套件本示例的按键/串口章节默认针对该板B92TLSR9528ATLSR952x 系列tlsr9528a、tlsr9528a_retention支持 retention 变体W91TLSR9118BDK40DTLSR911x 系列tlsr9118bdk40dWi-Fi/Thread 融合系列构建时用-b build_target指定上述任一目标即可。若使用 B91可重点参考本文使用指南一节的 UART、按键与 LED 说明因为这些外设映射是以tlsr9518adk80d为基准给出的。环境准备Docker 构建容器与激活脚本Telink 示例基于Zephyr RTOS构建官方推荐在 Docker 容器中完成以规避本地 Zephyr 工具链版本不一致的问题。启动构建容器推荐方式镜像版本从 CI 工作流中自动解析$ docker run -it --rm -v $PWD:/host -w /host ghcr.io/project-chip/chip-build-telink:$(wget -q -O - https://raw.githubusercontent.com/project-chip/connectedhomeip/master/.github/workflows/examples-telink.yaml 2 /dev/null | grep chip-build-telink | awk -F: {print $NF} | head -n1)该命令会拉取当前仓库 CI 所引用的chip-build-telink镜像标签并挂载当前目录。仓库内的对应证据默认容器内置的推荐 Zephyr 版本由 integrations/docker/images/stage-2/chip-build-telink/Dockerfile 定义兼容的 Docker 镜像版本在 .github/workflows/examples-telink.yaml 中声明。激活构建环境$ source ./scripts/activate.sh -p all,telink-p参数指定需要激活的平台包集合all,telink表示激活全部基础依赖并加入 Telink 平台支持脚本位于 scripts/activate.sh。构建与烧录构建固件在容器内、仓库根目录下执行west build$ west build -b build_target其中build_target替换为上文支持设备与构建目标表中的板卡名称如tlsr9518adk80d。关于 Flash 大小的关键参数-DFLASH_SIZE默认按 2 MB 布局构建。若你的板载 Flash 不是 2 MB必须显式指定例如$ west build -b build_target -- -DFLASH_SIZE1m $ west build -b build_target -- -DFLASH_SIZE4m注意-DFLASH_SIZE需要放在--之后作为传给底层构建系统的额外 CMake 参数。构建完成后目标固件位于build/zephyr/zephyr.bin。烧录固件通过 J-Link 等调试器烧录--erase会先擦除目标 Flash确保干净启动$ west flash --erase源码级视角prj.conf 关键配置解读示例的工程配置在 examples/all-clusters-minimal-app/telink/prj.conf它只保留本示例特有的配置公共项由平台Kconfig.defaults兜底。理解这些开关对修改自有应用至关重要配置项值含义CONFIG_CHIPy启用 MatterCHIP核心CONFIG_STD_CPP20y启用 C20 标准构建脚本中通过 enable-gnu-std.cmake 配合CONFIG_GPIOy启用 GPIO支撑按键与 LEDCONFIG_CHIP_DEVICE_PRODUCT_ID327690x8001本示例的 Matter 产品 IDall-clusters-minimal-app 专用 PIDCONFIG_BT_DEVICE_NAMETelinkMinAppBLE 广播的设备名称配网时可在扫描结果中识别CONFIG_CHIP_OTA_REQUESTORn默认关闭 OTA 请求端功能下文 OTA 章节需改为yCONFIG_CHIP_DEVICE_SOFTWARE_VERSION1设备软件版本号OTA 测试时需要比镜像版本低CONFIG_CHIP_LIB_SHELLn关闭 CHIP Shell减少 Flash 占用CONFIG_CHIP_FACTORY_DATA等n关闭工厂数据支持及相关 CD 存储CONFIG_PMn关闭电源管理其中CONFIG_BT_DEVICE_NAME是配网排查时最容易用到的项如果手机或 chip-tool 扫描不到设备首先确认该名称是否正常出现在 BLE 扫描结果中。使用指南UART、按键与 LEDUART 串口输出将串口连接到以下引脚即可查看设备日志以tlsr9518adk80d为基准名称引脚RXPB3J34 连接器第 17 脚TXPB2J34 连接器第 16 脚GNDGND波特率115200 bits/s。日志模块在 AppTask.cpp 中声明为LOG_MODULE_DECLARE(app, CONFIG_CHIP_APP_LOG_LEVEL)日志级别跟随 Kconfig 的CONFIG_CHIP_APP_LOG_LEVEL。按键功能tlsr9518adk80d名称功能说明Button 1恢复出厂设置忘记已配网的 Thread 网络并回到未配网状态触发方式连续按下 3 次Button 2未使用—Button 3未使用—Button 4打开配网窗口触发 BLE 配网窗口供配网器执行基于 BLE 的 commissioning按键的底层映射与去抖逻辑由examples/platform/telink/util/src/ButtonManager.cpp及zephyr_ext/zephyr_key_pool.c、zephyr_key_matrix.c实现具体 GPIO 引脚定义以板级设备树为准。LEDThread 网络状态指示红色 LED用于指示 Thread 网络当前状态其闪烁模式与状态的对应关系状态说明短脉冲闪烁设备未配网到 ThreadThread 功能关闭频繁脉冲闪烁设备已配网Thread 已启用正在尝试JOINThread 网络宽间隔脉冲闪烁设备已成功加入 Thread 网络并成为CHILD节点LED 驱动位于examples/platform/telink/util/src/LEDManager.cpp支持 PWM 与 WS2812 等灯池扩展见zephyr_ext/zephyr_led_pool.c、zephyr_ws2812.c。实际接线时需将 LED 与对应 GPIO 正确连接否则状态不可见。使用 chip-tool 配网配网commissioning是让 Matter 设备加入网络的第一步。官方推荐使用 chip-tool 作为配网器controller。先构建 chip-tool CLI构建方法详见 examples/chip-tool/README.md典型方式是通过scripts/examples/gn_build_example.sh examples/chip-tool/linux out/chip-tool一类 GN 构建脚本生成可执行文件。通过BLE Thread方式配网${CHIP_TOOL_DIR}/chip-tool pairing ble-thread ${NODE_ID} hex:${DATASET} ${PIN_CODE} ${DISCRIMINATOR}参数含义${NODE_ID}为该设备分配 Matter 节点 ID${DATASET}Thread 网络的 Active Operational Dataset以hex:前缀传入十六进制字符串${PIN_CODE}设备的配网 PIN如20202021${DISCRIMINATOR}BLE 配网判别器如3840。完整示例./chip-tool pairing ble-thread 1234 hex:0e080000000000010000000300000f35060004001fffe0020811111111222222220708fd61f77bd3df233e051000112233445566778899aabbccddeeff030e4f70656e54687265616444656d6f010212340410445f2b5ca6f2a93a55ce570a70efeecb0c0402a0fff8 20202021 3840执行成功后设备将获得 Thread 网络凭据并开始入网流程此时可通过上文LED一节观察设备从尝试 JOIN到成为 CHILD的状态迁移。通过 Linux OTA Provider 实现 OTA 升级OTAOver-The-Air升级是量产设备的关键能力。本示例默认未启用OTACONFIG_CHIP_OTA_REQUESTORn见 prj.conf只有 ota-requestor-app 示例默认开启。如需为本示例或其他 Telink 示例启用 OTA在对应prj.conf中设置CONFIG_CHIP_OTA_REQUESTORy重新构建后会生成两类二进制文件merged.bin烧录到 PCB 的主固件至少需要 2 MB Flashmatter.ota提供给 OTA Provider 的升级镜像。版本号约束以上两个文件具有相同的 SW 版本。要实际测试 OTA 流程matter.ota的软件版本必须高于设备当前运行的版本。在prj.conf中把基础版本设为较低值即可例如CONFIG_CHIP_DEVICE_SOFTWARE_VERSION2即设备基础固件用1OTA 镜像用2以此制造版本差。OTA 完整操作流程构建 Linux OTA Provider源码在 examples/ota-provider-app/linux./scripts/examples/gn_build_example.sh examples/ota-provider-app/linux out/ota-provider-app chip_config_network_layer_blefalse这里通过chip_config_network_layer_blefalse关闭 BLE 网络层OTA Provider 仅走 IPon-network配网。运行 OTA Provider 并指定升级镜像./chip-ota-provider-app -f matter.ota使用 chip-tool 配网 OTA Provideron-network 方式走 WiFi/Ethernet 直连./chip-tool pairing onnetwork ${OTA_PROVIDER_NODE_ID} 20202021其中${OTA_PROVIDER_NODE_ID}是 Linux OTA Provider 的节点 ID。配置 ACL允许设备访问 OTA Provider./chip-tool accesscontrol write acl [{fabricIndex: 1, privilege: 5, authMode: 2, subjects: [112233], targets: null}, {fabricIndex: 1, privilege: 3, authMode: 2, subjects: null, targets: null}] ${OTA_PROVIDER_NODE_ID} 0其中${OTA_PROVIDER_NODE_ID}同上。第一条 ACL 条目授予管理权限privilege 5给主体 112233第二条授予操作权限privilege 3给所有主体targets: null表示不限集群与端点。通知设备开始 OTA由 OTA Requestor 发起公告触发下载./chip-tool otasoftwareupdaterequestor announce-otaprovider ${OTA_PROVIDER_NODE_ID} 0 0 0 ${DEVICE_NODE_ID} 0参数说明${OTA_PROVIDER_NODE_ID}Linux OTA Provider 的节点 ID${DEVICE_NODE_ID}已配网的目标设备Telink 设备的节点 ID其余数字为 announce-otaprovider 命令所需的 provider endpoint、fabric index 等参数。传输完成后OTA Requestor 会向 OTA Provider 发送ApplyUpdateRequest命令请求应用新镜像设备在成功应用 OTA 镜像后会自动重启。至此整个构建镜像 → 托管 Provider → 配网 → ACL 授权 → 公告下载 → 应用重启的 OTA 闭环完成。小结Matter Telink All Clusters Minimal 示例是通往 Telink 平台 Matter 开发的最小完整闭环三个端点的 ZCL 集群覆盖了从数据模型生成ZAP → CMake到应用任务初始化绑定、ModeSelect 静态模式管理的完整范式prj.conf中的 PID、BLE 设备名、OTA 与版本号等开关则直接决定设备的可配网性与可升级性。建议开发者在构建自有应用时以本示例为起点复制目录保留 CMakeLists.txt 的 ZAP 驱动结构按实际硬件调整prj.confFlash 大小、PID、设备名量产前务必验证 OTA 链路并按本文流程用 Linux OTA Provider 做一次端到端升级测试。【免费下载链接】connectedhomeipMatter (formerly Project CHIP) creates more connections between more objects, simplifying development for manufacturers and increasing compatibility for consumers, guided by the Connectivity Standards Alliance.项目地址: https://gitcode.com/GitHub_Trending/co/connectedhomeip创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考