Matter CYW30739 恒温器示例实战:Infineon CYW30739 平台上的 Matter 设备构建、证书配置与烧录

原创2026-09-17 10:04:212,325 阅读
文章标签:物联网智能家居嵌入式IoT协议通信网络蓝牙密码学认证鉴权

Matter CYW30739 恒温器示例实战:Infineon CYW30739 平台上的 Matter 设备构建、证书配置与烧录

本文围绕 Matter(原 Project CHIP,即 connectedhomeip)仓库中的 examples/thermostat/infineon/cyw30739 示例展开:它演示了如何在 Infineon CYW30739 平台上,基于 ModusToolbox 工具链和 GN/Ninja 构建一个可通过 OpenThread 网络受控的 Matter 恒温器(Thermostat)设备,并通过蓝牙低功耗(BLE)完成配对(Commissioning)。读完后,你将掌握从环境准备、子模块同步、编译构建、出厂数据(Factory Data)与证书配置,到进入恢复模式烧录、完整联调的完整流程,并理解示例各模块的源码职责。

1. 示例定位与整体组成

CYW30739 恒温器示例是 Matter 在 Infineon CYW30739 平台上的基线演示(baseline demonstration):

  • 网络与配对方式:设备通过 BLE 执行 Rendez-vous(会合)流程完成配对——设备与 Matter 控制器之间交换安全信息,随后控制器下发目标 Thread 网络信息(含 Active Dataset)与 CASE 凭据;配对完成后,设备加入 OpenThread 网络并受控制器控制。
  • 设备形态:一个恒温器(Thermostat)设备,运行在 Infineon ModusToolbox SDK 之上。

从构建文件看,这个示例的“应用层代码”与“平台层代码”是分离的:

  • 应用层位于 cyw30739 示例目录,包含 5 个源文件:src/AppTask.cpp、src/SensorManager.cpp、src/TemperatureManager.cpp、src/ThermostatUI.cpp(仅在使能显示时编译)和 src/ZclCallbacks.cpp;
  • 平台层位于 infineon/cyw30739 平台目录,提供 main.cpp、matter_config.cpp(Matter 初始化)、LEDWidget.cpp、OTAConfig.cpp、SoftwareDiagnostics.cpp 等公共组件,并以 cyw30739_example 模板打包成静态库供各示例复用。

平台入口 main.cpp 的逻辑非常精简:

APPLICATION_START()
{
    printf("\nApp starting\n");

    if (CYW30739MatterConfig::InitMatter() != CHIP_NO_ERROR)
        printf("\nERROR InitMatter\n");
}

即应用启动后直接调用 CYW30739MatterConfig::InitMatter() 完成 Matter 栈初始化,其余能力(OTA、软件诊断、LED 指示、Shell 命令)由平台库统一提供。

各应用模块的职责(从源码结构看):

模块 头文件 职责
AppTask AppTask.h 应用主任务 AppTaskMain() 与 UI 刷新入口 UpdateThermoStatUI()
SensorManager SensorManager.h 传感器 GPIO 中断管理,Init(AsyncWorkFunct) 注册中断回调,中断发生后投递到异步工作队列
TemperatureManager TemperatureManager.h 维护当前温度/湿度、加热与制冷设定值、系统模式;实现 AttributeChangeHandler 同步控制器下发的 Thermostat 集群属性
ThermostatUI ThermostatUI.h 屏幕绘制:DrawUI()、SetCurrentTemp()、SetCurrentHumidity()
ZclCallbacks ZclCallbacks.cpp 各集群(Thermostat、Descriptor、General Commissioning 等)的 ZCL 回调注册与处理

数据模型(集群/设备类型定义)由 args.gni 指定:

app_data_model = "${chip_root}/examples/thermostat/thermostat-common"

也就是说,CYW30739 示例复用 thermostat-common 中的公共 .matter/.zap 数据模型,与 ESP32、Linux 等其他平台的恒温器示例共享同一套集群定义。

2. 构建特性:ICD 角色与 OTA 支持

示例的 args.gni 中还定义了三个对运行行为影响显著的构建参数:

