mirror of
https://github.com/bluekitchen/btstack.git
synced 2025-01-08 12:50:52 +00:00
90 lines
3.0 KiB
Markdown
90 lines
3.0 KiB
Markdown
# BTstack Port for POSIX Systems with libusb Library
|
|
|
|
## Compilation
|
|
The quickest way to try BTstack is on a Linux or OS X system with an
|
|
additional USB Bluetooth dongle. It requires
|
|
[pkg-config](http://www.freedesktop.org/wiki/Software/pkg-config/)
|
|
and [libusb-1.0](http://libusb.info) or higher to be
|
|
installed.
|
|
|
|
On a recent Debian-based system, all you need is:
|
|
|
|
apt-get install gcc git libusb-1.0 pkg-config
|
|
|
|
|
|
When everything is ready, you compile all examples with:
|
|
|
|
make
|
|
|
|
## Environment Setup
|
|
|
|
### Linux
|
|
|
|
On Linux, the USB Bluetooth dongle is usually not accessible to a regular user. You can either:
|
|
- 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 Cypress Semiconductor / Broadcom BCM20702A, e.g. DeLOCK Bluetooth 4.0 dongle
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="0a5c", ATTRS{idProduct}=="21e8", MODE="0666"
|
|
|
|
# Match Asus BT400
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="0b05", ATTRS{idProduct}=="17cb", MODE="0666"
|
|
|
|
# Match Laird BT860 / Cypress Semiconductor CYW20704A2
|
|
SUBSYSTEM=="usb", ATTRS{idVendor}=="04b4", ATTRS{idProduct}=="f901", MODE="0666"
|
|
|
|
### macOS
|
|
|
|
On macOS, the OS will try to use a plugged-in Bluetooth Controller if one is available.
|
|
It's best to to tell the OS to always use the internal Bluetooth Contoller.
|
|
|
|
For this, execute:
|
|
|
|
sudo nvram bluetoothHostControllerSwitchBehavior=never
|
|
|
|
and then reboot to activate the change.
|
|
|
|
Note: if you get this error,
|
|
|
|
libusb: warning [darwin_open] USBDeviceOpen: another process has device opened for exclusive access
|
|
libusb: error [darwin_reset_device] ResetDevice: device not opened for exclusive access
|
|
|
|
and you didn't start another instance and you didn't assign the USB Controller to a virtual machine,
|
|
macOS uses the plugged-in Bluetooth Controller. Please configure NVRAM as explained and try again after a reboot.
|
|
|
|
|
|
## Running the examples
|
|
|
|
BTstack's HCI USB transport will try to find a suitable Bluetooth module and use it.
|
|
|
|
On start, BTstack will try to find a suitable Bluetooth module. It will also print the path to the packet log as well as the USB path.
|
|
|
|
$ ./le_counter
|
|
Packet Log: /tmp/hci_dump.pklg
|
|
BTstack counter 0001
|
|
USB Path: 06
|
|
BTstack up and running on 00:1A:7D:DA:71:13.
|
|
|
|
If you want to run multiple examples at the same time, it helps to fix the path to the used Bluetooth module by passing -u usb-path to the executable.
|
|
|
|
Example running le_streamer and le_streamer_client in two processes, using Bluetooth dongles at USB path 6 and 4:
|
|
|
|
./le_streamer -u 6
|
|
Specified USB Path: 06
|
|
Packet Log: /tmp/hci_dump_6.pklg
|
|
USB Path: 06
|
|
BTstack up and running on 00:1A:7D:DA:71:13.
|
|
To start the streaming, please run the le_streamer_client example on other device, or use some GATT Explorer, e.g. LightBlue, BLExplr.
|
|
|
|
$ ./le_streamer_client -u 4
|
|
Specified USB Path: 04
|
|
Packet Log: /tmp/hci_dump_4.pklg
|
|
USB Path: 04
|
|
BTstack up and running on 00:1A:7D:DA:71:13.
|
|
Start scanning!
|