#include #include #include // Add header of the fonts here. Remove as many as possible to get conserve FLASH memory. #include #include #include #include <7segment.h> #include #include #include // Change the total fonts included #define TOTALFONTS 7 // Add the font name as declared in the header file. Remove as many as possible to get conserve FLASH memory. const unsigned char *MICROVIEW::fontsPointer[]={font5x7,font8x16,sevensegment,fontlargenumber, space01,space02,space03}; // TODO - Need to be able to let user add custom fonts from outside of the library // TODO - getTotalFonts(), addFont() return font number, removeFont() /* Page buffer 64 x 48 divided by 8 = 384 bytes Page buffer is required because in SPI mode, the host cannot read the SSD1306's GDRAM of the controller. This page buffer serves as a scratch RAM for graphical functions. All drawing function will first be drawn on this page buffer, only upon calling display() function will transfer the page buffer to the actual LCD controller's memory. */ static uint8_t screenmemory [] = { // LCD Memory organised in 64 horizontal pixel and 6 rows of byte // B B .............B ----- // y y .............y \ // t t .............t \ // e e .............e \ // 0 1 .............63 \ // \ // D0 D0.............D0 \ // D1 D1.............D1 / ROW 0 // D2 D2.............D2 / // D3 D3.............D3 / // D4 D4.............D4 / // D5 D5.............D5 / // D6 D6.............D6 / // D7 D7.............D7 ---- 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x80, 0xC0, 0xC0, 0xC0, 0xC0, 0xC0, 0x80, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x80, 0xC0, 0xC0, 0xE0, 0xE0, 0xF0, 0xF0, 0x78, 0x38, 0xDC, 0xDC, 0xFE, 0xFE, 0x6F, 0x6F, 0xE7, 0xE7, 0x63, 0x61, 0xC1, 0xC1, 0xC3, 0x87, 0x87, 0x0F, 0x0F, 0x1E, 0x1E, 0x3C, 0x3C, 0x78, 0x78, 0xF0, 0xF0, 0xE0, 0xE0, 0xC0, 0xC0, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xFC, 0xFE, 0xFE, 0x3F, 0x7F, 0x77, 0xF3, 0xE3, 0xE1, 0xC1, 0xC0, 0x80, 0x80, 0x07, 0x0F, 0x1F, 0x38, 0x30, 0x36, 0x76, 0x61, 0x61, 0x60, 0x68, 0x69, 0x66, 0x60, 0x61, 0xB1, 0xBF, 0xDE, 0xC0, 0xE0, 0xF0, 0xF0, 0xF8, 0xF8, 0xFC, 0xBC, 0xBF, 0xFF, 0xFF, 0xFF, 0xFF, 0x3F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x07, 0x07, 0x0F, 0xFF, 0xFE, 0xFE, 0x3C, 0x3D, 0x79, 0x7B, 0xF3, 0xF7, 0xE7, 0xCF, 0xCE, 0x9E, 0x9C, 0x3C, 0xF8, 0xF8, 0xF8, 0x7C, 0xFC, 0xFE, 0xCE, 0xEF, 0xFF, 0xFF, 0xFB, 0xFB, 0x7F, 0xFF, 0xFE, 0xFE, 0x1F, 0x0F, 0xFF, 0xFF, 0xFF, 0x01, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x01, 0x03, 0x03, 0x07, 0x07, 0x0F, 0x0F, 0x0F, 0x0F, 0xFF, 0xFF, 0xFF, 0x03, 0x01, 0x7F, 0xFF, 0x7F, 0x00, 0x1F, 0x3F, 0x1F, 0x00, 0x00, 0x07, 0x0F, 0x07, 0x00, 0x01, 0x03, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x03, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }; void MICROVIEW::begin() { // default 5x7 font setFontType(0); setColor(WHITE); setDrawMode(NORM); setCursor(0,0); // Setting up SPI pins pinMode(MOSI, OUTPUT); pinMode(SCK, OUTPUT); pinMode(DC, OUTPUT); pinMode(RESET, OUTPUT); pinMode(CS, OUTPUT); digitalWrite(CS, HIGH); sckport = portOutputRegister(digitalPinToPort(SCK)); sckpinmask = digitalPinToBitMask(SCK); mosiport = portOutputRegister(digitalPinToPort(MOSI)); mosipinmask = digitalPinToBitMask(MOSI); csport = portOutputRegister(digitalPinToPort(CS)); cspinmask = digitalPinToBitMask(CS); dcport = portOutputRegister(digitalPinToPort(DC)); dcpinmask = digitalPinToBitMask(DC); digitalWrite(RESET, HIGH); // VDD (3.3V) goes high at start, lets just chill for 5 ms delay(5); // bring reset low digitalWrite(RESET, LOW); // Setup SPI frequency SPI.setClockDivider(SPI_CLOCK_DIV2); SPI.begin(); // wait 10ms delay(10); // bring out of reset digitalWrite(RESET, HIGH); // Init sequence for 64x48 OLED module command(DISPLAYOFF); // 0xAE command(SETDISPLAYCLOCKDIV); // 0xD5 command(0x80); // the suggested ratio 0x80 command(SETMULTIPLEX); // 0xA8 command(0x2F); command(SETDISPLAYOFFSET); // 0xD3 command(0x0); // no offset command(SETSTARTLINE | 0x0); // line #0 command(CHARGEPUMP); // enable charge pump command(0x14); command(NORMALDISPLAY); // 0xA6 command(DISPLAYALLONRESUME); // 0xA4 command(SEGREMAP | 0x1); command(COMSCANDEC); command(SETCOMPINS); // 0xDA command(0x12); command(SETCONTRAST); // 0x81 command(0x8F); command(SETPRECHARGE); // 0xd9 command(0xF1); command(SETVCOMDESELECT); // 0xDB command(0x40); command(DISPLAYON); //--turn on oled panel clear(ALL); // Erase hardware memory inside the OLED controller to avoid random data in memory. } void MICROVIEW::command(uint8_t c) { // Hardware SPI *csport |= cspinmask; // CS HIGH *dcport &= ~dcpinmask; // DC LOW *csport &= ~cspinmask; // CS LOW SPI.transfer(c); *csport |= cspinmask; // CS HIGH } void MICROVIEW::data(uint8_t c) { // Hardware SPI *csport |= cspinmask; // CS HIGH *dcport |= dcpinmask; // DC HIGH *csport &= ~cspinmask; // CS LOW SPI.transfer(c); *csport |= cspinmask; // CS HIGH } void MICROVIEW::setPageAddress(uint8_t add) { add=0xb0|add; command(add); return; } void MICROVIEW::setColumnAddress(uint8_t add) { command((0x10|(add>>4))+0x02); command((0x0f&add)); return; } /* Clear GDRAM inside the LCD controller - mode = ALL Clear screen page buffer - mode = PAGE */ void MICROVIEW::clear(uint8_t mode) { uint8_t page=6, col=0x40; if (mode==ALL) { for (int i=0;i<8; i++) { setPageAddress(i); setColumnAddress(0); for (int j=0; j<0x80; j++) { data(0); } } } else { memset(screenmemory,0,384); // (64 x 48) / 8 = 384 display(); } } /* Clear GDRAM inside the LCD controller - mode = ALL with c character. Clear screen page buffer - mode = PAGE with c character. */ void MICROVIEW::clear(uint8_t mode, uint8_t c) { uint8_t page=6, col=0x40; if (mode==ALL) { for (int i=0;i<8; i++) { setPageAddress(i); setColumnAddress(0); for (int j=0; j<0x80; j++) { data(c); } } } else { memset(screenmemory,c,384); // (64 x 48) / 8 = 384 display(); } } // This routine is to transfer the page buffer to the LCD controller's memory. void MICROVIEW::display(void) { uint8_t i, j; for (i=0; i<6; i++) { setPageAddress(i); setColumnAddress(0); for (j=0;j<0x40;j++) { data(screenmemory[i*0x40+j]); } } } #if ARDUINO >= 100 size_t MICROVIEW::write(uint8_t c) { #else void MICROVIEW::write(uint8_t c) { #endif if (c == '\n') { cursorY += fontHeight; cursorX = 0; } else if (c == '\r') { // skip } else { drawChar(cursorX, cursorY, c, foreColor, drawMode); cursorX += fontWidth+1; if ((cursorX > (LCDWIDTH - fontWidth))) { cursorY += fontHeight; cursorX = 0; } } #if ARDUINO >= 100 return 1; #endif } void MICROVIEW::setCursor(uint8_t x, uint8_t y) { cursorX=x; cursorY=y; } void MICROVIEW::pixel(uint8_t x, uint8_t y) { pixel(x,y,foreColor,drawMode); } void MICROVIEW::pixel(uint8_t x, uint8_t y, uint8_t color, uint8_t mode) { if ((x<0) || (x>=LCDWIDTH) || (y<0) || (y>=LCDHEIGHT)) return; if (mode==XOR) { if (color==WHITE) screenmemory[x+ (y/8)*LCDWIDTH] ^= _BV((y%8)); } else { if (color==WHITE) screenmemory[x+ (y/8)*LCDWIDTH] |= _BV((y%8)); else screenmemory[x+ (y/8)*LCDWIDTH] &= ~_BV((y%8)); } //display(); } // Draw line using current fore color and current draw mode void MICROVIEW::line(uint8_t x0, uint8_t y0, uint8_t x1, uint8_t y1) { line(x0,y0,x1,y1,foreColor,drawMode); } // Draw line using color and mode // bresenham's algorithm void MICROVIEW::line(uint8_t x0, uint8_t y0, uint8_t x1, uint8_t y1, uint8_t color, uint8_t mode) { uint8_t steep = abs(y1 - y0) > abs(x1 - x0); if (steep) { swap(x0, y0); swap(x1, y1); } if (x0 > x1) { swap(x0, x1); swap(y0, y1); } uint8_t dx, dy; dx = x1 - x0; dy = abs(y1 - y0); int8_t err = dx / 2; int8_t ystep; if (y0 < y1) { ystep = 1; } else { ystep = -1;} for (; x0= 0) { y--; ddF_y += 2; f += ddF_y; } x++; ddF_x += 2; f += ddF_x; pixel(x0 + x, y0 + y, color, mode); pixel(x0 - x, y0 + y, color, mode); pixel(x0 + x, y0 - y, color, mode); pixel(x0 - x, y0 - y, color, mode); pixel(x0 + y, y0 + x, color, mode); pixel(x0 - y, y0 + x, color, mode); pixel(x0 + y, y0 - x, color, mode); pixel(x0 - y, y0 - x, color, mode); } } // Draw filled circle using current fore color and current draw mode void MICROVIEW::circleFill(uint8_t x0, uint8_t y0, uint8_t radius) { circleFill(x0,y0,radius,foreColor,drawMode); } // Draw filled circle using color and mode void MICROVIEW::circleFill(uint8_t x0, uint8_t y0, uint8_t radius, uint8_t color, uint8_t mode) { // TODO - - find a way to check for no overlapping of pixels so that XOR draw mode will work perfectly int8_t f = 1 - radius; int8_t ddF_x = 1; int8_t ddF_y = -2 * radius; int8_t x = 0; int8_t y = radius; // Temporary disable fill circle for XOR mode. if (mode==XOR) return; for (uint8_t i=y0-radius; i<=y0+radius; i++) { pixel(x0, i, color, mode); } while (x= 0) { y--; ddF_y += 2; f += ddF_y; } x++; ddF_x += 2; f += ddF_x; for (uint8_t i=y0-y; i<=y0+y; i++) { pixel(x0+x, i, color, mode); pixel(x0-x, i, color, mode); } for (uint8_t i=y0-x; i<=y0+x; i++) { pixel(x0+y, i, color, mode); pixel(x0-y, i, color, mode); } } } uint8_t MICROVIEW::getLCDHeight(void) { return LCDHEIGHT; } uint8_t MICROVIEW::getLCDWidth(void) { return LCDWIDTH; } uint8_t MICROVIEW::getFontWidth(void) { return fontWidth; } uint8_t MICROVIEW::getFontHeight(void) { return fontHeight; } uint8_t MICROVIEW::getFontStartChar(void) { return fontStartChar; } uint8_t MICROVIEW::getFontTotalChar(void) { return fontTotalChar; } uint8_t MICROVIEW::getTotalFonts(void) { return TOTALFONTS; } uint8_t MICROVIEW::getFontType(void) { return fontType; } uint8_t MICROVIEW::setFontType(uint8_t type) { if ((type>=TOTALFONTS) || (type<0)) return -1; fontType=type; fontWidth=pgm_read_byte(fontsPointer[fontType]+0); fontHeight=pgm_read_byte(fontsPointer[fontType]+1); fontStartChar=pgm_read_byte(fontsPointer[fontType]+2); fontTotalChar=pgm_read_byte(fontsPointer[fontType]+3); fontMapWidth=(pgm_read_byte(fontsPointer[fontType]+4)*100)+pgm_read_byte(fontsPointer[fontType]+5); // two bytes values into integer 16 } void MICROVIEW::setColor(uint8_t color) { foreColor=color; } void MICROVIEW::setDrawMode(uint8_t mode) { drawMode=mode; } // Draw character using current fore color and current draw mode void MICROVIEW::drawChar(uint8_t x, uint8_t y, uint8_t c) { drawChar(x,y,c,foreColor,drawMode); } // Draw character using color and mode void MICROVIEW::drawChar(uint8_t x, uint8_t y, uint8_t c, uint8_t color, uint8_t mode) { // TODO - New routine to take font of any height, at the moment limited to font height in multiple of 8 pixels uint8_t rowsToDraw,row, tempC; uint8_t i,j,temp; uint16_t charPerBitmapRow,charColPositionOnBitmap,charRowPositionOnBitmap,charBitmapStartPosition; if ((c(fontStartChar+fontTotalChar-1))) // no bitmap for the required c return; tempC=c-fontStartChar; // each row (in datasheet is call page) is 8 bits high, 16 bit high character will have 2 rows to be drawn rowsToDraw=fontHeight/8; // 8 is LCD's page size, see SSD1306 datasheet if (rowsToDraw<=1) rowsToDraw=1; // the following draw function can draw anywhere on the screen, but SLOW pixel by pixel draw if (rowsToDraw==1) { for (i=0;i>=1; } } return; } // font height over 8 bit // take character "0" ASCII 48 as example charPerBitmapRow=fontMapWidth/fontWidth; // 256/8 =32 char per row charColPositionOnBitmap=tempC % charPerBitmapRow; // =16 charRowPositionOnBitmap=int(tempC/charPerBitmapRow); // =1 charBitmapStartPosition=(charRowPositionOnBitmap * fontMapWidth * (fontHeight/8)) + (charColPositionOnBitmap * fontWidth) ; // each row on LCD is 8 bit height (see datasheet for explanation) for(row=0;row>=1; } } } /* fast direct memory draw but has a limitation to draw in ROWS // only 1 row to draw for font with 8 bit height if (rowsToDraw==1) { for (i=0; i