chip_openthread_ftd = false
chip_enable_icd_server = true
chip_enable_ota_requestor = true
  • chip_openthread_ftd = false + chip_enable_icd_server = true:该设备以 ICD(Idle and Connectivity-Disabled,低复杂度/间歇连接节点) 角色运行 Thread 网络,而不是全功能节点(FTD)。ICD 节点周期性醒来维护网络状态,适合电池供电的恒温器类设备。
  • chip_enable_ota_requestor = true:使能 OTA Requestor,设备可以作为被升级方接收固件更新——这与平台层的 OTAConfig.cpp 相互印证,说明该示例支持远程 OTA 升级场景。

同一文件中还预设了产品标识与开发证书:

matter_product_id = "0x0006"
matter_product_name = "CYW30739 Thermostat App"
matter_att_cert = "${chip_root}/examples/platform/infineon/credentials/development/attestation/Matter-Development-DAC-1388-0006.p12"

即默认使用 Infineon 开发 DAC 证书(Vendor ID 0x1388,Product ID 0x0006)。该文件真实存在于仓库中,生产构建时应替换为自己的证书(见第 5 节)。

3. 准备开发环境:ModusToolbox 与子模块同步

3.1 安装 ModusToolbox 软件与工具包

CYW30739 的构建依赖 Infineon ModusToolbox 工具链与 matter-wpan-sdk(位于 third_party/infineon/repos/matter-wpan-sdk,由 --platform infineon 子模块检出)。需要按 Infineon 官方安装指南下载并安装 ModusToolbox 软件。

  • 若按官方指南安装,ModusToolbox 工具包会自动装到各操作系统的默认位置,构建系统可自动找到,无需额外配置。
  • 若将工具包安装到自定义位置,必须设置环境变量 CY_TOOLS_PATHS 指向工具目录(/path/to/ModusToolbox/tools_x.x):
export CY_TOOLS_PATHS="/path/to/ModusToolbox/tools_x.x"

WSL(Windows Subsystem for Linux)注意事项:如果在 WSL 中开发,请确认安装的是 Linux 版 ModusToolbox 软件。直接从 WSL 命令行调用 Windows 侧的工具会导致构建过程中的路径解析失败。

3.2 检出子模块并 Bootstrap

构建示例前,先在仓库根目录同步 Infineon 平台相关的子模块并执行引导脚本:

$ cd ~/connectedhomeip
$ scripts/checkout_submodules.py --platform infineon
$ bash scripts/bootstrap.sh -p all,infineon

4. 编译构建:gn_build_example.sh 与 GN/Ninja 直用

4.1 使用示例构建脚本

推荐方式是通过仓库自带的示例构建脚本:

$ cd ~/connectedhomeip
$ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat

4.2 直接使用 GN/Ninja

也可以进入构建环境后直接调用 GN/Ninja:

$ cd ~/connectedhomeip
$ source scripts/activate.sh
$ gn gen --root=examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat
$ ninja -C out/cyw30739-thermostat [thermostat-BOARD_NAME]

注意目标名中的 [thermostat-BOARD_NAME] 需替换为具体板卡。从 args.gni 中的板卡列表可以确定当前支持的 BOARD_NAME:

matter_wpan_sdk_board_list = [
  "CYW30739B2-P5-EVK-01",
  "CYW30739B2-P5-EVK-02",
  "CYW30739B2-P5-EVK-03",
]

因此实际目标为 thermostat-CYW30739B2-P5-EVK-01 / -02 / -03 三者之一。BUILD.gn 中通过 foreach(board, matter_wpan_sdk_board_list) 为每块板卡生成一个 matter_wpan_app 目标,并把全部板卡目标聚合进 group("default"),即一次 gn gen 会同时配置三种板卡的构建目标。

同时,.gn 声明了目标平台与 CPU:

default_args = {
  target_cpu = "arm"
  target_os = "cyw30739"

  import("//args.gni")
}

