1.3.4 SAMA5D2 Xplained Ultra Evaluation Kit: Building and Running the UART Bootloader With SD/eMMC Media Applications
Downloading and Building the Application
To clone or download this application from Github, go to the main page of this repository and then click Clone button to clone this repo or download as zip file. This content can also be download using content manager by following these instructions.
Path of the application within the repository is apps/mpu_uart_bootloader/.
To build the application, refer to the following table and open the project using its IDE.
Bootloader Application
| Project Name | Description |
|---|---|
| bootloader_sd_emmc/firmware/sam_a5d2_xult.X | MPLAB X Project for SAMA5D2 Xplained Ultra Evaluation Kit |
Test Application
| Project Name | Description |
|---|---|
| test_app/firmware/sam_a5d2_xult.X | MPLAB X Project for SAMA5D2 Xplained Ultra Evaluation Kit |
Setting Up SAMA5D2 Xplained Ultra Evaluation Kit
- Short jumper JP2 (DEBUG_DIS)
- Connect the Debug USB port on the board to the computer using a micro USB cable
- SD card with FAT32 file system
Setting Up the Host Script
- Refer to the Bootloader Host Script Help for setting up the btl_host.py utility used to send the application binary from host PC
Running the Application
-
Open the test application project test_app/firmware/sam_a5d2_xult.X in the IDE.
-
Build the project to generate the harmony.bin binary (Do not program the binary).
-
Open the bootloader project bootloader_sd_emmc/firmware/sam_a5d2_xult.X in the IDE.
-
Build the project to generate the harmony_bootloader.bin binary (Do not program the binary).
-
Copy the MPU bootstrap loader binary (boot.bin) from <harmony3_path>/bootloader_apps_uart/deps/at91bootstrap_binaries_sam_a5d2_xult/sd_card/boot.bin onto the SD card.
-
Copy the harmony bootloader binary (harmony_bootloader.bin) from <harmony3_path>/bootloader_apps_uart/apps/mpu_uart_bootloader/bootloader_sd_emmc/firmware/sam_a5d2_xult.X/dist/sam_a5d2_xult/production/harmony_bootloader.bin onto the SD card.
-
Insert the SD card into SDMMC1 connector J19 on the board.
-
Reset or Power cycle the device. Green LED will be turned-on to indicate that harmony bootloader code is running on the target.
-
Run the btl_host.py from command prompt to program the application binary.
python <harmony3_path>/bootloader/tools/btl_host.py -v -i <COM PORT> -d sama5 -f <harmony3_path>/bootloader_apps_uart/apps/mpu_uart_bootloader/test_app/firmware/sam_a5d2_xult.X/dist/sam_a5d2_xult/production/harmony.bin
-
Following figure shows output of successfully programming the test application.
- Rebooting and Reboot Done messages in below output signifies that bootloading is successful

-
If above step is successful then the Green LED should start blinking.
-
Open the Terminal application (e.g., Tera Term) on the computer.
-
Configure the serial port settings as follows:
- Baud: 115200
- Data: 8 Bits
- Parity: None
- Stop: 1 Bit
- Flow Control: None
-
Reset or Power cycle the device.
-
Green LED should start blinking and the user should see below output on the console.

-
Press and hold the Switch PB_USER and then press Reset button or Power cycle the device to force trigger bootloader at startup.
-
Repeat Steps 9-15 once.
- This step is to verify whether bootloader is triggered by switch press at reset
Additional Steps (Optional)
- To bootload any other application, refer to the Configuring an Application to Be Bootloaded for MPUs
