Building and Running the UART Bootloader 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/uart_bootloader/
To build the application, refer to the following table and open the project using its IDE.
Bootloader Application
Project Name | Description |
---|---|
bootloader/firmware/sam_ha1_xpro.X | MPLABX Project for SAM HA1G16A Xplained Pro |
Test Application
Project Name | Description |
---|---|
test_app/firmware/sam_ha1_xpro.X | MPLABX Project for SAM HA1G16A Xplained Pro |
Setting up SAM HA1G16A Xplained Pro
- Connect the Debug USB port on the board to the computer using a micro USB cable
Note
- ATSAMHA1G16A device in SAM HA1G16A Xplained Pro board is not recommended for new design, hence replace the device with ATSAMHA1G16AB device
- Connect the supported external debugger to Cortex Debug Port
Setting up the host script
- Refer to 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_ha1_xpro.X in the IDE
- Build the project to generate the binary (Do not program the binary)
- Open the bootloader project bootloader/firmware/sam_ha1_xpro.X in the IDE
-
Build and program the application using the IDE
-
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 samha1 -a 0x800 -f <harmony3_path>\bootloader_apps_uart\apps\uart_bootloader\test_app\firmware\sam_ha1_xpro.X\dist\sam_ha1_xpro\production\sam_ha1_xpro.X.production.bin
- Following snapshot 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 LED0 should start blinking
- Open the Terminal application (Ex.: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
-
LED0 should start blinking and you should see below output on the console
-
Press and hold the Switch SW0 to trigger Bootloader from test application and you should see below output
- Repeat Steps 5-11 once and jump to Step-14.
- This step is to verify that bootloader is running after triggering bootloader from test application in Step 12
- Press and hold the Switch SW0 and then press Reset button or Power cycle the device to force trigger bootloader at startup
- Repeat Steps 5-11 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 Application Configurations
-
Once done repeat the applicable steps mentioned in Running The Application