窗帘

此窗帘示例演示了使用 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/common/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\rtl87x2g\rtl8777g\firmware\trustzone_disable

Bank0 Boot PatchImage

BANK0_boot_patch_MP_release_xxx.bin

\subsys\openthread\vendor\rtl87x2g\rtl8777g\firmware

Bank0 OTA HeaderFile

OTAHeader_Bank0_xxx.bin

\subsys\openthread\vendor\rtl87x2g\rtl8777g\firmware\trustzone_disable

Bank0 SystemPatch Image

sys_patch_MP_release_xxx.bin

\subsys\openthread\vendor\rtl87x2g\rtl8777g\firmware

Bank0 Bluetooth StackPatch Image

bt_stack_patch_MP_master_xxx.bin

\subsys\openthread\vendor\rtl87x2g\rtl8777g\firmware

Bank0 Bluetooth HostImage

bt_host_MP_xxx.bin

\subsys\openthread\vendor\rtl87x2g\rtl8777g\firmware

测试验证

在将示例工程烧录到您的 EVB 板后，完成以下各节中的步骤。

准备阶段

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

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

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

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

  5. 下面按键测试不需要进行commission，如果进行commission，因为会进dlps，定时器会被关闭，灯不会亮。

测试阶段

  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 亮起，其亮度随每次按键按下而增加，直到达到最大亮度。