Mohamed Salem 5779ac2fa4 Add repo-level README and CLAUDE.md

Top-level docs for the multi-project Pico repository. Lists projects,
common conventions, prerequisites, and getting-started instructions.

2026-04-13 03:43:38 +02:00

1.5 KiB

Raw Blame History

Pico Projects

A collection of Raspberry Pi Pico (RP2040) firmware projects. Each project is self-contained in its own subfolder with its own Dockerized build system, CMake configuration, and source code.

Projects

Project	Description	Target Board
color_switcher	Interactive color-switching firmware with USB-CDC serial commands and WS2812B LED control via PIO	Waveshare RP2040-Zero

Getting Started

Each project is independent. To work on one, cd into its folder:

cd color_switcher/
docker compose build              # first time only
docker compose run --rm pico-build bash build.sh   # compile
./flash.sh                        # flash to Pico (hold BOOTSEL + plug in)

See each project's own README.md for project-specific instructions.

Prerequisites

Docker and Docker Compose

No local ARM toolchain needed — everything builds inside Docker containers.

Repository Structure

pico/
├── color_switcher/          # WS2812B color switcher with USB/UART comm
│   ├── cmake/               # modular CMake build system
│   ├── src/                 # layered C firmware (MCU → HAL → APP → SYS)
│   ├── Dockerfile           # containerized ARM cross-compilation
│   ├── docker-compose.yml
│   ├── build.sh / flash.sh
│   └── CLAUDE.md / README.md
└── README.md                # this file