bdaddr.rst 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. ======
  2. bdaddr
  3. ======
  4. -------------------------------------------------
  5. Utility for changing the Bluetooth device address
  6. -------------------------------------------------
  7. :Authors: - Marcel Holtmann <marcel@holtmann.org>
  8. - Adam Laurie <adam@algroup.co.uk>
  9. :Version: BlueZ
  10. :Copyright: Free use of this software is granted under ther terms of the GNU
  11. Lesser General Public Licenses (LGPL).
  12. :Date: Sep 27, 2005
  13. :Manual section: 1
  14. :Manual group: Linux System Administration
  15. SYNOPSIS
  16. ========
  17. **bdaddr**
  18. **bdaddr** -h
  19. **bdaddr** [-i <*dev*>] [-r] [-t] [*new_bdaddr*]
  20. DESCRIPTION
  21. ===========
  22. **bdaddr(1)** is used to query or set the local Bluetooth device address
  23. (BD_ADDR). If run with no arguments, **bdaddr** prints the chip manufacturer's
  24. name, and the current BD_ADDR. If the IEEE OUI index file "oui.txt" is
  25. installed on the system, the BD_ADDR owner will be displayed. If the optional
  26. [*new_bdaddr*] argument is given, the device will be reprogrammed with that
  27. address. This can either be permanent or temporary, as specified by the -t
  28. flag. In both cases, the device must be reset before the new address will
  29. become active. This can be done with a 'soft' reset by specifying the -r
  30. flag, or a 'hard' reset by removing and replugging the device. A 'hard' reset
  31. will cause the address to revert to the current non-volatile value.
  32. **bdaddr** uses manufacturer specific commands to set the address, and is
  33. therefore device specific. For this reason, not all devices are supported,
  34. and not all options are supported on all devices. Current supported
  35. manufacturers are: **Ericsson**, **Cambridge Silicon Radio (CSR)**,
  36. **Texas Instruments (TI)**, **Zeevo** and **ST Microelectronics (ST)**.
  37. OPTIONS
  38. =======
  39. -h Gives a list of possible commands.
  40. -i <dev> Specify a particular device to operate on. If not specified,
  41. default is the first available device.
  42. -r Reset device and make new BD_ADDR active. CSR devices only.
  43. -t Temporary change. Do not write to non-volatile memory.
  44. CSR devices only.
  45. FILES
  46. =====
  47. /usr/share/misc/oui.txt
  48. IEEE Organizationally Unique Identifier consolidated file.
  49. Manually update from: http://standards.ieee.org/regauth/oui/oui.txt
  50. RESOURCES
  51. =========
  52. http://www.bluez.org
  53. REPORTING BUGS
  54. ==============
  55. linux-bluetooth@vger.kernel.org