NAME

uflash - utility for flashing the BBC micro:bit with Python scripts and the MicroPython runtime

SYNOPSIS

uflash [--runtime RUNTIME] [--watch] [--minify] [source] [target [target...]]

uflash --extract HEXFILE [source]

uflash --version

uflash --help

DESCRIPTION

uflash flashes Python onto a BBC micro:bit or extracts Python source from a .hex file. If no path to the micro:bit is provided, uflash will attempt to autodetect the correct path to the device. If no path to the Python script is provided, uflash will flash an unmodified MicroPython firmware onto the device.

OPTIONS

uflash supports the following options:

-r, --runtime RUNTIME

use the specified MicroPython runtime file

-w, --watch

watch the source file for changes

-m, --minify

minify the source

-e, --extract HEXFILE

extract Python source from given hex file

source

the Python source file to flash or extract to

target

path to one or more mounted micro:bit devices

-h, --help

display usage information and exit

--version

display current version and exit

EXAMPLES

If you type the command on its own then uflash will attempt to find a connected BBC micro:bit and flash an unmodified default version of the MicroPython runtime onto it:

$ uflash
Flashing Python to: /media/ntoll/MICROBIT/micropython.hex
    

To flash a version of the MicroPython runtime with a specified script embedded within it (so that script is run when the BBC micro:bit boots up) then pass the path to the Python script in as the first argument to the command:

$ uflash my_script.py
Flashing Python to: /media/ntoll/MICROBIT/micropython.hex
    

You can let uflash watch for changes of your script. It will be flashed automatically every time you save it:

$ uflash --watch my_script.py
    

At this point uflash will try to automatically detect the path to the device. However, if you have several devices plugged in and/or know what the path on the filesystem to the BBC micro:bit already is, you can specify this as a second argument to the command:

$ uflash myscript.py /media/ntoll/MICROBIT
Flashing Python to: /media/ntoll/MICROBIT/micropython.hex
    

You can even flash multiple devices at once:

$ uflash myscript.py /media/ntoll/MICROBIT /media/ntoll/MICROBIT1
Flashing Python to: /media/ntoll/MICROBIT/micropython.hex
Flashing Python to: /media/ntoll/MICROBIT1/micropython.hex
    

To extract a Python script from a hex file use the “–extract” flag like this:

$ uflash --extract something.hex myscript.py
    

This will save the Python script recovered from “something.hex” into the file “myscript.py”. If you don’t supply a target the recovered script will emit to STDOUT.

If you’re developing MicroPython and have a custom runtime hex file you can specify that uflash use it instead of the default version of MicroPython in the following way:

$ uflash --runtime=firmware.hex
    

FILES

The default MicroPython firmware file is located in /usr/share/firmware-microbit-micropython/firmware.hex.

REPORTING BUGS

Upstream bug tracker: https://github.com/ntoll/uflash/issues

COPYRIGHT

Copyright 2015-2018 Nicholas H.Tollervey and others.

AUTHOR

This manual page is based on the uflash documentation. It was created by Nick Morrott <nickm@debian.org> for the Debian GNU/Linux system, but may be used by others

SEE ALSO

mu-editor(1)

https://uflash.readthedocs.io/en/latest/