matrix11x7 NodeJS

A nodeJS library for the Pimoroni 11x7 LED Matrix Breakout

It works with nodeJS v10.17.0, other versions might work as well.

Installation

npm i matrix11x7

this will only work on a linux system with an i2c bus. on raspbian i2c is not enabled by default, here's some information on enabling it.

Usage

This library provides a method to instanciate a display. On that display, two methods can be used: basicMatrix, that allows you to display a pixel matrix (prefferably 11x7 pixels) and scrollText, that let's you write a string that will then scroll through the screen.

Basic Matrix

const matrix11x7 = require('matrix11x7');

// a 7 by 11 pixel matrix where each value is an integer between 0 an 255 (intensity)
const matrixHeart = [
  [0, 0, 0, 0, 50, 0, 50, 0, 0, 0, 0],
  [0, 0, 0, 50, 0, 50, 0, 50, 0, 0, 0],
  [0, 0, 50, 0, 0, 0, 0, 0, 50, 0, 0],
  [0, 0, 50, 0, 0, 0, 0, 0, 50, 0, 0],
  [0, 0, 0, 50, 0, 0, 0, 50, 0, 0, 0],
  [0, 0, 0, 0, 50, 0, 50, 0, 0, 0, 0],
  [0, 0, 0, 0, 0, 50, 0, 0, 0, 0, 0],
];

const init = async () => {
  try {
    const instance = await matrix11x7();
    instance.basicMatrix(matrixHeart);
  } catch (e) {
    console.error(e);
  }
};

init();

Scrolling Text

const matrix11x7 = require('matrix11x7');

const init = async () => {
  try {
    const instance = await matrix11x7();
    instance.scrollText("Hello World", {
      speed: 80, // optional - milliseconds between each step
      infinite: true, // optional - wether it should stop after one run or keep running
      font: null, // optional - the font you want to use (see src/fonts/ as an example)
      intensity: 50, // optional - an integer between 0 an 255 (intensity)
    });
  } catch (e) {
    console.error(e);
  }
};

init();