1.6.5 WBZ451 Curiosity Development Board: Building and Running the File System based QSPI Flash 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/fs/qspi/
To build the application, refer to the following table and open the project using its IDE.
Bootloader Application
Project Name | Description |
---|---|
bootloader/wbz451_curiosity.X | MPLABX Project for WBZ451 Curiosity Development Board |
Programmer application
Project Name | Description |
---|---|
app_programmer/wbz451_curiosity.X | MPLABX Project for WBZ451 Curiosity Development Board |
Setting up WBZ451 Curiosity Development Board
To run the demo, the following additional hardware are required:
One microSD click
One micro SD Card
Install the microSD click on to the mikroBUS Header J4 of the device
Connect the Debug USB port on the board to the computer using a micro USB cable
Running the Application
Open the bootloader project bootloader/wbz451_curiosity.X in the IDE
Make sure that the app_programmer/wbz451_curiosity.X is added as a loadable project to bootloader application
As the QSPI Flash memory may not have any valid binary required by bootloader for the first time, Adding the app_programmer as loadable allows MPLAB X to create a unified hex file and program both these applications in their respective memory locations based on their linker script configurations
Open the Terminal application (Ex.:Tera Term) on the computer to get programmer application messages through UART once loaded
Configure the serial port settings as follows:
Baud : 115200
Data : 8 Bits
Parity : None
Stop : 1 Bit
Flow Control : None
Build and program the bootloader application using the IDE
Once programming is done bootloader starts execution and directly jumps to application space to run the programmer application
LED0 starts blinking indicating that the programmer application is running and you should see below output on the console
Open the programmer application project app_programmer/wbz451_curiosity.X in the IDE
Update app_programmer/firmware/src/app_monitor.c to update printf message from Serial Memory to QSPI Flash Memory as below
printf("\r\n###### File System (QSPI Flash Memory) Programmer Application Running ######\r\n");
Clean and Build the project to generate the binary (Do not program the binary)
Copy the generated application binary file to a sdcard from the Host PC
<harmony3_path>/bootloader_apps_serial_memory/apps/fs/qspi/app_programmer/wbz451_curiosity.X/dist/wbz451_curiosity/production/wbz451_curiosity.X.production.bin
Rename the copied application binary file to image.bin
Insert the sdcard with the application binary image.bin in the sdcard slot of the device
Following snapshot shows output of successfully copying the programmer application binary to QSPI Flash Memory
LED0 should still be blinking
Remove the sdcard from the sdcard slot
Press and hold the Switch SW0 to trigger Bootloader from programmer application and you should see below output
Once Firmware Update is successful LED0 should start blinking indicating updated programmer application running and you should see below output on the console
Additional Steps (Optional)
To bootload any other application refer to Application Configurations
Note - This application should have programming capabilities to QSPI Flash Memory
Application vector table need to be placed in the FLASH memory (from BOOT_FLASH to FLASH memory)
Once done repeat the applicable steps mentioned in Running The Application