btstack/port/libusb
2017-11-09 12:07:51 +01:00
..
.gitignore
btstack_config.h
main.c libusb: setup btstack_tlv_posix using bd_addr in path 2017-11-09 12:07:51 +01:00
Makefile libusb: setup btstack_tlv_posix using bd_addr in path 2017-11-09 12:07:51 +01:00
README.md libusb: add README.md, explain linux udev rules 2017-11-09 11:40:58 +01:00

BTstack Port for POSIX Systems with libusb library

The quickest way to try BTstack is on a Linux or OS X system with an additional USB Bluetooth dongle. It requires pkg-config and libusb-1.0 or higher to be installed.

On Linux, the USB Bluetooth donle is usually not accessible to a regular user. You can:

  • run the examples as root
  • add a udev rule for your dongle to extend access rights to user processes

To add an udev rule, please create /etc/udev/rules.d/btstack.rules and add this

# Match all devices from CSR
SUBSYSTEM=="usb", ATTRS{idVendor}=="0a12", MODE="0666"

# Match DeLOCK Bluetooth 4.0 dongle
SUBSYSTEM=="usb", ATTRS{idVendor}=="0a5c", ATTRS{device}=="21e8", MODE="0666"

# Match Asus BT400
SUBSYSTEM=="usb", ATTRS{idVendor}=="0b05", ATTRS{device}=="17cb", MODE="0666"

On OS X, its necessary to tell the OS to only use the internal Bluetooth. For this, execute:

sudo nvram bluetoothHostControllerSwitchBehavior=never

You may need to reboot for the change to become active.