讓 CommandKit 插座
支援 Matter，重獲新生

首次安裝有兩種方式。請先在原廠更新頁 http://插座IP/upload.htm 確認插座的韌體版本與設定，再選擇適合的方式。

方式 B 的準備清單

• CMNDKT-004 智慧插座（RTL8196E 與 GD25Q64 8 MiB 快閃記憶體）
• CH341A 燒錄器（確認為 3.3 V）與 SOIC-8 測試夾
• macOS 或 Linux 電腦，Python 3.11 以上
• flashrom v1.8.0 與支援 LZMA 的 squashfs-tools
• Release 的 matter-8m-region.bin 與 .json
• 保存備份用的私人資料夾（備份含這台插座的專屬資料，請勿公開）

git clone https://github.com/lee98064/incipio-commandkit.git
cd incipio-commandkit
python3 -m pip install -r tools/requirements.txt

將 matter-8m-region.bin 與 matter-8m-region.json 放到 artifacts/releases/。flashrom 的建置方式請參考建置說明。

依第 1 章選擇的方式操作。兩種方式都會保留 bootloader、MAC、無線校正、原廠 HomeKit 資料與第二槽原廠韌體。

1. 下載首次安裝檔

   下載 commandkit-matter-v0.3.1-public-first-install.bin。這是公開共用檔，不含任何裝置金鑰；每台插座第一次開機時會自行產生身分與 Matter 設定碼。

   下載首次安裝檔
2. 開啟原廠更新頁並核對條件

   插座裝好外殼、接上電源、不要接負載。在路由器的裝置清單找到插座 IP，以瀏覽器開啟 http://插座IP/upload.htm，確認韌體為 10219-1531、Active Bank 2、已勾選 Enable Dual Firmware。不要變更雙韌體設定。

3. 上傳

   在頁面上方按 Select File 選擇首次安裝檔，再按 Upload。

4. 等待重新開機

   等待頁面倒數與重新開機，期間請保持供電。不要按「Reboot Form Backup Bank Now」。第一次開機會先產生裝置身分，可能比平常久一些。

5. 進行首次設定

   出現 CommandKit-Setup-XXXXXX 熱點後，依第 3 章完成設定。

工具會先讀取兩份完整備份並逐位元比對，再依備份產生這台插座專用的映像，最後只寫入第一槽檔案系統。晶片型號、備份內容或核對結果有任何不符，工具都會自動停止。

1. 斷電並接上燒錄器

   拔除插座電源並拆開外殼，以測試夾夾住 GD25Q64（注意 pin 1 方向），再連接 CH341A。

2. 讀取兩份備份

   python3 tools/flash.py backup --session private/read-01 \
     --mains-disconnected --voltage-3v3 --no-other-supply

   三個旗標代表你已確認「已斷開市電、電壓為 3.3 V、沒有其他供電」；工具不會替你量測。備份存放在 private/read-01/，請妥善保存。

3. 產生這台插座專用的映像

   python3 tools/flash.py prepare \
     --backup1 private/read-01/before-1.bin --backup2 private/read-01/before-2.bin \
     --release artifacts/releases/matter-8m-region.bin \
     --manifest artifacts/releases/matter-8m-region.json \
     --profile private/outlet-a --output private/matter-target.bin

   此步驟不會接觸硬體。--profile 資料夾保存這台插座的身分；日後重新安裝同一台插座時請沿用，Matter 設定碼才會維持不變。

4. 只寫入第一槽

   python3 tools/flash.py write \
     --image private/matter-target.bin --record private/matter-target.bin.json \
     --session private/write-01 \
     --mains-disconnected --voltage-3v3 --no-other-supply

   寫入範圍固定為 0x130000–0x3BFFFF。完成後工具會完整讀回並逐位元核對；顯示 write_verified_not_boot_tested 即表示寫入與核對完成。

5. 移除燒錄器並裝回外殼

   拆下測試夾與所有接線，裝回外殼後再插上電源。

接上電源後，插座會開啟設定熱點。指示燈每半秒亮滅一次，表示正在等待設定。

1. 連接設定熱點

   手機的 Wi-Fi 選擇 CommandKit-Setup-XXXXXX，不需要密碼。此時無法上網屬正常現象，請保持連線。

2. 開啟設定頁

   若設定頁沒有自動出現，請以瀏覽器開啟 http://192.168.1.254/。

3. 選擇家中 Wi-Fi

   點選 2.4 GHz 網路並輸入密碼；隱藏網路可手動輸入名稱。插座不支援 5 GHz 與僅限 WPA3 的網路。

4. 建立管理密碼

   至少 8 個字元，用於登入管理後台。忘記密碼時只能恢復出廠設定。

5. 保存 Matter 配對碼

   畫面會顯示這台插座專屬的 QR Code 與 11 位數設定碼，請拍照保存。設定碼在重新開機與更新後都不會改變。

插座預設使用 Matter。

1. 手機切回家中 Wi-Fi

   插座與手機必須在同一個網路。

2. 在家庭 app 加入配件

   開啟 Apple 家庭、Google Home 或 Home Assistant，選擇「加入配件」或「新增裝置」。

3. 掃描 QR Code 或輸入設定碼

   使用第 3 章保存的 QR Code 或 11 位數設定碼，依 app 指示完成。

改用 HomeKit

登入管理後台，在「配對」分頁選擇 HomeKit 並儲存，插座會重新啟動。HomeKit 使用插座原廠標籤上的配對碼。HomeKit 模式下，網頁的即時量測與 kWh 累計會暫停。

線上更新

1. 開啟管理後台

   頁面會自動檢查新版本；有新版時，總覽頁會顯示「有新版本可以安裝」。

2. 登入並進入「更新」分頁

   以管理員登入後，按「下載並更新」。

3. 等待安裝完成

   畫面會依序顯示下載、上傳驗證、安裝、重新啟動，約需 1 至 4 分鐘。過程中請保持供電，完成後重新登入即可。

沒有網際網路時，可先在電腦下載 matter.ota，在「手動更新」選擇或拖放檔案。一般更新會保留裝置身分、Wi-Fi、管理密碼、家庭配對與累積用電。

恢復出廠會保留 MAC、無線校正、原廠 HomeKit 資料與這台插座的 Matter 身分。