引言

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

一、硬件準(zhǔn)備

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

推薦使用支持Thread和Wi-Fi的雙模芯片開(kāi)發(fā)板，這是構(gòu)建Matter設(shè)備的常見(jiàn)選擇。

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

1.2 輔助設(shè)備

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

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

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

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

• Git：用于拉取代碼。
• Python 3.8+ 及 pip：編譯腳本依賴(lài)。
• CMake 3.20+：項(xiàng)目構(gòu)建工具。

2.2 獲取Matter SDK

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

2.3 安裝編譯工具鏈

根據(jù)目標(biāo)平臺(tái)安裝對(duì)應(yīng)的工具鏈：

- 對(duì)于nRF52840：安裝arm-none-eabi-gcc及nRF5 Command Line Tools。
- 對(duì)于ESP32：安裝ESP-IDF（樂(lè)鑫官方框架）。
運(yùn)行SDK中的環(huán)境引導(dǎo)腳本通?？勺詣?dòng)安裝大部分依賴(lài)：
`bash
./scripts/bootstrap.sh
`

2.4 編譯第一個(gè)示例

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

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

3.1 構(gòu)建Matter控制器

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

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

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

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

3.3 使用iOS/Android測(cè)試App

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

四、常見(jiàn)問(wèn)題與優(yōu)化建議

4.1 編譯錯(cuò)誤處理

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

4.2 開(kāi)發(fā)效率提升

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

##

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

提示：Matter SDK更新較快，具體命令若有變動(dòng)，請(qǐng)以GitHub倉(cāng)庫(kù)最新說(shuō)明為準(zhǔn)。