GitHub

wch-dev-skill

用于沁恒全系列MCU主控开发的AI技能。AI skills for developing the full range of WCH MCU controllers.

C2026-10-09T04:29:25Z★ 24

查看原始项目 ↗

项目文档

简体中文 | English

wch-dev-skill

统一的 WCH（南京沁恒微电子）全系列微控制器固件开发 AI Skill。让 AI Agent 自动生成符合 WCH SDK 规范的嵌入式代码，覆盖 35+ 芯片家族、10 大架构分组。

支持芯片：CH572/CH579（BLE）、CH583/CH585/CH592/CH595（BLE+USB）、CH32V003/CH32V006/CH32L103（低成本）、CH32V103/CH32V20x/CH32V307/CH32V407（通用）、CH32F103/CH32F20x/CH32M030（ARM）、CH32X035/CH32X315/CH641/CH643（USB-PD）、CH32H417（高性能）、CH569（以太网+USB3.0）、CH561/CH563（ARM7TDMI）、CH543-CH559（8051）。

功能特性

统一路由：自动识别芯片型号，导航到正确的 chips/<family>/ 目录
10 个芯片家族，每个家族包含完整的 recipes（场景指南）、API 速查、陷阱文档和 EXAM 例程
覆盖 BLE 全角色（Peripheral/Central/HID/Mesh/OTA/ANCS）、以太网、USB 3.0、USB-PD、LCD、NFC-A 等
每个场景提供完整的调用链、初始化序列和可复制的代码模板
包含各架构（RISC-V/ARM/ARM7TDMI/8051）的常见错误和陷阱

芯片家族覆盖

家族	目录	芯片	架构	关键特性
CH57x	`chips/ch57x/`	CH572, CH579	RISC-V	BLE 5.0, LCD (CH579), NET (CH579)
CH58x/CH59x	`chips/ch58x-ch59x/`	CH583, CH585, CH592, CH595	RISC-V	BLE+USB, LCD, NFCA, ENCODER, KEYSCAN
CH32V 通用	`chips/ch32v-general/`	CH32V103, CH32V20x, CH32V307, CH32V407	RISC-V	CAN, ETH, USB, BLE, LTDC, ARGB
CH32V 低成本	`chips/ch32v-lowcost/`	CH32V003, CH32V006, CH32L103	RISC-V	OPA, USB-PD (CH32L103), LPTIM
CH32F ARM	`chips/ch32f-arm/`	CH32F103, CH32F20x, CH32M030	ARM Cortex-M3	STM32 兼容, BLE, USB-PD
CH32X USB-PD	`chips/ch32x-usbpd/`	CH32X035, CH32X315, CH641, CH643	RISC-V	USB-PD, PIOC
CH32H417	`chips/ch32h-highperf/`	CH32H417	RISC-V	USB 3.0, LTDC, SerDes, 双核
CH569	`chips/ch56x-ethernet/`	CH569	RISC-V	ETH, USB 3.0, eMMC, ECDC
CH561/CH563	`chips/ch561-ch563/`	CH561, CH563	ARM7TDMI	ETH, USB 2.0 HS
CH5xx 8051	`chips/ch5xx-8051/`	CH543-CH559	8051	USB, TouchKey

安装说明

1. 拉取仓库到 skill 目录

根据你使用的 AI Agent 文档，找到或创建存放 Skill 的目录：

git clone <repo-url> wch-dev-skill

例如：

Claude Code项目作用域：位于项目根目录下的 .claude/skills用户作用域：位于 ~/.claude/skills，对本机所有项目生效进入到对应的 skills 文件夹下在终端执行 git clone <repo-url> wch-dev-skill 即可

QwenCode项目作用域：位于项目根目录下的 .qwen/skills用户作用域：位于 ~/.qwen/skills，对本机所有项目生效

OpenCode项目作用域：位于项目根目录下的 .opencode/skills用户作用域：位于 ~/.config/opencode/skills，对本机所有项目生效

2. 使用指定 skill

在你的 AI Agent 中确认 Skill 已加载，可通过命令指定 skill。

例如：

Claude Code 在终端中输入 claude 后回车，然后输入 /wch-dev-skill 并描述你的需求

QwenCode 在终端中输入 qwen 后回车，输入 /skills 回车，选择 wch-dev-skill

OpenCode 在终端中输入 opencode 后回车，输入 /skills 回车，选择 wch-dev-skill

工作原理

Skill 定义了一套工作流，AI Agent 在生成固件代码时会遵循：

步骤	名称	说明
1	识别芯片	确定具体芯片型号，导航到 `chips/<family>/`
2	阅读方案	在 `recipes/` 中匹配场景，获取完整调用链
3	查询 API	查阅 `resources/peripheral_api.md` 获取函数签名
4	检查陷阱	阅读 `resources/pitfalls.md` 避免常见错误
5	验证	确认 API 签名、头文件包含、引脚分配、时钟配置
6	确认	向用户展示实现方案（包含、引脚、初始化序列、主循环）
7	执行	复制最接近的 EXAM 例程，然后修改适配
8	构建	RISC-V/ARM: MounRiver Studio (.wvproj)。ARM7: Keil MDK。8051: Keil C51
9	调试	UART 调试输出（115200 波特率）。BLE: nRF Connect。USB-PD: USB-C 分析仪

