Mohamed Salem
5779ac2fa4
Top-level docs for the multi-project Pico repository. Lists projects, common conventions, prerequisites, and getting-started instructions.
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
# 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](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:
|
|
|
|
```bash
|
|
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](https://docs.docker.com/get-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
|
|
``` |