From d577091a3632210b7c5d8a07bc7698097f0042a6 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Tue, 27 Sep 2005 15:19:14 +0000 Subject: Show the OUI and include a manual page for the bdaddr utility --- test/bdaddr.8 | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 test/bdaddr.8 (limited to 'test/bdaddr.8') diff --git a/test/bdaddr.8 b/test/bdaddr.8 new file mode 100644 index 00000000..623a1401 --- /dev/null +++ b/test/bdaddr.8 @@ -0,0 +1,61 @@ +.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 ] [-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) +and +.B Zeevo + +.SH OPTIONS +.TP +.BI -h +Gives a list of possible commands. +.TP +.BI -i\ +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 , +man page by Adam Laurie +.PP -- cgit From 3b01d3c5e0457009c0bdc683d9e8adab29d20fe1 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Mon, 10 Oct 2005 08:22:59 +0000 Subject: Add address change support for Texas Instruments chips --- test/bdaddr.8 | 31 +++++++++++++++++++------------ 1 file changed, 19 insertions(+), 12 deletions(-) (limited to 'test/bdaddr.8') diff --git a/test/bdaddr.8 b/test/bdaddr.8 index 623a1401..dbc2099e 100644 --- a/test/bdaddr.8 +++ b/test/bdaddr.8 @@ -12,23 +12,28 @@ bdaddr \- Utility for changing the Bluetooth device address .LP .B bdaddr -is used to query or set the local Bluetooth device address (BD_ADDR). If run with no arguments, +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. +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 +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) -and +.B Ericsson, Cambridge Silicon Radio (CSR), Texas Instruments (TI) +and .B Zeevo .SH OPTIONS @@ -37,7 +42,8 @@ and Gives a list of possible commands. .TP .BI -i\ -Specify a particular device to operate on. If not specified, default is the first available device. +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. @@ -54,7 +60,8 @@ devices only. .TP .I /usr/share/misc/oui.txt -IEEE Organizationally Unique Identifier master file. Manually update from: http://standards.ieee.org/regauth/oui/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 , man page by Adam Laurie -- cgit From 0625c60f29f27381030c00b188d21773f8a057c4 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Mon, 17 Apr 2006 01:12:27 +0000 Subject: Mention ST based chips --- test/bdaddr.8 | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'test/bdaddr.8') diff --git a/test/bdaddr.8 b/test/bdaddr.8 index dbc2099e..78d47945 100644 --- a/test/bdaddr.8 +++ b/test/bdaddr.8 @@ -32,9 +32,9 @@ 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) +.B Ericsson, Cambridge Silicon Radio (CSR), Texas Instruments (TI), Zeevo and -.B Zeevo +.B ST Microelectronics (ST) .SH OPTIONS .TP -- cgit