1.. _apollo3_evb:
2
3Ambiq Apollo3 Blue EVB
4######################
5
6Apollo3 Blue EVB is a board by Ambiq featuring their ultra-low power Apollo3 Blue SoC.
7
8.. image:: ./apollo3-blue-soc-eval-board.jpg
9   :align: center
10   :alt: Apollo3 Blue EVB
11
12Hardware
13********
14
15- Apollo3 Blue SoC with up to 96 MHz operating frequency
16- ARM® Cortex® M4F core
17- 16 kB 2-way Associative/Direct-Mapped Cache per core
18- Up to 1 MB of flash memory for code/data
19- Up to 384 KB of low leakage / low power RAM for code/data
20- Integrated Bluetooth 5 Low-energy controller
21
22For more information about the Apollo3 Blue SoC and Apollo3 Blue EVB board:
23
24- `Apollo3 Blue Website`_
25- `Apollo3 Blue Datasheet`_
26- `Apollo3 Blue EVB Website`_
27
28Supported Features
29==================
30
31The Apollo3 Blue EVB board configuration supports the following hardware features:
32
33+-----------+------------+-------------------------------------+
34| Interface | Controller | Driver/Component                    |
35+===========+============+=====================================+
36| MPU       | on-chip    | memory protection unit              |
37+-----------+------------+-------------------------------------+
38| NVIC      | on-chip    | nested vector interrupt controller  |
39+-----------+------------+-------------------------------------+
40| SYSTICK   | on-chip    | systick                             |
41+-----------+------------+-------------------------------------+
42| STIMER    | on-chip    | stimer                              |
43+-----------+------------+-------------------------------------+
44| GPIO      | on-chip    | gpio                                |
45+-----------+------------+-------------------------------------+
46| UART      | on-chip    | serial                              |
47+-----------+------------+-------------------------------------+
48| WDT       | on-chip    | watchdog                            |
49+-----------+------------+-------------------------------------+
50| RADIO     | on-chip    | bluetooth                           |
51+-----------+------------+-------------------------------------+
52
53The default configuration can be found in the defconfig file:
54``boards/arm/apollo3_evb/apollo3_evb_defconfig``.
55
56Programming and Debugging
57=========================
58
59Flashing an application
60-----------------------
61
62Connect your device to your host computer using the JLINK USB port.
63The sample application :ref:`hello_world` is used for this example.
64Build the Zephyr kernel and application, then flash it to the device:
65
66.. zephyr-app-commands::
67   :zephyr-app: samples/hello_world
68   :board: apollo3_evb
69   :goals: flash
70
71.. note::
72   `west flash` requires `SEGGER J-Link software`_ and `pylink`_ Python module
73   to be installed on you host computer.
74
75Open a serial terminal (minicom, putty, etc.) with the following settings:
76
77- Speed: 115200
78- Data: 8 bits
79- Parity: None
80- Stop bits: 1
81
82Reset the board and you should be able to see on the corresponding Serial Port
83the following message:
84
85.. code-block:: console
86
87   Hello World! apollo3_evb
88
89.. _Apollo3 Blue Website:
90   https://ambiq.com/apollo3-blue/
91
92.. _Apollo3 Blue Datasheet:
93   https://contentportal.ambiq.com/documents/20123/388390/Apollo3-Blue-SoC-Datasheet.pdf
94
95.. _Apollo3 Blue EVB Website:
96   https://www.ambiq.top/en/apollo3-blue-soc-eval-board
97
98.. _SEGGER J-Link software:
99   https://www.segger.com/downloads/jlink
100
101.. _pylink:
102   https://github.com/Square/pylink
103