Karl Zweimüller / UniGraphic

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 GraphicsDisplay

Fork of the UniGraphic-Library for monochrome LCDs with ST7920 controller and 128x64-IIC-OLED-Display with SH1106-Controller

/media/uploads/charly/20170522_210344.jpg

/media/uploads/charly/20180425_230623.jpg

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@38:1b6f9fc49a03, 2018-10-30 (annotated)

Committer:
charly
Date:
Tue Oct 30 20:00:29 2018 +0000
Revision:
38:1b6f9fc49a03
Parent:
37:5de028b08308 
some modifications.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
charly 36:668396f861d2 1 /* mbed UniGraphic library - Device specific class
charly 38:1b6f9fc49a03 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 38:1b6f9fc49a03 49 copy_to_lcd();
charly 36:668396f861d2 50 }
charly 36:668396f861d2 51 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 52 : LCD(displayproto, Hz, mosi, miso, sclk, CS, reset, DC, LCDSIZE_X, LCDSIZE_Y, IC_X_SEGS, IC_Y_COMS, name)
charly 36:668396f861d2 53 {
charly 36:668396f861d2 54 hw_reset();
charly 36:668396f861d2 55 BusEnable(true);
charly 36:668396f861d2 56 init();
charly 36:668396f861d2 57 cls();
charly 36:668396f861d2 58 set_orientation(1);
charly 36:668396f861d2 59 locate(0,0);
charly 38:1b6f9fc49a03 60 copy_to_lcd();
charly 36:668396f861d2 61 }
charly 36:668396f861d2 62
charly 36:668396f861d2 63 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 64 : LCD(displayproto, Hz, address, sda, scl,reset, LCDSIZE_X, LCDSIZE_Y, IC_X_SEGS, IC_Y_COMS, name)
charly 36:668396f861d2 65 {
charly 36:668396f861d2 66 hw_reset();
charly 36:668396f861d2 67 init();
charly 36:668396f861d2 68 cls();
charly 36:668396f861d2 69 set_orientation(1);
charly 36:668396f861d2 70 locate(0,0);
charly 38:1b6f9fc49a03 71 copy_to_lcd();
charly 36:668396f861d2 72 }
charly 36:668396f861d2 73
charly 36:668396f861d2 74
charly 36:668396f861d2 75 // reset and init the lcd controller
charly 36:668396f861d2 76 void SH1106::init()
charly 36:668396f861d2 77 {
charly 36:668396f861d2 78 /* Start Initial Sequence ----------------------------------------------------*/
charly 36:668396f861d2 79 /* SH1106
charly 36:668396f861d2 80 // wr_cmd8(0xE2); // sw reset
charly 36:668396f861d2 81 wait_ms(15);
charly 36:668396f861d2 82
charly 36:668396f861d2 83 wr_cmd8(SH1106_DISPLAYOFF); // no problem in SPI_16 for single byte cmds
charly 36:668396f861d2 84 wr_cmd16((SH1106_SETDISPLAYCLOCKDIV<<8)|0x80); // wr_cmd16 for multibyte cmds issue in SPI16 mode
charly 36:668396f861d2 85 // wr_cmd8(0x80); // in SPI_16 it would become 0xE380 and will break things up
charly 36:668396f861d2 86 wr_cmd16((SH1106_SETMULTIPLEX<<8)|63);
charly 36:668396f861d2 87 // wr_cmd8(63);
charly 36:668396f861d2 88
charly 36:668396f861d2 89 wr_cmd16((SH1106_SETDISPLAYOFFSET<<8)|0x00);
charly 36:668396f861d2 90 // wr_cmd8(0x0);
charly 36:668396f861d2 91
charly 36:668396f861d2 92 wr_cmd8(SH1106_SETSTARTLINE | 0x0); // line #0
charly 36:668396f861d2 93
charly 36:668396f861d2 94 wr_cmd16((SH1106_CHARGEPUMP<<8)|0x14);
charly 36:668396f861d2 95 // wr_cmd8(0x14); // 0x10
charly 36:668396f861d2 96
charly 36:668396f861d2 97 wr_cmd16((SH1106_MEMORYMODE<<8)|0x00);
charly 36:668396f861d2 98 // wr_cmd8(0x00); // 0x0 act like ks0108
charly 36:668396f861d2 99
charly 36:668396f861d2 100 wr_cmd8(SH1106_SEGREMAP ); //| 0x1);
charly 36:668396f861d2 101
charly 36:668396f861d2 102 wr_cmd8(SH1106_COMSCANDEC);
charly 36:668396f861d2 103
charly 36:668396f861d2 104 wr_cmd16((SH1106_SETCOMPINS<<8)|0x12);
charly 36:668396f861d2 105 // wr_cmd8(0x12); // LCDSIZE_Y == 32 ? 0x02 : 0x12);
charly 36:668396f861d2 106
charly 36:668396f861d2 107 wr_cmd16((SH1106_SETCONTRAST<<8)|0xCF);
charly 36:668396f861d2 108 // wr_cmd8(0xCF); // _rawHeight == 32 ? 0x8F : ((vccstate == SH1106_EXTERNALVCC) ? 0x9F : 0xCF) );
charly 36:668396f861d2 109
charly 36:668396f861d2 110 wr_cmd16((SH1106_SETPRECHARGE<<8)|0xF1);
charly 36:668396f861d2 111 // wr_cmd8(0xF1); // : 0x22);
charly 36:668396f861d2 112
charly 36:668396f861d2 113 wr_cmd16((SH1106_SETVCOMDETECT<<8)|0x40);
charly 36:668396f861d2 114 // wr_cmd8(0x40);
charly 36:668396f861d2 115
charly 36:668396f861d2 116 wr_cmd8(SH1106_DISPLAYALLON_RESUME);
charly 36:668396f861d2 117
charly 36:668396f861d2 118 //wr_cmd8(SH1106_NORMALDISPLAY);
charly 36:668396f861d2 119 wr_cmd8(SH1106_INVERTDISPLAY);
charly 36:668396f861d2 120
charly 36:668396f861d2 121 wr_cmd8(SH1106_DISPLAYON);
charly 36:668396f861d2 122 */
charly 36:668396f861d2 123
charly 36:668396f861d2 124 //SH1106
charly 36:668396f861d2 125 wr_cmd8(0xAE);//--turn off oled panel
charly 36:668396f861d2 126 wr_cmd8(0x02);//---set low column address
charly 36:668396f861d2 127 wr_cmd8(0x10);//---set high column address
charly 36:668396f861d2 128 wr_cmd8(0x40);//--set start line address Set Mapping RAM Display Start Line (0x00~0x3F)
charly 36:668396f861d2 129 wr_cmd8(0x81);//--set contrast control register
charly 36:668396f861d2 130 wr_cmd8(0xA0);//--Set contrast
charly 36:668396f861d2 131 wr_cmd8(0xA8);//--set multiplex ratio(1 to 64)
charly 36:668396f861d2 132 wr_cmd8(0x3F);//--1/64 duty
charly 36:668396f861d2 133 wr_cmd8(0xD3);//-set display offset Shift Mapping RAM Counter (0x00~0x3F)
charly 36:668396f861d2 134 wr_cmd8(0x00);//-not offset
charly 36:668396f861d2 135 wr_cmd8(0xd5);//--set display clock divide ratio/oscillator frequency
charly 36:668396f861d2 136 wr_cmd8(0x80);//--set divide ratio, Set Clock as 100 Frames/Sec
charly 36:668396f861d2 137 wr_cmd8(0xD9);//--set pre-charge period
charly 36:668396f861d2 138 wr_cmd8(0xF1);//Set Pre-Charge as 15 Clocks & Discharge as 1 Clock
charly 36:668396f861d2 139 wr_cmd8(0xDA);//--set com pins hardware configuration
charly 36:668396f861d2 140 wr_cmd8(0x12); // or 0x02
charly 36:668396f861d2 141 wr_cmd8(0xDB);//--set vcomh
charly 36:668396f861d2 142 wr_cmd8(0x40);//Set VCOM Deselect Level
charly 36:668396f861d2 143 //wr_cmd8(0x20);//-Set Page Addressing Mode (0x00/0x01/0x02) // not on SH1106
charly 36:668396f861d2 144 wr_cmd8(0xA4);// Disable Entire Display On (0xa4/0xa5)
charly 36:668396f861d2 145 wr_cmd8(0xA6);// Disable Inverse Display On (0xa6/a7)
charly 36:668396f861d2 146
charly 37:5de028b08308 147 wr_cmd8(0xA0); // normal order
charly 37:5de028b08308 148 //wr_cmd8(0xA1); // reverse order
charly 37:5de028b08308 149 wr_cmd8(0xC0);//Set COM/Row Scan Direction normal
charly 37:5de028b08308 150 //wr_cmd8(0xC8); //reverse direction
charly 36:668396f861d2 151 wr_cmd8(0xAF);//--turn on oled panel
charly 36:668396f861d2 152 }
charly 36:668396f861d2 153
charly 36:668396f861d2 154 ////////////////////////////////////////////////////////////////////
charly 36:668396f861d2 155 // functions that overrides the standard ones implemented in LCD.cpp
charly 36:668396f861d2 156 ////////////////////////////////////////////////////////////////////
charly 36:668396f861d2 157
charly 36:668396f861d2 158 void SH1106::copy_to_lcd(void)
charly 36:668396f861d2 159 {
charly 36:668396f861d2 160
charly 38:1b6f9fc49a03 161 for(uint8_t page=0; page<8 /*_LCDPAGES */; page++) {
charly 38:1b6f9fc49a03 162 wr_cmd8(0xB0+page); // set page
charly 37:5de028b08308 163 wr_cmd8(0x02); // set column low nibble My Display starts at column 2 (up to column 130 of 132)
charly 36:668396f861d2 164 wr_cmd8(0x10); // set column hi nibble
charly 36:668396f861d2 165 wr_grambuf(buffer16+(page*screensize_X>>1), screensize_X>>1); // send whole page pixels as shorts(16bit) not bytes!
charly 36:668396f861d2 166 }
charly 36:668396f861d2 167 }
charly 36:668396f861d2 168
charly 36:668396f861d2 169 void SH1106::cls(void)
charly 36:668396f861d2 170 {
charly 36:668396f861d2 171 unsigned short tmp = _background^0xFFFF;
charly 36:668396f861d2 172 //memset(buffer,tmp,/*screensize_X*_LCDPAGES*/ 128*64/8); // clear display buffer
charly 36:668396f861d2 173 memset(buffer,0x00,screensize_X*(screensize_Y>>3)); // clear display buffer
charly 38:1b6f9fc49a03 174 if (get_auto_up()) {
charly 38:1b6f9fc49a03 175 copy_to_lcd();
charly 38:1b6f9fc49a03 176 }
charly 36:668396f861d2 177 }
charly 36:668396f861d2 178
charly 36:668396f861d2 179 void SH1106::mirrorXY(mirror_t mode)
charly 36:668396f861d2 180 {
charly 36:668396f861d2 181 switch (mode) {
charly 36:668396f861d2 182 case(NONE):
charly 36:668396f861d2 183 wr_cmd16(0xA0C0);
charly 36:668396f861d2 184 break;
charly 36:668396f861d2 185 case(X):
charly 36:668396f861d2 186 wr_cmd16(0xA1C0);
charly 36:668396f861d2 187 break;
charly 36:668396f861d2 188 case(Y):
charly 36:668396f861d2 189 wr_cmd16(0xA0C8);
charly 36:668396f861d2 190 break;
charly 36:668396f861d2 191 case(XY):
charly 36:668396f861d2 192 wr_cmd16(0xA1C8);
charly 36:668396f861d2 193 break;
charly 36:668396f861d2 194 }
charly 36:668396f861d2 195 }
charly 36:668396f861d2 196
charly 36:668396f861d2 197 void SH1106::set_contrast(int o)
charly 36:668396f861d2 198 {
charly 36:668396f861d2 199 contrast = o;
charly 36:668396f861d2 200
charly 36:668396f861d2 201 wr_cmd16(0x8100|(o&0xFF));
charly 36:668396f861d2 202 }
charly 36:668396f861d2 203
charly 36:668396f861d2 204 void SH1106::pixel(int x, int y, unsigned short color)
charly 36:668396f861d2 205 {
charly 36:668396f861d2 206 // first check parameter
charly 36:668396f861d2 207 if((x >= screensize_X) || (y >= screensize_Y) || (x<0) || (y<0)) return;
charly 36:668396f861d2 208
charly 36:668396f861d2 209 //Buffer[(Xpoint + (Ypoint / 8) * sOLED_DIS.OLED_Dis_Column)] |= 1 << (Ypoint % 8);
charly 36:668396f861d2 210 //Buffer[(Xpoint + (Ypoint / 8) * sOLED_DIS.OLED_Dis_Column)] |= 0 << (Ypoint % 8);
charly 36:668396f861d2 211 if (color) {
charly 38:1b6f9fc49a03 212 buffer[x+((y>>3)*screensize_X)] |= 1 << (y % 8);
charly 36:668396f861d2 213 } else {
charly 38:1b6f9fc49a03 214 buffer[x+((y>>3)*screensize_X)] |= 0 << (y % 8);
charly 36:668396f861d2 215 }
charly 36:668396f861d2 216 }
charly 36:668396f861d2 217
charly 36:668396f861d2 218
charly 36:668396f861d2 219 unsigned short SH1106::pixelread(int x, int y)
charly 36:668396f861d2 220 {
charly 36:668396f861d2 221 // first check parameter
charly 36:668396f861d2 222 if((x >= screensize_X) || (y >= screensize_Y) || (x<0) || (y<0)) return 0;
charly 36:668396f861d2 223
charly 36:668396f861d2 224 //Buffer[(Xpoint + (Ypoint / 8) * sOLED_DIS.OLED_Dis_Column)] |= 1 << (Ypoint % 8);
charly 36:668396f861d2 225 //Buffer[(Xpoint + (Ypoint / 8) * sOLED_DIS.OLED_Dis_Column)] |= 0 << (Ypoint % 8);
charly 36:668396f861d2 226 if (buffer[x+((y>>3)*screensize_X)] & 1 << (y % 8) == 0)
charly 38:1b6f9fc49a03 227 return Black ; // pixel not set, Black
charly 38:1b6f9fc49a03 228 else return White; // pixel set, White
charly 36:668396f861d2 229 }