A wrapper around Pimoroni's `interstate75` library which allows for running locally and easier testing.
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.