Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
en:reference:matrix [2017/11/06 10:26] kniwwelinoen:reference:matrix [2018/01/23 13:06] (current) kniwwelino
Line 1: Line 1:
 +====== 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 =====
 +