LedMatrix.h

#include <Arduino.h>

// max7219 registers
#define MAX7219_REG_NOOP         0x0
#define MAX7219_REG_DIGIT0       0x1
#define MAX7219_REG_DIGIT1       0x2
#define MAX7219_REG_DIGIT2       0x3
#define MAX7219_REG_DIGIT3       0x4
#define MAX7219_REG_DIGIT4       0x5
#define MAX7219_REG_DIGIT5       0x6
#define MAX7219_REG_DIGIT6       0x7
#define MAX7219_REG_DIGIT7       0x8
#define MAX7219_REG_DECODEMODE   0x9
#define MAX7219_REG_INTENSITY    0xA
#define MAX7219_REG_SCANLIMIT    0xB
#define MAX7219_REG_SHUTDOWN     0xC
#define MAX7219_REG_DISPLAYTEST  0xF

#define TEXT_ALIGN_LEFT          0 // Text is aligned to left side of the display
#define TEXT_ALIGN_LEFT_END      1 // Beginning of text is just outside the right end of the display
#define TEXT_ALIGN_RIGHT         2 // End of text is aligned to the right of the display
#define TEXT_ALIGN_RIGHT_END     3 // End of text is just outside the left side of the display

//type of font
#define FONT_cp437   0 //cp437 font
#define FONT_5x7     1 //5x7 ascii font

class LedMatrix {
    
public:
    
    /**
     * Constructor.
     * numberOfDisplays: number of connected devices
     * slaveSelectPin: CS (or SS) pin connected to your ESP8266
     */
    LedMatrix(byte numberOfDisplays, int8_t sck, int8_t miso, int8_t mosi, byte slaveSelectPin);
	// New constructor enhanced with font selector
	LedMatrix(byte numberOfDevices, int8_t sck, int8_t miso, int8_t mosi, byte slaveSelectPin, byte font);
    
    /**
     * Initializes the SPI interface
     */
    void init();
    
    /**
     * Sets the intensity on all devices.
     * intensity: 0-15
     */
    void setIntensity(byte intensity);
    
    /**
     * Sets the width in pixels for one character.
     * Default is 7.
     */
    void setCharWidth(byte charWidth);
    
    /**
     * Sets the text alignment.
     * Default is TEXT_ALIGN_LEFT_END.
     *
     */
    void setTextAlignment(byte textAlignment);
    
    /**
     * Send a byte to a specific device.
     */
    void sendByte (const byte device, const byte reg, const byte data);
    
    /**
     * Send a byte to all devices (convenience method).
     */
    void sendByte (const byte reg, const byte data);
    
    /**
     * Turn on pixel at position (x,y).
     */
    void setPixel(int8_t x, int8_t y);
    
    /**
     * Clear the frame buffer.
     */
    void clear();
    
    /**
     * Draw rectangle at position (x0, y0) - (x1, y1), including borders.
     */
    void drawRectangle(int8_t x0, int8_t y0, int8_t x1, int8_t y1);

    /**
     * Draw line between position (x0, y0) and (x1, y1), including endpoints.
     */
    void drawLine(int8_t x0, int8_t y0, int8_t x1, int8_t y1);

	/**
     * Draw the currently set text at the current offset.
     */
    void drawText();
    
    /**
     * Set the current text.
     */
    void setText(String text);
    
    /**
     * Set the text that will replace the current text after a complete scroll
     * cycle.
     */
    void setNextText(String nextText);
    
    /**
     * Set a specific column with a byte value to the framebuffer.
     */
    void setColumn(int column, byte value);
    
    /**
     * Writes the framebuffer to the displays.
     */
    void commit();
    
    /**
     * Writes the framebuffer to the displays in chained mode (horizontal):
     */
    void commith();
    
    /**
     * Scroll the text to the right.
     */
    void scrollTextRight();
    
    /**
     * Scroll the text to the left.
     */
    void scrollTextLeft();
    
    /**
     * Oscilate the text between the two limits.
     */
    void oscillateText();
    
private:
    byte* cols;
    byte spiregister[8];
    byte spidata[8];
    String myText;
    String myNextText;
    int myTextOffset = 1;
    int myTextAlignmentOffset = 0;
    int increment = -1;
    byte myNumberOfDevices = 0;
    byte mySlaveSelectPin = 0;
    byte myCharWidth = 7;
    byte myTextAlignment = 1;
    byte myFont = 0;
    int8_t _sck;
    int8_t _miso;
    int8_t _mosi;
    void calculateTextAlignmentOffset();
};