PICOTOOL-VERIFY(1)

📦 version 2.2.0-a4, in ubuntu stonking

💖 PICOTOOL-VERIFY(1) 💖

okay so bestie, welcome to picotool-verify, part of the user commands club 🎀 — it's the vibe-check tool for your device, literally.

✨ NAME ✨

picotool-verify — check that the device contents match those in the file 🫶

✨ SYNOPSIS ✨

picotool verify <filename> [-t <type>] [-r <from> <to>] [-o <offset>]
[device-selection]

✨ OPTIONS ✨

📁 The file to compare against

  • <filename> — the file name, periodt 💅

🗺️ Address options

  • -r, --range — compare a sub range of memory only, not the whole thing, iykyk
    • <from> — the lower address bound in hex
    • <to> — the upper address bound in hex
  • -o, --offset — specify the load address when comparing with a BIN file
    • <offset> — load offset (memory address; default 0x10000000)
  • -t <type> — specify file type (uf2 | elf | bin) explicitly, ignoring fileextension 🔥
ngl that "ignoring fileextension" is doing a lot of work — it lowkey means the extension doesn't get a say, the <type> you type is the main character.

🎯 Target device selection

  • --bus <bus> — filter devices by USB bus number
  • --address <addr> — filter devices by USB device address
  • --vid <vid> — filter by vendor id
  • --pid <pid> — filter by product id
  • --ser <ser> — filter by serial number
  • -f, --force — force a device not in BOOTSEL mode but running compatible code toreset so the command can be executed. After executing the command(unless the command itself is a reboot) the device will berebooted back to application mode ✨
  • -F, --force-no-reboot — force a device not in BOOTSEL mode but running compatible code toreset so the command can be executed. After executing the command(unless the command itself is a reboot) the device will be leftconnected and accessible to picotool, but without the USB drivemounted 👑
bestie, pls note the difference: -f reboots it back to application mode, while -F leaves it connected and accessible to picotool but with no USB drive mounted. Choose wisely 🫶

brought to you by picotool 2.2.0-a4+dfsg, December 2025 — slay, iconic, no cap 💖✨🦋

📦 where this page comes from