1.. zephyr:board:: apard32690
2
3Overview
4********
5The AD-APARD32690-SL is a platform for prototyping intelligent, secure, and connected field devices.
6It has an Arduino Mega-compatible form factor and two Pmod-compatible connectors.
7The system includes the MAX32690 ARM Cortex-M4 with FPU-Based Microcontroller and Bluetooth LE 5.2.
8The MCU is coupled with external RAM (2 x 512 Mb) and Flash (64 Mb) memories to meet the requirements
9of the most demanding applications. The MAXQ1065 security coprocessor enables state of the art
10security features such as for root-of-trust, mutual authentication, data confidentiality and
11integrity, secure boot, and secure communications.
12A 10 Mbps single-pair Ethernet link using the ADIN1110 10BASE-T1L MAC/PHY, enables remote
13data acquisition and system configuration. The 10BASE-T1L interface also supports Single-pair
14Power over Ethernet (SPoE) and be used for powering the system via an Arduino shield implementing
15the required power circuitry.
16
17The Zephyr port is running on the MAX32690 MCU.
18
19Hardware
20********
21
22- MAX32690 MCU:
23
24    - Ultra-Efficient Microcontroller for Battery-Powered Applications
25
26      - 120MHz Arm Cortex-M4 Processor with FPU
27      - 7.3728MHz and 60MHz Low-Power Oscillators
28      - External Crystal Support (32MHz required for BLE)
29      - 32.768kHz RTC Clock (Requires External Crystal)
30      - 8kHz Always-On Ultra-Low Power Oscillator
31      - 3MB Internal Flash, 1MB Internal SRAM (832kB ECC ON)
32      - TBDμW/MHz Executing from Cache at 1.1V
33      - 1.8V and 3.3V I/O with No Level Translators
34      - External Flash & SRAM Expansion Interfaces
35
36    - Bluetooth 5.2 LE Radio
37
38      - Dedicated, Ultra-Low-Power, 32-Bit RISC-V Coprocessor to Offload Timing-Critical Bluetooth Processing
39      - Fully Open-Source Bluetooth 5.2 Stack Available
40      - Supports AoA, AoD, LE Audio, and Mesh
41      - High-Throughput (2Mbps) Mode
42      - Long-Range (125kbps and 500kbps) Modes
43      - Rx Sensitivity: -97.5dBm; Tx Power: +4.5dBm
44      - Single-Ended Antenna Connection (50Ω)
45
46    - Multiple Peripherals for System Control
47
48      - 16-Channel DMA
49      - Up To Five Quad SPI Master (60MHz)/Slave (48MHz)
50      - Up To Four 1Mbaud UARTs with Flow Control
51      - Up To Two 1MHz I2C Master/Slave
52      - I2S Master/Slave
53      - Eight External Channel, 12-bit 1MSPS SAR ADC w/ on-die temperature sensor
54      - USB 2.0 Hi-Speed Device
55      - 16 Pulse Train Engines
56      - Up To Six 32-Bit Timers with 8mA High Drive
57      - Up To Two CAN 2.0 Controllers
58      - Up To Four Micro-Power Comparators
59      - 1-Wire Master
60
61    - Security and Integrity
62
63      - ChipDNA Physically Un-clonable Function (PUF)
64      - Modular Arithmetic Accelerator (MAA), True Random Number Generator (TRNG)
65      - Secure Nonvolatile Key Storage, SHA-256, AES-128/192/256
66      - Secure Boot ROM
67
68- External devices connected to the APARD32690:
69
70  - On-Board HyperRAM
71  - On-Board SPI Flash
72  - USB 2.0 Type-C interface to the MAX32690
73  - SPI PMOD connector
74  - I2C PMOD connector
75  - SWD 10-Pin Header
76  - On-Board Bluetooth 5.2 LE Radio antenna
77  - MAXQ1065 Ultralow Power Cryptographic Controller with ChipDNA
78  - ADIN1110 Robust, Industrial, Low Power 10BASE-T1L Ethernet MAC-PHY
79  - U-Blox NINA-W102 802.11b/g/n module with dual-mode Bluetooth v4.2
80  - On-Board 5V, 3.3V, 1.8V, and 1.1V voltage regulators
81  - 2-Pin external power supply terminal block (5V - 28V DC)
82  - Board Power Provided by either the USB Port or the 2-Pin connector
83  - Arduino Mega compatible header.
84  - Two general-purpose LEDs and one general purpose push button.
85
86
87Supported Features
88==================
89
90Below interfaces are supported by Zephyr on APARD32690.
91
92+-----------+------------+------------------------------------+
93| Interface | Controller | Driver/Component                   |
94+===========+============+====================================+
95| NVIC      | on-chip    | nested vector interrupt controller |
96+-----------+------------+------------------------------------+
97| SYSTICK   | on-chip    | systick                            |
98+-----------+------------+------------------------------------+
99| CLOCK     | on-chip    | clock and reset control            |
100+-----------+------------+------------------------------------+
101| GPIO      | on-chip    | gpio                               |
102+-----------+------------+------------------------------------+
103| UART      | on-chip    | serial                             |
104+-----------+------------+------------------------------------+
105| SPI       | on-chip    | spi                                |
106+-----------+------------+------------------------------------+
107| ADIN1110  | spi        | ADIN1110 10BASE-T1L mac/phy        |
108+-----------+------------+------------------------------------+
109| TRNG      | on-chip    | entropy                            |
110+-----------+------------+------------------------------------+
111| Timer     | on-chip    | counter                            |
112+-----------+------------+------------------------------------+
113| W1        | on-chip    | one wire master                    |
114+-----------+------------+------------------------------------+
115
116
117Connections and IOs
118===================
119
120+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
121| Name      | Name          | Settings      | Description                                                                                      |
122+===========+===============+===============+==================================================================================================+
123| P55       | SWD TX        |               |                                                                                                  |
124|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
125|           |               | | 1-2       | |  | Connects the SWD UART TX to the (UART) RX port of the U-Blox Nina W102.       |               |
126|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
127|           |               | | 2-3       | |  | Connects the SWD UART TX to the UART0 TX pin of the MAX32690.                 |               |
128|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
129|           |               |               |                                                                                                  |
130+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
131| P50       | SWD RX        | +-----------+ |  +-------------------------------------------------------------------------------+               |
132|           |               | | 1-2       | |  | Connects the SWD UART RX to the (UART) TX port of the U-Blox Nina W102.       |               |
133|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
134|           |               | | 2-3       | |  | Connects the SWD UART RX to the UART0 RX pin of the MAX32690.                 |               |
135|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
136|           |               |               |                                                                                                  |
137+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
138| P51       | SWD POW       | +-----------+ |  +-------------------------------------------------------------------------------+               |
139|           |               | | 1-2       | |  | Connects the SWD Vcc pin to 3.3V.                                             |               |
140|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
141|           |               | | 2-3       | |  | Connects the SWD Vcc pin to 1.8V.                                             |               |
142|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
143|           |               |               |                                                                                                  |
144+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
145| P38       | UART RX WIFI  | +-----------+ |  +-------------------------------------------------------------------------------+               |
146|           |               | | 1-2       | |  | Connect the U-Blox Nina W102 UART RX to the UART2A TX pin of the MAX32690     |               |
147|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
148|           |               | | Open      | |  | Disconnects the U-Blox Nina W102 UART RX from the UART2A TX pin               |               |
149|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
150|           |               |               |                                                                                                  |
151+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
152| P58       | UART TX WIFI  | +-----------+ |  +-------------------------------------------------------------------------------+               |
153|           |               | | 1-2       | |  | Connect the U-Blox Nina W102 UART TX to the UART2A RX pin of the MAX32690.    |               |
154|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
155|           |               | | Open      | |  | Disconnects the U-Blox Nina W102 UART TX from the UART2A RX pin.              |               |
156|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
157|           |               |               |                                                                                                  |
158+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
159| S4        | SW1           | +-----------+ |  +-------------------------------------------------------------------------------+               |
160|           |               | | On        | |  | Pulls the ADIN1110's SWPD_EN pin to 3.3V through a resistor.                  |               |
161|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
162|           |               | | Off       | |  | Leaves the ADIN1110's SWPD_EN pin floating.                                   |               |
163|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
164|           |               |               |                                                                                                  |
165+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
166| S4        | SW2           | +-----------+ |  +-------------------------------------------------------------------------------+               |
167|           |               | | On        | |  | Pulls the ADIN1110's CFG0 pin to 3.3V through a resistor.                     |               |
168|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
169|           |               | | Off       | |  | Leaves the ADIN1110's CFG0 pin floating.                                      |               |
170|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
171|           |               |               |                                                                                                  |
172+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
173| S4        | SW3           | +-----------+ |  +-------------------------------------------------------------------------------+               |
174|           |               | | On        | |  | Pulls the ADIN1110's CFG1 pin to 3.3V through a resistor.                     |               |
175|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
176|           |               | | Off       | |  | Leaves the ADIN1110's CFG1 pin floating.                                      |               |
177|           |               | +-----------+ |  +-------------------------------------------------------------------------------+               |
178|           |               |               |                                                                                                  |
179+-----------+---------------+---------------+--------------------------------------------------------------------------------------------------+
180
181
182Programming and Debugging
183*************************
184
185Flashing
186========
187
188The MAX32690 MCU can be flashed by connecting an external debug probe to the
189SWD port. SWD debug can be accessed through the Cortex 10-pin connector, P9.
190Logic levels are either 1.8V or 3.3V (based on P51 selection).
191
192Once the debug probe is connected to your host computer, then you can simply run the
193``west flash`` command to write a firmware image into flash.
194
195.. note::
196
197   This board uses OpenOCD as the default debug interface. You can also use
198   a Segger J-Link with Segger's native tooling by overriding the runner,
199   appending ``--runner jlink`` to your ``west`` command(s). The J-Link should
200   be connected to the standard 2*5 pin debug connector (P9) using an
201   appropriate adapter board and cable.
202
203Debugging
204=========
205
206Please refer to the `Flashing`_ section and run the ``west debug`` command
207instead of ``west flash``.
208
209References
210**********
211
212- `AD-APARD32690-SL web page`_
213
214.. _AD-APARD32690-SL web page:
215   https://www.analog.com/en/resources/evaluation-hardware-and-software/evaluation-boards-kits/ad-apard32690-sl.html
216