1.. zephyr:board:: apollo4p_blue_kxr_evb
2
3Apollo4 Blue Plus KXR EVB is a board by Ambiq featuring their ultra-low power Apollo4 Blue Plus SoC.
4
5Hardware
6********
7
8- Apollo4 Blue 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- Bluetooth 5.1 Low Energy
16
17For more information about the Apollo4 Blue Plus SoC and Apollo4 Blue Plus KXR EVB board:
18
19- `Apollo4 Blue Plus Website`_
20- `Apollo4 Blue Plus Datasheet`_
21- `Apollo4 Blue Plus KXR EVB Website`_
22
23Supported Features
24==================
25
26The Apollo4 Blue Plus KXR EVB board configuration supports the following hardware features:
27
28+-----------+------------+-------------------------------------+
29| Interface | Controller | Driver/Component                    |
30+===========+============+=====================================+
31| MPU       | on-chip    | memory protection unit              |
32+-----------+------------+-------------------------------------+
33| NVIC      | on-chip    | nested vector interrupt controller  |
34+-----------+------------+-------------------------------------+
35| SYSTICK   | on-chip    | systick                             |
36+-----------+------------+-------------------------------------+
37| STIMER    | on-chip    | stimer                              |
38+-----------+------------+-------------------------------------+
39| GPIO      | on-chip    | gpio                                |
40+-----------+------------+-------------------------------------+
41| UART      | on-chip    | serial                              |
42+-----------+------------+-------------------------------------+
43| WDT       | on-chip    | watchdog                            |
44+-----------+------------+-------------------------------------+
45| SPI(M)    | on-chip    | spi                                 |
46+-----------+------------+-------------------------------------+
47| I2C(M)    | on-chip    | i2c                                 |
48+-----------+------------+-------------------------------------+
49| CLOCK     | on-chip    | clock_control                       |
50+-----------+------------+-------------------------------------+
51| RADIO     | on-chip    | bluetooth                           |
52+-----------+------------+-------------------------------------+
53
54The default configuration can be found in
55:zephyr_file:`boards/ambiq/apollo4p_blue_kxr_evb/apollo4p_blue_kxr_evb_defconfig`
56
57Programming and Debugging
58=========================
59
60Flashing an application
61-----------------------
62
63Connect your device to your host computer using the JLINK USB port.
64The sample application :zephyr:code-sample:`hello_world` is used for this example.
65Build the Zephyr kernel and application, then flash it to the device:
66
67.. zephyr-app-commands::
68   :zephyr-app: samples/hello_world
69   :board: apollo4p_blue_kxr_evb
70   :goals: flash
71
72.. note::
73   ``west flash`` requires `SEGGER J-Link software`_ and `pylink`_ Python module
74   to be installed on you host computer.
75
76Open a serial terminal (minicom, putty, etc.) with the following settings:
77
78- Speed: 115200
79- Data: 8 bits
80- Parity: None
81- Stop bits: 1
82
83Reset the board and you should be able to see on the corresponding Serial Port
84the following message:
85
86.. code-block:: console
87
88   Hello World! apollo4p_blue_kxr_evb
89
90.. _Apollo4 Blue Plus Website:
91   https://ambiq.com/apollo4-blue-plus/
92
93.. _Apollo4 Blue Plus Datasheet:
94   https://contentportal.ambiq.com/documents/20123/388410/Apollo4-Blue-Plus-SoC-Datasheet.pdf
95
96.. _Apollo4 Blue Plus KXR EVB Website:
97   https://www.ambiq.top/en/apollo4-blue-plus-kxr-soc-eval-board
98
99.. _SEGGER J-Link software:
100   https://www.segger.com/downloads/jlink
101
102.. _pylink:
103   https://github.com/Square/pylink
104