# 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.