MD_MAX72xx_lib.h

Go to the documentation of this file.

/*
MD_MAX72xx - Library for using a MAX7219/7221 LED matrix controller
 
See header file for comments
 
This file contains library related definitions and is not visible
to user code.
 
Copyright (C) 2012-14 Marco Colli. All rights reserved.
 
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
 
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.
 
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 */
#pragma once
 
#include "MD_MAX72xx.h"
 
#define MAX_DEBUG 0 
 
#if MAX_DEBUG
#define PRINT(s, v)                                                                                                    \
    {                                                                                                                  \
        Serial.print(F(s));                                                                                            \
        Serial.print(v);                                                                                               \
    } 
#define PRINTX(s, v)                                                                                                   \
    {                                                                                                                  \
        Serial.print(F(s));                                                                                            \
        Serial.print(v, HEX);                                                                                          \
    } 
#define PRINTB(s, v)                                                                                                   \
    {                                                                                                                  \
        Serial.print(F(s));                                                                                            \
        Serial.print(v, BIN);                                                                                          \
    } 
#define PRINTS(s)                                                                                                      \
    {                                                                                                                  \
        Serial.print(F(s));                                                                                            \
    } 
#else
#define PRINT(s, v)  
#define PRINTX(s, v) 
#define PRINTB(s, v) 
#define PRINTS(s)    
#endif
 
// Opcodes for the MAX7221 and MAX7219
// All OP_DIGITn are offsets from OP_DIGIT0
#define OP_NOOP        0  
#define OP_DIGIT0      1  
#define OP_DIGIT1      2  
#define OP_DIGIT2      3  
#define OP_DIGIT3      4  
#define OP_DIGIT4      5  
#define OP_DIGIT5      6  
#define OP_DIGIT6      7  
#define OP_DIGIT7      8  
#define OP_DECODEMODE  9  
#define OP_INTENSITY   10 
#define OP_SCANLIMIT   11 
#define OP_SHUTDOWN    12 
#define OP_DISPLAYTEST 15 
 
#define ALL_CHANGED 0xff 
#define ALL_CLEAR   0x00 
 
#define FONT_FILE_INDICATOR 'F' 
 
// Shortcuts
#define SPI_DATA_SIZE    (sizeof(uint8_t) * _maxDevices * 2) 
#define SPI_OFFSET(i, x) (((LAST_BUFFER - (i)) * 2) + (x))   
 
#define FIRST_BUFFER 0                 
#define LAST_BUFFER  (_maxDevices - 1) 
 
// Macros to map reversed ROW and COLUMN coordinates
#define HW_ROW(r) (_hwRevRows ? (ROW_SIZE - 1 - (r)) : (r)) 
#define HW_COL(c) (_hwRevCols ? (COL_SIZE - 1 - (c)) : (c)) 
 
// variables shared in the library
extern const uint8_t PROGMEM _sysfont[];