Firmware firmware/v0.6.0

Firmware changes since v0.5.0

• stallguard: wire DIAG stall detection -> blocking incident (WIP, untested) (f1f20f3)

Firmware files

Flash the .uf2 for your board revision and role. Hold BOOTSEL while plugging in the Pico, then drag the file onto the RPI-RP2 drive.

basically v1-1 — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-v1-1 → the board controlling the feeder stages
• distribution-v1-1 → the board controlling the chute and bin tower

basically v1-2 — has 5 total steppers. Only one firmware needed:

• distribution-v1-2 → handles everything on the v1-2 board

SKR Pico — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-skr → the board controlling the feeder stages
• distribution-skr → the board controlling the chute and bin tower

File	Board	Role
basically-v1-1-feeder-*.uf2	basically v1-1	Feeder MB
basically-v1-1-distribution-*.uf2	basically v1-1	Distribution MB
basically-v1-2-distribution-*.uf2	basically v1-2	Distribution MB (all-in-one)
feeder-skr-*.uf2	SKR Pico	Feeder MB
distribution-skr-*.uf2	SKR Pico	Distribution MB

SorterOS v3.4.7

sorteros/v3.4.7

sorteros: bake in Rockchip HW-decode stack + PyGObject for the image …

SorterOS v3.4.6

