Jump to main content

# 1.3.6.2 Bootloader and Application Binary Merge Script Help

Downloading the host script

To clone or download these host tools 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 MCC content manager.

Path of the tool within the repository is tools/btl_app_merge_bin.py.

Setting up the Host PC

- The Script is compatible with Python 3.x and higher

Description

- This script should be used to merge the bootloader binary and application binary

- It creates a merged binary output where bootloader is placed from start and the application will be placed at the offset passed as parameter

- If the application offset is not equal to end of bootloader offset it fills the gap with 0xFF until the application offset

- The merged binary can be used by btl_host.py as input for Updating bootloader and application together

- The merged binary will be created in the directory from where the script was called

Usage Examples

Below is the syntax to show help menu for the script:

    python <harmony3_path>/bootloader/tools/btl_app_merge_bin.py --help

Below is the syntax and an example on how to merge a bootloader binary and application binary:

    python <harmony3_path>/bootloader/tools/btl_app_merge_bin.py -o <Offset> -b <Bootloader_binary_path> -a <Application_binary_path>

    python <harmony3_path>/bootloader/tools/btl_app_merge_bin.py -o 0x2000 -b <harmony3_path>/bootloader_apps_uart/apps/uart_fail_safe_bootloader/bootloader/firmware/sam_e54_xpro.X/dist/sam_e54_xpro/production/sam_e54_xpro.X.production.bin -a <harmony3_path>/bootloader_apps_uart/apps/uart_fail_safe_bootloader/test_app/firmware/sam_e54_xpro.X/dist/sam_e54_xpro/production/sam_e54_xpro.X.production.bin

    python <harmony3_path>/bootloader/tools/btl_host.py -v -s -i COM18 -d same5x -a 0x80000 -f <Path_to_merged_binary>/btl_app_merged.bin

Rev: G