No description
Find a file
Zoltán Vörös 847c7f9d63
Merge pull request #54 from v923z/readme
updated readme
2020-03-06 18:31:04 +01:00
.github/workflows fix printing failure info when tests fail 2020-02-18 21:10:33 -06:00
code Fix handling of negative indices 2020-02-29 17:00:42 -06:00
docs created new create sub-module for ndarray initialisation functions 2020-02-27 20:39:13 +01:00
tests slicing: add test of slice assignment 2020-02-29 17:11:56 -06:00
.gitignore ignore files created by ./build.sh 2020-02-27 13:56:09 -06:00
build.sh build: include debug information (may also disable optimization) 2020-02-29 16:57:09 -06:00
LICENSE Create LICENSE 2019-09-11 19:53:01 +02:00
README.md updated readme 2020-03-06 18:27:59 +01:00

micropython-ulab

ulab is a numpy-like array manipulation library for micropython and circuitpython. The module is written in C, defines compact containers for numerical data, and is fast. The library is a software-only standard micropython user module, i.e., it has no hardware dependencies, and can be compiled for any platform. The float implementation of micropython (float, or double) is automatically detected.

Documentation can be found under https://micropython-ulab.readthedocs.io/en/latest/.

Firmware

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.

It is also included in most development builds of CircuitPython for SAMD51 and nRF microcontrollers.

Compiling

If you want to try the latest version of ulab on micropython, 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

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 this step 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. If your target is unix, you don't need to specify the BOARD parameter.

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.