引言

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

一、硬件準備

1.1 核心開發板選擇

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

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

1.2 輔助設備

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

二、軟件開發環境搭建

2.1 操作系統與基礎工具

建議在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，現更名為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 安裝編譯工具鏈

根據目標平臺安裝對應的工具鏈：

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

2.4 編譯第一個示例

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

三、調試與測試環境配置

3.1 構建Matter控制器

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

3.2 配網與調試

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

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

3.3 使用iOS/Android測試App

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

四、常見問題與優化建議

4.1 編譯錯誤處理

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

4.2 開發效率提升

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

##

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

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