Two implementation methods are provided: GUI and CLI.

Terminology Explanation: Terminology Explanation

Download all-app.bin

  1. Using CLI

    .\bk_loader.exe download -p COM11 -b 1500000 --reset_baudrate 115200 -i D:/all-app.bin --reboot

  • .\bk_loader.exe: CLI tool path

  • download: download

  • -p: Serial port name

  • -b: Working baud rate

  • --reset_baudrate: Reset baud rate

  • -i: bin file path

  • --reboot: Reboot device after download completes

  1. Using GUI

  • Select all-app.bin file

../../_images/download_all_app.png

Download the first 8K data of all-app.bin to flash address 0x1000

  1. Using CLI

    .\bk_loader.exe download -p COM11 -b 1500000 --reset_baudrate 115200 -i D:/all-app.bin@0x1000-0x2000 --reboot

  • -i: bin file path

  • D:/all-app.bin@0x1000-0x2000 format: path@addr-length
    • path: bin file path

    • addr: flash start address

    • length: length to operate

  1. Using GUI

  • Select all-app.bin file

  • Edit region

../../_images/download_all_app_pre_8k_1.png
../../_images/download_all_app_pre_8k_2.png
../../_images/download_all_app_pre_8k_3.png

Download bootloader-ota.bin

bootlader-ota.bin is used to upgrade bootloader

  1. Using command line:

    .\bk_loader.exe download -p COM11 -b 1500000 --reset_baudrate 115200 -i D:/bootloader-ota.bin --reboot

  2. Using GUI

  • Select bootloader-ota.bin file

../../_images/download_bootloader_ota.png

Download all-app-outter-flash.bin

all-app-outter-flash.bin can be used to download external flash

  1. Using command line:

    .\bk_loader.exe download -p COM11 -b 1500000 --reset_baudrate 115200 -i D:/all-app-outter-flash.bin --reboot

  2. Using GUI

  • Select all-app-outter-flash.bin file

../../_images/download_outter_flash.png

Download Device Name

Device name example, in string format, downloaded to flash address 0x1000 with big-endian byte order.

  1. Using CLI

    .\bk_loader.exe download -p COM11 -b 1500000 --reset_baudrate 115200 --expand_data device_name@3@0x1000@example --reboot

  • --expand_data: Extended data

  • Extended data format name@type@addr@data
    • name: Extended data name

    • type: Extended data type

    • addr: Flash address

    • data: Extended data value

Extended data: Extended Data

  1. Using GUI

  • Add extended data

  • Fill in name, type, address, data

Warning

No spaces allowed in the name.

../../_images/download_device_name_1.png
../../_images/download_device_name_2.png

Download Device MAC Address

Device MAC address is feda10, in hexadecimal format, downloaded to flash address 0x1000 with little-endian byte order.

  1. Using CLI

    .\bk_loader.exe download -p COM11 -b 1500000 --reset_baudrate 115200 --expand_data device_mac@0@0x1000@feda10 --reboot

  2. Using GUI

  • Add extended data

  • Fill in name, byte order, address, data

../../_images/download_device_mac.png

Download Extended Data

  1. Using CLI .\bk_loader.exe download -p COM11 -b 1500000 --reset_baudrate 115200 --expand_data name@type@addr@value --reboot

  • name: Extended data name

  • type: Byte order

  • addr: Extended data address

  • value: Extended data value

  1. Using GUI

  • Add extended data

  • Fill in name, byte order, address, data

../../_images/download_expand_data_1.png
../../_images/download_expand_data_2.png

Download eFuse to OTP Area

eFuse file is in JSON format

  1. Using CLI

    .\bk_loader.exe download -p COM11 -b 1500000 --reset_baudrate 115200 --safe_json D:/safe.json --reboot

  • --safe_json: eFuse file path

  1. Using GUI

  • Select eFuse file

Warning

Warning: OTP data cannot be modified once downloaded. Please ensure the data content is completely correct before performing the download operation!

../../_images/download_efuse.png

Erase All Flash Data

  1. Using CLI

    .\bk_loader.exe erase -p COM11 -b 1500000 --reset_baudrate 115200 --chip_all --reboot

  • erase: Erase

  • --chip_all: All flash

  • --reboot: Reboot device after erase completes

  1. Using GUI

  • Select full erase

Warning

Warning: Flash contains important calibration data. Please ensure the correctness of the erase area.

../../_images/erase_all.png

Erase Specified Flash Area Data

  1. Using CLI

    .\bk_loader.exe erase -p COM11 -b 1500000 --reset_baudrate 115200 -f 0x1000-0x2000,0x3000-0x4000 --reboot

  • erase: Erase

  • -f: Specify the flash area to erase

  • Format: -f:addr1-length1,addr2-length2
    • addr1: Start address of the flash area to erase

    • length1: Length of the flash area to erase

    • addr2: Start address of the flash area to erase

    • length2: Length of the flash area to erase

  1. Using GUI

  • Fill in the area

  • Start erasing

../../_images/erase_custom_1.png
../../_images/erase_custom_2.png

Read eFuse

  1. Using CLI

    .\bk_loader.exe read -p COM11 -b 1500000 --reset_baudrate 115200 --read_efuse 0-0 --reboot

  • read: Read

  • --read_efuse: Read eFuse

  • 0-0: Read all eFuse

  1. Using GUI

  • Select read eFuse

../../_images/read_efuse.png

Read All Flash Data

  1. Using CLI

    .\bk_loader.exe read -p COM11 -b 1500000 --reset_baudrate 115200 --chip_all --reboot

  • --reboot: Reboot device after read completes

  1. Using GUI

  • Select all flash

../../_images/read_all.png

Read Specified Flash Area

  1. Using CLI

    .\bk_loader.exe read -p COM11 -b 1500000 --reset_baudrate 115200 0 -f 0x0-0x1000,0x2000-0x3000 --reboot

  2. Using GUI

  • Fill in the area

../../_images/read_custom_1.png
../../_images/read_custom_2.png