Software Examples

Overview

The AD-EthernetAPLDevice-SL board supports two main categories of software examples, available through public repositories. Both example sets are designed to be compiled using Code Fusion Studio (CFS) for optimal compatibility and ease of use.

Prerequisites

Updating the Firmware

The on-board MAX32690 microcontroller’s firmware must be updated to ensure compatibility with the latest software examples. To update the firmware, use the MAX32625PICO programmer before programming the AD-EthernetAPLDevice-SL board itself.

Requirements:

  • MAX32625PICO programmer

  • Micro-USB cable

  • Host PC with USB port

  • 10-pin ribbon cable (for connecting the MAX32625PICO to the AD-EthernetAPLDevice-SL)

First, flash a new bootloader onto the MAX32625PICO:

  1. Download the firmware image: MAX32625PICO firmware

  2. Enter MAINTENANCE mode on the MAX32625PICO:

    • Ensure the MAX32625PICO is disconnected from both the PC and the AD-EthernetAPLDevice-SL.

    • Connect only the micro-USB cable to the MAX32625PICO.

    • Press and hold the button on the MAX32625PICO.

    • While holding the button, connect the USB cable to the PC.

    • Release the button once the MAINTENANCE drive appears.

  3. Copy the downloaded firmware image to the MAINTENANCE drive.

  4. Wait until the MAINTENANCE drive disappears and is replaced by a drive named DAPLINK. The bootloader update is complete.

Programming the AD-EthernetAPLDevice-SL

  1. Connect the MAX32625PICO to the PC using the micro-USB cable.

  2. Connect the MAX32625PICO to the AD-EthernetAPLDevice-SL board using the 10-pin ribbon cable.

  3. Power on the AD-EthernetAPLDevice-SL.

  4. Verify that a DAPLINK drive appears on the PC.

  5. Copy the new firmware image to the DAPLINK drive and wait for the drive to remount.

  6. Open the DAPLINK drive and check for a FAIL.TXT file. If FAIL.TXT is present, repeat the copy step. If not, safely disconnect the MAX32625PICO from the AD-EthernetAPLDevice-SL; the firmware update is complete.

Code Fusion Studio Installation

Before working with any examples, you’ll need to install Code Fusion Studio:

Security Considerations

While the examples don’t require TESA access, the board is fully compatible with additional security mechanisms. For enhanced security features:

MSDK Examples

The MSDK examples demonstrate peripheral usage through the Maxim HAL interface. These examples are automatically installed with Code Fusion Studio.

Loading MSDK Examples

  1. Open Visual Studio Code.

  2. Click Browse MSDK examples.

    https://media.githubusercontent.com/media/analogdevicesinc/documentation/main/docs/solutions/reference-designs/ad-ethernetapldevice-sl/software-example/browse-msdk.png

  3. Navigate to the MAX32690 folder.

  4. Select your desired example folder.

  5. Click SELECT EXAMPLE.

    https://media.githubusercontent.com/media/analogdevicesinc/documentation/main/docs/solutions/reference-designs/ad-ethernetapldevice-sl/software-example/select-example.png

  6. Choose your import destination folder.

    https://media.githubusercontent.com/media/analogdevicesinc/documentation/main/docs/solutions/reference-designs/ad-ethernetapldevice-sl/software-example/destination-folder.png

  7. Edit the makefile:

    • Set SBT = 0 to enable binary signature process

    • Save the file

    https://media.githubusercontent.com/media/analogdevicesinc/documentation/main/docs/solutions/reference-designs/ad-ethernetapldevice-sl/software-example/makefile-config.png

  8. Click the Build button to compile.

    https://media.githubusercontent.com/media/analogdevicesinc/documentation/main/docs/solutions/reference-designs/ad-ethernetapldevice-sl/software-example/build.png

no-OS Examples

The no-OS examples are specifically designed for the AD-EthernetAPLDevice-SL board and utilize the no-OS HAL for direct hardware access.

Loading no-OS Examples

  1. Follow the build guide.

  2. Switch to the appropriate branch using Git Bash:

    git switch release/hockey_puck

  3. Refer to the repository’s readme file for specific Code Fusion Studio loading instructions

Note

Set SBT = 0 in the makefile to disable firmware digital signature verification.