窗帘
此窗帘示例演示了使用 Matter 应用层来构建一个窗帘设备。该设备作为一个 Matter 附件设备工作,这意味着它可以通过 基于低功耗 802.15.4 Thread 网络的 Matter 网络进行配对和远程控制。示例使用按钮来逐步改变窗帘的位置和移动模式, 并通过 LED 显示这些变化的状态。 可用的移动模式如下:
升降 - 在此移动模式下,窗帘上下移动。
倾斜 - 在此移动模式下,窗帘叶片前后倾斜,而窗帘本身不垂直移动。
环境需求
该示例支持以下开发套件:
硬件平台 |
板卡名称 |
---|---|
RTL8777G HDK |
RTL8777G EVB |
准备 Matter 环境
要设置 Matter 环境,请按照 开发环境设置 中列出的步骤操作。
准备 CHIP Tool
CHIP Tool(chip-tool)是 Matter 的控制器实现,允许将 Matter 设备加入网络并使用 Matter 消息与其通信,这些消息可能包含数据模型的相关操作,例如群集命令。该工具还提供其他特定于 Matter 的实用程序,如解析设置负载或执行发现操作。
要构建 CHIP Tool,请按照 CHIP Tool 步骤操作。
配置选项
示例样本配置
我们的示例样本都有默认配置。
如果要修改示例配置,
可以更改 matter/connectedhomeip/examples/<app_name>/realtek_bee/main/include
路径下的 CHIPProjectConfig.h
,其中 app_name 指的是应用程序的名称,例如 lighting-app。
有关配置项的更多信息,请参见 APP配置。
工厂数据配置
对于 EVB 板,工厂数据默认是禁用的。要使用工厂数据,请参阅 工厂数据 中的 启用工厂数据支持 和 工厂数据生成 部分。
编译和下载
编译
导航到 openthread 目录并编译 window-covering 应用程序。
$ cd ./subsys/matter/samples
$ rm -r build/
$ ./build.py rtl8777g window
下载
编译成功后,应用程序 bin 文件 matter-cli-mtd_bank0_MP_dev_*.bin
将生成在目录 build/bank0/bin
中。
要将应用程序 bin 文件下载到 EVB 板,按照 快速入门 中 固件下载 中列出的步骤操作。如果工厂数据已启用,请参阅 工厂数据 中的 烧录工厂数据。
然后按下 EVB 板上的重置按钮,它将开始运行。
其他需要烧录的文件如下表所示。
文件类型 |
文件 |
文件路径 |
---|---|---|
System ConfigFile |
configFile_xxx.bin |
\subsys\openthread\vendor\bee4\rtl8777g\firmware\trustzone_disable |
Bank0 Boot PatchImage |
BANK0_boot_patch_MP_release_xxx.bin |
\subsys\openthread\vendor\bee4\rtl8777g\firmware |
Bank0 OTA HeaderFile |
OTAHeader_Bank0_xxx.bin |
\subsys\openthread\vendor\bee4\rtl8777g\firmware\trustzone_disable |
Bank0 SystemPatch Image |
sys_patch_MP_release_xxx.bin |
\subsys\openthread\vendor\bee4\rtl8777g\firmware |
Bank0 Bluetooth StackPatch Image |
bt_stack_patch_MP_master_xxx.bin |
\subsys\openthread\vendor\bee4\rtl8777g\firmware |
Bank0 Bluetooth HostImage |
bt_host_MP_xxx.bin |
\subsys\openthread\vendor\bee4\rtl8777g\firmware |
测试验证
在将示例工程烧录到您的 EVB 板后,完成以下各节中的步骤。
准备阶段
使用 USB 线将套件连接到计算机。
使用串口调试工具(例如,Tera Term)打开与套件的串口连接。
如果在编程过程中未擦除 flash,请按住 SW2 并保持 6.5s 以上,直到进行出厂重置。
按下 RST 以开启蓝牙广播。
将设备加入到 Matter 网络。请参考 设备配网。在配网过程中,记下窗帘节点 ID 的值以备后用(<window_node_ID>)。
测试阶段
观察 LED 0 和 LED 2 是否亮起,这意味着窗帘完全打开。 设备默认以升降模式启动。
按下 SW3 20 次以完全关闭窗帘。 LED 0 的亮度随每次按键按下而减少,直到 LED 熄灭。
按下 SW4 20 次以在升降模式下完全打开窗帘。 LED 0 亮起,其亮度随每次按键按下而增加,直到达到最大亮度。
按下 SW1 切换到倾斜模式。
按下 SW3 20 次以在倾斜模式下完全关闭窗帘。 LED 2 的亮度随每次按键按下而减少,直到 LED 熄灭。
按下 SW4 20 次以在倾斜模式下完全打开窗帘。 LED 2 亮起,其亮度随每次按键按下而增加,直到达到最大亮度。