2023-11-07 08:57:44 +00:00
|
|
|
# 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
|
|
|
|
|
|
2024-07-01 14:21:33 +00:00
|
|
|
BTstack's FeeeBSD port does not have additional dependencies. To compile the cmake project with Make
|
2023-11-07 08:57:44 +00:00
|
|
|
|
|
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
cmake ..
|
|
|
|
|
make
|
|
|
|
|
|
|
|
|
|
or using Ninja:
|
|
|
|
|
|
2024-07-01 14:21:33 +00:00
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
cmake -G Ninja ..
|
2023-11-07 08:57:44 +00:00
|
|
|
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
|
