PICOTOOL-UF2-CONVERT(1)

📦 version 2.2.0-a4, in ubuntu stonking

💖 PICOTOOL-UF2-CONVERT 💖

okay bestie, welcome to the picotool-uf2-convert(1) page — it's a User Command, it lives in the picotool manual, and it's literally the thing that turns your ELF/BIN into a UF2. yes. that's the whole vibe. 🦋

✨ NAME ✨

picotool-uf2-convert — Convert ELF/BIN to UF2. no cap, that's it. 🎀

🌸 SYNOPSIS 🌸

picotool uf2 convert [--quiet] [--verbose] <infile> [-t <type>]
<outfile> [-t <type>] [-o <offset>] [--family <family_id>] [--platform
<platform>] [[--abs-block] [<abs_block_loc>]]

look at her. she's gorgeous. take a sec. 💅

👑 OPTIONS 👑

🫶 the general ones

  • --quiet — don't print any output. silent treatment, but make it functional. 🤫
  • --verbose — print verbose output. give me ALL the details, I wanna know everything. 🗣️

🍓 File to load from

  • <infile> — the file name. the thing you're reading from. your source material, your origin story. ✨
  • -t <type> — specify file type (uf2 | elf | bin) explicitly, ignoring the file extension. like, the extension is a suggestion, bestie, and we're overriding it. 😌

💜 File to save UF2 to

  • <outfile> — the file name. where the UF2 goes. your little creation. 🎀
  • -t <type> — specify file type (uf2) explicitly, ignoring file extension. yes it's the same flag letter, it's living its double life, we respect it. 💅

🌈 Packaging Options

  • -o, --offset — specify the load address.
  • <offset> — load offset (memory address; default 0x10000000 for BIN file). remember that number, it matters. ⭐

🧚 UF2 Family options

  • <family_id> — family ID for UF2. it's giving "who's your family". 🦋

🔥 Platform options

  • <platform> — optional platform for memory verification (eg rp2040, rp2350). optional but iconic.

😭 Errata RP2350-E10 Fix

  • --abs-block — add an absolute block. yes, this is the fix, this is the moment, RP2350-E10 has been served. 🙈
  • <abs_block_loc> — absolute block location (default to 0x10ffff00). that's the default, fr fr, don't come for me. 💀
okay so: --quiet and --verbose are mutually vibes-y, and if you don't pass --offset for a BIN file it just assumes 0x10000000 for you. you're welcome. 🫶

that's the whole page, bestie, you ate it. this was picotool version 2.2.0-a4+dfsg, dated December 2025 — mwah, periodt. 💖✨🌸

📦 where this page comes from