Rob Dobson / LEDMatrix

Forked LEDMatrix and added horizontal scrolling

Fork of LEDMatrix by Yihui Xiong

LEDMatrix.h@2:cd2da920cf98, 2016-01-14 (annotated)

Committer:
Bobty
Date:
Thu Jan 14 12:57:59 2016 +0000
Revision:
2:cd2da920cf98
Parent:
1:79cf2e115449
Child:
3:1e06e89bc0c9
Improved scrolling; Now handles multiple independent lines of text; Converted the coordinate system to more conventional one

Who changed what in which revision?

UserRevisionLine numberNew contents of line
yihui 0:13728deac7a7 1 /**
yihui 0:13728deac7a7 2 * LED Matrix library for http://www.seeedstudio.com/depot/ultrathin-16x32-red-led-matrix-panel-p-1582.html
yihui 0:13728deac7a7 3 * The LED Matrix panel has 32x16 pixels. Several panel can be combined together as a large screen.
yihui 0:13728deac7a7 4 *
yihui 0:13728deac7a7 5 * Coordinate & Connection (mbed -> panel 0 -> panel 1 -> ...)
yihui 0:13728deac7a7 6 * (0, 0) (0, 0)
yihui 0:13728deac7a7 7 * +--------+--------+--------+ +--------+--------+
yihui 0:13728deac7a7 8 * | 5 | 3 | 1 | | 1 | 0 |
yihui 0:13728deac7a7 9 * | | | | | | |<----- mbed
yihui 0:13728deac7a7 10 * +--------+--------+--------+ +--------+--------+
yihui 0:13728deac7a7 11 * | 4 | 2 | 0 | (64, 16)
yihui 0:13728deac7a7 12 * | | | |<----- mbed
yihui 0:13728deac7a7 13 * +--------+--------+--------+
yihui 0:13728deac7a7 14 * (96, 32)
yihui 0:13728deac7a7 15 * Copyright (c) 2013 Seeed Technology Inc.
yihui 0:13728deac7a7 16 * @auther Yihui Xiong
yihui 0:13728deac7a7 17 * @date Nov 7, 2013
yihui 0:13728deac7a7 18 * @license Apache
yihui 0:13728deac7a7 19 */
yihui 0:13728deac7a7 20
yihui 0:13728deac7a7 21
yihui 0:13728deac7a7 22 #ifndef __LED_MATRIX_H__
yihui 0:13728deac7a7 23 #define __LED_MATRIX_H__
yihui 0:13728deac7a7 24
yihui 0:13728deac7a7 25 #include "mbed.h"
yihui 0:13728deac7a7 26
Bobty 2:cd2da920cf98 27 const int LED_MATRIX_LEDS_HORIZONTALLY = 32;
Bobty 2:cd2da920cf98 28 const int LED_MATRIX_LEDS_VERTICALLY = 16;
Bobty 2:cd2da920cf98 29 const int LED_MATRIX_MAX_LINES = 16;
Bobty 2:cd2da920cf98 30
Bobty 2:cd2da920cf98 31 class LEDMatrix
Bobty 2:cd2da920cf98 32 {
yihui 0:13728deac7a7 33 public:
Bobty 2:cd2da920cf98 34
yihui 0:13728deac7a7 35 LEDMatrix(PinName pinA, PinName pinB, PinName pinC, PinName pinD, PinName pinOE, PinName pinR1, PinName pinSTB, PinName pinCLK);
yihui 0:13728deac7a7 36
yihui 0:13728deac7a7 37 /**
yihui 0:13728deac7a7 38 * set the display's display buffer and number, the buffer's size must be not less than 512 * number / 8 bytes
Bobty 2:cd2da920cf98 39 * @param pDisplayBuf display buffer
yihui 0:13728deac7a7 40 * @param number panels' number
yihui 0:13728deac7a7 41 */
Bobty 2:cd2da920cf98 42 void begin(uint8_t *pDisplayBuf, uint16_t width, uint16_t height, uint16_t scrollWidth, uint16_t numLines, int charSeparation = 1);
yihui 0:13728deac7a7 43
yihui 0:13728deac7a7 44 /**
Bobty 2:cd2da920cf98 45 * draw a point - origin is like a graph with 0,0 at the lower-left corner
yihui 0:13728deac7a7 46 * @param x x
yihui 0:13728deac7a7 47 * @param y y
yihui 0:13728deac7a7 48 * @param pixel 0: led off, >0: led on
yihui 0:13728deac7a7 49 */
yihui 0:13728deac7a7 50 void drawPoint(uint16_t x, uint16_t y, uint8_t pixel);
yihui 0:13728deac7a7 51
yihui 0:13728deac7a7 52 /**
Bobty 2:cd2da920cf98 53 * draw a rect - origin is like a graph with 0,0 at the lower-left corner
yihui 0:13728deac7a7 54 * @param (x1, y1) top-left position
yihui 0:13728deac7a7 55 * @param (x2, y2) bottom-right position, not included in the rect
yihui 0:13728deac7a7 56 * @param pixel 0: rect off, >0: rect on
yihui 0:13728deac7a7 57 */
yihui 0:13728deac7a7 58 void drawRect(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint8_t pixel);
yihui 0:13728deac7a7 59
yihui 0:13728deac7a7 60 /**
yihui 0:13728deac7a7 61 * draw a image
yihui 0:13728deac7a7 62 * @param (x1, y1) top-left position
yihui 0:13728deac7a7 63 * @param (x2, y2) bottom-right position, not included in the rect
yihui 0:13728deac7a7 64 * @param pixels contents, 1 bit to 1 led
yihui 0:13728deac7a7 65 */
yihui 0:13728deac7a7 66 void drawImage(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2, uint8_t *image);
yihui 0:13728deac7a7 67
yihui 0:13728deac7a7 68 /**
yihui 0:13728deac7a7 69 * turn off 1/16 leds and turn on another 1/16 leds
yihui 0:13728deac7a7 70 */
yihui 0:13728deac7a7 71 void scan();
yihui 0:13728deac7a7 72
Bobty 2:cd2da920cf98 73 void invertColour();
yihui 0:13728deac7a7 74
Bobty 2:cd2da920cf98 75 uint8_t isInvertedColour();
yihui 0:13728deac7a7 76
yihui 0:13728deac7a7 77 void on();
yihui 0:13728deac7a7 78
yihui 0:13728deac7a7 79 void off();
Bobty 1:79cf2e115449 80
Bobty 2:cd2da920cf98 81 // Passing lineIdx == -1 to the following functions resets all lines
Bobty 2:cd2da920cf98 82 // Lines are numbered starting at 0
Bobty 2:cd2da920cf98 83 void clear(int lineIdx = -1);
Bobty 2:cd2da920cf98 84 void scroll(int lineIdx, bool scrollLeft);
Bobty 2:cd2da920cf98 85 void scrollReset(int lineIdx = -1);
Bobty 2:cd2da920cf98 86 void scrollToPos(int lineIdx, int pos);
Bobty 2:cd2da920cf98 87 void setupScroll(int lineIdx, int scrollWidth, int scrollInc);
yihui 0:13728deac7a7 88
Bobty 2:cd2da920cf98 89 uint8_t reverseBits(uint8_t b);
Bobty 2:cd2da920cf98 90 int displayChar(int xPos, int yPos, char ch);
Bobty 2:cd2da920cf98 91 int displayLargeDigit(int curX, int curY, char ch);
Bobty 2:cd2da920cf98 92 int displayLine(int lineIdx, const char* line);
Bobty 2:cd2da920cf98 93
Bobty 2:cd2da920cf98 94 // Called frequently and regularly to handle effects like scrolling
Bobty 2:cd2da920cf98 95 void serviceEffects();
Bobty 2:cd2da920cf98 96
yihui 0:13728deac7a7 97 private:
Bobty 2:cd2da920cf98 98 bool getRowsToWorkOn(int lineIdx, int &startRow, int &numRows);
yihui 0:13728deac7a7 99 DigitalOut a, b, c, d, oe, r1, stb, clk;
Bobty 2:cd2da920cf98 100 uint8_t *_pDisplayBuf;
yihui 0:13728deac7a7 101 uint16_t width;
yihui 0:13728deac7a7 102 uint16_t height;
Bobty 2:cd2da920cf98 103 uint16_t dispBufWidth;
Bobty 2:cd2da920cf98 104 uint16_t numLines;
yihui 0:13728deac7a7 105 uint8_t mask;
Bobty 2:cd2da920cf98 106 bool _isEnabled;
Bobty 2:cd2da920cf98 107 int _hScrollPos[LED_MATRIX_LEDS_VERTICALLY];
Bobty 2:cd2da920cf98 108 int _hScrollWidth[LED_MATRIX_LEDS_VERTICALLY];
Bobty 2:cd2da920cf98 109 bool _isBusy;
Bobty 2:cd2da920cf98 110 int _charSeparation;
Bobty 2:cd2da920cf98 111 int _lineScrollInc[LED_MATRIX_MAX_LINES];
yihui 0:13728deac7a7 112 };
yihui 0:13728deac7a7 113
yihui 0:13728deac7a7 114 #endif