ubertooth-util(1)

1UBERTOOTH-UTIL(1)                User Commands               UBERTOOTH-UTIL(1)
2
3
4

NAME

6       ubertooth-util(1) - general purpose Ubertooth utility
7

SYNOPSIS

9       ubertooth-util [-abcdefghijk-ellemenop-qrstuvwxyZ]
10

DESCRIPTION

12       ubertooth-util(1) is a catch-all tool for doing generally useful things
13       with, to, and about Ubertooth. To get  firmware  revision  and  compile
14       information, run:
15
16              ubertooth-util -vV
17
18       To fully reset Ubertooth, run:
19
20              ubertooth-util -r
21
22       Other  options are available for modifying LED states, setting channel,
23       and  performing  miscellaneous  radio-related  actions.  Refer  to  the
24       [OPTIONS][] section for full details.
25
26       The  utility  also  includes  a simple range test tool for use with two
27       Uberteeth. Refer to [RANGE TEST][] for full details.
28

OPTIONS

30       Common options:
31
32              · -v : get firmware revision number
33
34              · -V : get compile info
35
36              · -I : identify ubertooth device by flashing all LEDs
37
38              · -d[0-1] : get/set all LEDs
39
40              · -l[0-1] : get/set USR LED
41
42              · -S : stop current operation
43
44              · -r : full reset
45
46              · -U<0-7> : set ubertooth device to use
47
48       Radio options:
49
50              · -a[0-7] : get/set power amplifier level
51
52              · -c[2400-2483] : get/set channel in MHz
53
54              · -C[0-78] : get/set channel
55
56              · -q[1-225 (RSSI threshold)] : start LED spectrum analyzer
57
58              · -t : intitiate continuous transmit test
59
60              · -z : set squelch level
61
62       Range test:
63
64              · -e : start repeater mode
65
66              · -m : display range test result
67
68              · -n : initiate range test
69
70       Miscellaneous:
71
72              · -f : activate flash programming (DFU) mode
73
74              · -i : activate In-System Programming (ISP) mode
75
76              · -b : get hardware board id number
77
78              · -p : get microcontroller Part ID
79
80              · -s : get microcontroller serial number
81

RANGE TEST

83       Using two Uberteeth it is possible to perform a range test.  One  Uber‐
84       tooth acts as a repeated by running:
85
86              ubertooth-util -e
87
88       A second Ubertooth (the sender) initiates the range test by running:
89
90              ubertooth-util -n
91
92       During  the  range test the sender Ubertooth will transmit data packets
93       at increasing power level, listening  for  repeats  from  the  repeater
94       Ubertooth. The receiving Ubertooth will validate that the received data
95       was not corrupted in flight.
96
97       The range test results can be displayed on the sender Ubertooth's  sys‐
98       tem by running:
99
100              ubertooth-util -m
101
102       Note  that  the  range  test  transmits the Cortex M3 microcontroller's
103       serial number. If you do not wish to broadcast that  information  wire‐
104       lessly, do not use the range test functionality.
105

AUTHOR

110       This manual page was written by Mike Ryan.
111

COPYRIGHT

113       ubertooth-util(1)  is  Copyright  (c)  2010-2017. This tool is released
114       under the GPLv2. Refer to COPYING for further details.
115
116
117
118Project Ubertooth                 March 2017                 UBERTOOTH-UTIL(1)