intro.rst 1.4 KB

123456789101112131415161718192021222324252627282930313233
  1. Introduction
  2. ------------
  3. Python library interfacing LED matrix displays with the MAX7219 driver (using
  4. SPI) and WS2812 & APA102 NeoPixels (inc Pimoroni Unicorn pHat/Hat and Unicorn
  5. Hat HD) on the Raspberry Pi and other Linux-based single board computers - it
  6. provides a Pillow-compatible drawing canvas, and other functionality to
  7. support:
  8. * multiple cascaded devices
  9. * LED matrix, seven-segment and NeoPixel variants
  10. * scrolling/panning capability,
  11. * terminal-style printing,
  12. * state management,
  13. * dithering to monochrome,
  14. * Python 3.6+ is supported
  15. .. image:: https://raw.githubusercontent.com/rm-hull/luma.led_matrix/master/doc/images/devices.jpg
  16. :alt: max7219 matrix
  17. A LED matrix can be acquired for a few pounds from outlets like `Banggood
  18. <http://www.banggood.com/MAX7219-Dot-Matrix-Module-DIY-Kit-SCM-Control-Module-For-Arduino-p-72178.html?currency=GBP>`_.
  19. Likewise 7-segment displays are available from `Ali-Express
  20. <http://www.aliexpress.com/item/MAX7219-Red-Module-8-Digit-7-Segment-Digital-LED-Display-Tube-For-Arduino-MCU/1449630475.html>`_
  21. or `Ebay <http://www.ebay.com/itm/-/172317726225>`_.
  22. .. seealso::
  23. Further technical information for the specific devices can be found in the
  24. datasheets below:
  25. - :download:`MAX7219 <tech-spec/MAX7219.pdf>`
  26. - :download:`WS2812 <tech-spec/WS2812.pdf>`
  27. - :download:`WS2812B <tech-spec/WS2812B.pdf>`
  28. - :download:`APA102 <tech-spec/APA102.pdf>`