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