Jump to main content

##

# 1.1.13 SAM D20 Xplained Pro Evaluation Kit: Building and Running the I2C Bootloader applications

Path of the application within the repository is apps/i2c_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_d20_xpro.X | MPLABX Project for SAM D20 Xplained Pro Evaluation Kit

Test Application

Project Name | Description
--- | ---
test_app/firmware/sam_d20_xpro.X | MPLABX Project for SAM D20 Xplained Pro Evaluation Kit

Setting up SAM D20 Xplained Pro Evaluation Kit

- SAM D20 Xplained Pro Evaluation Kit is used for both Host Development kit and Target Development kit

- Connect the I2C SDA line Pin 11 (SERCOM2 PAD/PA08) on EXT1 of the Host development kit to the I2C SDA line Pin 11 (SERCOM2 PAD/PA08) on EXT1 of the Target development kit

- Connect the I2C SCL line Pin 12 (SERCOM2 PAD/PA09) on EXT1 of the Host development kit to the I2C SCL line Pin 12 (SERCOM2 PAD/PA09) on EXT1 of the Target development kit

- Connect a ground wire between the Host development kit and Target development kit

- Connect the Debug USB port on the Host development kit to the computer using a micro USB cable

- Connect the Debug USB port on the Target development kit to the computer using a micro USB cable

Building and Configuring I2C Host Applications

Using I2C NVM Host application to send the application binary to Target development kit

If the NVM Host Development Kit being used is other than SAM D20 Xplained Pro Evaluation Kit then follow the steps mentioned in Configuring NVM Host application project

1. Open the NVM host application project host_app_nvm/firmware/sam_d20_xpro.X in the IDE

   - If a NVM host application project of different development kit is used then open that project in the IDE

2. Build and program the NVM host application using the IDE on to the Host development kit

   - The prebuilt test application image available under host_app_nvm/firmware/src/test_app_images/image_pattern_hex_sam_d20_xpro.h will be programmed on to the Target development kit with default host_app_nvm project configuration

3. Jump to Running The Application

Running the Application

1. Open the bootloader project bootloader/firmware/sam_d20_xpro.X in the IDE

2. Build and program the application using the IDE on to the Target development kit

   - LED0 will be turned-on to indicate that bootloader code is running on the target
   - LED0 will also turn on when the bootloader does not find a valid application; i.e. the first word of the application (stack pointer), contains 0xFFFFFFFF

3. If the test application is being programmed, Open the Terminal application (Ex.:Tera Term) on the computer and configure the serial port settings for Target Development kit as follows:

   - Baud : 115200
   - Data : 8 Bits
   - Parity : None
   - Stop : 1 Bit
   - Flow Control : None

4. Press the Switch SW0 on the Host development kit to trigger programming of the application binary

5. Once the programming is complete,

   - LED0 on the Host development kit will be turned on indicating success

   - The target development kit will be reset. Upon re-start, the boot-loader will jump to the user application

   - If the test application is programmed then LED0 should start blinking and you should see below output on the Target development kit console

6. Press and hold the Switch SW0 to trigger Bootloader from test application and you should see below output

7. Press Reset button on the Host development kit to reprogram the application binary

8. Repeat Steps 4-5 once

   - This step is to verify that bootloader is running after triggering bootloader from test application in Step 6

Additional Steps (Optional)

Using I2C NVM Host application

- To bootload any application other than host_app_nvm/firmware/src/test_app_images/image_pattern_hex_sam_d20_xpro.h refer to Application Configurations

- Once the application is configured, Refer to Configuring NVM Host application project for setting up the host_app_nvm project

- Once done repeat the applicable steps mentioned in Running The Application