并加载示例的 args.gni(// 即该示例目录本身,因为构建以它为 GN root)。

4.3 清理构建产物

删除生成的可执行文件、库与目标文件:

$ cd ~/connectedhomeip
$ rm -rf out/cyw30739-thermostat

5. Factory Data:出厂数据的开发默认值与生产覆盖

Matter 设备的“出厂数据”(Factory Data)包括:配对凭据(passcode/discriminator/PAKE 参数)、设备信息(厂商/产品/序列号/硬件版本)与设备认证材料(DAC/DAC Key/PAI 证书/CD)。CYW30739 示例对这几类数据都提供了 GN 构建参数用于覆盖默认值。

5.1 Commissionable Data(配对参数)

Infineon CYW30739 示例默认使用测试用 passcode、discriminator 与 PAKE 参数。生产构建时,制造商应通过以下构建参数覆盖:

  • matter_passcode
  • matter_discriminator
  • matter_pake_iteration_count
  • matter_pake_salt
$ cd ~/connectedhomeip
$ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat \
'matter_passcode=20202021' \
'matter_discriminator=3840' \
'matter_pake_iteration_count=1000' \
'matter_pake_salt="U1BBS0UyUCBLZXkgU2FsdA=="'

其中 matter_pake_salt 为 Base64 编码的盐值(示例值解码即为一串占位文本,生产环境应使用随机生成的真实盐值)。passcode 是控制器在配对时输入的数字口令,discriminator 则是打印在设备二维码/手动码中的 2 位数。

5.2 Device Information(设备信息)

设备信息默认值即上文第 2 节 args.gni 中的 matter_product_id(0x0006)、matter_product_name("CYW30739 Thermostat App")等。支持通过以下参数覆盖:

  • matter_vendor_name
  • matter_vendor_id
  • matter_product_name
  • matter_product_id
  • matter_serial_number
  • matter_hardware_version
  • matter_hardware_version_string
$ cd ~/connectedhomeip
$ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat \
'matter_vendor_name="Infineon"' \
'matter_vendor_id="0x1388"' \
'matter_product_name="TEST_PRODUCT"' \
'matter_product_id="0x0001"' \
'matter_serial_number="TEST_SN"' \
'matter_hardware_version=30739' \
'matter_hardware_version_string="30739"'

这些值最终会进入 Device Information 集群(Vendor Name、Vendor ID、Product Name、Product ID、Serial Number、Hardware Version 等属性),是控制器识别设备的基础。

5.3 DAC / DAC Key / PAI 证书 / CD(设备认证材料)

示例默认使用开发用证书、密钥与 CD(Certification Declaration,认证声明)。生产构建时可用以下参数指定正式认证材料:

  • matter_att_cert
  • matter_att_cert_password
  • matter_cd
$ cd ~/connectedhomeip
$ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat \
'matter_att_cert="/path/to/att_cert.p12"' \
'matter_att_cert_password="password"' \
'matter_cd="/path/to/cd.der"'
  • att_cert 为 P12 格式的 DAC(Device Attestation Certificate),matter_att_cert_password 是该 P12 的解密口令;
  • matter_cd 为 DER 格式的认证声明,用于证明设备符合 Matter 认证要求。

仓库中同时提供了配套的 Infineon 开发 CD:Matter-Development-CD-1388-0001-0008.der,与默认 DAC 属同一开发证书体系,便于开发环境自签链路自洽。

5.4 使用已预配置(Provisioned)的 Optiga Trust M

对于配备 Optiga Trust M 安全元件的板卡,CYW30739 为了开发方便,默认会把出厂数据写入(provision)到 Optiga Trust M 中。而量产板上的 Optiga Trust M 出厂即带有预配置好的出厂数据,此时应通过以下参数让设备直接使用已预配置的对象而不是再次写入:

  • use_provisioned_optiga
  • optiga_dac_object_id
  • optiga_dac_key_object_id
  • optiga_pai_cert_object_id
$ cd ~/connectedhomeip
$ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat \
'optiga_dac_object_id="0xe0e0"' \
'optiga_dac_key_object_id="0xe0f0"' \
'optiga_pai_cert_object_id="0xe0e8"'

开发者必须将对象 ID(object ID)设置为与 Optiga 预配置流程中使用的配置相对应的值,否则设备在认证时将读取不到正确的 DAC/DAC Key/PAI 证书对象。仓库中 Optiga Trust M 的驱动与构建封装位于 third_party/infineon/trustm,matter-wpan-sdk 中的平台代码(${matter_wpan_sdk_build_root})则通过 cyw30739_example.gni 中的依赖 ${matter_wpan_sdk_build_root}:${board} 注入对应板卡的板级实现。

6. 烧录应用:进入恢复模式并运行 Flash 脚本

6.1 进入恢复模式(Recovery Mode)

运行烧录脚本前,先手动将 CYW30739 置入恢复模式:

  1. 按住板卡上的 RECOVERY 按键不松手;
  2. 按住板卡上的 RESET 按键;
  3. 松开 RESET 按键;
  4. 1 秒后再松开 RECOVERY 按键。

6.2 运行烧录脚本

构建产物目录中会为每块板卡生成一个 *.flash.py 烧录脚本:

$ cd ~/connectedhomeip
$ out/cyw30739-thermostat/thermostat-BOARD_NAME.flash.py --port <port>

将 thermostat-BOARD_NAME 替换为实际目标(如 thermostat-CYW30739B2-P5-EVK-01),--port 指定设备连接的串口(如 /dev/ttyUSB0 或 WSL 下映射的串口设备)。该脚本由 matter-wpan-sdk 的构建模板(matter_wpan_executable)在构建时生成,通过串口完成恢复模式下的固件下载。

7. 运行完整示例:完整联调前提与步骤

完整跑通示例需要以下前提与步骤:

  1. 已有一个配置好并在运行的 OpenThread 边界路由器(Border Router)。若尚未搭建,可参考仓库文档 OpenThread 边界路由器(Raspberry Pi)指南 在树莓派上搭建;
  2. 需要一个同网参考设备:为了演示控制器与设备的控制链路,README 要求有第二台 CYW30739 设备,同样运行恒温器示例,并被配对到同一个 OpenThread 网络——这样可以通过已入网设备与待配对设备的对比,验证 BLE 配对(Rendez-vous)、Active Dataset 下发与 CASE 凭据交换的完整链路。

典型联调流程可以归纳为:

  1. 在树莓派边界路由器上启动 OpenThread Border Agent,得到 Thread 网络(PAN ID/扩展 PAN ID/信道/PSKc);
  2. 将第一台 CYW30739 板卡配对入网(如先通过 shell/配网命令);
  3. 第二台板卡按第 6 节流程烧录固件后,通过 Matter 控制器(如 chip-tool、手机 App)发起 BLE 配对:输入第 5.1 节的 passcode,读取 discriminator/二维码完成安全会合,控制器下发 Thread Active Dataset 与 CASE 凭据;
  4. 入网后,通过控制器的 Thermostat 集群接口(Current Heating Cooling、Local Temperature、Occupancy、System Mode 等属性与命令)对设备读写,验证 TemperatureManager 中的 AttributeChangeHandler 与 UI/传感器任务之间的联动。

8. 小结:从源码看这个示例的边界与可复用点

  • 适用平台:Infineon CYW30739(ModusToolbox + matter-wpan-sdk),当前构建目标覆盖 CYW30739B2-P5-EVK-01/02/03 三块评估板(见 args.gni)。
  • 设备角色:Thread ICD 节点 + OTA Requestor + BLE 配网(见 chip_openthread_ftd=false、chip_enable_icd_server=true、chip_enable_ota_requestor=true)。
  • 代码分层:应用层 5 个源文件(任务/传感器/温度管理/UI/ZCL 回调)位于 examples/thermostat/infineon/cyw30739/src,平台层(Matter 初始化、OTA、诊断、LED、Shell)复用 examples/platform/infineon/cyw30739;数据模型复用 examples/thermostat/thermostat-common。
  • 生产化清单:替换 passcode/discriminator/PAKE 参数 → 替换 vendor/product/序列号/硬件版本 → 替换 DAC(P12)/口令/CD(DER)→ 若使用预配置 Optiga Trust M,则设置 use_provisioned_optiga 与三个对象 ID。

按上述流程,即可完成从源码检出到设备入网受控的完整闭环;所有引用的构建脚本、板卡列表、默认证书与模块划分均可以在本仓库对应路径中直接查证。

登录后查看全文
connectedhomeip