# octopus1633/usbliter8-firmware architecture

> Architecture diagram of the GitHub repository octopus1633/usbliter8-firmware, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/octopus1633/usbliter8-firmware
- Repository: https://github.com/octopus1633/usbliter8-firmware

## Overview

This repository distributes prebuilt usbliter8 community firmware; it does not contain the firmware source or runtime. The user workflow is to identify their RP2350 board and choose its matching UF2 image. Each listed board has a separate firmware artifact. Relationships are limited to the README’s documented board-to-image matching; no source excerpts were available to verify firmware internals.

Main entry points: [`usbliter8.pico2.uf2`](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.pico2.uf2) (Pico 2 UF2), [`usbliter8.pimoroni_tiny2350.uf2`](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.pimoroni_tiny2350.uf2) (Tiny2350 UF2), [`usbliter8.waveshare_rp2350_pizero.uf2`](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_pizero.uf2) (Pizero UF2), [`usbliter8.waveshare_rp2350_usb_a.uf2`](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_usb_a.uf2) (USB-A UF2)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_firmware["UF2 firmware"]
  node_pico2["Pico 2 UF2"]
  node_tiny2350["Tiny2350 UF2"]
  node_pizero["Pizero UF2"]
  node_usb_a["USB-A UF2"]
  node_usb_c["USB-C UF2"]
  node_usb_cm["USB-CM UF2"]
  node_zero["Zero UF2"]
end

node_user(("Board owner"))

node_user -->|"chooses for Pico 2"| node_pico2
node_user -->|"chooses for Tiny2350"| node_tiny2350
node_user -->|"chooses for Pizero"| node_pizero
node_user -->|"chooses for USB-A"| node_usb_a
node_user -->|"chooses for USB-C"| node_usb_c
node_user -->|"chooses for USB-CM"| node_usb_cm
node_user -->|"chooses for Zero"| node_zero

click node_pico2 "https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.pico2.uf2"
click node_tiny2350 "https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.pimoroni_tiny2350.uf2"
click node_pizero "https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_pizero.uf2"
click node_usb_a "https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_usb_a.uf2"
click node_usb_c "https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_usb_c.uf2"
click node_usb_cm "https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_usb_cm.uf2"
click node_zero "https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_zero.uf2"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_pico2,node_tiny2350,node_pizero,node_usb_a,node_usb_c,node_usb_cm,node_zero toneBlue
class node_user toneIndigo
```

## Components

### UF2 firmware

- [Pico 2 UF2](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.pico2.uf2): `usbliter8.pico2.uf2`
- [Tiny2350 UF2](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.pimoroni_tiny2350.uf2): `usbliter8.pimoroni_tiny2350.uf2`
- [Pizero UF2](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_pizero.uf2): `usbliter8.waveshare_rp2350_pizero.uf2`
- [USB-A UF2](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_usb_a.uf2): `usbliter8.waveshare_rp2350_usb_a.uf2`
- [USB-C UF2](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_usb_c.uf2): `usbliter8.waveshare_rp2350_usb_c.uf2`
- [USB-CM UF2](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_usb_cm.uf2): `usbliter8.waveshare_rp2350_usb_cm.uf2`
- [Zero UF2](https://github.com/octopus1633/usbliter8-firmware/blob/main/usbliter8.waveshare_rp2350_zero.uf2): `usbliter8.waveshare_rp2350_zero.uf2`

### Other components

- **Board owner**

## Connections

- Board owner → Pico 2 UF2: chooses for Pico 2 (evidence: `README.md`)
- Board owner → Tiny2350 UF2: chooses for Tiny2350 (evidence: `README.md`)
- Board owner → Pizero UF2: chooses for Pizero (evidence: `README.md`)
- Board owner → USB-A UF2: chooses for USB-A (evidence: `README.md`)
- Board owner → USB-C UF2: chooses for USB-C (evidence: `README.md`)
- Board owner → USB-CM UF2: chooses for USB-CM (evidence: `README.md`)
- Board owner → Zero UF2: chooses for Zero (evidence: `README.md`)
