Repository navigation
Releases
v0.3.1-preview — 網頁開關插座
管理後台可以直接開關插座。
- 網頁開關插座：總覽頁電力卡右上角新增開關按鈕。管理員登入後即可開關，關閉前會再確認；收到 MCU 確認才顯示成功，失敗或逾時會提示原因。限 Matter 模式，HomeKit 模式按鈕停用（請使用家庭 App 或實體按鍵）。
- 不拆機安裝：符合條件的原廠插座（10219-1531、Active Bank 2、已啟用 Dual Firmware）可在原廠
http://插座IP/upload.htm上傳 commandkit-matter-v0.3.1-public-first-install.bin（SHA-2566de78864…1f1862），不必拆機；此方式已在實體插座實測成功。請勿用它更新已安裝本韌體的插座。
已安裝自訂韌體的插座：開啟 http://插座IP:18082/ 會自動提示新版，登入後在「更新」分頁按「下載並更新」；或下載 matter.ota 手動上傳。一般 OTA 保留裝置身分、原廠 HomeKit 配對碼、Wi-Fi、管理密碼、家庭配對與累積 kWh。kernel／Bank 2 hash 與簽章公鑰和 v0.3.0 相同。
原生與 MIPS 更新／管理測試（各 59 項）、Matter VM（經由實際 HTTP API 驗證開關與 MCU 確認）、PID1 更新路徑、部署、實際 MIPS 設定伺服器、原廠 Boa 模擬與公開檔案稽核均通過。這是預覽版，原機安裝驗收由使用者執行。
v0.3.0-preview — 全新管理介面與設定精靈
全新設計的插座管理後台與首次設定熱點。
- 管理後台：即時功率量表與近 2 分鐘走勢、電壓／電流／累積用電卡片、分頁導覽（手機為底部分頁列）、深色模式。
- 自動檢查更新：開啟
http://插座IP:18082/會自動查詢新版本，有新版時總覽頁會提示；登入後在「更新」分頁一鍵下載並更新，安裝過程分步顯示。 - 燈號與配對：六種 LED 模式改為卡片並附燈號預覽，夜間熄燈加上 24 小時時間軸；Matter 設定碼可一鍵複製。
- 設定熱點精靈：首次設定改為三步驟——選擇 Wi-Fi、建立管理密碼、加入家庭。
已安裝自訂韌體的插座：在管理後台登入 → 更新 → 下載並更新；或下載 matter.ota 後手動上傳。ZIP 內含韌體、說明與驗證資料；matter-matter-ota.bin 供 Matter OTA Provider 使用。首次安裝請依燒錄說明使用 matter-8m-region.bin（部分燒錄映像，需本機個別化，不可整片燒錄）。
不拆機安裝（新增）：原廠韌體 10219-1531、Active Bank 2、已啟用 Dual Firmware 的原廠插座，可在原廠 http://插座IP/upload.htm 上傳 commandkit-matter-v0.3.0-public-first-install.bin（SHA-256 7497ddbf…a35ab），不必拆機或使用燒錄器；此方式已在實體插座實測成功。這是公開共用檔，不含裝置金鑰，每台首次開機自行產生身分。請勿用它更新已安裝本韌體的插座。安裝說明
裝置 API、OTA 簽章與保留範圍不變；kernel／Bank 2 hash 與簽章公鑰和 v0.2.11 相同。一般 OTA 保留裝置身分、原廠 HomeKit 配對碼、Wi-Fi、管理密碼、家庭配對與累積 kWh。
原生、Linux 與 MIPS 的更新／管理測試（各 55 項）、PID1 更新路徑、部署 12 項、實際 MIPS 設定伺服器 14 項及公開檔案稽核均通過；介面已在真實 C 管理服務 fixture 上以瀏覽器實測。這是預覽版，原機安裝驗收由使用者執行。
v0.2.11-preview — LED 控制與夜間熄燈
新增 LED 控制與夜間熄燈，HomeKit、Matter 共用設定。
- 六種模式：智慧狀態、跟隨開關、反向指示、耗電指示、恆亮、恆滅。
- 尋找插座、家庭 App 辨識、設定／連線／配對／異常燈號。
- 跨午夜熄燈排程、NTP 與手機校時備援；校時獨立處理。
- 這次也發布先前完成的 Wi-Fi 回連修復、協議切換、密碼管理後台、配對重設、kWh 歸零與完整出廠重置。
使用插座後台 http://插座IP:18082/ → 管理員登入 → 管理設定 → 韌體更新。線上索引部署完成後可按「檢查新版本」；也可下載 matter.ota 手動更新。ZIP 提供韌體、說明與驗證資料；matter-matter-ota.bin 供 Matter OTA Provider。
一般 OTA 保留裝置身分、原廠 HomeKit 配對碼、Wi-Fi、管理密碼、配對與累積 kWh。首次從尚無管理密碼的舊版升級，會進入初始設定熱點建立密碼並重新輸入 Wi-Fi。原廠 /boafrm/formDualFirmware 需要不同的首次安裝包。
原生與 MIPS 更新／管理測試各 55 項通過，部署 12 項通過、1 項歷史診斷版跳過；原廠 HomeKit hook／配對重置、模擬 MCU 按鍵與瀏覽器面板已驗證。這是預覽版，原機 RF／MFi／LED 與 OTA 安裝仍待驗收。HomeKit 模式的自訂網頁量測及 kWh 累計仍暫停。新版更新索引僅提供 HomeKit／Matter 共用韌體，停止發行舊診斷變體。
v0.2.3-preview — 即時電力監測與簽章 OTA
在插座原有管理網址新增即時電壓、電流、功率與估算累積 kWh。頁面每 2 秒刷新，累積電量約每 30 秒保存，無效或過期讀值顯示「—」。同頁下方保留簽章 OTA 更新入口。
本版已在原機由 v0.2.2 透過區網 OTA 更新，確認版本 5 健康、裝置專屬診斷認證保留、頁面與建置來源相符，以及四項讀值正常。Linux／MIPS 各 24 項更新與 HTTP 測試、12 項部署檢查、完整 Matter commissioning／CASE／持久配對／量測與電量訂閱及重啟保存，以及手機網頁操作均通過。範圍見 verification/monitor-results.json。
已有支援 OTA 的版本請使用 matter.ota；exec-test.ota 僅供原診斷版使用，不能混刷。matter-matter-ota.bin 是提供 Matter OTA Provider 的標準外層容器。
8 MiB BIN 是位址對齊的部分燒錄映像，必須本機個別化並限定 Bank 1 rootfs，禁止全片覆蓋；首次從 v0.1 升級仍須使用原燒錄流程。保留 bootloader、kernel、Bank 2、MAC、MIB、校正、原廠 HomeKit／MFi 與出廠資料。
預覽版本：量測尚未以參考電表校正，非零負載、斷電、長期穩定性與 Apple 家庭等平台 UI 尚未完成本版原機驗收。累積 kWh 為功率積分估算。原廠 Bank 2 提供 checksum fallback，沒有完整應用失敗 A/B 版本回退。
v0.1.0-preview — Incipio CommandKit
v0.1.0-preview — Incipio CommandKit
兩種預覽版：Matter 裝置專屬設定碼／開放配網熱點／MCU 繼電器控制，以及獨立 GCC 執行檔診斷。完整來源、逆向與使用／燒錄文件在 repository。
**BIN 各為 8,388,608 bytes，但只是位址對齊的部分燒錄映像，不能直接整片覆蓋，也不能直接初始化空白晶片。**唯一有效內容為 Bank 1 rootfs [0x130000,0x3C0000)；其餘全為 0xFF。使用本專案工具取得两份一致備份、在本機生成新私人金鑰、合成完整私人目標，再限定區域寫入。每台的 bootloader、kernel、MAC、MIB、校正、Bank 2、factory／HomeKit／MFi 原值保留。
公開 BIN 不含原裝置金鑰、設定 AP 憑證或保留區資料。SHA256SUMS 與各 JSON 對應本次重打包，不能混用歷史映像 hash。
**新公開版本未做原機燒錄／RF／負載及家庭 app 驗收。**MIPS VM 已完成 Matter commissioning、10 次加密開關／按鍵同步／逾時復原／Identify；身分／QR、配網頁與原廠 MIB helper 模擬測試、診斷完整 VM 與 flashrom dummy write／restore 通過。模擬對端不能代替實體裝置。
Matter fabrics 只在 RAM，斷電需重新配對；停用 HomeKit 自動啟動及原廠 OTA。Matter 使用 SDK 開發 attestation，不宣稱商用認證。診斷版不啟動 Matter／HomeKit，不提供軟體繼電器切換；三支附件樣本只有執行檔。
市電斷開、3.3 V、無其他供電時才使用 CH341A。完成後移除燒錄器和全部接線，再裝回外殼上電。限定相容 kernel／Bank 2 的 GD25Q64(B) 8 MiB 裝置，工具不提供全片清除或跳過驗證。
自寫碼先不新增授權，原廠反編譯與第三方元件保持各自來源／既有授權。