solutions/ad-apard32690-sl: Update csv, index

aronkis · aronkis · commit 9623487d81f8 · 2025-12-18T15:47:12.000+02:00
Update pin descriptions and specifications CSV files.
Update index formatting.

Signed-off-by: Aron Kis &lt;kis.aron@analog.com&gt;
diff --git a/docs/solutions/reference-designs/ad-apard32690-sl/index.rst b/docs/solutions/reference-designs/ad-apard32690-sl/index.rst
@@ -2,8 +2,8 @@
 AD-APARD32690-SL
 ================
 
-Arduino Form-factor Development Platform Based on MAX32690 ARM Cortex-M4 Microcontroller
-""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+Arduino Form-factor Development Platform Based on MAX32690 ARM Cortex-M4
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 
 Introduction
 ------------
@@ -18,7 +18,8 @@ industrial field devices. Some of the main features and benefits include:
 - ARM Cortex-M4 Ultra Efficient Microcontroller with integrated Bluetooth 5.2 LE
 - WiFi connectivity
 - Long-range, single-pair 10BASE-T1L Ethernet interface
-- Built-in security for root-of-trust, mutual authentication, data confidentiality and integrity, secure boot, and secure communications
+- Built-in security for root-of-trust, mutual authentication, data
+  confidentiality and integrity, secure boot, and secure communications
 - Open-source software stack
 
 .. figure:: eval-max32690-ardz_angle.jpg
@@ -51,7 +52,8 @@ system together and get it up and running in no time.
 This is what you’ll find in the development kit box:
 
 - 1 x AD-APARD32690-SL board
-- 1 x :dokuwiki:`AD-T1LUSB2.0-EBZ <resources/eval/user-guides/ad-t1lusb-ebz>` 10BASE-T1L to USB adapter board
+- 1 x :dokuwiki:`AD-T1LUSB2.0-EBZ <resources/eval/user-guides/ad-t1lusb-ebz>`
+  10BASE-T1L to USB adapter board
 - 1 x PROFIBUS (1x2x18AWG) cable for Single Pair Ethernet (SPE) connectivity
 - 1 x USB 2.0 cable
 
@@ -73,7 +75,7 @@ transfer.
 
 Hardware Components and Connections
 -----------------------------------
-
+.. attention:: TO BE REPLACED!
 .. figure:: apard32690_hw_components.png
 
     Hardware Components and Connections
@@ -88,12 +90,17 @@ Required Hardware
 ~~~~~~~~~~~~~~~~~
 
 - **Development kit**: :adi:`AD-APARD32690-SL Microcontroller Board <AD-APARD32690-SL>`
-- **Power supplies**: 5V to 28V at 2A external power supply or 5V USB-C power supply
-- **Programmer**: :adi:`MAX32625PICO` or any other similar programmer supporting the SWD interface
-
-#. Connect the AD-APARD32690-SL to the :dokuwiki:`AD-T1LUSB2.0-EBZ <resources/eval/user-guides/ad-t1lusb-ebz>` using the single pair Ethernet cable.
+- **Power supplies**: 5V to 28V at 2A external power supply or 5V USB-C power
+  supply
+- **Programmer**: :adi:`MAX32625PICO` or any other similar programmer
+  supporting the SWD interface
+
+#. Connect the AD-APARD32690-SL to the :dokuwiki:`AD-T1LUSB2.0-EBZ <resources/eval/user-guides/ad-t1lusb-ebz>`
+   using the single pair Ethernet
+   cable.
 #. Connect the AD-T1LUSB2.0-EBZ to your PC using an USB cable.
-#. Connect the MAX32625PICO programmer, or any programmer supporting the SWD interface, to the AD-APARD32690-SL.
+#. Connect the MAX32625PICO programmer, or any programmer supporting the SWD
+   interface, to the AD-APARD32690-SL.
 #. Connect the power supply to the AD-APARD32690-SL.
 
 .. figure:: apard32690_system_setup.jpg
@@ -112,29 +119,40 @@ MAX32625PICO.
 
 #. Download the firmware image: `MAX32625PICO firmware <https://github.com/MaximIntegrated/max32625pico-firmware-images/raw/master/bin/max32625_max32650fthr_if_crc_swd_v1.0.6.bin>`__
 #. Set the MAX32625PICO in MAINTENANCE mode:
