summaryrefslogtreecommitdiffstats
path: root/test/bdaddr.8
blob: 78d47945d321d9db4817dbd4c29ffc64bbc4245a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
.TH BDADDR 8 "Sep 27 2005" BlueZ "Linux System Administration"
.SH NAME
bdaddr \- Utility for changing the Bluetooth device address
.SH SYNOPSIS
.B bdaddr
.br
.B bdaddr -h
.br
.B bdaddr [-i <dev>] [-r] [-t] [new bdaddr]

.SH DESCRIPTION
.LP
.B
bdaddr
is used to query or set the local Bluetooth device address (BD_ADDR). If run
with no arguments, 
.B
bdaddr
prints the chip manufacturer's name, and the current BD_ADDR. If the IEEE OUI
index file "oui.txt" is installed on the system, the BD_ADDR owner will be
displayed. If the optional [new bdaddr] argument is given, the device will be
reprogrammed with that address. This can either be permanent or temporary, as
specified by the -t flag. In both cases, the device must be reset before the
new address will become active. This can be done with a 'soft' reset by
specifying the -r flag, or a 'hard' reset by removing and replugging the
device. A 'hard' reset will cause the address to revert to the current
non-volatile value.
.PP
.B
bdaddr
uses manufacturer specific commands to set the address, and is therefore
device specific. For this reason, not all devices are supported, and not all
options are supported on all devices.
Current supported manufacturers are:
.B Ericsson, Cambridge Silicon Radio (CSR), Texas Instruments (TI), Zeevo
and
.B ST Microelectronics (ST)

.SH OPTIONS
.TP
.BI -h
Gives a list of possible commands.
.TP
.BI -i\ <dev>
Specify a particular device to operate on. If not specified, default is the
first available device.
.TP
.BI -r
Reset device and make new BD_ADDR active. 
.B
CSR
devices only.
.TP
.BI -t
Temporary change. Do not write to non-volatile memory.
.B
CSR
devices only.
.SH FILES
.TP
.I
/usr/share/misc/oui.txt
IEEE Organizationally Unique Identifier master file.
Manually update from: http://standards.ieee.org/regauth/oui/oui.txt
.SH AUTHORS
Written by Marcel Holtmann <marcel@holtmann.org>,
man page by Adam Laurie <adam@algroup.co.uk>
.PP