Mohamed Salem 4f1199a3e6 Scaffold bootloader project with TODO checklist

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.

2026-04-18 23:37:33 +02:00

939 B

Raw Blame History

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.

939 B Raw Blame History