UBERTOOTH-AFH(1)

πŸ“¦
version 2020.12.R1 Β· 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– UBERTOOTH-AFH πŸ’– (section 1 of the manual, bestie)

okay so you found the weird little tool that sniffs out Bluetooth hopping patterns?? slay. this is ubertooth-afh, a User Command, and she is lowkey a detective. let's get into it πŸ•΅οΈβ™€οΈβœ¨

🌸 NAME 🌸

ubertooth-afh β€” passive detection of AFH channel map

yes, passive β€” she's just vibing and watching, not touching anything. respectful king energy.

πŸ¦‹ SYNOPSIS πŸ¦‹

ubertooth-afh -u <uap> -l <lap> [-r] [-m <seconds>]

that's it, that's the whole vibe. give her a UAP and a LAP and she goes. πŸ’…

✨ DESCRIPTION ✨

okay so classic Bluetooth piconets? they commonly make use of Adaptive Frequency Hopping (AFH) to avoid interference with other signals in 2.4 GHz. basically they hop around the spectrum so they don't step on anybody's toes πŸ¦ΆπŸŽ€ and this tool attempts to determine the AFH map being used for a given piconet, which is identified by its UAP and LAP.

at a minimum you must provide UAP and LAP. no UAP, no LAP, no map, periodt. 🚫

where do you even get those?? go read ubertooth-rx(1) β€” that's the tool for sniffing them over the air, and it also has the details on where else to find them. iykyk πŸ“‘

by default the tool will only print the AFH map when it is updated. like, only when something actually changes, she stays quiet. but if you pass the -r flag, the AFH map gets printed out in binary form once per second. constant updates, main character behavior, no chill. πŸ”₯

πŸ‘‘ OPTIONS πŸ‘‘

the essentials, bestie:

  • -l <LAP> β€” LAP of target piconet (3 bytes / 6 hex digits)
  • -u <UAP> β€” UAP of target piconet (1 byte / 2 hex digits)
  • -m <int> β€” threshold for channel removal (default: 5)
  • -r β€” print AFH channel map once every second (default: print on update)

🌈 Other options 🌈

the bonus round, the little extras, the garnish πŸ“:

  • -t <seconds> β€” timeout for initial AFH map detection (not required, she's just being patient with you)
  • -e <0-4> β€” maximum access code errors (default: 2, range: 0-4)
  • -V β€” print version information
  • -U <0-7> β€” set ubertooth device to use
heads up bestie: -e only goes from 0 to 4. don't try to be cute with 5. πŸ™ˆ

πŸ” SEE ALSO πŸ”

  • ubertooth-rx(1): a tool for finding UAP and LAP β€” go here first if you're lost, she's the plug πŸ’œ
  • ubertooth(7): overview of Project Ubertooth β€” the whole lore, the extended universe 🧚

🫢 AUTHOR 🫢

This manual page was written by Mike Ryan. thank you mike, king, legend, icon πŸ‘‘

ubertooth-afh(1) is Copyright (c) 2015-2017. This tool is released under the GPLv2. Refer to COPYING for further details.


okay and that's the whole page!!

mwah πŸ’‹ this was Project Ubertooth, March 2017 β€” go forth and map those channels, bestie. you're literally gonna ate. πŸ’…βœ¨πŸ¦‹