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/SSD1306.cpp@13:d8c593fa7705, 2015-02-22 (annotated)
- Committer:
- Geremia
- Date:
- Sun Feb 22 16:13:11 2015 +0000
- Revision:
- 13:d8c593fa7705
- Parent:
- 12:9c8f3076347c
- Child:
- 15:b9483ba842c8
multibyte cmds workaround for compatibility with actual SPI_16 NOP trick (see LCD class wr_cmd8)
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
dreschpe | 12:9c8f3076347c | 1 | /* mbed UniGraphic library - Device specific class |
dreschpe | 12:9c8f3076347c | 2 | * Copyright (c) 2015 Peter Drescher |
dreschpe | 12:9c8f3076347c | 3 | * Released under the MIT License: http://mbed.org/license/mit |
dreschpe | 12:9c8f3076347c | 4 | */ |
dreschpe | 12:9c8f3076347c | 5 | |
dreschpe | 12:9c8f3076347c | 6 | #include "Protocols.h" |
dreschpe | 12:9c8f3076347c | 7 | #include "SSD1306.h" |
dreschpe | 12:9c8f3076347c | 8 | |
dreschpe | 12:9c8f3076347c | 9 | ////////////////////////////////////////////////////////////////////////////////// |
dreschpe | 12:9c8f3076347c | 10 | // display settings /////////////////////////////////////////////////////// |
dreschpe | 12:9c8f3076347c | 11 | ///////////////////////////////////////////////////////////////////////// |
dreschpe | 12:9c8f3076347c | 12 | |
dreschpe | 12:9c8f3076347c | 13 | |
dreschpe | 12:9c8f3076347c | 14 | #define IC_X_SEGS 128 // UC1608 SEG has range 0-239 (239-0 if MX=1), check your datasheet, important for the orientation |
dreschpe | 12:9c8f3076347c | 15 | #define IC_Y_COMS 64 // UC1608 COM has range 0-127 (127-0 if MY=1), check your datasheet, important for the orientation |
dreschpe | 12:9c8f3076347c | 16 | |
dreschpe | 12:9c8f3076347c | 17 | #define SSD1306_SETCONTRAST 0x81 |
dreschpe | 12:9c8f3076347c | 18 | #define SSD1306_DISPLAYALLON_RESUME 0xA4 |
dreschpe | 12:9c8f3076347c | 19 | #define SSD1306_DISPLAYALLON 0xA5 |
dreschpe | 12:9c8f3076347c | 20 | #define SSD1306_NORMALDISPLAY 0xA6 |
dreschpe | 12:9c8f3076347c | 21 | #define SSD1306_INVERTDISPLAY 0xA7 |
dreschpe | 12:9c8f3076347c | 22 | #define SSD1306_DISPLAYOFF 0xAE |
dreschpe | 12:9c8f3076347c | 23 | #define SSD1306_DISPLAYON 0xAF |
dreschpe | 12:9c8f3076347c | 24 | #define SSD1306_SETDISPLAYOFFSET 0xD3 |
dreschpe | 12:9c8f3076347c | 25 | #define SSD1306_SETCOMPINS 0xDA |
dreschpe | 12:9c8f3076347c | 26 | #define SSD1306_SETVCOMDETECT 0xDB |
dreschpe | 12:9c8f3076347c | 27 | #define SSD1306_SETDISPLAYCLOCKDIV 0xD5 |
dreschpe | 12:9c8f3076347c | 28 | #define SSD1306_SETPRECHARGE 0xD9 |
dreschpe | 12:9c8f3076347c | 29 | #define SSD1306_SETMULTIPLEX 0xA8 |
dreschpe | 12:9c8f3076347c | 30 | #define SSD1306_SETLOWCOLUMN 0x00 |
dreschpe | 12:9c8f3076347c | 31 | #define SSD1306_SETHIGHCOLUMN 0x10 |
dreschpe | 12:9c8f3076347c | 32 | #define SSD1306_SETSTARTLINE 0x40 |
dreschpe | 12:9c8f3076347c | 33 | #define SSD1306_MEMORYMODE 0x20 |
dreschpe | 12:9c8f3076347c | 34 | #define SSD1306_COMSCANINC 0xC0 |
dreschpe | 12:9c8f3076347c | 35 | #define SSD1306_COMSCANDEC 0xC8 |
dreschpe | 12:9c8f3076347c | 36 | #define SSD1306_SEGREMAP 0xA0 |
dreschpe | 12:9c8f3076347c | 37 | #define SSD1306_CHARGEPUMP 0x8D |
dreschpe | 12:9c8f3076347c | 38 | |
dreschpe | 12:9c8f3076347c | 39 | SSD1306::SSD1306(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) |
dreschpe | 12:9c8f3076347c | 40 | : LCD(displayproto, port, CS, reset, DC, WR, RD, LCDSIZE_X, LCDSIZE_Y, IC_X_SEGS, IC_Y_COMS, name) |
dreschpe | 12:9c8f3076347c | 41 | { |
dreschpe | 12:9c8f3076347c | 42 | hw_reset(); |
dreschpe | 12:9c8f3076347c | 43 | BusEnable(true); |
dreschpe | 12:9c8f3076347c | 44 | init(); |
dreschpe | 12:9c8f3076347c | 45 | cls(); |
dreschpe | 12:9c8f3076347c | 46 | set_orientation(1); |
dreschpe | 12:9c8f3076347c | 47 | locate(0,0); |
dreschpe | 12:9c8f3076347c | 48 | } |
dreschpe | 12:9c8f3076347c | 49 | SSD1306::SSD1306(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) |
dreschpe | 12:9c8f3076347c | 50 | : LCD(displayproto, Hz, mosi, miso, sclk, CS, reset, DC, LCDSIZE_X, LCDSIZE_Y, IC_X_SEGS, IC_Y_COMS, name) |
dreschpe | 12:9c8f3076347c | 51 | { |
dreschpe | 12:9c8f3076347c | 52 | hw_reset(); |
dreschpe | 12:9c8f3076347c | 53 | BusEnable(true); |
dreschpe | 12:9c8f3076347c | 54 | init(); |
dreschpe | 12:9c8f3076347c | 55 | cls(); |
dreschpe | 12:9c8f3076347c | 56 | set_orientation(1); |
dreschpe | 12:9c8f3076347c | 57 | locate(0,0); |
dreschpe | 12:9c8f3076347c | 58 | } |
dreschpe | 12:9c8f3076347c | 59 | // reset and init the lcd controller |
dreschpe | 12:9c8f3076347c | 60 | void SSD1306::init() |
dreschpe | 12:9c8f3076347c | 61 | { |
dreschpe | 12:9c8f3076347c | 62 | /* Start Initial Sequence ----------------------------------------------------*/ |
dreschpe | 12:9c8f3076347c | 63 | |
dreschpe | 12:9c8f3076347c | 64 | // wr_cmd8(0xE2); // sw reset |
dreschpe | 12:9c8f3076347c | 65 | wait_ms(15); |
dreschpe | 12:9c8f3076347c | 66 | |
Geremia | 13:d8c593fa7705 | 67 | wr_cmd8(SSD1306_DISPLAYOFF); // no problem in SPI_16 for single byte cmds |
Geremia | 13:d8c593fa7705 | 68 | wr_cmd16((SSD1306_SETDISPLAYCLOCKDIV<<8)|0x80); // wr_cmd16 for multibyte cmds issue in SPI16 mode |
Geremia | 13:d8c593fa7705 | 69 | // wr_cmd8(0x80); // in SPI_16 it would become 0xE380 and will break things up |
Geremia | 13:d8c593fa7705 | 70 | wr_cmd16((SSD1306_SETMULTIPLEX<<8)|63); |
Geremia | 13:d8c593fa7705 | 71 | // wr_cmd8(63); |
dreschpe | 12:9c8f3076347c | 72 | |
Geremia | 13:d8c593fa7705 | 73 | wr_cmd16((SSD1306_SETDISPLAYOFFSET<<8)|0x00); |
Geremia | 13:d8c593fa7705 | 74 | // wr_cmd8(0x0); |
dreschpe | 12:9c8f3076347c | 75 | |
dreschpe | 12:9c8f3076347c | 76 | wr_cmd8(SSD1306_SETSTARTLINE | 0x0); // line #0 |
dreschpe | 12:9c8f3076347c | 77 | |
Geremia | 13:d8c593fa7705 | 78 | wr_cmd16((SSD1306_CHARGEPUMP<<8)|0x14); |
Geremia | 13:d8c593fa7705 | 79 | // wr_cmd8(0x14); // 0x10 |
dreschpe | 12:9c8f3076347c | 80 | |
Geremia | 13:d8c593fa7705 | 81 | wr_cmd16((SSD1306_MEMORYMODE<<8)|0x00); |
Geremia | 13:d8c593fa7705 | 82 | // wr_cmd8(0x00); // 0x0 act like ks0108 |
dreschpe | 12:9c8f3076347c | 83 | |
dreschpe | 12:9c8f3076347c | 84 | wr_cmd8(SSD1306_SEGREMAP ); //| 0x1); |
dreschpe | 12:9c8f3076347c | 85 | |
dreschpe | 12:9c8f3076347c | 86 | wr_cmd8(SSD1306_COMSCANDEC); |
dreschpe | 12:9c8f3076347c | 87 | |
Geremia | 13:d8c593fa7705 | 88 | wr_cmd16((SSD1306_SETCOMPINS<<8)|0x12); |
Geremia | 13:d8c593fa7705 | 89 | // wr_cmd8(0x12); // LCDSIZE_Y == 32 ? 0x02 : 0x12); |
dreschpe | 12:9c8f3076347c | 90 | |
Geremia | 13:d8c593fa7705 | 91 | wr_cmd16((SSD1306_SETCONTRAST<<8)|0xCF); |
Geremia | 13:d8c593fa7705 | 92 | // wr_cmd8(0xCF); // _rawHeight == 32 ? 0x8F : ((vccstate == SSD1306_EXTERNALVCC) ? 0x9F : 0xCF) ); |
dreschpe | 12:9c8f3076347c | 93 | |
Geremia | 13:d8c593fa7705 | 94 | wr_cmd16((SSD1306_SETPRECHARGE<<8)|0xF1); |
Geremia | 13:d8c593fa7705 | 95 | // wr_cmd8(0xF1); // : 0x22); |
dreschpe | 12:9c8f3076347c | 96 | |
Geremia | 13:d8c593fa7705 | 97 | wr_cmd16((SSD1306_SETVCOMDETECT<<8)|0x40); |
Geremia | 13:d8c593fa7705 | 98 | // wr_cmd8(0x40); |
dreschpe | 12:9c8f3076347c | 99 | |
dreschpe | 12:9c8f3076347c | 100 | wr_cmd8(SSD1306_DISPLAYALLON_RESUME); |
dreschpe | 12:9c8f3076347c | 101 | |
dreschpe | 12:9c8f3076347c | 102 | //wr_cmd8(SSD1306_NORMALDISPLAY); |
dreschpe | 12:9c8f3076347c | 103 | wr_cmd8(SSD1306_INVERTDISPLAY); |
dreschpe | 12:9c8f3076347c | 104 | |
dreschpe | 12:9c8f3076347c | 105 | wr_cmd8(SSD1306_DISPLAYON); |
dreschpe | 12:9c8f3076347c | 106 | } |
dreschpe | 12:9c8f3076347c | 107 | |
dreschpe | 12:9c8f3076347c | 108 | //////////////////////////////////////////////////////////////////// |
dreschpe | 12:9c8f3076347c | 109 | // functions that overrides the standard ones implemented in LCD.cpp |
dreschpe | 12:9c8f3076347c | 110 | //////////////////////////////////////////////////////////////////// |
dreschpe | 12:9c8f3076347c | 111 | |
dreschpe | 12:9c8f3076347c | 112 | void SSD1306::mirrorXY(mirror_t mode) |
dreschpe | 12:9c8f3076347c | 113 | { |
dreschpe | 12:9c8f3076347c | 114 | switch (mode) |
dreschpe | 12:9c8f3076347c | 115 | { |
dreschpe | 12:9c8f3076347c | 116 | case(NONE): |
dreschpe | 12:9c8f3076347c | 117 | wr_cmd16(0xA0C0); |
dreschpe | 12:9c8f3076347c | 118 | break; |
dreschpe | 12:9c8f3076347c | 119 | case(X): |
dreschpe | 12:9c8f3076347c | 120 | wr_cmd16(0xA1C0); |
dreschpe | 12:9c8f3076347c | 121 | break; |
dreschpe | 12:9c8f3076347c | 122 | case(Y): |
dreschpe | 12:9c8f3076347c | 123 | wr_cmd16(0xA0C8); |
dreschpe | 12:9c8f3076347c | 124 | break; |
dreschpe | 12:9c8f3076347c | 125 | case(XY): |
dreschpe | 12:9c8f3076347c | 126 | wr_cmd16(0xA1C8); |
dreschpe | 12:9c8f3076347c | 127 | break; |
dreschpe | 12:9c8f3076347c | 128 | } |
dreschpe | 12:9c8f3076347c | 129 | } |
dreschpe | 12:9c8f3076347c | 130 | |
dreschpe | 12:9c8f3076347c | 131 | void SSD1306::set_contrast(int o) |
dreschpe | 12:9c8f3076347c | 132 | { |
dreschpe | 12:9c8f3076347c | 133 | contrast = o; |
dreschpe | 12:9c8f3076347c | 134 | |
dreschpe | 12:9c8f3076347c | 135 | wr_cmd16(0x8100|(o)); |
dreschpe | 12:9c8f3076347c | 136 | } |