1.4.2 FUSE bit binary file Script Help

This document describes the usage of btl_fuse_bin_gen.py host script

Path of the tool in bootloader repository is tools/btl_fuse_bin_gen.py

Setting up the Host PC

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

Description

  • This script extracts specific memory address ranges from an HEX file.

  • The memory ranges to extract are based on the selected device type..

  • It takes the input hex file, target device, and output binary file as command-line arguments.

  • It creates a (-f) filtered hex file and converts it into a (-o) binary file for use in programming only the fuse section.

Usage Examples

Below is the syntax to show help menu for the script

python <harmony3_path>/bootloader/tools/btl_fuse_bin_gen.py --help
btl_host_help_menu

Basic syntax and example for generating fuse binary file

Below syntax and example can be used to generate fuse binary file from HexFile

python <harmony3_path>\bootloader\tools\btl_fuse_bin_gen.py -d <device> -f <secure_application_hex_path> -o <output_path>

Below syntax and example can be used for PIC32CM_SG00_CPRO

FACTORY PROGRAMMED TRUSTZONE UART BOOTLAODER

python <harmony3_path>\bootloader\tools\btl_fuse_bin_gen.py -d PIC32CM_GC00_SG00 -f <harmony3_path>\bootloader_apps_pic32cm_sg_gc\apps\trustzone\images\pic32cm_sg_curiosity_pro_secure_with_fuse.X.production.hex -o devcfg.bin

TRUSTZONE UART BOOTLOADER

python <harmony3_path>\bootloader\tools\btl_fuse_bin_gen.py -d PIC32CM_GC00_SG00 -f <harmony3_path>\bootloader_apps_uart\apps\uart_bootloader\test_app\pic32cm_sg00_curiosity_pro_trustzone\pic32cm_sg00_curiosity_pro_secure\pic32cm_sg00_secure.X\dist\default\production\pic32cm_sg00_secure.X.production.hex -o devcfg.bin

Below syntax and example can be used for PIC32CK_SG01_CULT

TRUSTZONE UART BOOTLOADER

python <harmony3_path>\bootloader\tools\btl_fuse_bin_gen.py -d PIC32CK_GC01_SG01 -f <harmony3_path>bootloader_apps_uart\apps\uart_bootloader\test_app\pic32ck_sg01_cult_trustzone\pic32ck_sg01_cult_secure\pic32ck_sg01_cult_secure.X\dist\default\production\pic32ck_sg01_cult_secure.X.production.hex  -o devcfg.bin