UniGraphic-Fork for ST7920-LCD-controller and SH1106. Tested with 128x64 LCD with SPI and 128x64-OLED with IIC
Dependents: UniGraphic-St7920-Test AfficheurUTILECO
Fork of UniGraphic by
Fork of the UniGraphic-Library for monochrome LCDs with ST7920 controller and 128x64-IIC-OLED-Display with SH1106-Controller
Had to adapt LCD for following reasons:
- Give access to screenbuffer buffer[] to parent class
- pixel() and pixel_read() as they are hardware-dependent
- added reset-pin to IIC-Interface
GraphicDisplay:: sends buffer to LCD when auto_update is set to true.
Testprogram for ST7920 can be found here:
https://developer.mbed.org/users/charly/code/UniGraphic-St7920-Test/
Inits/SH1106.cpp@37:5de028b08308, 2018-04-25 (annotated)
- Committer:
- charly
- Date:
- Wed Apr 25 20:55:59 2018 +0000
- Revision:
- 37:5de028b08308
- Parent:
- 36:668396f861d2
- Child:
- 38:1b6f9fc49a03
Restored SSD1306.
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
charly | 36:668396f861d2 | 1 | /* mbed UniGraphic library - Device specific class |
charly | 37:5de028b08308 | 2 | * SH1106 by Karl Zweimüller, based on |
charly | 36:668396f861d2 | 3 | * SSD1306 by Copyright (c) 2015 Peter Drescher |
charly | 36:668396f861d2 | 4 | * Released under the MIT License: http://mbed.org/license/mit |
charly | 36:668396f861d2 | 5 | */ |
charly | 36:668396f861d2 | 6 | |
charly | 36:668396f861d2 | 7 | #include "Protocols.h" |
charly | 36:668396f861d2 | 8 | #include "SH1106.h" |
charly | 36:668396f861d2 | 9 | |
charly | 36:668396f861d2 | 10 | ////////////////////////////////////////////////////////////////////////////////// |
charly | 36:668396f861d2 | 11 | // display settings /////////////////////////////////////////////////////// |
charly | 36:668396f861d2 | 12 | ///////////////////////////////////////////////////////////////////////// |
charly | 36:668396f861d2 | 13 | |
charly | 36:668396f861d2 | 14 | |
charly | 36:668396f861d2 | 15 | #define IC_X_SEGS 132 // 132 SEG |
charly | 36:668396f861d2 | 16 | #define IC_Y_COMS 64 // 64 COM |
charly | 36:668396f861d2 | 17 | |
charly | 36:668396f861d2 | 18 | #define SH1106_SETCONTRAST 0x81 |
charly | 36:668396f861d2 | 19 | #define SH1106_DISPLAYALLON_RESUME 0xA4 |
charly | 36:668396f861d2 | 20 | #define SH1106_DISPLAYALLON 0xA5 |
charly | 36:668396f861d2 | 21 | #define SH1106_NORMALDISPLAY 0xA6 |
charly | 36:668396f861d2 | 22 | #define SH1106_INVERTDISPLAY 0xA7 |
charly | 36:668396f861d2 | 23 | #define SH1106_DISPLAYOFF 0xAE |
charly | 36:668396f861d2 | 24 | #define SH1106_DISPLAYON 0xAF |
charly | 36:668396f861d2 | 25 | #define SH1106_SETDISPLAYOFFSET 0xD3 |
charly | 36:668396f861d2 | 26 | #define SH1106_SETCOMPINS 0xDA |
charly | 36:668396f861d2 | 27 | #define SH1106_SETVCOMDETECT 0xDB |
charly | 36:668396f861d2 | 28 | #define SH1106_SETDISPLAYCLOCKDIV 0xD5 |
charly | 36:668396f861d2 | 29 | #define SH1106_SETPRECHARGE 0xD9 |
charly | 36:668396f861d2 | 30 | #define SH1106_SETMULTIPLEX 0xA8 |
charly | 36:668396f861d2 | 31 | #define SH1106_SETLOWCOLUMN 0x00 |
charly | 36:668396f861d2 | 32 | #define SH1106_SETHIGHCOLUMN 0x10 |
charly | 36:668396f861d2 | 33 | #define SH1106_SETSTARTLINE 0x40 |
charly | 36:668396f861d2 | 34 | #define SH1106_MEMORYMODE 0x20 |
charly | 36:668396f861d2 | 35 | #define SH1106_COMSCANINC 0xC0 |
charly | 36:668396f861d2 | 36 | #define SH1106_COMSCANDEC 0xC8 |
charly | 36:668396f861d2 | 37 | #define SH1106_SEGREMAP 0xA0 |
charly | 36:668396f861d2 | 38 | #define SH1106_CHARGEPUMP 0x8D |
charly | 36:668396f861d2 | 39 | |
charly | 36:668396f861d2 | 40 | SH1106::SH1106(proto_t displayproto, PortName port, PinName CS, PinName reset, PinName DC, PinName WR, PinName RD, const char *name , unsigned int LCDSIZE_X, unsigned int LCDSIZE_Y) |
charly | 36:668396f861d2 | 41 | : LCD(displayproto, port, CS, reset, DC, WR, RD, LCDSIZE_X, LCDSIZE_Y, IC_X_SEGS, IC_Y_COMS, name) |
charly | 36:668396f861d2 | 42 | { |
charly | 36:668396f861d2 | 43 | hw_reset(); |
charly | 36:668396f861d2 | 44 | BusEnable(true); |
charly | 36:668396f861d2 | 45 | init(); |
charly | 36:668396f861d2 | 46 | cls(); |
charly | 36:668396f861d2 | 47 | set_orientation(1); |
charly | 36:668396f861d2 | 48 | locate(0,0); |
charly | 36:668396f861d2 | 49 | } |
charly | 36:668396f861d2 | 50 | SH1106::SH1106(proto_t displayproto, int Hz, PinName mosi, PinName miso, PinName sclk, PinName CS, PinName reset, PinName DC, const char *name, unsigned int LCDSIZE_X, unsigned int LCDSIZE_Y) |
charly | 36:668396f861d2 | 51 | : LCD(displayproto, Hz, mosi, miso, sclk, CS, reset, DC, LCDSIZE_X, LCDSIZE_Y, IC_X_SEGS, IC_Y_COMS, name) |
charly | 36:668396f861d2 | 52 | { |
charly | 36:668396f861d2 | 53 | hw_reset(); |
charly | 36:668396f861d2 | 54 | BusEnable(true); |
charly | 36:668396f861d2 | 55 | init(); |
charly | 36:668396f861d2 | 56 | cls(); |
charly | 36:668396f861d2 | 57 | set_orientation(1); |
charly | 36:668396f861d2 | 58 | locate(0,0); |
charly | 36:668396f861d2 | 59 | } |
charly | 36:668396f861d2 | 60 | |
charly | 36:668396f861d2 | 61 | SH1106::SH1106(proto_t displayproto, int Hz, int address, PinName sda, PinName scl, PinName reset, const char* name , unsigned int LCDSIZE_X, unsigned int LCDSIZE_Y) |
charly | 36:668396f861d2 | 62 | : LCD(displayproto, Hz, address, sda, scl,reset, LCDSIZE_X, LCDSIZE_Y, IC_X_SEGS, IC_Y_COMS, name) |
charly | 36:668396f861d2 | 63 | { |
charly | 36:668396f861d2 | 64 | hw_reset(); |
charly | 36:668396f861d2 | 65 | init(); |
charly | 36:668396f861d2 | 66 | cls(); |
charly | 36:668396f861d2 | 67 | set_orientation(1); |
charly | 36:668396f861d2 | 68 | locate(0,0); |
charly | 36:668396f861d2 | 69 | } |
charly | 36:668396f861d2 | 70 | |
charly | 36:668396f861d2 | 71 | |
charly | 36:668396f861d2 | 72 | // reset and init the lcd controller |
charly | 36:668396f861d2 | 73 | void SH1106::init() |
charly | 36:668396f861d2 | 74 | { |
charly | 36:668396f861d2 | 75 | /* Start Initial Sequence ----------------------------------------------------*/ |
charly | 36:668396f861d2 | 76 | /* SH1106 |
charly | 36:668396f861d2 | 77 | // wr_cmd8(0xE2); // sw reset |
charly | 36:668396f861d2 | 78 | wait_ms(15); |
charly | 36:668396f861d2 | 79 | |
charly | 36:668396f861d2 | 80 | wr_cmd8(SH1106_DISPLAYOFF); // no problem in SPI_16 for single byte cmds |
charly | 36:668396f861d2 | 81 | wr_cmd16((SH1106_SETDISPLAYCLOCKDIV<<8)|0x80); // wr_cmd16 for multibyte cmds issue in SPI16 mode |
charly | 36:668396f861d2 | 82 | // wr_cmd8(0x80); // in SPI_16 it would become 0xE380 and will break things up |
charly | 36:668396f861d2 | 83 | wr_cmd16((SH1106_SETMULTIPLEX<<8)|63); |
charly | 36:668396f861d2 | 84 | // wr_cmd8(63); |
charly | 36:668396f861d2 | 85 | |
charly | 36:668396f861d2 | 86 | wr_cmd16((SH1106_SETDISPLAYOFFSET<<8)|0x00); |
charly | 36:668396f861d2 | 87 | // wr_cmd8(0x0); |
charly | 36:668396f861d2 | 88 | |
charly | 36:668396f861d2 | 89 | wr_cmd8(SH1106_SETSTARTLINE | 0x0); // line #0 |
charly | 36:668396f861d2 | 90 | |
charly | 36:668396f861d2 | 91 | wr_cmd16((SH1106_CHARGEPUMP<<8)|0x14); |
charly | 36:668396f861d2 | 92 | // wr_cmd8(0x14); // 0x10 |
charly | 36:668396f861d2 | 93 | |
charly | 36:668396f861d2 | 94 | wr_cmd16((SH1106_MEMORYMODE<<8)|0x00); |
charly | 36:668396f861d2 | 95 | // wr_cmd8(0x00); // 0x0 act like ks0108 |
charly | 36:668396f861d2 | 96 | |
charly | 36:668396f861d2 | 97 | wr_cmd8(SH1106_SEGREMAP ); //| 0x1); |
charly | 36:668396f861d2 | 98 | |
charly | 36:668396f861d2 | 99 | wr_cmd8(SH1106_COMSCANDEC); |
charly | 36:668396f861d2 | 100 | |
charly | 36:668396f861d2 | 101 | wr_cmd16((SH1106_SETCOMPINS<<8)|0x12); |
charly | 36:668396f861d2 | 102 | // wr_cmd8(0x12); // LCDSIZE_Y == 32 ? 0x02 : 0x12); |
charly | 36:668396f861d2 | 103 | |
charly | 36:668396f861d2 | 104 | wr_cmd16((SH1106_SETCONTRAST<<8)|0xCF); |
charly | 36:668396f861d2 | 105 | // wr_cmd8(0xCF); // _rawHeight == 32 ? 0x8F : ((vccstate == SH1106_EXTERNALVCC) ? 0x9F : 0xCF) ); |
charly | 36:668396f861d2 | 106 | |
charly | 36:668396f861d2 | 107 | wr_cmd16((SH1106_SETPRECHARGE<<8)|0xF1); |
charly | 36:668396f861d2 | 108 | // wr_cmd8(0xF1); // : 0x22); |
charly | 36:668396f861d2 | 109 | |
charly | 36:668396f861d2 | 110 | wr_cmd16((SH1106_SETVCOMDETECT<<8)|0x40); |
charly | 36:668396f861d2 | 111 | // wr_cmd8(0x40); |
charly | 36:668396f861d2 | 112 | |
charly | 36:668396f861d2 | 113 | wr_cmd8(SH1106_DISPLAYALLON_RESUME); |
charly | 36:668396f861d2 | 114 | |
charly | 36:668396f861d2 | 115 | //wr_cmd8(SH1106_NORMALDISPLAY); |
charly | 36:668396f861d2 | 116 | wr_cmd8(SH1106_INVERTDISPLAY); |
charly | 36:668396f861d2 | 117 | |
charly | 36:668396f861d2 | 118 | wr_cmd8(SH1106_DISPLAYON); |
charly | 36:668396f861d2 | 119 | */ |
charly | 36:668396f861d2 | 120 | |
charly | 36:668396f861d2 | 121 | //SH1106 |
charly | 36:668396f861d2 | 122 | wr_cmd8(0xAE);//--turn off oled panel |
charly | 36:668396f861d2 | 123 | wr_cmd8(0x02);//---set low column address |
charly | 36:668396f861d2 | 124 | wr_cmd8(0x10);//---set high column address |
charly | 36:668396f861d2 | 125 | wr_cmd8(0x40);//--set start line address Set Mapping RAM Display Start Line (0x00~0x3F) |
charly | 36:668396f861d2 | 126 | wr_cmd8(0x81);//--set contrast control register |
charly | 36:668396f861d2 | 127 | wr_cmd8(0xA0);//--Set contrast |
charly | 36:668396f861d2 | 128 | wr_cmd8(0xA8);//--set multiplex ratio(1 to 64) |
charly | 36:668396f861d2 | 129 | wr_cmd8(0x3F);//--1/64 duty |
charly | 36:668396f861d2 | 130 | wr_cmd8(0xD3);//-set display offset Shift Mapping RAM Counter (0x00~0x3F) |
charly | 36:668396f861d2 | 131 | wr_cmd8(0x00);//-not offset |
charly | 36:668396f861d2 | 132 | wr_cmd8(0xd5);//--set display clock divide ratio/oscillator frequency |
charly | 36:668396f861d2 | 133 | wr_cmd8(0x80);//--set divide ratio, Set Clock as 100 Frames/Sec |
charly | 36:668396f861d2 | 134 | wr_cmd8(0xD9);//--set pre-charge period |
charly | 36:668396f861d2 | 135 | wr_cmd8(0xF1);//Set Pre-Charge as 15 Clocks & Discharge as 1 Clock |
charly | 36:668396f861d2 | 136 | wr_cmd8(0xDA);//--set com pins hardware configuration |
charly | 36:668396f861d2 | 137 | wr_cmd8(0x12); // or 0x02 |
charly | 36:668396f861d2 | 138 | wr_cmd8(0xDB);//--set vcomh |
charly | 36:668396f861d2 | 139 | wr_cmd8(0x40);//Set VCOM Deselect Level |
charly | 36:668396f861d2 | 140 | //wr_cmd8(0x20);//-Set Page Addressing Mode (0x00/0x01/0x02) // not on SH1106 |
charly | 36:668396f861d2 | 141 | wr_cmd8(0xA4);// Disable Entire Display On (0xa4/0xa5) |
charly | 36:668396f861d2 | 142 | wr_cmd8(0xA6);// Disable Inverse Display On (0xa6/a7) |
charly | 36:668396f861d2 | 143 | |
charly | 37:5de028b08308 | 144 | wr_cmd8(0xA0); // normal order |
charly | 37:5de028b08308 | 145 | //wr_cmd8(0xA1); // reverse order |
charly | 37:5de028b08308 | 146 | wr_cmd8(0xC0);//Set COM/Row Scan Direction normal |
charly | 37:5de028b08308 | 147 | //wr_cmd8(0xC8); //reverse direction |
charly | 36:668396f861d2 | 148 | wr_cmd8(0xAF);//--turn on oled panel |
charly | 36:668396f861d2 | 149 | } |
charly | 36:668396f861d2 | 150 | |
charly | 36:668396f861d2 | 151 | //////////////////////////////////////////////////////////////////// |
charly | 36:668396f861d2 | 152 | // functions that overrides the standard ones implemented in LCD.cpp |
charly | 36:668396f861d2 | 153 | //////////////////////////////////////////////////////////////////// |
charly | 36:668396f861d2 | 154 | |
charly | 36:668396f861d2 | 155 | void SH1106::copy_to_lcd(void) |
charly | 36:668396f861d2 | 156 | { |
charly | 36:668396f861d2 | 157 | |
charly | 36:668396f861d2 | 158 | for(int page=0; page<8 /*_LCDPAGES */; page++) { |
charly | 37:5de028b08308 | 159 | wr_cmd8(0x02); // set column low nibble My Display starts at column 2 (up to column 130 of 132) |
charly | 36:668396f861d2 | 160 | wr_cmd8(0x10); // set column hi nibble |
charly | 36:668396f861d2 | 161 | wr_cmd8(0xB0+page); // set page |
charly | 36:668396f861d2 | 162 | wr_grambuf(buffer16+(page*screensize_X>>1), screensize_X>>1); // send whole page pixels as shorts(16bit) not bytes! |
charly | 36:668396f861d2 | 163 | } |
charly | 36:668396f861d2 | 164 | } |
charly | 36:668396f861d2 | 165 | |
charly | 36:668396f861d2 | 166 | void SH1106::cls(void) |
charly | 36:668396f861d2 | 167 | { |
charly | 36:668396f861d2 | 168 | unsigned short tmp = _background^0xFFFF; |
charly | 36:668396f861d2 | 169 | //memset(buffer,tmp,/*screensize_X*_LCDPAGES*/ 128*64/8); // clear display buffer |
charly | 36:668396f861d2 | 170 | memset(buffer,0x00,screensize_X*(screensize_Y>>3)); // clear display buffer |
charly | 36:668396f861d2 | 171 | copy_to_lcd(); |
charly | 36:668396f861d2 | 172 | } |
charly | 36:668396f861d2 | 173 | |
charly | 36:668396f861d2 | 174 | void SH1106::mirrorXY(mirror_t mode) |
charly | 36:668396f861d2 | 175 | { |
charly | 36:668396f861d2 | 176 | switch (mode) { |
charly | 36:668396f861d2 | 177 | case(NONE): |
charly | 36:668396f861d2 | 178 | wr_cmd16(0xA0C0); |
charly | 36:668396f861d2 | 179 | break; |
charly | 36:668396f861d2 | 180 | case(X): |
charly | 36:668396f861d2 | 181 | wr_cmd16(0xA1C0); |
charly | 36:668396f861d2 | 182 | break; |
charly | 36:668396f861d2 | 183 | case(Y): |
charly | 36:668396f861d2 | 184 | wr_cmd16(0xA0C8); |
charly | 36:668396f861d2 | 185 | break; |
charly | 36:668396f861d2 | 186 | case(XY): |
charly | 36:668396f861d2 | 187 | wr_cmd16(0xA1C8); |
charly | 36:668396f861d2 | 188 | break; |
charly | 36:668396f861d2 | 189 | } |
charly | 36:668396f861d2 | 190 | } |
charly | 36:668396f861d2 | 191 | |
charly | 36:668396f861d2 | 192 | void SH1106::set_contrast(int o) |
charly | 36:668396f861d2 | 193 | { |
charly | 36:668396f861d2 | 194 | contrast = o; |
charly | 36:668396f861d2 | 195 | |
charly | 36:668396f861d2 | 196 | wr_cmd16(0x8100|(o&0xFF)); |
charly | 36:668396f861d2 | 197 | } |
charly | 36:668396f861d2 | 198 | |
charly | 36:668396f861d2 | 199 | void SH1106::pixel(int x, int y, unsigned short color) |
charly | 36:668396f861d2 | 200 | { |
charly | 36:668396f861d2 | 201 | // first check parameter |
charly | 36:668396f861d2 | 202 | if((x >= screensize_X) || (y >= screensize_Y) || (x<0) || (y<0)) return; |
charly | 36:668396f861d2 | 203 | |
charly | 36:668396f861d2 | 204 | //Buffer[(Xpoint + (Ypoint / 8) * sOLED_DIS.OLED_Dis_Column)] |= 1 << (Ypoint % 8); |
charly | 36:668396f861d2 | 205 | //Buffer[(Xpoint + (Ypoint / 8) * sOLED_DIS.OLED_Dis_Column)] |= 0 << (Ypoint % 8); |
charly | 36:668396f861d2 | 206 | if (color) { |
charly | 36:668396f861d2 | 207 | buffer[x+((y>>3)*screensize_X)] |= 0 << (y % 8); |
charly | 36:668396f861d2 | 208 | } else { |
charly | 36:668396f861d2 | 209 | buffer[x+((y>>3)*screensize_X)] |= 1 << (y % 8); |
charly | 36:668396f861d2 | 210 | } |
charly | 36:668396f861d2 | 211 | |
charly | 36:668396f861d2 | 212 | |
charly | 36:668396f861d2 | 213 | } |
charly | 36:668396f861d2 | 214 | |
charly | 36:668396f861d2 | 215 | |
charly | 36:668396f861d2 | 216 | unsigned short SH1106::pixelread(int x, int y) |
charly | 36:668396f861d2 | 217 | { |
charly | 36:668396f861d2 | 218 | // first check parameter |
charly | 36:668396f861d2 | 219 | if((x >= screensize_X) || (y >= screensize_Y) || (x<0) || (y<0)) return 0; |
charly | 36:668396f861d2 | 220 | |
charly | 36:668396f861d2 | 221 | //Buffer[(Xpoint + (Ypoint / 8) * sOLED_DIS.OLED_Dis_Column)] |= 1 << (Ypoint % 8); |
charly | 36:668396f861d2 | 222 | //Buffer[(Xpoint + (Ypoint / 8) * sOLED_DIS.OLED_Dis_Column)] |= 0 << (Ypoint % 8); |
charly | 36:668396f861d2 | 223 | if (buffer[x+((y>>3)*screensize_X)] & 1 << (y % 8) == 0) |
charly | 36:668396f861d2 | 224 | return 0xFFFF ; // pixel not set, White |
charly | 36:668396f861d2 | 225 | else return 0; // pixel set, Black |
charly | 36:668396f861d2 | 226 | } |