引言

隨著智能家居設備互聯(lián)互通需求的日益增長，由連接標準聯(lián)盟（CSA）推出的Matter協(xié)議正成為行業(yè)焦點。本系列旨在通過實戰(zhàn)，帶領開發(fā)者從零開始掌握Matter應用開發(fā)。作為開篇，本文將詳細講解如何搭建一套完整、高效的Matter軟硬件開發(fā)環(huán)境。

一、硬件準備

1.1 核心開發(fā)板選擇

推薦使用支持Thread和Wi-Fi的雙模芯片開發(fā)板，這是構建Matter設備的常見選擇。

• Nordic nRF52840 DK：性能穩(wěn)定，社區(qū)資源豐富，支持OpenThread邊界路由器功能。
• ESP32-C3/C6：性價比高，樂鑫提供完善的Matter SDK支持。
• Silicon Labs EFR32MG24：專為Matter和物聯(lián)網(wǎng)優(yōu)化，集成度高。

1.2 輔助設備

• 支持Thread的邊界路由器：如Nordic nRF52840 DK配合Raspberry Pi，或直接使用Google Nest Hub等商用設備。
• 手機/平板：用于調(diào)試和配網(wǎng)（需安裝Matter測試App，如“Matter Tool”）。
• USB數(shù)據(jù)線、杜邦線等基礎配件。

二、軟件開發(fā)環(huán)境搭建

2.1 操作系統(tǒng)與基礎工具

建議在Ubuntu 20.04/22.04 LTS（或Windows WSL2、macOS）下進行。確保已安裝：

• Git：用于拉取代碼。
• Python 3.8+ 及 pip：編譯腳本依賴。
• CMake 3.20+：項目構建工具。

2.2 獲取Matter SDK

Matter的核心是開源的Connected Home over IP (CHIP) SDK，現(xiàn)更名為Matter SDK。通過以下命令獲取：
`bash
git clone --recurse-submodules https://github.com/project-chip/connectedhomeip.git
cd connectedhomeip
./scripts/checkout_submodules.py --platform linux --shallow
`

2.3 安裝編譯工具鏈

根據(jù)目標平臺安裝對應的工具鏈：

- 對于nRF52840：安裝arm-none-eabi-gcc及nRF5 Command Line Tools。
- 對于ESP32：安裝ESP-IDF（樂鑫官方框架）。
運行SDK中的環(huán)境引導腳本通常可自動安裝大部分依賴：
`bash
./scripts/bootstrap.sh
`

2.4 編譯第一個示例

以在nRF52840 DK上編譯lighting-app（燈設備示例）為例：
`bash
source ./scripts/activate.sh # 激活環(huán)境
cd examples/lighting-app/nrfconnect
west build -b nrf52840dk_nrf52840 # 使用west工具構建
`
編譯成功后，固件將生成在build/zephyr目錄下，可通過J-Link或nRF Connect Programmer工具燒錄至開發(fā)板。

三、調(diào)試與測試環(huán)境配置

3.1 構建Matter控制器

控制器用于調(diào)試設備。可編譯PC版的chip-tool（命令行控制器）：
`bash
cd examples/chip-tool
gn gen out/debug # 生成構建目錄
ninja -C out/debug # 編譯
`
編譯后，out/debug/chip-tool即可用于控制Matter設備。

3.2 配網(wǎng)與調(diào)試

1. 設備上電：燒錄好的設備啟動后進入配網(wǎng)模式。
2. 使用chip-tool配網(wǎng)：通過以下命令實現(xiàn)基于PBKDF的配網(wǎng)：
`bash
./chip-tool pairing ble-thread id> pincode> operational_dataset>
`

3. 發(fā)送控制命令：配網(wǎng)成功后，可測試開關燈：
`bash
./chip-tool onoff on 1
`

3.3 使用iOS/Android測試App

安裝官方“Matter測試工具”App，可掃描二維碼或手動輸入配網(wǎng)碼，實現(xiàn)圖形化控制，更貼近真實用戶場景。

四、常見問題與優(yōu)化建議

4.1 編譯錯誤處理

• 依賴缺失：仔細查看錯誤日志，根據(jù)提示安裝對應包（如libssl-dev、libdbus-1-dev）。
• 網(wǎng)絡問題：Git子模塊或工具鏈下載失敗時，可配置代理或手動下載。

4.2 開發(fā)效率提升

• 使用Docker：官方提供預配置的Docker鏡像（project-chip/chip-build），可避免環(huán)境沖突。
• IDE集成：VS Code配合C/C++、CMake插件，提升代碼瀏覽和調(diào)試體驗。
• 日志分析：啟用設備端詳細日志（如PRINTF_DEBUG），并通過串口工具（如screen、minicom）實時查看。

##

至此，一個基礎的Matter軟硬件開發(fā)環(huán)境已搭建完畢。通過編譯示例、配網(wǎng)和控制，開發(fā)者可以直觀感受Matter的工作流程。在后續(xù)實戰(zhàn)中，我們將深入設備端模型定義、業(yè)務邏輯開發(fā)及跨生態(tài)系統(tǒng)測試。記住，穩(wěn)定的環(huán)境是高效開發(fā)的基石，遇到問題時不妨回顧本文步驟，或查閱Matter SDK的官方文檔與社區(qū)。

提示：Matter SDK更新較快，具體命令若有變動，請以GitHub倉庫最新說明為準。