1.. zephyr:board:: adi_sdp_k1
2
3Overview
4********
5
6The EVAL-SDP-CK1Z (SDP-K1) controller board is a system demonstration platform
7(SDP) from Analog Devices designed to connect to evaluation shields containing
8ADI components.
9
10- STM32 microcontroller in BGA216 package
11- USB 2.0 device with USB-C connector
12- USB debug interface supporting CMSIS-DAP through a NXP Freescale
13  microcontroller
14- Flexible board power supply
15    - USB VBUS 5 V max. 500 mA
16    - 5.5mm DC power jack 7 - 12 V min. 300 mA
17    - VIN from Arduino* compatible connectors
18    - VIN from 120-pin connector 5 V min. 300 mA
19- 3 color LEDs (green, orange, red) and 1 status LED
20- One push-buttons: RESET
21- 16MB SDRAM
22- Arduino UNO and 120-pin SDP connectors
23
24More information about the board can be found on the `ADI SDP-K1 website`_.
25
26Hardware
27********
28
29ADI SDP-K1 provides the following hardware components:
30
31- STM32F469NIH6 in BGA216 package
32- ARM |reg| 32-bit Cortex |reg| -M4 CPU with FPU
33- 180 MHz max CPU frequency
34- VDD of 1.8 V or 3.3 V
35- 2 MB Flash
36- 384 KB SRAM
37- GPIO with external interrupt capability
38- LCD parallel interface, 8080/6800 modes
39- LCD TFT controller supporting up to XGA resolution
40- MIPI |reg|  DSI host controller supporting up to 720p 30Hz resolution
41- 3x12-bit ADC with 24 channels
42- 2x12-bit D/A converters
43- RTC
44- Advanced-control Timer
45- General Purpose Timers (17)
46- Watchdog Timers (2)
47- USART/UART (8)
48- I2C (3)
49- SPI (6)
50- 1xSAI (serial audio interface)
51- SDIO
52- 2xCAN
53- USB 2.0 OTG FS with on-chip PHY
54- USB 2.0 OTG HS/FS with dedicated DMA, on-chip full-speed PHY and ULPI
55- 10/100 Ethernet MAC with dedicated DMA
56- 8- to 14-bit parallel camera
57- CRC calculation unit
58- True random number generator
59- DMA Controller
60
61More information about STM32F469NI can be found here:
62       - `STM32F469NI product page`_
63       - `STM32F469 reference manual`_
64
65Supported Features
66==================
67
68The Zephyr stm32f469i_disco board configuration supports the following hardware features:
69
70+-----------+------------+-------------------------------------+
71| Interface | Controller | Driver/Component                    |
72+===========+============+=====================================+
73| UART      | on-chip    | serial port-polling;                |
74|           |            | serial port-interrupt               |
75+-----------+------------+-------------------------------------+
76| PINMUX    | on-chip    | pinmux                              |
77+-----------+------------+-------------------------------------+
78| GPIO      | on-chip    | gpio                                |
79+-----------+------------+-------------------------------------+
80
81Other hardware features are not yet supported on Zephyr porting.
82
83The default configuration can be found in
84:zephyr_file:`boards/adi/sdp_k1/adi_sdp_k1_defconfig`
85
86Pin Mapping
87===========
88
89For more details please refer to `EVAL-SDP-CK1Z User Guide`_.
90
91Arduino UNO headers
92-------------------
93
94.. figure:: img/adi_sdp_k1_arduino.webp
95   :align: center
96   :alt: ADI SDP-K1 Arduino UNO headers pinout
97
98   ADI SDP-K1 (Credit: Analog Devices, Inc.)
99
100120-pin SDP connector
101---------------------
102
103.. figure:: img/adi_sdp_k1_120pin.webp
104   :align: center
105   :alt: ADI SDP-K1 120-pin SDP connector pinout
106
107   ADI SDP-K1 (Credit: Analog Devices, Inc.)
108
109Default Zephyr Peripheral Mapping:
110----------------------------------
111
112- UART_5 TX/RX : P2 (DAPLink USB-C)
113- UART_5 TX/RX : P8 (DAPLink two position through hole)
114- LED1 : DS6 (Red)
115- LED2 : DS5 (Orange)
116- LED3 : DS4 (Green)
117- LED4 : DS4 (Status)
118
119Programming and Debugging
120*************************
121
122The ADI SDP-K1 be programmed over USB using the DAPLink firmware running on an
123embedded NXP Freescale microcontroller or a 10-pin ``DEBUG`` header connected
124to a STLINK debugger.
125
126DAPLink exposes a storage device, as well as USB HID and CDC Endpoints, to the
127host. For more details please refer to the `Official DAPLink website`_.
128
129Flashing
130========
131
132Flashing an application with a STLINK debugger
133----------------------------------------------
134
135First, connect the STLINK debugger to your host computer using the Micro-USB port.
136Then attach the debugger to the 10-pin ``DEBUG`` header on the SDP-K1. Finally
137connect the SDP-K1 to your host computer using the USB-C port.
138
139Run a serial host program to connect with your board:
140
141.. code-block:: console
142
143   $ minicom -D /dev/serial/by-id/usb-ARM_DAPLink_CMSIS-DAP_<...>
144
145Here is an example for the :zephyr:code-sample:`hello_world` application.
146
147.. zephyr-app-commands::
148   :zephyr-app: samples/hello_world
149   :board: adi_sdp_k1
150   :goals: build flash
151
152You should see the following message on the console:
153
154.. code-block:: console
155
156   Hello World! adi_sdp_k1
157
158Debugging
159=========
160
161.. _ADI SDP-K1 website:
162   https://www.analog.com/en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/sdp-k1.html
163
164.. _EVAL-SDP-CK1Z User Guide:
165   https://www.analog.com/media/en/technical-documentation/user-guides/EVAL-SDP-CK1Z-UG-1539.pdf
166
167.. _STM32F469NI product page:
168   https://www.st.com/en/microcontrollers/stm32f469ni.html
169
170.. _STM32F469 reference manual:
171   https://www.st.com/resource/en/reference_manual/dm00127514.pdf
172
173.. _Official DAPLink website:
174   https://daplink.io/
175