xref: /btstack/port/posix-h4-nxp/README.md (revision ced70f9bfeafe291ec597a3a9cc862e39e0da3ce)
1# BTstack Port for POSIX Systems with NXP/Marvel 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.
5In this port, we've show how a NXP/Marvell Controller can be configured for use with BTstack. It's unclear if the required firmware file for older Controllers,
6e.g. 88W8997, can be detected during the firmware upload. This port selects the firmware for NXP 88W8997.
7For newer Controllers, e.g. IW416 or IW612, the firmware can be selected automatically.
8
9## Compilation
10
11BTstack's posix-h4-nxp port does not have additional dependencies. You can directly run cmake and then your default build system. E.g. with Ninja:
12
13	mkdir build
14    cd build
15    cmake -G Ninja ..
16    ninja
17
18## Running the examples
19
20Please reset the Controller first. On start, BTstack prints the path to the packet log.
21
22	$ ./gatt_counter
23	Packet Log: /tmp/hci_dump.pklg
24	BTstack counter 0001
25	BTstack up and running on 00:1A:7D:DA:71:13.
26
27## Issues
28- NXP 88W8997 does not support SCO Flow Control which causes glitches when sending audio
29
30## ToDo
31- increase baud rate for firmware upload
32- skip firmware upload if firmware already present
33- increase baud rate for application
34