-      * Disconnect the MAX32625PICO from the PC and the AD-SWIOT1L-SL board.
-      * Plug the micro USB cable only in the MAX32625PICO.
-      * Keep the button on the MAX32625PICO pressed.
-      * Plug the micro USB cable into the PC.
-      * Once you see the MAINTENANCE drive being mounted, you may release the button.
 
-         .. figure:: picture2.jpg
-            :width: 300 px
+   * Disconnect the MAX32625PICO from the PC and the AD-SWIOT1L-SL board.
+   * Plug the micro USB cable only in the MAX32625PICO.
+   * Keep the button on the MAX32625PICO pressed.
+   * Plug the micro USB cable into the PC.
+   * Once you see the MAINTENANCE drive being mounted, you may release the
+     button.
+
+     .. figure:: picture2.jpg
+        :width: 300 px
 
-            Imaging the MAX32625PICO
+        Imaging the MAX32625PICO
 
-#. Drag and drop (to the MAINTENANCE drive) the firmware image you previously downloaded.
-#. After a few seconds, the MAINTENANCE drive will disappear and will be replaced by a drive named DAPLINK. Once this is done, the process is complete, and the MAX32625PICO may be used to flash the firmware of the AD-SWIOT1L-SL board.
+#. Drag and drop (to the MAINTENANCE drive) the firmware image you previously
+   downloaded.
+#. After a few seconds, the MAINTENANCE drive will disappear and will be
+   replaced by a drive named DAPLINK. Once this is done, the process is
+   complete, and the MAX32625PICO may be used to flash the firmware of the
+   AD-SWIOT1L-SL board.
 
 Programming the AD-APARD32690-SL
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 #. Connect the MAX32625PICO to the PC using the micro USB cable.
-#. Connect the MAX32625PICO to the AD-APARD32690-SL board using the 10-pin ribbon cable.
-#. Connect the power supply to the AD-APARD32690-SL. Make sure the board is powered up for the next steps.
+#. Connect the MAX32625PICO to the AD-APARD32690-SL board using the 10-pin
+   ribbon cable.
+#. Connect the power supply to the AD-APARD32690-SL. Make sure the board is
+   powered up for the next steps.
 #. A DAPLINK drive should appear as mounted on your PC.
-#. Drag and drop the new firmware image into the DAPLINK drive. After a few seconds, the drive will be remounted.
-#. Check the DAPLINK directory and make sure there is no FAIL.TXT file. In case there is, repeat the drag and drop step. Otherwise, you may disconnect the MAX32625PICO from the AD-APARD32690-SL, since the firmware update is complete.
+#. Drag and drop the new firmware image into the DAPLINK drive. After a few
+   seconds, the drive will be remounted.
+#. Check the DAPLINK directory and make sure there is no FAIL.TXT file. In case
+   there is, repeat the drag and drop step. Otherwise, you may disconnect the
+   MAX32625PICO from the AD-APARD32690-SL, since the firmware update is complete.
 
 AD-APARD32690-SL Software Stack
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/solutions/reference-designs/ad-apard32690-sl/pin-descriptions.csv b/docs/solutions/reference-designs/ad-apard32690-sl/pin-descriptions.csv
@@ -1,39 +1,44 @@
-﻿LEDs,
-DS1,Power good
-DS2,User LED
+﻿LEDs              ,
+DS1               , Power good
+DS2               , User LED
 Buttons & Switches,
