
Embedded-programming
Agent skill for STM32 development: SPL & HAL (CubeMX) × bare-metal & FreeRTOS, with a static checker, field-tested peripheral recipes (OLED, FSMC TFT-LCD, DA…
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up Embedded-programming (claude-skill project) into my current project. Found on https://claudeers.com/embedded-programming Repo: https://github.com/wdcjx/Embedded-programming Homepage/docs: — Detected install method: claude-skill → # copy this skill into .claude/skills/embedded-programming/ Category: skills. Platforms: api. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
# copy the skill dir into your project: # .claude/skills/embedded-programming/ (or ~/.claude/skills/embedded-programming/ for all projects)
git clone https://github.com/wdcjx/Embedded-programming
// compatibility
| Platforms | api |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | — |
| Pricing | open-source |
| Language | C |
embed — 嵌入式(STM32)开发辅助 Skill
一个给 AI Agent 用的技能(Skill):让 Agent 能独立完成简单 STM32 项目的代码生成 (GPIO / UART / TIM / ADC / I2C / SPI / EXTI / DMA / 看门狗 / OLED 显示屏),支持四条轨: 裸机 SPL(默认)、SPL + FreeRTOS、裸机 HAL(CubeMX + Keil,起步)、HAL + FreeRTOS, 输出带引脚分配表、接线表、工程文件清单和烧录说明的完整代码。
早期版本,随使用逐步完善,进度见 ROADMAP.md。
文件结构
embed/ # 单一技能:快速生成 + 工程纪律两种模式
├── SKILL.md # 入口:模式路由、工作流、硬约束、自检清单
├── README.md # 本文件
├── ROADMAP.md # 后续计划
├── references/
│ ├── stm32-stdperiph-api.md # 标准库 API 速查 + 密度宏/工程文件清单
│ ├── peripheral-recipes.md # 典型外设配方(点灯/串口/PWM/ADC/I2C/SPI…)
│ ├── freertos-spl-integration.md # SPL+FreeRTOS 集成规则(向量接管/FromISR/内存预算)
│ ├── oled-ssd1306.md # OLED 0.96"(SSD1306)驱动知识(I2C/SPI 双版)
│ ├── hal-basics.md # HAL 轨:CubeMX/句柄模型/SPL→HAL 对照/F1 坑/RTOS 铁律
│ ├── hal-driver-patterns.md # HAL 第三方驱动范式(I2C/SPI/DWT 延时,HAL_Driver_Lib 基准)
│ ├── freertos-hal-integration.md # HAL+FreeRTOS 完整集成(CubeMX 实测:时基 TIM2/三宏联动/双堆)
│ ├── hal-freertos-field-guide.md # 现场可靠性:__HAL_LOCK/Mutex/临界区/栈堆精算/Cache+DMA/低功耗
│ ├── symptom-quickref.md # 症状速查:死机/挂死/数据乱 → 根因反查
│ ├── fsmc-lcd-ili9341.md # FSMC 驱 TFT-LCD(ILI9341,HD/XL):地址译码/时序/绘图/坑
│ ├── f4-family-notes.md # F4 起步(F407VET6 实测):168MHz 时钟树/F1→F4 差异对照/换轨清单
│ ├── gsm-at-sms.md # GSM 模块 AT 短信报警(SIM800/900):注网自检/CMGS/回读+超时/节流
│ ├── spl-peripheral-checklist.md # 外设初始化顺序清单(纪律)
│ ├── isr-and-concurrency-rules.md # ISR/并发/volatile/临界区规则(纪律)
│ └── known-pitfalls.md # 已知坑清单(纪律)
├── templates/
│ ├── main.c # 裸机 SPL 工程骨架模板
│ ├── main_rtos_spl.c # SPL+FreeRTOS 任务工程骨架模板
│ ├── FreeRTOSConfig.h # F103 中密度 FreeRTOS 配置模板(Kernel 10.x~11.x)
│ └── main_hal.c # 裸机 HAL 骨架(CubeMX 对照 + 手写起点)
├── assets/
│ └── spl-project-template.md # Keil 工程组织/必配项/占用估算
├── scripts/
│ └── validate_generated.py # 静态纪律检查(VIOLATION 必须清零,含 RTOS/HAL 规则)
└── tests/
├── bad_sample.c # 裸机违规自测样本
├── bad_sample_rtos.c # RTOS 违规自测样本
└── bad_sample_hal.c # HAL 违规自测样本
两种模式:要一段能跑的简单代码 → 快速模式(直接说需求); 要"按老手工程纪律生成、审查、检查"的代码 → 纪律模式(默认;提到 规范/审查/检查/validate 即命中)。 两种模式共用同一套 API 文件与模板,纪律文件与检查脚本只在纪律模式强制。
安装
仓库地址:https://github.com/wdcjx/Embedded-programming
- DeepSeek Harness (DSH):侧边栏「技能库」→ 粘贴仓库链接
https://github.com/wdcjx/Embedded-programming安装(自动克隆 + 热加载), 或把整个embed文件夹放到~/.dsh/skills/embed; - 命令行:
git clone https://github.com/wdcjx/Embedded-programming.git,把克隆出的文件夹(或其内容)放到上面的技能目录; - Claude Code:把文件夹复制到
~/.claude/skills/embed。
注意:安装时目录名应与 SKILL.md 中的
name: embed一致。
触发方式
对 Agent 说:「用 embed 技能生成 STM32F103C8T6 的串口回显程序」 或「帮我写 STM32 标准库点灯 + printf,PA6 输出 PWM」——涉及 STM32 / 单片机 / 标准库 / HAL / CubeMX / FreeRTOS 的需求都会命中。 提到 CubeMX 或 HAL 时自动走 HAL 轨,其余默认 SPL 轨。
当前能力
默认目标 STM32F103C8T6(72MHz,中密度 MD;其他容量按密度宏/启动文件表适配)。超出表格范围的需求 Agent 会如实说明。
| 能力域 | 内容 | 状态 |
|---|---|---|
| 四轨代码生成 | 裸机 SPL(默认)/ SPL+FreeRTOS / 裸机 HAL(CubeMX+Keil)/ HAL+FreeRTOS;输出含引脚分配表、接线表、工程文件清单、烧录说明;SysTick 毫秒节拍非阻塞主循环 + printf 重定向 | ✅ 四轨集齐(v0.5.4) |
| 外设配方(SPL) | GPIO / EXTI / USART(printf、RXNE+IDLE 不定长帧)/ TIM(定时中断+PWM)/ ADC(F1 校准)/ I2C 主机(扫描、MPU6050)/ SPI 主机 / IWDG / DAC(HD/XL)/ 传感器驱动小抄(DS18B20 等 14 节) | ✅ recipes §1–14 |
| 显示 | OLED 0.96"(SSD1306,I2C/SPI 双版);FSMC 驱 TFT-LCD(ILI9341/9328:地址译码/时序/窗口绘图/波形示波器信号链) | ✅ 两个工程实测 |
| 通信与报警 | GSM 模块(SIM800/900)AT 短信:注网自检序列、CMGS 完整流程、回读+超时范式(禁盲等)、报警节流三件套(锁存/冷却/重发升级)、传感器阈值报警架构(滞回) | ✅ 火灾报警工程实测(v0.6.3) |
| FreeRTOS 集成 | FreeRTOSConfig.h 模板 + 任务骨架、向量接管三宏、FromISR 优先级红线(≥5)、20K RAM 堆预算、Keil 手动集成六步 SOP(SPL 轨);时基迁 TIM 文件地图、CMSIS V1↔V2、双堆模型(HAL 轨);Kernel 10.x~11.x | ✅ 实测工程 validator 0/0 |
| 跨家族 | F103C8T6 默认;F407VET6 起步(168MHz 时钟树模板、TIM2/TIM5 32 位、F1→F4 差异对照、换轨清单);F7/H7/G0/G4/L4 无标准库,走 HAL 轨并声明未实测校对 | F4 工程级实测(v0.6.2),未上板 |
| 工程纪律与静态检查 | validate_generated.py:时钟使能顺序、volatile/ISR 纪律、ISR 阻塞调用、等待超时、NVIC 分组、向量名、HAL 回调、RTOS API 误用——VIOLATION 清零才交付;坑清单 41 条(每条症状/原因/修法);症状速查 14 条反查表;__HAL_LOCK/Mutex/临界区/栈堆精算/Cache+DMA 现场可靠性知识 | ✅ 6 个自测样本持续回归 |
两种使用模式:快速模式(要一段能跑的简单代码,直接说需求);纪律模式(默认;提到 规范/审查/检查/validate 即命中)——硬约束 + validator 清零 + 坑位申报 + 完整交付物。
常见问题
模板在 VS Code 里报「无法打开源文件 stm32f10x.h / stdio.h」(C/C++ 1696)
这是预期现象,不是代码错误:
stm32f10x.h在 STM32 标准外设库(SPL)包里,模板单独存放时自然找不到;stdio.h在编译器工具链(Keil ARMCC / arm-none-eabi-gcc)里。
模板要放进含 SPL 的实际工程使用。若想在 VS Code 中获得 IntelliSense:
下载 SPL(ST 官网或 GitHub 镜像,如 STM32F10x_StdPeriph_Lib),在工作区建 .vscode/c_cpp_properties.json:
{
"configurations": [{
"name": "STM32",
"compilerPath": "C:/Keil_v5/ARM/ARMCC/bin/armcc.exe",
"defines": ["STM32F10X_MD", "HSE_VALUE=8000000", "USE_STDPERIPH_DRIVER"],
"includePath": [
"${workspaceFolder}/**",
"C:/path/to/STM32F10x_StdPeriph_Lib/Libraries/CMSIS/Device/ST/STM32F10x/Include",
"C:/path/to/STM32F10x_StdPeriph_Lib/Libraries/CMSIS/Include",
"C:/path/to/STM32F10x_StdPeriph_Lib/Libraries/STM32F10x_StdPeriph_Driver/inc"
]
}]
}
(用 GCC 时 compilerPath 指向 arm-none-eabi-gcc;只用 Keil 编译也可以直接无视该报错。)
许可
MIT
// faq
What is Embedded-programming?
Agent skill for STM32 development: SPL & HAL (CubeMX) × bare-metal & FreeRTOS, with a static checker, field-tested peripheral recipes (OLED, FSMC TFT-LCD, DAC waveform, GSM SMS alarm), F1→F4 migration notes, 41 known pitfalls & a symptom quickref. Works in DSH / Claude Code.. It is open-source on GitHub.
Is Embedded-programming free to use?
Embedded-programming is open-source, so it is free to use.
What category does Embedded-programming belong to?
Embedded-programming is listed under skills in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/embedded-programming)
// retro hit counter
[](https://claudeers.com/embedded-programming)
// reviews
// guestbook
// related in Claude Skills
An agentic skills framework & software development methodology that works.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
💫 Toolkit to help you get started with Spec-Driven Development