Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mcauser/micropython-max7219
MicroPython driver for MAX7219 8x8 LED matrix modules, cascadable and with framebuf
https://github.com/mcauser/micropython-max7219
framebuf led-matrix max7219 micropython spi
Last synced: 29 days ago
JSON representation
MicroPython driver for MAX7219 8x8 LED matrix modules, cascadable and with framebuf
- Host: GitHub
- URL: https://github.com/mcauser/micropython-max7219
- Owner: mcauser
- License: mit
- Created: 2017-10-01T13:10:56.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-07-03T01:02:28.000Z (over 5 years ago)
- Last Synced: 2024-10-01T05:08:54.617Z (about 1 month ago)
- Topics: framebuf, led-matrix, max7219, micropython, spi
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 180
- Watchers: 12
- Forks: 56
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-mpython - micropython-max7219 - Driver for MAX7219 8x8 LED matrix modules. (精选驱动库 / 显示类)
- awesome-micropython - micropython-max7219 - Driver for MAX7219 8x8 LED matrix modules. (Libraries / Display)
README
# MicroPython MAX7219 8x8 LED Matrix
A MicroPython library for the MAX7219 8x8 LED matrix driver, SPI interface, supports cascading and uses [framebuf](http://docs.micropython.org/en/latest/pyboard/library/framebuf.html)
## PyBoard Examples
**Single 8x8 LED Matrix**
```python
import max7219
from machine import Pin, SPI
spi = SPI(1)
display = max7219.Matrix8x8(spi, Pin('X5'), 1)
display.text('1',0,0,1)
display.show()
```
**Chain of 4x 8x8 LED Matrices**
Where the 4 is drawn on the DIN matrix.
```python
import max7219
from machine import Pin, SPI
spi = SPI(1)
display = max7219.Matrix8x8(spi, Pin('X5'), 4)
display.text('1234',0,0,1)
display.show()
```
**Chain of 8x 8x8 LED Matrices**
Where the 8 is drawn on the DIN matrix
```python
import max7219
from machine import Pin, SPI
spi = SPI(1)
display = max7219.Matrix8x8(spi, Pin('X5'), 8)
display.text('12345678',0,0,1)
display.show()
```
**Framebuf shapes and text**
```python
display.fill(0)
display.show()
display.pixel(0,0,1)
display.pixel(1,1,1)
display.hline(0,4,8,1)
display.vline(4,0,8,1)
display.line(8, 0, 16, 8, 1)
display.rect(17,1,6,6,1)
display.fill_rect(25,1,6,6,1)
display.show()
display.fill(0)
display.text('dead',0,0,1)
display.text('beef',32,0,1)
display.show()
display.fill(0)
display.text('12345678',0,0,1)
display.show()
display.scroll(-8,0) # 23456788
display.scroll(-8,0) # 34567888
display.show()
```
## ESP8266 Examples
Default baud rate of 80Mhz was introducing errors, dropped from 10Mhz and it works consistently.
```python
import max7219
from machine import Pin, SPI
spi = SPI(1, baudrate=10000000, polarity=0, phase=0)
display = max7219.Matrix8x8(spi, Pin(15), 4)
display.brightness(0)
display.fill(0)
display.text('1234',0,0,1)
display.show()
```
## ESP32 Examples
Default baud rate of 80Mhz was introducing errors, dropped from 10Mhz and it works consistently.
```python
import max7219
from machine import Pin, SPI
spi = SPI(1, baudrate=10000000, polarity=1, phase=0, sck=Pin(4), mosi=Pin(2))
ss = Pin(5, Pin.OUT)
display = max7219.Matrix8x8(spi, ss, 4)
display.text('1234',0,0,1)
display.show()
```
## Connections
PyBoard | max7219 8x8 LED Matrix
------- | ----------------------
VIN | VCC
GND | GND
X8 MOSI | DIN
X5 CS | CS
X6 SCK | CLK
Wemos D1 Mini | max7219 8x8 LED Matrix
---------------- | ----------------------
5V | VCC
GND | GND
D7 MOSI (GPIO13) | DIN
D8 CS (GPIO15) | CS
D5 SCK (GPIO14) | CLK
ESP32 | max7219 8x8 LED Matrix
---------------- | ----------------------
5V | VCC
GND | GND
D2 MOSI | DIN
D5 CS | CS
D4 SCK | CLK
## Links
* Based on [deshipu's max7219.py](https://bitbucket.org/thesheep/micropython-max7219/src)
* [micropython.org](http://micropython.org)
* [Docs on framebuf](http://docs.micropython.org/en/latest/pyboard/library/framebuf.html)
## License
Licensed under the [MIT License](http://opensource.org/licenses/MIT).