claudeers.
// Claude Skills

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…

Actively maintained
100/100
last commit 11 days ago
last release 15 days ago
releases 3
open issues 0

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.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/embedded-programming/   (or ~/.claude/skills/embedded-programming/ for all projects)
// or clone
git clone https://github.com/wdcjx/Embedded-programming

// compatibility

Platformsapi
Operating systems—
AI compatibilityclaude
License—
Pricingopen-source
LanguageC

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

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.

36 views
★ 39 stars
unclaimed
updated 26 days ago

// embed badge

Embedded-programming on Claudeers
[![Claudeers](https://claudeers.com/api/badge/embedded-programming.svg)](https://claudeers.com/embedded-programming)

// retro hit counter

Embedded-programming hit counter
[![Hits](https://claudeers.com/api/counter/embedded-programming.svg)](https://claudeers.com/embedded-programming)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

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,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how Embedded-programming connects across the ecosystem