Damian Michalak-Szmaciński e5c1a3bb52 [nrfconnect] Add to flake8 in workflow and fix python files (#25277) 2 tahun lalu
..
README.md 361893368c [GN] ESP32 flashing support (#2903) 5 tahun lalu
bouffalolab_firmware_utils.py d5bfb4b38f Add isort formatter to restyled configuration (#24148) 3 tahun lalu
cyw30739_firmware_utils.py 1af90eb88e Infineon CYW30739 - lighting-app support (#13491) 4 tahun lalu
efr32_firmware_utils.py 89fc8211b4 [Silabs] Add Support for Modules for Matter (#22793) 3 tahun lalu
esp32_firmware_utils.py 69e96c9202 Fix unexpected firmware selection by flashing scripts (#12345) 4 tahun lalu
firmware_utils.py d5bfb4b38f Add isort formatter to restyled configuration (#24148) 3 tahun lalu
gen_flashing_script.py bcf67b3ae7 Flashing wrappers need python3 (#2710) 5 tahun lalu
nrfconnect_firmware_utils.py e5c1a3bb52 [nrfconnect] Add to flake8 in workflow and fix python files (#25277) 2 tahun lalu
psoc6_firmware_utils.py ab028397da [Infineon] Restructure p6 and cyw30739 devices to single folder (#21926) 3 tahun lalu
qpg_firmware_utils.py d5bfb4b38f Add isort formatter to restyled configuration (#24148) 3 tahun lalu

README.md

Flashing Scripts

Using

\${TARGET}.flash.py

When a build target has a corresponding .flash.py script, that script can be run to flash the target to an attached device.

This is really just a wrapper around ${PLATFORM}_firmware_utils.py with built-in argument defaults, so that it can typically be run with no arguments. You can however supply additional command line arguments to override or supplement the defaults, for example to select a specific connected device. In particular, ${TARGET}.flash.py --help lists the available arguments.

\${PLATFORM}_firmware_utils.py

These scripts invoking flashing tools for the particular platform with a more-or-less uniform interface. The core set of command line options is

--erase               Erase device
--application FILE    Flash an image
--verify_application  Verify the image after flashing
--reset               Reset device after flashing

Running ${PLATFORM}_firmware_utils.py --help will show the complete list of available command line options for that platform.

Generating wrappers

Normally this is done automatically for a suitable GN build target.

The script gen_flashing_script.py builds a ${TARGET}.flash.py wrapper script to invoke the firmware utils with a particular set of argument defaults. Run this as

gen_flashing_script.py ${PLATFORM} --output filename [argument ...]

The arguments are the same as those of ${PLATFORM}_firmware_utils.py. Some platforms may have additional options, e.g. to obtain additional values from a configuration file. Use gen_flashing_script.py ${PLATFORM} --help to list all options for a particular platform.