xref: /btstack/port/apollo2-em9304/README.md (revision e6c9673776c7f85e24c76da7f4b1b83031102d2b)
1*e6c96737SMatthias Ringwald# BTstack port for Ambiq Apollo2 with EM9304
2*e6c96737SMatthias Ringwald
3*e6c96737SMatthias RingwaldThis port uses the Ambiq Apollo2 EVB with their EM9304 (AM_BLE) shield.
4*e6c96737SMatthias RingwaldHAL and BSP from Ambiq Suite 1.2.11 were used together with the regular ARM GCC.
5*e6c96737SMatthias RingwaldUpload is possible via the internal J-Link interface or the 10-pin Mini ARM-JTAG Interface.
6*e6c96737SMatthias Ringwald
7*e6c96737SMatthias Ringwald## Hardware
8*e6c96737SMatthias Ringwald
9*e6c96737SMatthias RingwaldAmbiq Apollo2 EVB + AM_BLE Shield
10*e6c96737SMatthias Ringwald- http://ambiqmicro.com/apollo-ultra-low-power-mcus/apollo2-mcu/
11*e6c96737SMatthias Ringwald
12*e6c96737SMatthias Ringwald## Software
13*e6c96737SMatthias Ringwald
14*e6c96737SMatthias RingwaldAmbiqSuite:
15*e6c96737SMatthias Ringwald- http://ambiqmicro.com/apollo-ultra-low-power-mcus/apollo2-mcu/
16*e6c96737SMatthias Ringwald
17*e6c96737SMatthias RingwaldPlease clone BTstack as AmbiqSuite/third-party/bstack folder into the AmbiqSuite.
18*e6c96737SMatthias Ringwald
19*e6c96737SMatthias Ringwald## Create Example Projects
20*e6c96737SMatthias Ringwald
21*e6c96737SMatthias RingwaldTo create example GCC projects, go to the Apollo2-EM9304 folder
22*e6c96737SMatthias Ringwald
23*e6c96737SMatthias Ringwald	$ cd port/apollo2-em9304
24*e6c96737SMatthias Ringwald
25*e6c96737SMatthias Ringwaldand run make
26*e6c96737SMatthias Ringwald
27*e6c96737SMatthias Ringwald	$ ./create_examples.py
28*e6c96737SMatthias Ringwald
29*e6c96737SMatthias RingwaldAll examples are placed in the boards/apollo2_evb_am_ble/examples folder with btstack_ prefix.
30*e6c96737SMatthias Ringwald
31*e6c96737SMatthias Ringwald
32*e6c96737SMatthias Ringwald## Compile & Run Example Project
33*e6c96737SMatthias Ringwald
34*e6c96737SMatthias RingwaldGo to to the gcc folder of one of the example folders and run make
35*e6c96737SMatthias Ringwald
36*e6c96737SMatthias Ringwald    $ run make
37*e6c96737SMatthias Ringwald
38*e6c96737SMatthias RingwaldTo upload, please follow the instructions in the Apollo Getting Started documents.
39*e6c96737SMatthias Ringwald
40*e6c96737SMatthias Ringwald## Debug output
41*e6c96737SMatthias Ringwald
42*e6c96737SMatthias Ringwaldprintf is routed over the USB connector of the EVB at 115200.
43*e6c96737SMatthias Ringwald
44*e6c96737SMatthias RingwaldIn port/apollo2-em9304/btstack_config.h additional debug information can be enabled by uncommenting ENABLE_LOG_INFO.
45*e6c96737SMatthias Ringwald
46*e6c96737SMatthias RingwaldAlso, the full packet log can be enabled in src/btstack_port.c by uncommenting the hci_dump_open(..) line. The console output can then be converted into .pklg files for OS X PacketLogger or WireShark by running tool/create_packet_log.py
47