hardware

此技能為 Sipeed 嵌入式裝置提供完整的硬體互動介面。它將 I2C 與 SPI 匯流排操作抽象化為簡單的代理命令，讓使用者能夠輕鬆與感測器、顯示器及工業控制器進行通訊。專為硬體工程師、IoT 開發者與創客設計，此技能簡化了在 ARM 與 RISC-V 平台上除錯及整合外設的複雜流程。使用者無需從零開始編寫底層驅動，即可檢測匯流排可用性、執行裝置位址掃描、讀取感測器暫存器並執行多位元組的 SPI 傳輸。

• 完整支援 I2C 匯流排檢測、位址掃描及暫存器級別的讀寫操作。

• 完整的 SPI 裝置管理，包含清單檢視、讀取與寫入，並提供傳輸模式驗證。

• 內建寫入操作安全性檢查，強制要求使用者對資料修改進行確認，以防止意外的硬體損壞。

• 支援多種常見硬體模組，例如 AHT20 濕度感測器、BME280 氣壓感測器、SSD1306 OLED 螢幕、MPU6050 IMU、DS3231 RTC 以及 INA219 電量監測器。

• 提供針對常見問題（如權限錯誤、匯流排編號偏移及引腳多工衝突）的疑難排解流程。

• 在初始化前務必檢查開發板的引腳多工（Pinmux）配置，因為 Sipeed 開發板上的 I2C 與 SPI 引腳通常與 WiFi SDIO 功能共用。

• 頻繁使用 i2c detect 與 spi list 工具，以確保系統重啟後匯流排分配保持一致。

• 對於敏感的寫入操作，請務必在代理程式提示詞中加入 confirm: true 參數。

• 適用於嵌入式系統原型開發、自動化感測器數據記錄及外設測試場景，提供快速的反覆運算回饋。

• 注意：某些設定可能需要手動載入核心模組（如 i2c-dev）或使用 devmem 工具對特定 Sipeed 板型進行暫存器級別的引腳配置。