sorteros: clone main + sync with Python 3.12 on firstboot (#151)

The 3.4.5 image cloned the stale sorteros-v3 branch (missing the
-dev systemd units, so install-services failed) and ran uv sync
against Python 3.13, which the backend rejects (requires >=3.12,<3.13).
Point firstboot at main and sync with 3.12; bump image to 3.4.6.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Firmware firmware/v0.5.0

Firmware files

Flash the .uf2 for your board revision and role. Hold BOOTSEL while plugging in the Pico, then drag the file onto the RPI-RP2 drive.

basically v1-1 — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-v1-1 → the board controlling the feeder stages
• distribution-v1-1 → the board controlling the chute and bin tower

basically v1-2 — has 5 total steppers. Only one firmware needed:

• distribution-v1-2 → handles everything on the v1-2 board

SKR Pico — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-skr → the board controlling the feeder stages
• distribution-skr → the board controlling the chute and bin tower

File	Board	Role
basically-v1-1-feeder-*.uf2	basically v1-1	Feeder MB
basically-v1-1-distribution-*.uf2	basically v1-1	Distribution MB
basically-v1-2-distribution-*.uf2	basically v1-2	Distribution MB (all-in-one)
feeder-skr-*.uf2	SKR Pico	Feeder MB
distribution-skr-*.uf2	SKR Pico	Distribution MB

What's Changed

• Use full git clone in SorterOS firstboot by @spencerhhubert in #145
• Bump SorterOS to v3.4.5 by @spencerhhubert in #146
• flash.py: handle RPI-RP2 block device not yet mounted on Linux by @spencerhhubert in #147
• hive: resilient, resumable catalog sync with admin dashboard by @spencerhhubert in #148
• settings: Tailscale network management + compact color picker by @spencerhhubert in #149
• sorteros: clone main + sync with Python 3.12 on firstboot by @spencerhhubert in #151
• sorteros: bake in Rockchip HW-decode stack + PyGObject by @spencerhhubert in #152
• Reach the UI by IP or Tailscale name, and join Tailscale from settings by @spencerhhubert in #153
• backend: default to classification channel setup, go-to-angle feeder, and simple_state_machine_rev01 by @spencerhhubert in #154
• StallGuard telemetry (not real sg yet), firmware improvements, TMC2209 UART init fix (2x uart still not working) by @spencerhhubert in #150

Full Changelog: firmware/v0.4.0...firmware/v0.5.0

SorterOS v3.4.5

SorterOS v3.4.5

Asset: sorteros-v3.4.5-2026-05-29.zip
SHA-256: 3bb65dbc708f5e7c12c413ece0c52ce69922df0368a39104b69fa3e9af443f71

Firmware firmware/v0.4.0

Firmware files

Flash the .uf2 for your board revision and role. Hold BOOTSEL while plugging in the Pico, then drag the file onto the RPI-RP2 drive.

basically v1-1 — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-v1-1 → the board controlling the feeder stages
• distribution-v1-1 → the board controlling the chute and bin tower

basically v1-2 — has 5 total steppers. Only one firmware needed:

• distribution-v1-2 → handles everything on the v1-2 board

SKR Pico — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-skr → the board controlling the feeder stages
• distribution-skr → the board controlling the chute and bin tower

File	Board	Role
basically-v1-1-feeder-*.uf2	basically v1-1	Feeder MB
basically-v1-1-distribution-*.uf2	basically v1-1	Distribution MB
basically-v1-2-distribution-*.uf2	basically v1-2	Distribution MB (all-in-one)
feeder-skr-*.uf2	SKR Pico	Feeder MB
distribution-skr-*.uf2	SKR Pico	Distribution MB

What's Changed

• docs: update SorterOS installation — GitHub Releases and sorter.local URL by @spencerhhubert in #134
• fix some potentially bad parsing if file is bad or nonexistent by @spencerhhubert in #135
• Hive teacher backfill, Perceptron integration, sorter incident hardening, model publish polish by @mneuhaus in #136
• Orange Pi bringup: fix firstboot/dev-service setup, make multi-host access work, and cut camera pipeline CPU load, RKNN tooling by @spencerhhubert in #137
• Orange Pi bringup — chute stress test, servo setup fixes, debug tooling by @spencerhhubert in #139
• Spencer/rev01 simple states for classification channel 01 by @spencerhhubert in #140
• mechanical/README: add OnShape CAD links and access info by @spencerhhubert in #141
• Remove ch3 per-detection dev-log from analyzeFeederChannels by @spencerhhubert in #142
• Rev04 perception + simple-state classification channel path by @spencerhhubert in #144
• Spencer/simple state cc improvements by @spencerhhubert in #143

Full Changelog: sorteros/v3.4.4...firmware/v0.4.0

SorterOS v3.4.4

SorterOS v3.4.4

Firmware firmware/v0.3.0

Firmware files

Flash the .uf2 for your board revision and role. Hold BOOTSEL while plugging in the Pico, then drag the file onto the RPI-RP2 drive.

basically v1-1 — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-v1-1 → the board controlling the feeder stages
• distribution-v1-1 → the board controlling the chute and bin tower

basically v1-2 — has 5 total steppers. Only one firmware needed:

• distribution-v1-2 → handles everything on the v1-2 board

SKR Pico — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-skr → the board controlling the feeder stages
• distribution-skr → the board controlling the chute and bin tower

File	Board	Role
basically-v1-1-feeder-*.uf2	basically v1-1	Feeder MB
basically-v1-1-distribution-*.uf2	basically v1-1	Distribution MB
basically-v1-2-distribution-*.uf2	basically v1-2	Distribution MB (all-in-one)
feeder-skr-*.uf2	SKR Pico	Feeder MB
distribution-skr-*.uf2	SKR Pico	Distribution MB

Full Changelog: firmware/v0.2.0...firmware/v0.3.0

Firmware firmware/v0.2.0

Firmware files

Flash the .uf2 for your board revision and role. Hold BOOTSEL while plugging in the Pico, then drag the file onto the RPI-RP2 drive.

basically v1-1 — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-v1-1 → the board controlling the feeder stages
• distribution-v1-1 → the board controlling the chute and bin tower

basically v1-2 — has 5 total steppers. Only one firmware needed:

• distribution-v1-2 → handles everything on the v1-2 board

SKR Pico — labeled either "Feeder" or "Distribution" on the board. Download both:

• feeder-skr → the board controlling the feeder stages
• distribution-skr → the board controlling the chute and bin tower

File	Board	Role
feeder-v1-1_*.uf2	basically v1-1	Feeder MB
distribution-v1-1_*.uf2	basically v1-1	Distribution MB
distribution-v1-2_*.uf2	basically v1-2	Distribution MB (all-in-one)
feeder-skr_*.uf2	SKR Pico	Feeder MB
distribution-skr_*.uf2	SKR Pico	Distribution MB

Full Changelog: firmware/v0.1.0...firmware/v0.2.0

Firmware firmware/v0.1.0

Firmware build for tag firmware/v0.1.0.

File	Board	Role
feeder-v1-1_*.uf2	Basically v1-1	Feeder
distribution-v1-1_*.uf2	Basically v1-1	Distribution
feeder-v1-2_*.uf2	Basically v1-2	Feeder
distribution-v1-2_*.uf2	Basically v1-2	Distribution