Package: uflash
uFlashTHIS MODULE ONLY WORKS WITH PYTHON 2.7 or 3.3+.A utility for flashing the BBC micro:bit with Python scripts and the
MicroPython runtime. You pronounce the name of this utility “micro-flash”. ;-)It provides three services:A library of functions to programatically create a hex file and flash it onto a BBC micro:bit.A command line utility calleduflashthat will flash Python scripts onto a BBC micro:bit.A command line utility calledpy2hexfor creating hex files from Python scripts and saving them on the local filesystemSeveral essential operations are implemented:Encode Python into the hex format.Embed the resulting hexified Python into the MicroPython runtime hex.Extract an encoded Python script from a MicroPython hex file.Discover the connected micro:bit.Copy the resulting hex onto the micro:bit, thus flashing the device.Specify the MicroPython runtime hex in which to embed your Python code.InstallationTo install simply type:$ pip install uflash…and the package will download from PyPI. If you wish to upgrade to the
latest version, use the following command:$ pip install --no-cache --upgrade uflashNB:You must use a USBdatacable to connect the micro:bit to your
computer (some cables are power only). You’re in good shape if, when plugged
in, the micro:bit appears as a USB storage device on your file system.Linux users: For uflash to work you must ensure the micro:bit is mounted as a
USB storage device. Usually this is done automatically. If not you’ve probably
configured automounting to be off. If that’s the case, we assume you
have the technical knowledge to mount the device yourself or to install the
required kernel modules if they’re missing. Default installs of popular Linux
distros “should just work” (tm) out of the box given a default install.Command UsageuflashTo read help simply type:$ uflash --helpor:$ uflash -hTo discover the version information type:$ uflash --versionIf 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.hexTo 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 my_script.py to: /media/ntoll/MICROBIT/micropython.hexYou can let uflash watch for changes of your script. It will be flashed
automatically every time you save it:$ uflash -w my_script.pyor:$ uflash --watch my_script.pyAt 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 myscript.py to: /media/ntoll/MICROBIT/micropython.hexYou can even flash multiple devices at once:$ uflash myscript.py /media/ntoll/MICROBIT /media/ntoll/MICROBIT1
Flashing myscript.py to: /media/ntoll/MICROBIT/micropython.hex
Flashing myscript.py to: /media/ntoll/MICROBIT1/micropython.hexTo extract a Python script from a hex file use the “-e” flag like this:$ uflash -e something.hex myscript.pyThis 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 built-in version of MicroPython in
the following way:$ uflash -r firmware.hexor:$ uflash --runtime=firmware.hexpy2hexTo create output .hex files in the same directory as the input .py files:$ py2hex tests/example.py
Hexifying example.py as: tests/example.hexpy2hex includes that same -r/–runtime and -m/–minify options as uflash
and adds an additional option -o/–outdir:To create output .hex files in a different directory:$ py2hex example.py -o /tmp
Hexifying example.py as: /tmp/example.hexor:$ py2hex example.py --outdir /tmp
Hexifying example.py as: /tmp/example.hexpy2hex can handle multiple input files:$ py2hex a.py b.py c.py
Hexifying a.py as: a.hex
Hexifying b.py as: b.hex
Hexifying c.py as: c.hexor:$ py2hex *.py
Hexifying a.py as: a.hex
Hexifying b.py as: b.hex
Hexifying c.py as: c.hexDevelopmentThe source code is hosted in GitHub. Please feel free to fork the repository.
Assuming you have Git installed you can download the code from the canonical
repository with the following command:$ git clone https://github.com/ntoll/uflash.gitEnsure you have the correct dependencies for development installed by creating
a virtualenv and running:$ pip install -r requirements.txtTo locally install your development version of the module into a virtualenv,
run the following command:$ python setup.py developThere is a Makefile that helps with most of the common workflows associated
with development. Typingmakeon its own will list the options thus:$ make

There is no default Makefile target right now. Try:

make clean - reset the project and remove auto-generated assets.
make pyflakes - run the PyFlakes code checker.
make pep8 - run the PEP8 style checker.
make test - run the test suite.
make coverage - view a report on test coverage.
make check - run all the checkers and tests.
make package - create a deployable package for the project.
make rpm - create an rpm package for the project.
make publish - publish the project to PyPI.
make docs - run sphinx to create project documentation.Release History1.2.4Updated to the latest version of MicroPython for micro:bit (1.0.1)This is the version of uflash to be used in Mu 1.0.2.1.2.3Update to the latest version of MicroPython for micro:bit (1.0.0).This is the version of uflash to be used in Mu 1.0.1.1.2.2Update to latest version of MicroPython for micro:bit (1.0.0-rc.3).1.2.1Update to latest version of MicroPython. Thanks to Damien George and Carlos
Pereira Atencio for their hard work.This is the version of uflash to be used in Mu 1.0.0 (final).1.2.0Update to latest version of MicroPython. Thanks to Damien George.Add attribute called MICROPYTHON_VERSION to report the version of MicroPython
bundled with uflash.1.1.1Update to the latest version of MicroPython for the BBC micro:bit – fixes a
bug relating to flooding and the radio module. As always, many thanks to
Damien George for his work on MicroPython.1.1.0Update to latest version of MicroPython for the BBC micro:bit (many thanks to Damien George for his amazing efforts!).Add a –version flag to uflash that causes it to print the current version number (many thanks to Lenz Grimmer for this work).Allow uflash to accept the content of a script as well as the path to a script (many thanks to Zander Brown for this work).Ensure uflash works nicely / better with external tools (many thanks to Lex Robinson for this work).Added copyright and license information to the start of the script.1.0.8Refactor hex extraction to not depend on extended address record before script (thanks Carlos).Refactor tox tests to fix Windows related Gremlin (thanks again, Carlos).1.0.7Watch for changes in a script. Automatically flash on save.1.0.5Update runtime to include latest bug fixes and inclusion of input() builtin.Detecting drives on Windows 10 no longer causes pop-ups in certain situations.Documentation updates.1.0.4Add support for flash multiple microbits.1.0.3Update runtime to include audio and speech modules.1.0.2Update runtime to include the new radio module.1.0.1Update runtime to include file system related changes.1.0.0.final.0Runtime updated to version 1.0 of MicroPython for the BBC micro:bit.1.0.0.beta.7Runtime update to fix display related bug.1.0.0.beta.6Runtime update to latest version of the DAL (swaps pins 4 and 5).1.0.0.beta.5Runtime update to fix error reporting bug.1.0.0.beta.4Documentation update.Help text update.1.0.0.beta.3Add ability to specify a MicroPython runtime to use.Test fixes.1.0.0.beta.2Updated to latest version of MicroPython runtime.1.0.0.beta.1Works with Python 2.7 (thanks to @Funkyhat).Updated to the latest build of MicroPython for the BBC micro:bit.Minor refactoring and updates to the test suite due to MicroPython updates.0.9.17Minor code refactor.Documentation update.0.9.14Feature complete.Comprehensive test suite - 100% coverage.Tested on Linux and Windows.Documentation.Access via the “uflash” command.0.0.1Initial release. Basic functionality.