xref: /btstack/port/posix-h4-bcm/README.md (revision 36e2ff5e995e605fb249f227da24ebb53b7c1c78)
1893dbb94SMatthias Ringwald# BTstack Port for POSIX Systems with modern Infineon (CYW) H4 Bluetooth Controller
2893dbb94SMatthias Ringwald
3893dbb94SMatthias Ringwald## Configuration
4893dbb94SMatthias RingwaldNewer Infineon Airoc (tm) Controllers like the CYW5557x series accept PatchRAM upload only in a so-called
5893dbb94SMatthias Ringwald'auto-baud mode' which is entered by asserting CTS (low) and starting/resetting the controller via BT_REG_EN.
6*36e2ff5eSMatthias RingwaldThis port currently only supports the CYW5557x Controllers.
7893dbb94SMatthias Ringwald
8893dbb94SMatthias Ringwald## Compilation
9893dbb94SMatthias Ringwald
10893dbb94SMatthias RingwaldBTstack's posix-h4-bcm port does not have additional dependencies. You can directly run cmake and then your default
11893dbb94SMatthias Ringwaldbuild system. E.g. with Ninja:
12893dbb94SMatthias Ringwald
13893dbb94SMatthias Ringwald	mkdir build
14893dbb94SMatthias Ringwald    cd build
15893dbb94SMatthias Ringwald    cmake -G Ninja ..
16893dbb94SMatthias Ringwald    ninja
17893dbb94SMatthias Ringwald
18893dbb94SMatthias Ringwald## Running the examples
19893dbb94SMatthias Ringwald
20893dbb94SMatthias RingwaldOn start, BTstack opens the serial port, which asserts CTS, and requests you to reset the Controller with a countdown.
21893dbb94SMatthias Ringwald
22893dbb94SMatthias Ringwald	$ ./gatt_counter
23893dbb94SMatthias Ringwald    Packet Log: /tmp/hci_dump.pklg
24893dbb94SMatthias Ringwald    Phase 1: Download firmware
25893dbb94SMatthias Ringwald    Please reset Bluetooth Controller, e.g. via RESET button. Firmware download starts in:
26893dbb94SMatthias Ringwald    3
27893dbb94SMatthias Ringwald    2
28893dbb94SMatthias Ringwald    1
29893dbb94SMatthias Ringwald    Firmware download started
30*36e2ff5eSMatthias Ringwald    Local version information:
31*36e2ff5eSMatthias Ringwald    - HCI Version    0x000a
32*36e2ff5eSMatthias Ringwald    - HCI Revision   0x0b73
33*36e2ff5eSMatthias Ringwald    - LMP Version    0x000a
34*36e2ff5eSMatthias Ringwald    - LMP Subversion 0x2257
35*36e2ff5eSMatthias Ringwald    - Manufacturer 0x0009
36893dbb94SMatthias Ringwald    Phase 2: Main app
37893dbb94SMatthias Ringwald    BTstack up and running at 55:56:0A:0A:76:93
38*36e2ff5eSMatthias Ringwald    ...
39893dbb94SMatthias Ringwald
40893dbb94SMatthias Ringwald## ToDo
41*36e2ff5eSMatthias Ringwald- select PatchRAM file based on HCI Read Local Version Information
42