test/bdaddr.8

   1 .TH BDADDR 8 "Sep 27 2005" BlueZ "Linux System Administration"
   2 .SH NAME
   3 bdaddr \- Utility for changing the Bluetooth device address
   4 .SH SYNOPSIS
   5 .B bdaddr
   6 .br
   7 .B bdaddr -h
   8 .br
   9 .B bdaddr [-i <dev>] [-r] [-t] [new bdaddr]
  10
  11 .SH DESCRIPTION
  12 .LP
  13 .B
  14 bdaddr
  15 is used to query or set the local Bluetooth device address (BD_ADDR). If run
  16 with no arguments,
  17 .B
  18 bdaddr
  19 prints the chip manufacturer's name, and the current BD_ADDR. If the IEEE OUI
  20 index file "oui.txt" is installed on the system, the BD_ADDR owner will be
  21 displayed. If the optional [new bdaddr] argument is given, the device will be
  22 reprogrammed with that address. This can either be permanent or temporary, as
  23 specified by the -t flag. In both cases, the device must be reset before the
  24 new address will become active. This can be done with a 'soft' reset by
  25 specifying the -r flag, or a 'hard' reset by removing and replugging the
  26 device. A 'hard' reset will cause the address to revert to the current
  27 non-volatile value.
  28 .PP
  29 .B
  30 bdaddr
  31 uses manufacturer specific commands to set the address, and is therefore
  32 device specific. For this reason, not all devices are supported, and not all
  33 options are supported on all devices.
  34 Current supported manufacturers are:
  35 .B Ericsson, Cambridge Silicon Radio (CSR), Texas Instruments (TI), Zeevo
  36 and
  37 .B ST Microelectronics (ST)
  38
  39 .SH OPTIONS
  40 .TP
  41 .BI -h
  42 Gives a list of possible commands.
  43 .TP
  44 .BI -i\ <dev>
  45 Specify a particular device to operate on. If not specified, default is the
  46 first available device.
  47 .TP
  48 .BI -r
  49 Reset device and make new BD_ADDR active.
  50 .B
  51 CSR
  52 devices only.
  53 .TP
  54 .BI -t
  55 Temporary change. Do not write to non-volatile memory.
  56 .B
  57 CSR
  58 devices only.
  59 .SH FILES
  60 .TP
  61 .I
  62 /usr/share/misc/oui.txt
  63 IEEE Organizationally Unique Identifier master file.
  64 Manually update from: http://standards.ieee.org/regauth/oui/oui.txt
  65 .SH AUTHORS
  66 Written by Marcel Holtmann <marcel@holtmann.org>,
  67 man page by Adam Laurie <adam@algroup.co.uk>
  68 .PP