-S1,MAX32690 Reset
-S2,User Button
-S3,User switches
-S4,1: ADIN1110 SWPD_EN
-,2: ADIN1110 SPI_CFG0
-,3: ADIN1110 SPI_CFG1
-Jumper settings,
-P50,Position 1-2: Connect programmer SWD_RX to WiFi UART TX
-,Position 2-3: Connect programmer SWD_RX to MAX32690
-P55,Position 1-2: Connect programmer SWD_TX to WiFi UART RX
-,Position 2-3: Connect programmer SWD_RX to MAX32690
-P38,Connect WiFi UART TX to MAX32690
-P56,Connect WiFi UART RX to MAX32690
-P51,Position 1-2: Set programmer voltage to 3V3 (normal operation mode)
-,Position 2-3: Set programmer voltage to 1V8 (WiFi chip programming)
-Connectors,
-P1,10BASE-T1L
-P10,USB-C Power & Data
-P14,External Power 5V-28V
-P9,SWD Programmer
-P11,SPOE Shield ISO GND
-P16,SPOE Shield PI+
-P17,SPOE Shield PI-
-P53,SPOE Shield PI+
-P54,SPOE Shield PI-
-P12,SPOE Shield Data TRX N
-P15,SPOE Shield Data TRX P
-P8,SPI PMOD
-P13,I2C PMOD
-P2,Arduino Connector - Power
-P3,Arduino Connector - Analog
-P4,Arduino Connector - SPI / I2S
-P5,Arduino Connector - SPI & I2C
-P6,Arduino Connector - UART
-P7,Arduino Connector - GPIO & CAN
+S1                , MAX32690 Reset
+S2                , User Button
+S3                , User switches
+S4                , 1: ADIN1110 SWPD_EN
+                  , 2: ADIN1110 SPI_CFG0
+                  , 3: ADIN1110 SPI_CFG1
+Jumper settings   ,
+P50               , Position 1-2: Connect programmer SWD_RX to WiFi UART TX
+                  , Position 2-3: Connect programmer SWD_RX to MAX32690
+P55               , Position 1-2: Connect programmer SWD_TX to WiFi UART RX
+                  , Position 2-3: Connect programmer SWD_RX to MAX32690
+P38               , Connect WiFi UART TX to MAX32690
+P56               , Connect WiFi UART RX to MAX32690
+P51               , Position 1-2: Set programmer voltage to 3V3 (normal operation mode)
+                  , Position 2-3: Set programmer voltage to 1V8 (WiFi chip programming)
+JP12              , Position 1-2: To use the Low Power UART0RX port for programming and debugging
+                  , Position 2-3: to use the normal UART0RX port for programming and debugging
+JP13              , Position 1-2: To use the Low Power UART0TX port for programming and debugging
+                  , Position 2-3: to use the normal UART0TX port for programming and debugging
+Connectors        ,
+P1                , 10BASE-T1L
+P10               , USB-C Power & Data
+P14               , External Power 5V-28V
+P9                , SWD Programmer
+P58               , RISC-V Programmer
+P11               , SPOE Shield ISO GND
+P16               , SPOE Shield PI+
+P17               , SPOE Shield PI-
+P53               , SPOE Shield PI+
+P54               , SPOE Shield PI-
+P12               , SPOE Shield Data TRX N
+P15               , SPOE Shield Data TRX P
+P8                , SPI PMOD
+P13               , I2C PMOD
+P2                , Arduino Connector - Power
+P3                , Arduino Connector - Analog
+P4                , Arduino Connector - SPI / I2S
+P5                , Arduino Connector - SPI & I2C
+P6                , Arduino Connector - UART
+P7                , Arduino Connector - GPIO & CAN
diff --git a/docs/solutions/reference-designs/ad-apard32690-sl/specifications.csv b/docs/solutions/reference-designs/ad-apard32690-sl/specifications.csv
@@ -1,13 +1,13 @@
 ﻿Computing Resources,
-CPU,MAX32690 Ultralow Power ARM Cortex-M4 with FPU-Based Microcontroller (MCU) with 3 MB Flash and 1 MB SRAM
-Memory,1 Gb RAM
-Storage,64 Mb QSPI Flash
-Security,MAXQ1065 Ultralow Power Cryptographic Controller with ChipDNATM
-Connectivity,
-Ethernet,"ADIN1110 Robust, Industrial, Low Power 10BASE-T1L Ethernet MAC-PHY"
-WiFi,"NINA-W102 - IEEE 802.11b, IEEE 802.11g, IEEE 802.11n"
-Bluetooth,Bluetooth 5.2 LE Radio
-USB,USB 2.0
-Power supply,
-External power,5V DC to 28V DC
-USB-C,"5 V at 3 A, without power negotiation"
+CPU                , MAX32690 Ultralow Power ARM Cortex-M4 with FPU-Based Microcontroller (MCU) with 3 MB Flash and 1 MB SRAM
+Memory             , 1 Gb RAM
+Storage            , 64 Mb QSPI Flash
+Security           , MAXQ1065 Ultralow Power Cryptographic Controller with ChipDNATM
+Connectivity       ,
+Ethernet           , "ADIN1110 Robust, Industrial, Low Power 10BASE-T1L Ethernet MAC-PHY"
+WiFi               , "NINA-W102 - IEEE 802.11b, IEEE 802.11g, IEEE 802.11n"
+Bluetooth          , Bluetooth 5.2 LE Radio
+USB                , USB 2.0
+Power supply       ,
+External power     , 5V DC to 28V DC
+USB-C              , "5 V at 3 A, without power negotiation"
