ulab is a numpy-like array manipulation library for micropython. The module is written in C, defines compact containers for numerical data, and is fast.
Documentation can be found under https://micropython-ulab.readthedocs.io/en/latest/ The source for the manual is in https://github.com/v923z/micropython-ulab/blob/master/docs/ulab-manual.ipynb, while developer help is in https://github.com/v923z/micropython-ulab/blob/master/docs/ulab.ipynb.
Firmware for pyboard.v.1.1, and PYBD_SF6 is updated once in a while, and can be downloaded from https://github.com/v923z/micropython-ulab/releases.
If you want to try the latest version of ulab
, or your hardware is
different to pyboard.v.1.1, or PYBD_SF6, the firmware can be compiled
from the source by following these steps:
First, you have to clone the micropython repository by running
git clone https://github.com/micropython/micropython.git
on the command line. This will create a new repository with the name micropython
. Staying there, clone the ulab
repository with
git clone https://github.com/v923z/micropython-ulab.git ulab
Then you have to include ulab
in the compilation process by editing mpconfigport.h
of the directory of the port for which you want to compile, so, still on the command line, navigate to micropython/ports/unix
, or micropython/ports/stm32
, or whichever port is your favourite, and edit the mpconfigport.h
file there. All you have to do is add a single line at the end:
#define MODULE_ULAB_ENABLED (1)
This line will inform the compiler that you want ulab
in the resulting firmware. If you don't have the cross-compiler installed, your might want to do that now, for instance on Linux by executing
sudo apt-get install gcc-arm-none-eabi
If that was successful, you can try to run the make command in the port's directory as
make BOARD=PYBV11 USER_C_MODULES=../../../ulab all
which will prepare the firmware for pyboard.v.11. Similarly,
make BOARD=PYBD_SF6 USER_C_MODULES=../../../ulab all
will compile for the SF6 member of the PYBD series. Provided that you managed to compile the firmware, you would upload that by running either
dfu-util --alt 0 -D firmware.dfu
or
python pydfu.py -u firmware.dfu
In case you got stuck somewhere in the process, a bit more detailed instructions can be found under https://github.com/micropython/micropython/wiki/Getting-Started, and https://github.com/micropython/micropython/wiki/Pyboard-Firmware-Update.