Matrix

API

void MATRIXwrite(String text, int count, boolean wait)

Write the given text to the matrix and scroll it for a number of times.

text = text to be shown.
count = number of times the text shall be scrolled before disappearing (-1 = forever)
wait = if true, wait before text has been shown before returning.

void MATRIXwrite(String text)

Write the given text to the matrix and scroll it infinitely.

text = text to be shown.

void MATRIXwriteAndWait(String text)

Write the given text to the matrix and scroll it, wait before text has been shown before returning.

text = text to be shown.

void MATRIXwriteOnce(String text)

Write the given text to the matrix and scroll it once.

text = text to be shown.

void MATRIXdrawIcon(String iconString)

Draw the given icon on the matrix.

Icon is given as string and accepted in the following formats:

  • “B1111100000111110000011111” 25 pixels binary one after the other, prefix B
  • “0x7008E828A0” one byte for each 5px row, prefix 0x

iconString = icon to be shown.

void MATRIXdrawIcon(uint32_t iconLong)

Draw the given icon on the matrix.

Icon is given as 32bit long. Bits correspond to the pixels starting at top left.

iconLong = icon to be shown.

void MATRIXsetPixel(uint8_t x, uint8_t y, uint8_t on)

Sets the given pixel of the matrix to be on or off

x = pixel column
y = pixel row
on = true→ Pixel on, false→Pixel off.

void MATRIXsetBlinkRate(uint8_t b)

Sets the blink rate of the matrix.

b = Blink Rate (one of: MATRIX_STATIC/MATRIX_BLINK_2HZ/MATRIX_BLINK_1HZ/MATRIX_BLINK_HALFHZ)

void MATRIXsetBrightness(uint8_t b)

Sets the brightness of the matrix.

b = Brightness (range 1-15)

void MATRIXshowID()

Show the internal device ID on the matrix as on/off digital pattern.

The first 5 digits of the ID on the 5 lines (first 4 cols), the last digits of the ID on the 5th column

Wiring

Examples