Skip to content
cccskills
FreePublished on GitHub

hardware

Read and control sensors, displays, and other peripherals on Sipeed boards through I2C and SPI, two hardware communication interfaces. Find connected devices, prepare shared pins, and troubleshoot wiring, permissions, and communication settings.

OriginalShow the original description

Read and control I2C and SPI peripherals on Sipeed boards (LicheeRV Nano, MaixCAM, NanoKVM).

See how to install

Good for

  • Find sensors connected to a board
  • Read temperature and humidity sensor data
  • Control displays and other peripherals
  • Troubleshoot wiring and communication settings

Files included (3)

  • SKILL.md2.3 KB
  • references/board-pinout.md3.1 KB
  • references/common-devices.md4.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Hardware (I2C / SPI)

Use the i2c and spi tools to interact with sensors, displays, and other peripherals connected to the board.

Quick Start

# 1. Find available buses
i2c detect

# 2. Scan for connected devices
i2c scan  (bus: "1")

# 3. Read from a sensor (e.g. AHT20 temperature/humidity)
i2c read  (bus: "1", address: 0x38, register: 0xAC, length: 6)

# 4. SPI devices
spi list
spi read  (device: "2.0", length: 4)

Before You Start — Pinmux Setup

Most I2C/SPI pins are shared with WiFi on Sipeed boards. You must configure pinmux before use.

See references/board-pinout.md for board-specific commands.

Common steps:

  1. Stop WiFi if using shared pins: /etc/init.d/S30wifi stop
  2. Load i2c-dev module: modprobe i2c-dev
  3. Configure pinmux with devmem (board-specific)
  4. Verify with i2c detect and i2c scan

Safety

  • Write operations require confirm: true — always confirm with the user first
  • I2C addresses are validated to 7-bit range (0x03-0x77)
  • SPI modes are validated (0-3 only)
  • Maximum per-transaction: 256 bytes (I2C), 4096 bytes (SPI)

Common Devices

See references/common-devices.md for register maps and usage of popular sensors: AHT20, BME280, SSD1306 OLED, MPU6050 IMU, DS3231 RTC, INA219 power monitor, PCA9685 PWM, and more.

Troubleshooting

ProblemSolution
No I2C buses foundmodprobe i2c-dev and check device tree
Permission deniedRun as root or add user to i2c group
No devices on scanCheck wiring, pull-up resistors (4.7k typical), and pinmux
Bus number changedI2C adapter numbers can shift between boots; use i2c detect to find current assignment
WiFi stopped workingI2C-1/SPI-2 share pins with WiFi SDIO; can't use both simultaneously
devmem not foundDownload separately or use busybox devmem
SPI transfer returns all zerosCheck MISO wiring and device power
SPI transfer returns all 0xFFDevice not responding; check CS pin and clock polarity (mode)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

agent-browser

FreeSummary

Automate website navigation, form entry, button clicks, and data extraction using the agent-browser command-line tool. Capture screenshots or PDFs, reuse login sessions, and inspect page elements while checking web application behavior.

  • Automate form entry and button clicks
  • Extract text and links from web pages
  • Save screenshots and page PDFs
sipeed/picoclaw30.1KUpdated Oct 16, 2026

github

FreeSummary

Use the GitHub command-line tool to inspect issues, pull requests, and automated workflow runs. Check failed steps and logs, retrieve additional details through the API, and extract selected fields into structured results.

  • Check automated test results for a pull request
  • Inspect failed workflow steps and logs
  • List issue numbers and titles
sipeed/picoclaw30.1KUpdated Oct 16, 2026

picoclaw-agent

FreeSummary

Set up, debug, and extend PicoClaw using its own commands and configuration structure. Get guidance on model authentication, external tool connections, scheduled tasks, and how conversations are routed and stored.

  • Setting up models and authentication in PicoClaw
  • Configuring and troubleshooting MCP server connections
  • Setting up recurring tasks
sipeed/picoclaw30.1KUpdated Oct 16, 2026

skill-creator

FreeSummary

Turn repeated workflows into reusable Picoclaw skills, or update and review existing ones. Organize SKILL.md instructions, scripts, reference documents, and output assets, then check the structure and test representative tasks.

  • Turning a repeated workflow into a reusable skill
  • Updating or reviewing an existing SKILL.md
  • Organizing scripts, references, and templates
sipeed/picoclaw30.1KUpdated Oct 16, 2026

summarize

FreeSummary

Summarize articles, local files, YouTube videos, and podcasts to review their main points. Adjust the summary length, or extract available text and transcripts from URLs when you need the source content.

  • Reviewing the main points of an online article
  • Summarizing a local PDF
  • Extracting an available YouTube transcript
sipeed/picoclaw30.1KUpdated Oct 16, 2026

tmux

FreeSummary

Control interactive command-line programs through tmux by sending keystrokes, reading terminal output, and waiting for prompts. Use separate sessions to operate Python consoles or run multiple coding agents while checking their progress and results.

  • Operate an interactive Python console
  • Run multiple coding agents in parallel
  • Wait for prompts and inspect terminal output
sipeed/picoclaw30.1KUpdated Oct 16, 2026

See all skills by sipeed

Report a problem with this skill