edit

How to use Arduino Boards as DAPLink Device

Arm Mbed DAPLink is an open source software project that programs and debugs application software running on Arm Cortex CPUs. DAPLink is often referred to as interface firmware and runs on an auxiliary MCU connected to the SWD or JTAG port of the application MCU. This configuration is available on almost all development boards. It creates a bridge between your development computer and the CPU debug access port.

Please also visit DAPLink for more information.

Now, we have developed the DAPLink firmware running on your Arduino Boards(SAMD Series) such as Wio Terminal and Seeeduino Xiao so that you can upload and debug development boards that support DAPLink in a most cost-effective way!

Features

  • Debug and Flash Arm Cortex CPUs
  • Provides a virtual serial port, eliminating the need for a usb to serial port
  • Drag and drop to upload firmware(coming soon)

Supported Boards

It supports all the SAMD boards by Seeed:

Note

Please make sure you have installed the latest ArduinoSAMD board library for Seeed (>=1.8.1) for this to work!

Get Started

  1. Visit the Seeed_Arduino_DAPLink repositories and download the entire repo to your local drive.

  2. Now, the Seeed_Arduino_DAPLink library can be installed to the Arduino IDE. Open the Arduino IDE, and click sketch -> Include Library -> Add .ZIP Library, and choose the Seeed_Arduino_DAPLink file that you've have just downloaded.

InstallLibrary

2. Installing the Adafruit_TinyUSB_Arduino Library

  1. Visit the Adafruit_TinyUSB_Arduino repositories and download the entire repo to your local drive.

  2. Now, the Adafruit_TinyUSB_Arduino library can be installed to the Arduino IDE. Open the Arduino IDE, and click sketch -> Include Library -> Add .ZIP Library, and choose the Adafruit_TinyUSB_Arduino file that you've have just downloaded.

Customizing Pin Definitions

If you are using Wio Terminal or Seeeduino Xiao, you may skip this section and just use the default definitions.

  • The pins definitions for DAPLink is defined in DAP_config.h under Seeed_Arduino_DAPLink/src, reference the followings:

Upload to Arduino Boards

Open the simple_daplink.ino under Seeed_Arduino_DAPLink/example using Arduino IDE. Under Tools -> USB Stack and choose TinyUSB.

Compile and upload the code!

Hardware Connection Example

In this wiki, we have used the STM32F410RB development board as connection example:

If you have changed pinout definitions, please connect according to your own defines.

  • Seeeduino Xiao Connection Example
  • Wio Terminal Connection Example

Debug and Flash Example for IDEs

Our Arduino board now becomes our DAPLink device for uploading for MCUs! Let's have some examples for different IDEs for reference.

Debugging with OpenOCD

  • Connect the Arduino DAPLink to target Development according to the connection above, and to your PC.

  • Make sure you have installed OpenOCD.

  • Open Terminal and run the following:

Change to your device target according to your development board, you may check the official document for reference.

openocd -f interface/cmsis-dap.cfg -f target/stm32f4x.cfg
  • Under your development board project build path, run the gcc, which looks something like below:
  • under gdb, connect to local host by running the following:
target remote 127.0.0.1:3333
  • Now the development board is connected, you may start to debug or upload!

Run load to upload to development board:

Some useful commands for GDB:

  • continue/cont
  • Ctrl+C
  • next
  • break
  • info break
  • clear
  • delete
  • list

Debugging with Eclipse

For Eclipse, it's very similar to the OpenOCD as it can use the OpenOCD as backend.

  • Navigate to Help -> Eclipse Marketplace, search and download Eclipse Embedded CDT:
  • Navigate to Window -> Preference -> MCU -> Global OpenOCD Path and fill in your OpenOCD path as follow:
  • Build your project. Under Run Last Tool, click on External Tools Configurations:
  • Copy the following settings, please change to your path (also your target board).

If it goes well, it should look something like this:

  • Under Debug, click Debug Configurations, select Debugger section, and fill in your gcc path:

Now it's all good and ready to debug!

More reference, please check here.

Debugging with Keil

  • Connect the Arduino DAPLink to target Development according to the connection above and to your PC.

To use our Arduino DAPLink in Keil, check the following:

  • Open your project with Keil, click on the Options for target.

You should see a window just like below. Make sure the device matches with your device. Navigate to Debug section and select CMSIS-DAP Debugger.

  • Click on the settings next to the CMSIS-DAP Debugger.
  • Choose Seeed CMSIS-DAP(our Arduino board) and you should see that it's connected.
  • You may also want to navigate to the Flash Download section to make sure it's the right device and Click OK.
  • Click on Build and Flash!

Debugging with IAR Embedded Workbench

  • Connect the Arduino DAPLink to target Development according to the connection above and to your PC.

  • Open your project, and navigate to Project -> Options. In the Options menu, select Debugger:

  • In the Setup tab, select CMSIS DAP from the Driver drop-down menu.
  • In the Download tab, check Verify download and Use flash loader(s)
  • Select CMSIS DAP from the menu on the left, select the Interface tab and configure the SWD protocol.
  • Click OK, and you can click Download and Debug!

Serial Usage

To make life easier, we also implemented a USB to Serial function to the Arduino Sketch which saves you the need of additional hardware!

  • By default, it is defined as Serial1 and it's the Hardware Serial pins. For example, it's pin 6 and 7 for Seeeduino XIAO.

Note

You may define your own Serial in the Arduino Sketch.

Reference usage, check here.

Resources

Tech Support

Please submit any technical issue into our forum