Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JanBednarik/micropython-matrix8x8
MicroPython driver for AdaFruit 8x8 LED Matrix display.
https://github.com/JanBednarik/micropython-matrix8x8
Last synced: about 16 hours ago
JSON representation
MicroPython driver for AdaFruit 8x8 LED Matrix display.
- Host: GitHub
- URL: https://github.com/JanBednarik/micropython-matrix8x8
- Owner: JanBednarik
- License: mit
- Created: 2014-11-10T07:51:49.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-03-09T09:24:41.000Z (8 months ago)
- Last Synced: 2024-04-22T12:34:17.920Z (7 months ago)
- Language: Python
- Size: 414 KB
- Stars: 14
- Watchers: 4
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-micropython - micropython-matrix8x8 - Driver for Adafruit 8x8 LED Matrix display with HT16K33 backpack. (Libraries / Display)
- awesome-mpython - micropython-matrix8x8 - Driver for AdaFruit 8x8 LED Matrix display with HT16K33 backpack. (精选驱动库 / 显示类)
README
MicroPython Matrix8x8 Driver
============================
MicroPython driver for AdaFruit 8x8 LED Matrix display with HT16K33 backpack.
Installation
------------
Copy `matrix8x8.py` file to your pyboard.
Usage
-----
```
from matrix8x8 import Matrix8x8
display = Matrix8x8()
display.set_row(2, 0xFF) # turn on all LEDs in row 2
display.set_column(3, 0xFF) # turn on all LEDs in column 3
display.set_pixel(7, 6) # turn on LED at row 7, column 6
...
```
**Device controll methods:**
```
__init__(i2c_bus=1, addr=0x70, brightness=15, i2c=None)
Params:
* i2c_bus = I2C bus ID (1 or 2) or None (if param 'i2c' is provided)
* addr = I2C address of connected display
* brightness = display brightness (0 - 15)
* i2c = initialised instance of pyb.I2C object
on()
Turn on display.
off()
Turn off display. You can controll display when it's off (change image,
brightness, blinking, ...).
set_brightness(value)
Set display brightness. Value from 0 (min) to 15 (max).
set_blinking(mode)
Set blinking. Modes:
0 - blinking off
1 - blinking at 2Hz
2 - blinking at 1Hz
3 - blinking at 0.5Hz
```
**Image maipulation methods:**
```
set(bitmap)
Show bitmap on display. Bitmap should be 8 bytes/bytearray object or any
iterable object containing 8 bytes (one byte per row).
set_row(row, byte)
Set row by byte.
set_column(column, byte)
Set column by byte.
set_pixel(row, column)
Set (turn on) pixel.
clear()
Clear display.
clear_row(row)
Clear row.
clear_column(column)
Clear column.
clear_pixel(row, column)
Clear pixel.
```
Notes:
* Rows a columns are numbered from 0 to 7.
Examples
--------
`examples/test_features.py` - Simple demo of display/driver fetures and usage.
`examples/game_of_life.py` - Conway's Game of Life. In action video:
http://youtu.be/XZgU1wqZMic
You can copy one of the examples to your pyboard as `main.py` and if you connect
display to I2C bus 1, they will instantly work.
Wiring
------
LED Matrix display is using I2C bus. You can connect and controll more displays
with one I2C bus if you change I2C address of display.
Example of wiring to I2C bus 1 on breadboard:
More info & Help
----------------
You can check more about the MicroPython project here: http://micropython.org
Discussion about this driver: http://forum.micropython.org/viewtopic.php?f=5&t=405