UBERTOOTH-DFU(1)

💖 UBERTOOTH-DFU — the user-commands era 💖

okay bestie, so this is the manual page for ubertooth-dfu(1), a lil user-commands page from Project Ubertooth, and it's literally the glow-up your Ubertooth's firmware has been waiting for. no cap. let's get into it 🦋

✨ NAME ✨

ubertooth-dfu — Device firmware update for Ubertooth

like. that's it. that's the whole vibe. firmware updates for your Ubertooth, and she serves 💅

🌸 SYNOPSIS 🌸

To update firmware, run:

ubertooth-dfu -d bluetooth_rxtx.dfu -r

that's the whole thing bestie, copy-paste and go 🫶

🎀 DESCRIPTION 🎀

ubertooth-dfu(1) is a utility for updating firmware on Ubertooth. she can also download the currently running firmware from the device. versatile queen.

Running the upload or download command automatically resets the device into the firmware update bootloader. heads up though — the USB ID of the Ubertooth will change in the bootloader, and this may cause problems when attempting to update firmware from inside a VM. so if you're living that VM life, lowkey watch out 😭

In the DFU bootloader, the TX, RX, and USR LEDs will turn on and off in sequence. if this does not occur, you can try to manually force the device to boot into the bootloader. refer to [MANUALLY ENTERING BOOTLOADER][]. yes bestie she has a whole section, keep reading 💜

---

🔥 OPTIONS 🔥

Major modes:

• -d <firmware.dfu> : Download — write DFU file to device 📥
• -u <output.dfu> : Upload — read DFU file from device 📤
• -r : Reset device after performing operation 🔄 (the "and now we're done here" button, so iconic)

Miscellaneous:

• -s <file.bin> : Add DFU suffix to binary firmware file 🎀
• -U <0-7> : Which Ubertooth device to use — yes bestie, pick your girl, 0 through 7 🌈

---

🧚 MANUALLY ENTERING BOOTLOADER 🧚

If the device does not enter the bootloader when running the upload or download commands, it is possible to force the device to boot into that mode when it is inserted. To do so, you will need to jumper two pins on the expansion header. yes, we're doing arts and crafts. it's giving DIY era ✨

The expansion header is a 2x3 pin header between the two largest chips on the board, about halfway between the USB connector and antenna. It is labeled "EXPAND" on the back side of the board. Holding the board so USB is pointed up, on the front side of the board the expansion header looks like this:

         +-------+
       6 + O | O | 3
         +---+---+
       5 + O | O | 2
         +---+---+
       4 + O | X | 1
         +---+---+

PIN #1, marked X, is square. (she's not like the other pins 💅)

With Ubertooth unplugged, use a piece of wire, paperclip, staple, etc to connect pins 1 and 2 together. When it it plugged in, the Ubertooth should enter bootloader mode (LEDs will be turning on and off in sequence). honestly kind of a slay that a staple works here 🍓

⚠️ The bootloader will exit after 5 seconds of no activity and boot into the main firmware. so like… don't sit there staring, bestie. do the thing. 😭

---

🌈 SEE ALSO 🌈

• ubertooth(7): overview of Project Ubertooth — go read it, it's the lore 👑

👑 AUTHOR 👑

This manual page was written by Mike Ryan. ty king 🫶

💜 COPYRIGHT 💜

ubertooth-dfu(1) is Copyright (c) 2010-2017. This tool is released under the GPLv2. Refer to COPYING for further details. (the receipts are in COPYING, fr fr 📜)

---

and that's the whole page bestie!! 💖 this one came straight out of Project Ubertooth, dated March 2017, and it's still serving firmware-update realness to this very day. go flash something. periodt ✨🎀🦋