i75 0.5.0

A wrapper around Pimoroni's `interstate75` library which allows for running locally and easier testing.

i75

A wrapper around Pimoroni's interstate75 library which allows for running locally and easier testing.

This library provides a module, i75, which contains additional useful functionality over what is provided by MicroPython and the Pimoroni libraries. For full details, please read the documentation.

This library also provides a script, i75, which is used when running programs on a normal PC for testing purposes. This done by a set of modules which replicate the functionality of the native Interstate75(W) hardware, in particular using PyGame to represent a Hub75 LED matrix.

This is emulation is far from perfect, but hopefully allows a quicker development cycle than deploying to the physical hardware. In particular problems may include:

• Full Python3.x is used, so syntatic and sematic differences with MicroPython won't be picked up.
• Your PC is many times more powerful than the RP2040 chip, so CPU limits won't be picked up.
• Our emulation of built-in functionality may be incomplete or incorrect.
• Sensors or additional hardware is not emulated.

Any help improving these limitations is most welcome. Please see CONTRIBUTING.md for more details.

= Installation =

To install this library either check it out from GitHub, or install from PyPI.

git checkout https://github.com/andrewjw/i75.git
cd i75
sudo python3 setup.py install

or

pip3 install i75

= Running On A PC =

To run your script simply follow i75 with the path to your script. There are examples provided in the examples directory, which can be run as follows.

i75 examples/clock/clock.py

= Running On Interstate75 =

To install the library on your Interstate75 run install.sh. This will create a i75 directory on the Raspberry Pi Zero, and copy across the required files.

Install your script in the normal way, e.g.

ampy examples/clock/clock.py main.py

For ampy to work you need to tell it the correct device to use to communicate with Raspberry Pi Pico. To that either run install.sh -p /dev/tty.usbmodemN or set the AMPY_PORT environment details. For more details about ampy, check out their documentation.