README.md
1# BTstack Port for POSIX Systems with H4 Bluetooth Controller
2
3## Configuration
4Most Bluetooth Bluetooth Controllers connected via UART/H4 require some special configuration, e.g. to set the UART baud rate, and/or require firmware patches during startup. In this port, we've tried to do most of these automatically based on information gathered from the Bluetooth Controller. Here's some Controller specific details:
5
6## TI CC256x
7The CC2564x needs the correct init script to start up. The Makfile already has entries for most silicon revisions:
8
9- CC2560: bluetooth_init_cc2564_2.14.c
10- CC2564B: bluetooth_init_cc2564B_1.8_BT_Spec_4.1.c
11- CC2564C: bluetooth_init_cc2564C_1.5.c
12
13Please pick the correct one. The main.c verifies that the correct script is loaded, but the init script is linked to the executable.
14
15## Broadcom BCM/CYW 43430
16
17The correct firmware file needs to be provided in the current working directory. The Makefile downloads the one for the BCM43430 e.g. found on later Raspberry Pi editions. Please see the separate port/raspi, too.
18
19
20## Compilation
21
22BTstack's POSIX-H4 does not have additional dependencies. You can directly run make.
23
24 make
25
26
27## Running the examples
28
29On start, BTstack prints the path to the packet log and prints the information on the detected Buetooth Controller.
30
31 $ ./le_counter
32 Packet Log: /tmp/hci_dump.pklg
33 BTstack counter 0001
34 BTstack up and running on 00:1A:7D:DA:71:13.
35
36Please note that BTstack will increase the baudrate. Before starting again, you should reset or power-cycle the Bluetooth Controller.
37