使用 Matter-SDK 快速搭建 Matter 環(huán)境 (Linux)
Matter 作為一個統(tǒng)一的智能家居互聯(lián)協(xié)議，憑借其高兼容性的特點，正逐漸打破各個智能家居之間的壁壘。樂鑫作為在 Matter 項目發(fā)布之初的早期成員，提供了一套開源、完整、易用的 Matter-SDK。
樂鑫的 Matter-SDK 是建立在開源 Matter-SDK 之上的，它提供了簡化的 API、常用的外設(shè)、安全、制造和生產(chǎn)工具以及詳盡的文檔支持。該 SDK 包括豐富的生產(chǎn)參考資料，旨在簡化 Matter 產(chǎn)品的開發(fā)過程，使用戶能夠在最短的時間內(nèi)投入生產(chǎn)。
您可以觀看下面的教程視頻，也可以閱讀本篇的圖文教程。本文將詳細介紹在 Linux 環(huán)境下，如何使用 Matter-SDK 完成 Matter 環(huán)境搭建。
搭建步驟：
1. 系統(tǒng)及設(shè)備環(huán)境
操作系統(tǒng)：Ubuntu 22.04.3 LTS
主機配置：具有藍牙適配器
網(wǎng)絡(luò)：能流暢訪問?Github?的網(wǎng)絡(luò)環(huán)境
測試芯片：ESP32-C3-MINI-1
測試開發(fā)板：ESP32-C3-DevKitM-1 v1.0
注：Ubuntu 版本應(yīng)為 20.04 和 22.04，并且為主機開發(fā)。若使用虛擬機，在用 CHIP Tool 工具進行配網(wǎng)調(diào)試時會出現(xiàn)查找藍牙設(shè)備失敗或者無法進行調(diào)試的情況。
2. 安裝準(zhǔn)備
2.1 Matter 安裝準(zhǔn)備
安裝過程具體請參考官方 Github 項目。
注：Windows 系統(tǒng)推薦使用 WSL 進行開發(fā)，詳見官方 WSL 配置方法。
2.2 搭建 ESP-IDF 開發(fā)環(huán)境
Matter 的開發(fā)環(huán)境依賴于 ESP-IDF 開發(fā)環(huán)境，如果當(dāng)前沒有搭建 ESP-IDF 環(huán)境，請參考官方文檔進行搭建，或者使用下面的指令進行快速搭建。
（1）安裝 ESP-IDF 需要以下安裝準(zhǔn)備：
（2）獲取倉庫，進行安裝：
使用以下指令獲取倉庫，進行安裝：
4. 配置環(huán)境
當(dāng)每一個新終端開啟時，使用以下命令來配置 Matter 的開發(fā)環(huán)境：
您可以選擇開啟 Ccache 以提升編譯速度：
進入 ESP-Matter Light 示例目錄：
開始編譯示例，首先設(shè)置編譯目標(biāo)芯片平臺（以 ESP32-C3 為例）：
在正式進行燒錄之前，推薦先擦除整片 Flash，燒錄并監(jiān)控：
至此，如果編譯沒有報錯，程序成功燒錄進 ESP32-C3，并在終端界面顯示正常的狀態(tài)，則代表 Matter 環(huán)境已被成功搭建。
6. 對 Matter 設(shè)備進行配網(wǎng)與基本控制
首先，使用在交互模式下的 CHIP Tool 進行配網(wǎng)。先為配網(wǎng)開啟一個新的終端，配置 Matter 的開發(fā)環(huán)境，并運行：
對設(shè)備進行配網(wǎng)具有多種途徑，這里我們使用 BLE Wi-Fi 的方式進行配網(wǎng)，復(fù)制如下指令：
在上述指令中，0x7283 是隨機選取的節(jié)點 ID，20202021 是配對碼，3840 是鑒別碼，粘貼命令到終端，確保電腦與所填 Wi-Fi 在同一網(wǎng)絡(luò)環(huán)境內(nèi)，在 SSID 填入 Wi-Fi 名稱，passphrase 填入密碼。填寫完成后的示例如下：
開始運行，等待一段時間，當(dāng)監(jiān)控設(shè)備的終端中出現(xiàn)以下日志時，即代表配網(wǎng)成功：
在配網(wǎng)完成后，我們嘗試使用一個命令來對 ESP32-C3 開發(fā)板上的 RGB 燈進行控制，復(fù)制以下開關(guān)翻轉(zhuǎn)的命令到 CHIP Tool?終端中運行：
在監(jiān)控設(shè)備的終端中我們可以看到 Received command 相關(guān)日志：
即代表收到了指令的請求，同時，我們也可以看到開發(fā)板上的 RGB 燈關(guān)閉了，再次運行，RGB 燈被點亮。
7. 常見問題及其解決方法
（1）idf.py erase_flash 時出現(xiàn)：
解決方法：需要確保該用戶對 USB 口擁有正確的讀寫權(quán)限。
（2）git clone 時出錯或速度過慢：
解決方法：需要確保用戶擁有一個能流暢訪問 Github 的網(wǎng)絡(luò)。
（3）編譯 Light 示例時報錯，顯示：
解決方法：使用如下指令進行編譯。
（4）在配網(wǎng)過程中并未出現(xiàn)如下提示：
解決方法：嘗試重復(fù)進行配網(wǎng)操作。
（5）運行 idf.py 相關(guān)指令時顯示：
原因：開啟新終端時未配置 Matter 環(huán)境。
解決方法：使用如下指令配置 Matter 環(huán)境。
（6）Matter 安裝過程中出現(xiàn)：
解決方法：
（7）Matter 安裝過程中出現(xiàn)：
原因：python 3.10 版本中 pip 安裝器的 bug 對 Matter 在 python 環(huán)境設(shè)置過程中的 pip 安裝步驟產(chǎn)生了影響。
解決辦法：將 python 3.10 切換至更低的版本，例如 3.8，再對 ESP-IDF 和 ESP-Matter 進行安裝。
以上就是通過 Matter-SDK 完成 ESP-Matter 的環(huán)境搭建及測試的全過程。如果您有任何問題，可以進入樂鑫官網(wǎng)查看相關(guān)技術(shù)文檔獲取幫助，歡迎在評論區(qū)留言討論，或隨時聯(lián)系我們。
相關(guān)資料
ESP-Matter 編程指南
https://docs.espressif.com/projects/esp-matter/en/latest/esp32/index.html
ESP-Matter 示例代碼
https://github.com/espressif/esp-matter/tree/68e99de70266674ce172459136960bbb5c58dc0e
Connectedhomeip Github 項目
https://github.com/project-chip/connectedhomeip
樂鑫 Matter 系列文章
https://zhuanlan.zhihu.com/p/451354647
官方 WSL 配置方法
https://docs.espressif.com/projects/esp-matter/en/latest/esp32c3/developing.html
樂鑫官網(wǎng)
https://www.espressif.com/zh-hans
聯(lián)系我們
https://www.espressif.com/zh-hans/contact-us/sales-questions
