使用 Matter-SDK 快速搭建 Matter 环境 (Linux)

2023-09-25 14:40 作者:乐鑫信息科技 0人读过 | 我要投稿

Matter 作为一个统一的智能家居互联协议，凭借其高兼容性的特点，正逐渐打破各个智能家居之间的壁垒。乐鑫作为在 Matter 项目发布之初的早期成员，提供了一套开源、完整、易用的 Matter-SDK。

乐鑫的 Matter-SDK 是建立在开源 Matter-SDK 之上的，它提供了简化的 API、常用的外设、安全、制造和生产工具以及详尽的文档支持。该 SDK 包括丰富的生产参考资料，旨在简化 Matter 产品的开发过程，使用户能够在最短的时间内投入生产。

您可以观看下面的教程视频，也可以阅读本篇的图文教程。本文将详细介绍在 Linux 环境下，如何使用 Matter-SDK 完成 Matter 环境搭建。

搭建步骤：

1. 系统及设备环境

操作系统：Ubuntu 22.04.3 LTS
主机配置：具有蓝牙适配器
网络：能流畅访问 Github 的网络环境
测试芯片：ESP32-C3-MINI-1
测试开发板：ESP32-C3-DevKitM-1 v1.0

注：Ubuntu 版本应为 20.04 和 22.04，并且为主机开发。若使用虚拟机，在用 CHIP Tool 工具进行配网调试时会出现查找蓝牙设备失败或者无法进行调试的情况。

2. 安装准备

2.1 Matter 安装准备

安装过程具体请参考官方 Github 项目。

注：Windows 系统推荐使用 WSL 进行开发，详见官方 WSL 配置方法。

2.2 搭建 ESP-IDF 开发环境

Matter 的开发环境依赖于 ESP-IDF 开发环境，如果当前没有搭建 ESP-IDF 环境，请参考官方文档进行搭建，或者使用下面的指令进行快速搭建。

（1）安装 ESP-IDF 需要以下安装准备：

（2）获取仓库，进行安装：

3. 获取并安装 Matter

使用以下指令获取仓库，进行安装：

4. 配置环境

当每一个新终端开启时，使用以下命令来配置 Matter 的开发环境：

您可以选择开启 Ccache 以提升编译速度：

5. 编译 ESP-Matter 示例

进入 ESP-Matter Light 示例目录：

开始编译示例，首先设置编译目标芯片平台（以 ESP32-C3 为例）：

在正式进行烧录之前，推荐先擦除整片 Flash，烧录并监控：

至此，如果编译没有报错，程序成功烧录进 ESP32-C3，并在终端界面显示正常的状态，则代表 Matter 环境已被成功搭建。

6. 对 Matter 设备进行配网与基本控制

首先，使用在交互模式下的 CHIP Tool 进行配网。先为配网开启一个新的终端，配置 Matter 的开发环境，并运行：

对设备进行配网具有多种途径，这里我们使用 BLE Wi-Fi 的方式进行配网，复制如下指令：

在上述指令中，0x7283 是随机选取的节点 ID，20202021 是配对码，3840 是鉴别码，粘贴命令到终端，确保电脑与所填 Wi-Fi 在同一网络环境内，在 SSID 填入 Wi-Fi 名称，passphrase 填入密码。填写完成后的示例如下：

开始运行，等待一段时间，当监控设备的终端中出现以下日志时，即代表配网成功：

在配网完成后，我们尝试使用一个命令来对 ESP32-C3 开发板上的 RGB 灯进行控制，复制以下开关翻转的命令到 CHIP Tool 终端中运行：

在监控设备的终端中我们可以看到 Received command 相关日志：

即代表收到了指令的请求，同时，我们也可以看到开发板上的 RGB 灯关闭了，再次运行，RGB 灯被点亮。

7. 常见问题及其解决方法

（1）idf.py erase_flash 时出现：

解决方法：需要确保该用户对 USB 口拥有正确的读写权限。

（2）git clone 时出错或速度过慢：

解决方法：需要确保用户拥有一个能流畅访问 Github 的网络。

（3）编译 Light 示例时报错，显示：

解决方法：使用如下指令进行编译。

（4）在配网过程中并未出现如下提示：

解决方法：尝试重复进行配网操作。

（5）运行 idf.py 相关指令时显示：

原因：开启新终端时未配置 Matter 环境。

解决方法：使用如下指令配置 Matter 环境。

（6）Matter 安装过程中出现：

解决方法：

（7）Matter 安装过程中出现：

原因：python 3.10 版本中 pip 安装器的 bug 对 Matter 在 python 环境设置过程中的 pip 安装步骤产生了影响。

解决办法：将 python 3.10 切换至更低的版本，例如 3.8，再对 ESP-IDF 和 ESP-Matter 进行安装。

以上就是通过 Matter-SDK 完成 ESP-Matter 的环境搭建及测试的全过程。如果您有任何问题，可以进入乐鑫官网查看相关技术文档获取帮助，欢迎在评论区留言讨论，或随时联系我们。