xref: /btstack/port/archive/pic32-harmony/README.md (revision bfc39f3e53bffb178d46475fc3f3e00a92502490)
1*bfc39f3eSMatthias Ringwald# BTstack Port for the Microchip PIC32 Harmony Platform
2*bfc39f3eSMatthias Ringwald
3*bfc39f3eSMatthias RingwaldStatus: All examples working, polling UART driver. Tested on Bluetooth Audio Development Kit only. Created with Harmony v1.07, does not compile with new v2.x versions.
4*bfc39f3eSMatthias Ringwald
5*bfc39f3eSMatthias Ringwald## Hardware
6*bfc39f3eSMatthias Ringwald
7*bfc39f3eSMatthias RingwaldThe PIC32 Bluetooth Audio Development Kit comes with the CSR8811-based
8*bfc39f3eSMatthias RingwaldBTM805 Bluetooth module. In the port, the UART on the DAC daughter board
9*bfc39f3eSMatthias Ringwaldwas used for the debug output. Please remove the DAC board and connect a
10*bfc39f3eSMatthias Ringwald3.3V USB-2-UART converter to GND and TX to get the debug output.
11*bfc39f3eSMatthias Ringwald
12*bfc39f3eSMatthias Ringwald## Software
13*bfc39f3eSMatthias Ringwald
14*bfc39f3eSMatthias RingwaldMicrochip MPLAB X IDE and the MPLAB XC32 compiler needs to be installed.
15*bfc39f3eSMatthias Ringwald
16*bfc39f3eSMatthias Ringwald## Setup
17*bfc39f3eSMatthias Ringwald
18*bfc39f3eSMatthias Ringwald- Place BTstack tree into harmony/framework folder.
19*bfc39f3eSMatthias Ringwald- Run port/pic32-harmony/create_examples.py to create examples in harmony/apps/btstack folder.
20*bfc39f3eSMatthias Ringwald
21*bfc39f3eSMatthias Ringwald## Usage
22*bfc39f3eSMatthias Ringwald
23*bfc39f3eSMatthias RingwaldThe examples can be opened and compiled in Microchip MPLAB X IDE or from the command line using the Makefile generated by it.
24*bfc39f3eSMatthias Ringwald
25*bfc39f3eSMatthias Ringwald### Modifications to the GATT Database
26*bfc39f3eSMatthias Ringwald
27*bfc39f3eSMatthias RingwaldAfter changing the GATT definition in $example.gatt, please run ./update_gatt_db.h to regenerate example.h in the $example folder.
28*bfc39f3eSMatthias Ringwald
29*bfc39f3eSMatthias Ringwald### Compiler Warnings:
30*bfc39f3eSMatthias Ringwald
31*bfc39f3eSMatthias RingwaldThe project is set to use -Os optimization which will cause warnings if you
32*bfc39f3eSMatthias Ringwaldonly have the Free version. It will still compile a working example.
33*bfc39f3eSMatthias Ringwald
34