사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/mohitmishra786/low-level-dev-skills --skill datasheet-and-refmanual-reading시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Datasheet and Reference Manual Reading
Purpose
Teach agents a systematic methodology for reading MCU datasheets and reference manuals: which sections matter for firmware, how to cross-reference pin tables with register maps, and how to avoid documentation pitfalls (errata, footnotes, conditional fields). Not merged with skills/baremetal/peripherals-from-datasheet — this skill covers how to read docs; that skill covers how to write drivers from them.
When to Use
- Starting driver work on unfamiliar silicon
- Resolving ambiguous register bit behavior
- Verifying electrical and timing constraints before PCB/firmware sign-off
- Complementing
skills/baremetal/peripherals-from-datasheet(implementation focus) - Answering "where in the RM do I find X?"
Workflow
1. Document types
| Document | Primary use |
|---|---|
| Datasheet | Pinout, max ratings, package, brief features |
| Reference Manual (RM) | Register maps, bit fields, clock trees, peripheral behavior |
| Programming Manual (PM) | Cortex-M core, NVIC, MPU, debug (ARM doc) |
| Errata sheet | Silicon bugs that affect firmware workarounds |
Read the datasheet for what exists; read the RM for how to program it.
2. First-pass reading order (RM)
1. Memory and bus architecture (address map)
2. Reset and clock control (RCC / CGU)
3. GPIO / pin multiplexing
4. Target peripheral chapter (e.g. USART, SPI, DMA)
5. NVIC / EXTI interrupt mapping table
6. Electrical characteristics (only if timing-critical)
7. Errata — search peripheral name3. Register map extraction checklist
For each register:
- Offset from peripheral base (verify against memory map table)
- Reset value (affects read-modify-write defaults)
- Read-only / write-only / write-1-to-clear bits
- Fields that depend on mode (check "Notes" under table)
- Side effects: clearing flags, auto-clear bits, reserved must-write-0
c
/* Good — named constants from RM bit table */
#define USART_CR1_UE (1U << 13)
#define USART_CR1_TE (1U << 3)
/* Bad — magic numbers without RM citation */
*(volatile uint32_t *)0x40011000 = 0x2000;4. Pin / signal cross-reference
Schematic net → Datasheet pin table (AF number)
→ RM GPIO chapter (MODER, AFR)
→ Peripheral chapter (USART_TX on PA2 = AF7)Always confirm default state after reset (analog mode, pull, JTAG pins).
5. Timing and electrical traps
- Setup/hold for external bus modes (FSMC, SDIO)
- ADC sampling time vs source impedance (datasheet graph)
- Maximum GPIO toggle rate vs load capacitance
- Boot mode pins sampled only at reset
6. Errata workflow
Symptom matches errata?
├── Yes → apply documented workaround in driver
└── No → verify silicon revision (DBGMCU_IDCODE / UID)7. Agent usage
/datasheet-and-refmanual-reading Find STM32F4 USART baud rate formula and required clock sourceCommon Problems
| Symptom | Cause | Fix |
|---|---|---|
| Wrong register behavior | Read wrong silicon rev errata | Check ERRATA sheet first |
| AF does not work | Confused DS pin name with RM AF table | Cross-check both tables |
| Intermittent DMA | Missed footnote on buffer alignment | RM DMA chapter notes |
| Clock mismatch | Used max frequency from DS banner, not voltage range table | Use operating conditions table |
Related Skills
skills/baremetal/peripherals-from-datasheet— driver implementation workflowskills/baremetal/mmio-and-bit-manipulation— safe register accessskills/baremetal/gpio-baremetal— pin mux from RM tablesskills/kernel-dev/device-tree— bindings mirror RM capabilities for Linux
