feat(deploy): add stock RP2040 UF2 deployment

[zackees]

Summary

• generate RP2040/RP2350 UF2 from firmware.bin and deploy through stock RPI-RP2 mass storage
• support 1200-baud BOOTSEL entry, marker-volume discovery, ambiguity rejection, and post-flash CDC handoff
• allow no-pre-port deployment and emit FBUILD_DEPLOY_PORT for AutoResearch

Validation

• soldr cargo test -p fbuild-deploy rp2040 --lib (5 passed)
• soldr cargo check -p fbuild-daemon (passed)
• soldr cargo fmt --check

Related: #1040, FastLED/FastLED#3626

Summary by CodeRabbit

• New Features

  • Added firmware deployment support for Raspberry Pi RP2040/RP2350 boards.
  • Firmware can now be transferred through the board’s BOOTSEL drive using UF2 format.
  • Added automatic BOOTSEL detection and post-deployment serial reconnection.
  • Deployment responses now report the port used for recovery and monitoring.

• Bug Fixes

  • Improved serial recovery when no deployment port is selected in advance.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 631102e9-e462-4910-9388-67c29704f38d

📥 Commits

Reviewing files that changed from the base of the PR and between 4ac1ae9 and 884ea8b.

📒 Files selected for processing (3)

• crates/fbuild-daemon/src/handlers/operations/deploy.rs
• crates/fbuild-deploy/src/lib.rs
• crates/fbuild-deploy/src/rp2040.rs

---

📝 Walkthrough

Walkthrough

Adds RP2040/RP2350 UF2 deployment, BOOTSEL volume discovery, serial port recovery, Raspberry Pi deployer dispatch, and deploy responses containing the recovered port.

Changes

RP2040 deployment

Layer / File(s)	Summary
UF2 encoding and BOOTSEL discovery crates/fbuild-deploy/src/rp2040.rs	Adds UF2 generation, BOOTSEL volume scanning, serial 1200-baud triggering, UF2 writing, and unit tests.
RP2040 deployer execution crates/fbuild-deploy/src/rp2040.rs	Implements board-specific family selection, deployment orchestration, CDC port detection, and post-deploy recovery.
Daemon dispatch and deploy response crates/fbuild-deploy/src/lib.rs, crates/fbuild-daemon/src/handlers/operations/deploy.rs	Exports the RP2040 module, dispatches Raspberry Pi targets, derives recovery ports, and reports FBUILD_DEPLOY_PORT.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant DeployHandler
  participant Rp2040Deployer
  participant SerialPort
  participant BootselVolume
  DeployHandler->>Rp2040Deployer: select RaspberryPi deployer
  Rp2040Deployer->>SerialPort: trigger BOOTSEL with 1200-baud touch
  Rp2040Deployer->>BootselVolume: discover marker volume
  Rp2040Deployer->>BootselVolume: write firmware.uf2
  Rp2040Deployer->>SerialPort: wait for CDC port recovery
  Rp2040Deployer-->>DeployHandler: return deployment result and port

Loading

Possibly related issues

• feat(rp2040): zero-touch deployment to an as-received Pico via ROM UF2 #1040 — Adds the Raspberry Pi zero-touch UF2 deployment and port-recovery workflow described by the issue.
• feat(autoresearch/rp2040): support first deployment with no pre-existing COM port FastLED#3627 — Adds RP2040 deployment without a preselected serial port and returns the post-deploy CDC port.
• meta(rp2040): Pico 1 AutoResearch bring-up (superseded by #3648) FastLED#3626 — Implements stock USB/UF2 deployment and post-deploy port recovery for RP2040 boards.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/rp2040-uf2-deploy

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}