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