/*-------------------------------------------------------------------------------------- DMD32.h - Function and support library for the Freetronics DMD, a 512 LED matrix display panel arranged in a 32 x 16 layout. This LIibrary (DMD32) is a fork of original DMD library was modified to work on ESP32 Modified by: Khudhur Alfarhan // Qudoren@gmail.com 1/Oct./2020 Note that the DMD32 library uses the SPI port for the fastest, low overhead writing to the display. Keep an eye on conflicts if there are any other devices running from the same SPI port, and that the chip select on those devices is correctly set to be inactive when the DMD is being written to. LED Panel Layout in RAM 32 pixels (4 bytes) top left ---------------------------------------- | | Screen 1 | 512 pixels (64 bytes) | 16 pixels | | ---------------------------------------- bottom right --- */ #pragma once #ifndef MAIN_DMD32_H_ #define MAIN_DMD32_H_ #include #ifdef __cplusplus extern "C" { #endif // ###################################################################################################################### // ###################################################################################################################### #warning CHANGE THESE TO SEMI-ADJUSTABLE PIN DEFS! //ESP32 pins used for the display connection (Using VSPI) #define PIN_DMD_nOE 22 // D22 active low Output Enable, setting this low lights all the LEDs in the selected rows. Can pwm it at very high frequency for brightness control. #define PIN_DMD_A 19 // D19 #define PIN_DMD_B 21 // D21 #define PIN_DMD_CLK 18 // D18_SCK is SPI Clock if SPI is used #define PIN_DMD_SCLK 2 // D02 #define PIN_DMD_R_DATA 23 // D23_MOSI is SPI Master Out if SPI is used //Define this chip select pin that the Ethernet W5100 IC or other SPI device uses //if it is in use during a DMD scan request then scanDisplayBySPI() will exit without conflict! (and skip that scan) #define PIN_OTHER_SPI_nCS SS #define LIGHT_DMD_ROW_01_05_09_13() //{ digitalWrite( PIN_DMD_B, LOW ); digitalWrite( PIN_DMD_A, LOW ); } #define LIGHT_DMD_ROW_02_06_10_14() //{ digitalWrite( PIN_DMD_B, LOW ); digitalWrite( PIN_DMD_A, HIGH ); } #define LIGHT_DMD_ROW_03_07_11_15() //{ digitalWrite( PIN_DMD_B, HIGH ); digitalWrite( PIN_DMD_A, LOW ); } #define LIGHT_DMD_ROW_04_08_12_16() //{ digitalWrite( PIN_DMD_B, HIGH ); digitalWrite( PIN_DMD_A, HIGH ); } #define LATCH_DMD_SHIFT_REG_TO_OUTPUT() //{ digitalWrite( PIN_DMD_SCLK, HIGH ); digitalWrite( PIN_DMD_SCLK, LOW ); } #define OE_DMD_ROWS_OFF() //{ digitalWrite( PIN_DMD_nOE, LOW ); } #define OE_DMD_ROWS_ON() //{ digitalWrite( PIN_DMD_nOE, HIGH ); } //Pixel/graphics writing modes (bGraphicsMode) #define GRAPHICS_NORMAL 0 #define GRAPHICS_INVERSE 1 #define GRAPHICS_TOGGLE 2 #define GRAPHICS_OR 3 #define GRAPHICS_NOR 4 //drawTestPattern Patterns2 #define PATTERN_ALT_0 0 #define PATTERN_ALT_1 1 #define PATTERN_STRIPE_0 2 #define PATTERN_STRIPE_1 3 //display screen (and subscreen) sizing #define DMD_PIXELS_ACROSS 32 //pixels across x axis (base 2 size expected) #define DMD_PIXELS_DOWN 16 //pixels down y axis #define DMD_BITSPERPIXEL 1 //1 bit per pixel, use more bits to allow for pwm screen brightness control #define DMD_RAM_SIZE_BYTES ((DMD_PIXELS_ACROSS*DMD_BITSPERPIXEL/8)*DMD_PIXELS_DOWN) // (32x * 1 / 8) = 4 bytes, * 16y = 64 bytes per screen here. //lookup table for DMD::writePixel to make the pixel indexing routine faster static uint8_t bPixelLookupTable[8] = { 0x80, //0, bit 7 0x40, //1, bit 6 0x20, //2. bit 5 0x10, //3, bit 4 0x08, //4, bit 3 0x04, //5, bit 2 0x02, //6, bit 1 0x01 //7, bit 0 }; // Font Indices #define FONT_LENGTH 0 #define FONT_FIXED_WIDTH 2 #define FONT_HEIGHT 3 #define FONT_FIRST_CHAR 4 #define FONT_CHAR_COUNT 5 #define FONT_WIDTH_TABLE 6 typedef uint8_t (*FontCallback)(const uint8_t*); //The main class of DMD library functions class DMD { public: //Instantiate the DMD DMD(uint8_t panelsWide, uint8_t panelsHigh); //virtual ~DMD(); //Set or clear a pixel at the x and y location (0,0 is the top left corner) void writePixel( unsigned int bX, unsigned int bY, uint8_t bGraphicsMode, uint8_t bPixel ); //Draw a string void drawString( int bX, int bY, const char* bChars, uint8_t length, uint8_t bGraphicsMode); //Select a text font void selectFont(const uint8_t* font); //Draw a single character int drawChar(const int bX, const int bY, const unsigned char letter, uint8_t bGraphicsMode); //Find the width of a character int charWidth(const unsigned char letter); //Draw a scrolling string void drawMarquee( const char* bChars, uint8_t length, int left, int top); //Move the maquee accross by amount bool stepMarquee( int amountX, int amountY); //Clear the screen in DMD RAM void clearScreen( uint8_t bNormal ); //Draw or clear a line from x1,y1 to x2,y2 void drawLine( int x1, int y1, int x2, int y2, uint8_t bGraphicsMode ); //Draw or clear a circle of radius r at x,y centre void drawCircle( int xCenter, int yCenter, int radius, uint8_t bGraphicsMode ); //Draw or clear a box(rectangle) with a single pixel border void drawBox( int x1, int y1, int x2, int y2, uint8_t bGraphicsMode ); //Draw or clear a filled box(rectangle) with a single pixel border void drawFilledBox( int x1, int y1, int x2, int y2, uint8_t bGraphicsMode ); //Draw the selected test pattern void drawTestPattern( uint8_t bPattern ); //Scan the dot matrix LED panel display, from the RAM mirror out to the display hardware. //Call 4 times to scan the whole display which is made up of 4 interleaved rows within the 16 total rows. //Insert the calls to this function into the main loop for the highest call rate, or from a timer interrupt void scanDisplayBySPI(); private: void drawCircleSub( int cx, int cy, int x, int y, uint8_t bGraphicsMode ); //Mirror of DMD pixels in RAM, ready to be clocked out by the main loop or high speed timer calls uint8_t *bDMDScreenRAM; //Marquee values char marqueeText[256]; uint8_t marqueeLength; int marqueeWidth; int marqueeHeight; int marqueeOffsetX; int marqueeOffsetY; //Pointer to current font const uint8_t* Font; //Display information uint8_t DisplaysWide; uint8_t DisplaysHigh; uint8_t DisplaysTotal; int row1, row2, row3; //scanning pointer into bDMDScreenRAM, setup init @ 48 for the first valid scan volatile uint8_t bDMDByte; //uninitalised pointer to SPI object //SPIClass * vspi = NULL; static const int spiClk = 4000000; // 4 MHz SPI clock }; #ifdef __cplusplus } #endif #endif /* MAIN_DMD32_H_ */