xref: /btstack/port/apollo2-em9304/README.md (revision e6c9673776c7f85e24c76da7f4b1b83031102d2b)
1# BTstack port for Ambiq Apollo2 with EM9304
2
3This port uses the Ambiq Apollo2 EVB with their EM9304 (AM_BLE) shield.
4HAL and BSP from Ambiq Suite 1.2.11 were used together with the regular ARM GCC.
5Upload is possible via the internal J-Link interface or the 10-pin Mini ARM-JTAG Interface.
6
7## Hardware
8
9Ambiq Apollo2 EVB + AM_BLE Shield
10- http://ambiqmicro.com/apollo-ultra-low-power-mcus/apollo2-mcu/
11
12## Software
13
14AmbiqSuite:
15- http://ambiqmicro.com/apollo-ultra-low-power-mcus/apollo2-mcu/
16
17Please clone BTstack as AmbiqSuite/third-party/bstack folder into the AmbiqSuite.
18
19## Create Example Projects
20
21To create example GCC projects, go to the Apollo2-EM9304 folder
22
23	$ cd port/apollo2-em9304
24
25and run make
26
27	$ ./create_examples.py
28
29All examples are placed in the boards/apollo2_evb_am_ble/examples folder with btstack_ prefix.
30
31
32## Compile & Run Example Project
33
34Go to to the gcc folder of one of the example folders and run make
35
36    $ run make
37
38To upload, please follow the instructions in the Apollo Getting Started documents.
39
40## Debug output
41
42printf is routed over the USB connector of the EVB at 115200.
43
44In port/apollo2-em9304/btstack_config.h additional debug information can be enabled by uncommenting ENABLE_LOG_INFO.
45
46Also, 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