Mohamed Salem
4f1199a3e6
New project under bootloader/ with the same structure as color_switcher: Dockerfile, docker-compose, modular CMake, and APP_BOOT + SYS_ECU stub components. Reuses common/ submodules for MCU_UART, MCU_USB, HAL_COM, STD_TYPES. TODO.md lists all open design decisions (interface, protocol, flash layout, entry trigger, integrity checks, flash strategy) and the implementation tasks that depend on them.
24 lines
939 B
Markdown
24 lines
939 B
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Project
|
|
|
|
Custom bootloader for the Raspberry Pi Pico (RP2040). Receives firmware over a communication interface, writes to flash, and jumps to the main application.
|
|
|
|
## Build System
|
|
|
|
All builds run inside Docker — no local toolchain required.
|
|
|
|
- `docker compose run --rm pico-build bash /scripts/build.sh` — compile the firmware
|
|
- `./flash.sh bootloader` — flash to Pico (from repo root)
|
|
|
|
## Architecture
|
|
|
|
- `src/APP_BOOT/{inc,prg,cfg}/` — bootloader application logic (firmware receive, flash write, app jump)
|
|
- `src/SYS_ECU/{inc,prg,cfg}/` — system orchestrator (init sequence, main loop)
|
|
- Shared components from `common/` (STD_TYPES, MCU_UART, MCU_USB, HAL_COM, etc.)
|
|
|
|
## Conventions
|
|
|
|
Same as the repo-level CLAUDE.md — MISRA-C style, STD_TYPES, Hungarian naming, descriptive comments, no magic numbers. |