UBERTOOTH-UTIL(1)

💖 UBERTOOTH-UTIL 💖

okay so you opened the User Commands manual and found ubertooth-util — literally the main character of the Ubertooth command-line world. Buckle up bestie, we're doing this. 🦋✨

---

🎀 NAME 🎀

ubertooth-util — the general purpose Ubertooth utility. yes that's it, that's the whole vibe. it does a little bit of everything, no cap.

---

🌸 SYNOPSIS 🌸

ubertooth-util [-abcdefghijk-ellemenop-qrstuvwxyZ]

look at that flag soup. she contains multitudes. 💅

---

✨ DESCRIPTION ✨

so ubertooth-util(1) is the catch-all tool for doing generally useful things with, to, and about Ubertooth. with, to, AND about. she's versatile like that.

wanna know your firmware revision and your compile info? run:

ubertooth-util -vV

and when your Ubertooth is acting up and you just need a clean slate, a full factory-reset moment:

ubertooth-util -r

and there's more. there are other options for modifying LED states, setting the channel, and doing miscellaneous radio-related actions. the full tea is in the OPTIONS section below, go read it, i'll wait. 🫶

oh and p.s. — this utility also ships with a simple range test tool for when you have two Uberteeth and want to see how far the love travels. that whole saga lives in RANGE TEST. 🧚

---

👑 OPTIONS 👑

💫 Common options

• -v — get the firmware revision number
• -V — get the compile info
• -I — identify which ubertooth device is which by flashing all of its LEDs. it's giving identity crisis but make it cute
• -d[0-1] — get/set all LEDs
• -l[0-1] — get/set the USR LED specifically
• -S — stop whatever operation is currently running. sit. stay. 🛑
• -r — full reset
• -U<0-7> — pick which ubertooth device to use

📡 Radio options

• -a[0-7] — get/set the power amplifier level
• -c[2400-2483] — get/set the channel, in MHz
• -C[0-78] — get/set the channel (the non-MHz way)
• -q[1-225 (RSSI threshold)] — start the LED spectrum analyzer
• -t — initiate continuous transmit test
• -z — set the squelch level

🏃♀️ Range test

• -e — start repeater mode
• -m — display the range test result
• -n — initiate the range test

🌈 Miscellaneous

• -f — activate flash programming (DFU) mode
• -i — activate In-System Programming (ISP) mode
• -b — get the hardware board id number
• -p — get the microcontroller Part ID
• -s — get the microcontroller serial number

---

🦋 RANGE TEST 🦋

okay this is the part that's lowkey the coolest. if you've got two Uberteeth, you can do a whole range test. it's a two-device situation and both of them have jobs.

device one is the repeater. she repeats. run:

ubertooth-util -e

device two is the sender, and she kicks off the actual test by running:

ubertooth-util -n

now here's what goes down during the test: the sender Ubertooth will transmit data packets at increasing power level, listening the whole time for repeats coming back from the repeater Ubertooth. meanwhile the receiving Ubertooth validates that the data it got back was not corrupted in flight. teamwork, baby. 🤝

wanna see the results? you display them on the sender Ubertooth's system by running:

ubertooth-util -m

⚠️ heads up bestie, this one matters: the range test transmits the Cortex M3 microcontroller's serial number. like, over the air. if you do not want to broadcast that information wirelessly, then do not use the range test functionality. periodt. 🛑

---

🌟 SEE ALSO 🌟

ubertooth(7): overview of Project Ubertooth — go read that one too, iykyk.

---

💜 AUTHOR 💜

this manual page was written by Mike Ryan. thank you for your service legend. 🫡

---

📜 COPYRIGHT 📜

ubertooth-util(1) is Copyright (c) 2010-2017. this tool is released under the GPLv2. refer to COPYING for further details.

---

okay and that's the whole page!! 💖 this beauty is a Project Ubertooth joint from March 2017, and now you know everything she does. go flash some LEDs and be iconic. mwah. 💅✨🎀