窗帘

此窗帘示例演示了使用 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 板后，完成以下各节中的步骤。

准备阶段

  1. 使用 USB 线将套件连接到计算机。

  2. 使用串口调试工具（例如，Tera Term）打开与套件的串口连接。

  3. 如果在编程过程中未擦除 flash，请按住 SW2 并保持 6.5s 以上，直到进行出厂重置。

  4. 按下 RST 以开启蓝牙广播。

  5. 将设备加入到 Matter 网络。请参考 设备配网。在配网过程中，记下窗帘节点 ID 的值以备后用（<window_node_ID>）。

测试阶段

  1. 观察 LED 0 和 LED 2 是否亮起，这意味着窗帘完全打开。 设备默认以升降模式启动。

  2. 按下 SW3 20 次以完全关闭窗帘。 LED 0 的亮度随每次按键按下而减少，直到 LED 熄灭。

  3. 按下 SW4 20 次以在升降模式下完全打开窗帘。 LED 0 亮起，其亮度随每次按键按下而增加，直到达到最大亮度。

  4. 按下 SW1 切换到倾斜模式。

  5. 按下 SW3 20 次以在倾斜模式下完全关闭窗帘。 LED 2 的亮度随每次按键按下而减少，直到 LED 熄灭。

  6. 按下 SW4 20 次以在倾斜模式下完全打开窗帘。 LED 2 亮起，其亮度随每次按键按下而增加，直到达到最大亮度。