SAM9X60-EK – Configure and Build at91bootstrap for an MPLAB® Harmony 3 Project with MPLAB X IDE
Introduction
This training topic describes configuring and building at91bootstrap for loading and debugging an MPLAB® Harmony 3 project on the SAM9X60-EK Evaluation Kit using the MPLAB X Integrated Development Environment (IDE).
Background
The at91bootstrap is used by MPLAB X IDE to initialize DRAM so that it can continue loading the MPLAB Harmony 3 Software Framework project binary (harmony.bin). Once the project has been loaded onto the SAM9X60-EK, MPLAB X IDE can be used to develop and debug the application.
Prerequisites
The following are prerequisites for this training:
Download at91bootstrap
Create a Project Directory.
For the purposes of this training topic, we’ll name our project directory "at91bootstrap".
Download or clone at91bootstrap version 4.
Download or clone from the Linux4sam GitHub repository.
Open Project at91bootstrap
From MPLAB X IDE, select File > Open Project…
An Open Project dialog is displayed.
Find and select the at91bootstrap project directory.
Click on the Open Project button.
The at91bootstrap project will be displayed in the Projects pane (upper left) and the at91bootstrap – Dashboard pane (bottom left).
Configure at91bootstrap Project Properties
Open at91bootstrap Project Properties.
Open the at91bootstrap Project Properties using one of the following methods:
- In the Projects pane, highlight at91bootstrap and click on the wrench icon in the at91bootstrap - Dashboard.
- In the Projects pane, right-click on at91bootstrap and select Properties from the menu.
The Projects Properties – at91bootstrap dialog box opens.
Configure the XC32 Compiler.
In the Categories pane, select Makefile.
Enter the following text in the Build command and Debug build command boxes:
make CROSS_COMPILE="C:/Program Files/Microchip/xc32/v4.21/bin/bin/pic32c-"
Enter the following text in the Clean command box:
make mplabclean CROSS_COMPILE="C:/Program Files/Microchip/xc32/v4.21/bin/bin/pic32c-"
Configure at91bootstrap
Click on the Open button.
Observe the following settings:
Expand Primary Operation and observe the Configure and stop radio button.
Expand DRAM. Next, expand DRAM parts and select the DDR2 DDR_W972GG6KB (SAM9X60-EK) radio button.
Scroll down and expand Board’s Workaround Options. Expand Workaround for Board Quirks and select the Quirks for SAM9X60-EK board radio button.
Click on the Apply button and then the OK button.
The Project Properties dialog will close.
Build at91bootstrap
Build at91bootstrap.
Build the at91bootstrap project using one of the following methods:
- In the Projects pane, right-click on at91bootstrap and select Build from the menu
- Click on the Build icon (hammer) in the tool ribbon.
Observe the build is successful.
Note the location of at91bootstrap.elf:
<project_directory>\at91bootstrap\build\binaries\at91bootstrap.elf
Summary
The at91bootstrap has been configured and built to load and debug an MPLAB Harmony 3 Software Framework project using the MPLAB X IDE for the SAM9X60-EK Evaluation Kit.
What’s Next?
Once at91bootstrap has been configured and built, it can be used with an MPLAB Harmony 3 Software Framework project. The at91bootstrap.elf file is configured in the Project Properties as shown in the example figure below.
MPLAB X IDE uses at91bootstrap to initialize DRAM and continue loading the MPLAB Harmony 3 application binary image (harmony.bin) using a Debug Probe. Once the project has been loaded onto the SAM9X60-EK, MPLAB X IDE can be used to develop and debug the application.
For training topics on configuring and building at91bootstrap to load from Non-Volatile Memories (NVM), see:
Second-Stage Bootloader at91bootstrap
- SAM9X60-EK – Configure and Build at91bootstrap to Load an MPLAB Harmony 3 Application from NAND Flash Memory
- SAM9X60-EK – Configure and Build at91bootstrap to Load an MPLAB Harmony 3 Application from NOR Flash (QSPI) Memory
- SAM9X60-EK – Configure and Build at91bootstrap to Load an MPLAB Harmony 3 Application from SD Memory Card