覆盖场景

BLE 应用（CH57x / CH58x/CH59x / CH32V20x / CH32F20x）

BLE 从机（Peripheral）— 广播、GATT 服务、通知
BLE 主机（Central）— 扫描、连接、服务发现、读写
BLE HID 设备 — 键盘、鼠标、消费者控制
BLE Mesh — 配网、阿里智能灯模型、厂商模型
BLE OTA — 双镜像备份升级、IAP 引导
BLE 速度测试 — 吞吐量优化、LE 2M PHY
BLE IoCHub — 自定义数据点协议、多设备组网
BLE ANCS / 心率 / 透传 / USB 合用

有线通信

以太网 — TCP/UDP Socket（CH32V307/CH32F20x/CH569/CH561/CH563/CH32H417/CH579/CH595）
USB 设备 — CDC、HID、自定义（全系列）
USB 主机 — 设备枚举、AOA、U 盘
USB 3.0 — 超高速设备（CH569/CH32H417/CH32X315）
USB-PD — PD 协商、电压/电流配置（CH32X035/CH641/CH643/CH32L103/CH32M030/CH32H417）
CAN — CAN 2.0B 收发（CH32V307/CH32F103/CH32L103/CH32H417）

显示与人机交互

LCD 段码屏 — CH579/CH585/CH592/CH595
FSMC/TFT LCD — CH32V307/CH32F20x
LTDC 显示 — CH32V407/CH32H417
ARGB LED — CH32V407/CH32X315
TouchKey — 全系列
KEYSCAN 键盘矩阵 — CH572/CH595
ENCODER 编码器 — CH595
NFCA NFC-A — CH585

外设驱动

GPIO / UART / SPI / I2C / ADC / Timer / PWM — 全系列
DAC / OPA / CMP — 多数系列
Flash 读写擦除、DMA 传输、EXTI 中断
RTC / IWDG / WWDG / 低功耗模式

RTOS 支持

FreeRTOS / RT-Thread / HarmonyOS / TencentOS — CH32V/CH32F/CH32X/CH58x/CH59x 系列
UCOS — CH563

目录结构

wch-dev-skill/
  SKILL.md                        # 统一路由和指南
  README.md                       # 本文件（中文）
  README_EN.md                    # 英文说明
  CHANGELOG.md                    # 版本历史
  chips/
    ch57x/                        # CH572/CH579 BLE 5.0
      recipes/                    # 20 个场景指南
      resources/                  # API 速查、陷阱、配置、EXAM 例程
    ch58x-ch59x/                  # CH583/CH585/CH592/CH595 BLE+USB
      recipes/                    # 30 个场景指南
      resources/                  # API 速查、陷阱、配置、EXAM 例程
    ch32v-general/                # CH32V103/V20x/V307/V407
      recipes/                    # 21 个场景指南
      resources/                  # API 速查、陷阱、EXAM 例程
    ch32v-lowcost/                # CH32V003/V006/L103
      recipes/                    # 15 个场景指南
      resources/                  # API 速查、陷阱、EXAM 例程
    ch32f-arm/                    # CH32F103/F20x/M030 ARM Cortex-M3
      recipes/                    # 22 个场景指南
      resources/                  # API 速查、陷阱、EXAM 例程
    ch32x-usbpd/                  # CH32X035/X315/CH641/CH643 USB-PD
      recipes/                    # 14 个场景指南
      resources/                  # API 速查、陷阱、EXAM 例程
    ch32h-highperf/               # CH32H417 双核 USB3+LTDC
      recipes/                    # 38 个场景指南
      resources/                  # API 速查、陷阱、EXAM 例程
    ch56x-ethernet/               # CH569 ETH+USB3.0
      recipes/                    # 18 个场景指南
      resources/                  # API 速查、陷阱、EXAM 例程
    ch561-ch563/                  # CH561/CH563 ARM7TDMI ETH
      recipes/                    # 12 个场景指南
      resources/                  # API 速查、陷阱、EXAM 例程
    ch5xx-8051/                   # CH543-CH559 8051
      recipes/                    # 12 个场景指南
      resources/                  # API 速查、陷阱、EXAM 例程

参考资源

WCH 官网 → http://wch.cn
MounRiver Studio → http://www.mounriver.com
EVT SDK 源码 → 各芯片目录下的 EVT/EXAM/
BLE 参考手册 → chips/ch57x/resources/EXAM/BLE/
每个家族的 API 速查 → chips/<family>/resources/peripheral_api.md
常见陷阱 → chips/<family>/resources/pitfalls.md