例程:
- Github:esp-matter/examples/light
- Gitee:esp-matter/examples/light
此例程支持三种配网方式:
- 苹果手机扫码配网
- chip-tool 命令配网
- Matter 指令配网
1 使用苹果手机扫码配网
说明文档:Apple Matter 测试方法
所需设备:
- 苹果手机(最新版本 IOS 系统)
- 苹果音响(Apple-Matter)
测试条件
-
需要使用苹果手机和苹果音响设备,且将系统升级到最新版本
-
阅读Apple Matter 测试方法 文档,在
苹果手机
和苹果音箱
中,都安装"配置文件"。安装配置文件时,请使用手机端的默认浏览器访问"配置文件"的下载界面,进行下载,下载完成后在手机设置端
进行安装。 -
安装完成后,打开 home APP , 二维码参见说明 :
-
手机和音响要求在同一个
局域网
内
2 使用 Chip-tool 命令完成配网
所需设备:
- BLE 适配器(用在 Linux 电脑上)
测试条件
- 打开一个新的终端环境,配置好 esp-matter SDK 编译环境,进入到 esp-matter 路径
- 运行 chip-tool 的主机和 ESP设备
必须
连接到同一个Wi-Fi 网络环境 - 阅读Test Setup (CHIP Tool) 指令说明,运行相关配网指令,配网成功的日志如下:
指令序列如下:
chip-tool interactive start
pairing ble-wifi 0x7283 cc2.4 espressif 20202021 3840
使用 chip-tool 指令完成配网后,即可开始使用集群控制指令来控制 ESP 设备了。
注意:集群控制指令只能是在使用 chip-tool 指令完成配网后使用。chip-tool 指令不仅实现配网功能,还会发一些证书,这在之后的控制会话中需要用到。
3 使用 Matter 命令完成配网(不推荐)
说明文档:Device console
测试条件
-
使用 ESP32 开发板下载固件后,通过 monitor 监控日志打印,如下:
-
在终端日志的命令窗口,直接运行 Materr 配网相关指令