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 板型进行寄存器级别的引脚配置。