mirror of
https://github.com/bluekitchen/btstack.git
synced 2025-03-25 16:43:28 +00:00
45 lines
1.5 KiB
Markdown
45 lines
1.5 KiB
Markdown
|
# BTstack Port for FreeBSD Systems
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
This port assumes that FreeBSD provides an ng_hci netgraph node for a connected Bluetooth Controller.
|
||
|
|
In most cases, these are Bluetooth USB dongles or built-in Bluetooth Controller connected via USB.
|
||
|
|
|
||
|
|
For Bluetooth Controllers connected via UART, the POSX-H4 port might be a better option als
|
||
|
|
|
||
|
|
## Implementation details
|
||
|
|
In FreeBSD 13.2, the hci node is connected to a l2cap node and a btsock_hci_raw node. In order to take control, this
|
||
|
|
port create a custom netgraph ng_socket node and connect to the 'acl' and 'raw' hooks of the hci node. The OS Bluetooth
|
||
|
|
functionality will be interrupted.
|
||
|
|
|
||
|
|
## Compilation
|
||
|
|
|
||
|
|
BTstack's FeeeBSD port does not have additional dependencies. To compile the cmake project with make
|
||
|
|
|
||
|
|
mkdir build
|
||
|
|
cd build
|
||
|
|
cmake ..
|
||
|
|
make
|
||
|
|
|
||
|
|
or using Ninja:
|
||
|
|
|
||
|
|
mkdir ninja
|
||
|
|
cd ninja
|
||
|
|
cmake ..
|
||
|
|
ninja
|
||
|
|
|
||
|
|
## Running the examples
|
||
|
|
|
||
|
|
As the port needs to reconfigure the Bluetooth netgraph node, it needs to run with root privileges.
|
||
|
|
It tries to connect to 'ubt0hci' by default. If your Bluetooth Controller is different, you can select it with '-u node'
|
||
|
|
On start, BTstack prints the path to the packet log and prints the information on the detected Buetooth Controller.
|
||
|
|
|
||
|
|
$ sudo gatt_counter
|
||
|
|
Packet Log: /tmp/hci_dump.pklg
|
||
|
|
BTstack counter 0001
|
||
|
|
BTstack up and running on 00:1A:7D:DA:71:13.
|
||
|
|
|
||
|
|
## ToDO
|
||
|
|
- drop privileges after startup
|
||
|
|
- auto-detect ng_hci node
|
||
|
|
- support for profiles that require SCO: HFP & HSP
|