hardware

Read and control I2C and SPI peripherals on supported Sipeed boards.

5|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/tiancaiamao/ai --skill hardware-tiancaiamao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hardware
Source: https://github.com/tiancaiamao/ai/tree/main/skills/hardware
Command: npx skills add https://github.com/tiancaiamao/ai --skill hardware-tiancaiamao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the friction of working with low-level hardware interfaces on supported Sipeed boards by guiding reliable access to I2C and SPI peripherals.

Core Features & Use Cases

  • Bus Discovery and Scanning: Find active I2C buses and attached devices, or enumerate SPI devices before interacting with hardware.
  • Board-Specific Pinmux Setup: Apply the correct pin configuration for LicheeRV Nano, MaixCAM, MaixCAM2, and NanoKVM so shared pins do not conflict with WiFi or other functions.
  • Peripheral Read and Write Workflows: Read sensors, control displays, query RTCs, and operate common chips such as AHT20, BME280, SSD1306, MPU6050, DS3231, INA219, PCA9685, MCP3008, and W25Q128.
  • Safety and Troubleshooting: Validate address ranges, SPI modes, transfer sizes, and write confirmations while using the reference docs to diagnose bus, wiring, and permission issues.

Quick Start

Ask the Skill to help you configure the correct pinmux, detect available buses, and read data from a specific I2C or SPI device on your board.

Frequently Asked Questions about hardware

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scan I2C buses and detect connected sensors on Sipeed boards?

To scan I2C buses and detect sensors on Sipeed boards, you use guided bus discovery to find active I2C buses and enumerate attached devices before interacting with hardware, which ensures reliable peripheral access during hardware bring-up.

How do I configure pinmux for SPI peripherals on a LicheeRV Nano?

To configure pinmux for SPI peripherals on a LicheeRV Nano, apply board-specific pin configurations so shared pins do not conflict with WiFi or other functions. This setup is required before starting bus transactions and device control.

Can I read data from an AHT20 or BME280 sensor over I2C on MaixCAM?

Yes, you can read data from an AHT20 or BME280 sensor over I2C on MaixCAM. The Skill provides peripheral read and write workflows for querying these common chips and operating other supported I2C devices.

What is the best way to troubleshoot I2C and SPI device write failures on NanoKVM?

The best way to troubleshoot I2C and SPI device write failures on NanoKVM is to use built-in safety validation for address ranges, SPI modes, and write confirmations. Reference docs also help diagnose wiring and permission issues.

Does this hardware Skill support driving SSD1306 displays over SPI?

Yes, this hardware Skill supports driving SSD1306 displays over SPI. It handles peripheral read and write workflows for display driving alongside sensor polling, RTC queries, and operating chips like W25Q128 and MCP3008.

What limitations should I check before transferring large data over SPI on MaixCAM2?

Before transferring large data over SPI on MaixCAM2, check the validated transaction limits and transfer size constraints. The Skill applies guarded write operations with validated limits to prevent bus errors during peripheral debugging.