Oled display settings for personal project
SSD1308.cpp@0:300d08d9b058, 2012-07-18 (annotated)
- Committer:
- wim
- Date:
- Wed Jul 18 14:10:57 2012 +0000
- Revision:
- 0:300d08d9b058
- Child:
- 1:b7e8f5139026
First release of SSD1308 OLED driver (128x64, I2C interface)
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
wim | 0:300d08d9b058 | 1 | // SSD1308 I2C device class file |
wim | 0:300d08d9b058 | 2 | // Based on Solomon Systech SSD1308 datasheet, rev. 1, 10/2008 |
wim | 0:300d08d9b058 | 3 | // The SSD1308 is used for example in the Seeed 128x64 OLED Display |
wim | 0:300d08d9b058 | 4 | // http://www.seeedstudio.com/depot/grove-oled-display-12864-p-781.html?cPath=163_167 |
wim | 0:300d08d9b058 | 5 | // |
wim | 0:300d08d9b058 | 6 | // The original code by Andrew Schamp is using (and has been submitted as a part of) Jeff Rowberg's I2Cdevlib library, |
wim | 0:300d08d9b058 | 7 | // which should (hopefully) always be available at https://github.com/jrowberg/i2cdevlib |
wim | 0:300d08d9b058 | 8 | // Some parts also mashed up from Graphic Library for driving monochrome displays based on the PCD8544, |
wim | 0:300d08d9b058 | 9 | // Copyright (c) 2011, Wim De Roeve, who in turn did partial port of code found on |
wim | 0:300d08d9b058 | 10 | // http://serdisplib.sourceforge.net/ser/pcd8544.html#links and by Petras Saduikis <petras@petras.co.uk> |
wim | 0:300d08d9b058 | 11 | // |
wim | 0:300d08d9b058 | 12 | // Changelog: |
wim | 0:300d08d9b058 | 13 | // 2011-08-25 - Initial release by Andrew Schamp <schamp@gmail.com> |
wim | 0:300d08d9b058 | 14 | // 2012-06-19 - Ported to mbed and optimised (WH) |
wim | 0:300d08d9b058 | 15 | // |
wim | 0:300d08d9b058 | 16 | /* ============================================ |
wim | 0:300d08d9b058 | 17 | I2Cdev device library code is placed under the MIT license |
wim | 0:300d08d9b058 | 18 | Copyright (c) 2011 Andrew Schamp |
wim | 0:300d08d9b058 | 19 | Copyright (c) 2012 WH (mbed port) |
wim | 0:300d08d9b058 | 20 | |
wim | 0:300d08d9b058 | 21 | Permission is hereby granted, free of charge, to any person obtaining a copy |
wim | 0:300d08d9b058 | 22 | of this software and associated documentation files (the "Software"), to deal |
wim | 0:300d08d9b058 | 23 | in the Software without restriction, including without limitation the rights |
wim | 0:300d08d9b058 | 24 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
wim | 0:300d08d9b058 | 25 | copies of the Software, and to permit persons to whom the Software is |
wim | 0:300d08d9b058 | 26 | furnished to do so, subject to the following conditions: |
wim | 0:300d08d9b058 | 27 | |
wim | 0:300d08d9b058 | 28 | The above copyright notice and this permission notice shall be included in |
wim | 0:300d08d9b058 | 29 | all copies or substantial portions of the Software. |
wim | 0:300d08d9b058 | 30 | |
wim | 0:300d08d9b058 | 31 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
wim | 0:300d08d9b058 | 32 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
wim | 0:300d08d9b058 | 33 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
wim | 0:300d08d9b058 | 34 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
wim | 0:300d08d9b058 | 35 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
wim | 0:300d08d9b058 | 36 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
wim | 0:300d08d9b058 | 37 | THE SOFTWARE. |
wim | 0:300d08d9b058 | 38 | =============================================== |
wim | 0:300d08d9b058 | 39 | */ |
wim | 0:300d08d9b058 | 40 | #include "mbed.h" |
wim | 0:300d08d9b058 | 41 | #include "SSD1308.h" |
wim | 0:300d08d9b058 | 42 | |
wim | 0:300d08d9b058 | 43 | //#define SSD1308_USE_FONT |
wim | 0:300d08d9b058 | 44 | //#ifdef SSD1308_USE_FONT |
wim | 0:300d08d9b058 | 45 | |
wim | 0:300d08d9b058 | 46 | //#include "font_3x5.h" |
wim | 0:300d08d9b058 | 47 | //#include "font_5x7.h" |
wim | 0:300d08d9b058 | 48 | //#include "font_6x8.h" |
wim | 0:300d08d9b058 | 49 | #include "font_8x8.h" |
wim | 0:300d08d9b058 | 50 | //#include "font_8x12.h" |
wim | 0:300d08d9b058 | 51 | //#include "font_16x20.h" |
wim | 0:300d08d9b058 | 52 | #include "font_16x24.h" |
wim | 0:300d08d9b058 | 53 | //#endif |
wim | 0:300d08d9b058 | 54 | |
wim | 0:300d08d9b058 | 55 | //@brief Constructor |
wim | 0:300d08d9b058 | 56 | //@param I2C &i2c reference to i2c |
wim | 0:300d08d9b058 | 57 | //@param uint8_t deviceAddress slaveaddress |
wim | 0:300d08d9b058 | 58 | // |
wim | 0:300d08d9b058 | 59 | SSD1308::SSD1308(I2C &i2c, uint8_t deviceAddress) : _i2c(i2c) { |
wim | 0:300d08d9b058 | 60 | // m_devAddr = deviceAddress; |
wim | 0:300d08d9b058 | 61 | |
wim | 0:300d08d9b058 | 62 | _writeOpcode = deviceAddress & 0xFE; // low order bit = 0 for write |
wim | 0:300d08d9b058 | 63 | _readOpcode = deviceAddress | 0x01; // low order bit = 1 for read |
wim | 0:300d08d9b058 | 64 | |
wim | 0:300d08d9b058 | 65 | initialize(); |
wim | 0:300d08d9b058 | 66 | } |
wim | 0:300d08d9b058 | 67 | |
wim | 0:300d08d9b058 | 68 | // @brief High level Init, most settings remain at Power-On reset value |
wim | 0:300d08d9b058 | 69 | // |
wim | 0:300d08d9b058 | 70 | void SSD1308::initialize() { |
wim | 0:300d08d9b058 | 71 | setHorizontalAddressingMode(); |
wim | 0:300d08d9b058 | 72 | |
wim | 0:300d08d9b058 | 73 | clearDisplay(); |
wim | 0:300d08d9b058 | 74 | |
wim | 0:300d08d9b058 | 75 | setInverted(false); |
wim | 0:300d08d9b058 | 76 | |
wim | 0:300d08d9b058 | 77 | setDisplayOn(); |
wim | 0:300d08d9b058 | 78 | } |
wim | 0:300d08d9b058 | 79 | |
wim | 0:300d08d9b058 | 80 | |
wim | 0:300d08d9b058 | 81 | // @brief clear the display |
wim | 0:300d08d9b058 | 82 | // |
wim | 0:300d08d9b058 | 83 | #if(0) |
wim | 0:300d08d9b058 | 84 | // Standard version |
wim | 0:300d08d9b058 | 85 | void SSD1308::clearDisplay() { |
wim | 0:300d08d9b058 | 86 | |
wim | 0:300d08d9b058 | 87 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 88 | setPageAddress(0, MAX_PAGE); // all pages |
wim | 0:300d08d9b058 | 89 | setColumnAddress(0, MAX_COL); // all columns |
wim | 0:300d08d9b058 | 90 | |
wim | 0:300d08d9b058 | 91 | for (uint8_t page = 0; page < PAGES; page++) { |
wim | 0:300d08d9b058 | 92 | for (uint8_t col = 0; col < COLUMNS; col++) { |
wim | 0:300d08d9b058 | 93 | _sendData(0x00); |
wim | 0:300d08d9b058 | 94 | } |
wim | 0:300d08d9b058 | 95 | } |
wim | 0:300d08d9b058 | 96 | |
wim | 0:300d08d9b058 | 97 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 98 | } |
wim | 0:300d08d9b058 | 99 | #else |
wim | 0:300d08d9b058 | 100 | //Optimised version |
wim | 0:300d08d9b058 | 101 | // Save lots of I2C S,P, address and datacommands: |
wim | 0:300d08d9b058 | 102 | // Send S, address, DATA_MODE, data, data, data,...., P |
wim | 0:300d08d9b058 | 103 | // |
wim | 0:300d08d9b058 | 104 | void SSD1308::clearDisplay() { |
wim | 0:300d08d9b058 | 105 | |
wim | 0:300d08d9b058 | 106 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 107 | |
wim | 0:300d08d9b058 | 108 | setPageAddress(0, MAX_PAGE); // all pages |
wim | 0:300d08d9b058 | 109 | setColumnAddress(0, MAX_COL); // all columns |
wim | 0:300d08d9b058 | 110 | |
wim | 0:300d08d9b058 | 111 | _i2c.start(); |
wim | 0:300d08d9b058 | 112 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 113 | _i2c.write(DATA_MODE); |
wim | 0:300d08d9b058 | 114 | for (int i=0; i<(PAGES * COLUMNS); i++) { |
wim | 0:300d08d9b058 | 115 | _i2c.write(0x00); // Write Data |
wim | 0:300d08d9b058 | 116 | } |
wim | 0:300d08d9b058 | 117 | _i2c.stop(); |
wim | 0:300d08d9b058 | 118 | |
wim | 0:300d08d9b058 | 119 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 120 | } |
wim | 0:300d08d9b058 | 121 | #endif |
wim | 0:300d08d9b058 | 122 | |
wim | 0:300d08d9b058 | 123 | |
wim | 0:300d08d9b058 | 124 | // @brief fill the display |
wim | 0:300d08d9b058 | 125 | // @param uint8_t pattern fillpattern vertical patch or 8 bits |
wim | 0:300d08d9b058 | 126 | // |
wim | 0:300d08d9b058 | 127 | #if(0) |
wim | 0:300d08d9b058 | 128 | //Standard version |
wim | 0:300d08d9b058 | 129 | void SSD1308::fillDisplay(uint8_t pattern) { |
wim | 0:300d08d9b058 | 130 | |
wim | 0:300d08d9b058 | 131 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 132 | |
wim | 0:300d08d9b058 | 133 | setPageAddress(0, MAX_PAGE); // all pages |
wim | 0:300d08d9b058 | 134 | setColumnAddress(0, MAX_COL); // all columns |
wim | 0:300d08d9b058 | 135 | |
wim | 0:300d08d9b058 | 136 | for (uint8_t page = 0; page < PAGES; page++) { |
wim | 0:300d08d9b058 | 137 | for (uint8_t col = 0; col < COLUMNS; col++) { |
wim | 0:300d08d9b058 | 138 | _sendData(pattern); |
wim | 0:300d08d9b058 | 139 | } |
wim | 0:300d08d9b058 | 140 | } |
wim | 0:300d08d9b058 | 141 | |
wim | 0:300d08d9b058 | 142 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 143 | } |
wim | 0:300d08d9b058 | 144 | #else |
wim | 0:300d08d9b058 | 145 | |
wim | 0:300d08d9b058 | 146 | //Optimised version |
wim | 0:300d08d9b058 | 147 | // Save lots of I2C S,P, address and datacommands: |
wim | 0:300d08d9b058 | 148 | // Send S, address, DATA_MODE, data, data, data,...., P |
wim | 0:300d08d9b058 | 149 | // |
wim | 0:300d08d9b058 | 150 | void SSD1308::fillDisplay(uint8_t pattern, |
wim | 0:300d08d9b058 | 151 | uint8_t start_page, uint8_t end_page, |
wim | 0:300d08d9b058 | 152 | uint8_t start_col, uint8_t end_col) { |
wim | 0:300d08d9b058 | 153 | |
wim | 0:300d08d9b058 | 154 | int count = (end_page - start_page + 1) * (end_col - start_col + 1); |
wim | 0:300d08d9b058 | 155 | |
wim | 0:300d08d9b058 | 156 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 157 | setPageAddress(start_page, end_page); // set page window |
wim | 0:300d08d9b058 | 158 | setColumnAddress(start_col, end_col); // set column window |
wim | 0:300d08d9b058 | 159 | |
wim | 0:300d08d9b058 | 160 | _i2c.start(); |
wim | 0:300d08d9b058 | 161 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 162 | _i2c.write(DATA_MODE); |
wim | 0:300d08d9b058 | 163 | for (int i=0; i<count; i++) { |
wim | 0:300d08d9b058 | 164 | _i2c.write(pattern); // Write Data |
wim | 0:300d08d9b058 | 165 | } |
wim | 0:300d08d9b058 | 166 | _i2c.stop(); |
wim | 0:300d08d9b058 | 167 | |
wim | 0:300d08d9b058 | 168 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 169 | } |
wim | 0:300d08d9b058 | 170 | |
wim | 0:300d08d9b058 | 171 | #endif |
wim | 0:300d08d9b058 | 172 | |
wim | 0:300d08d9b058 | 173 | |
wim | 0:300d08d9b058 | 174 | // @brief write a bitmap to the display |
wim | 0:300d08d9b058 | 175 | // @param uint8_t* data pointer to bitmap |
wim | 0:300d08d9b058 | 176 | // @param uint8_t start_page begin page (0..MAX_PAGE) |
wim | 0:300d08d9b058 | 177 | // @param uint8_t end_page end page (start_page..MAX_PAGE) |
wim | 0:300d08d9b058 | 178 | // @param uint8_t start_col begin column (0..MAX_COL) |
wim | 0:300d08d9b058 | 179 | // @param uint8_t end_col end column (start_col..MAX_COL) |
wim | 0:300d08d9b058 | 180 | // |
wim | 0:300d08d9b058 | 181 | #if(0) |
wim | 0:300d08d9b058 | 182 | //Standard version |
wim | 0:300d08d9b058 | 183 | void SSD1308::writeBitmap(int len, uint8_t* data) { |
wim | 0:300d08d9b058 | 184 | |
wim | 0:300d08d9b058 | 185 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 186 | setPageAddress(0, MAX_PAGE); // all pages |
wim | 0:300d08d9b058 | 187 | setColumnAddress(0, MAX_COL); // all columns |
wim | 0:300d08d9b058 | 188 | |
wim | 0:300d08d9b058 | 189 | _i2c.start(); |
wim | 0:300d08d9b058 | 190 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 191 | _i2c.write(DATA_MODE); |
wim | 0:300d08d9b058 | 192 | for (int i=0; i<len; i++) { |
wim | 0:300d08d9b058 | 193 | _i2c.write(data[i]); // Write Data |
wim | 0:300d08d9b058 | 194 | } |
wim | 0:300d08d9b058 | 195 | _i2c.stop(); |
wim | 0:300d08d9b058 | 196 | |
wim | 0:300d08d9b058 | 197 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 198 | } |
wim | 0:300d08d9b058 | 199 | #else |
wim | 0:300d08d9b058 | 200 | |
wim | 0:300d08d9b058 | 201 | //Optimised version |
wim | 0:300d08d9b058 | 202 | // Save lots of I2C S,P, address and datacommands: |
wim | 0:300d08d9b058 | 203 | // Send S, address, DATA_MODE, data, data, data,...., P |
wim | 0:300d08d9b058 | 204 | // |
wim | 0:300d08d9b058 | 205 | void SSD1308::writeBitmap(uint8_t* data, |
wim | 0:300d08d9b058 | 206 | uint8_t start_page, uint8_t end_page, |
wim | 0:300d08d9b058 | 207 | uint8_t start_col, uint8_t end_col){ |
wim | 0:300d08d9b058 | 208 | |
wim | 0:300d08d9b058 | 209 | int count = (end_page - start_page + 1) * (end_col - start_col + 1); |
wim | 0:300d08d9b058 | 210 | |
wim | 0:300d08d9b058 | 211 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 212 | setPageAddress(start_page, end_page); // set page window |
wim | 0:300d08d9b058 | 213 | setColumnAddress(start_col, end_col); // set column window |
wim | 0:300d08d9b058 | 214 | |
wim | 0:300d08d9b058 | 215 | _i2c.start(); |
wim | 0:300d08d9b058 | 216 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 217 | _i2c.write(DATA_MODE); |
wim | 0:300d08d9b058 | 218 | for (int i=0; i<count; i++) { |
wim | 0:300d08d9b058 | 219 | _i2c.write(data[i]); // Write Data |
wim | 0:300d08d9b058 | 220 | } |
wim | 0:300d08d9b058 | 221 | _i2c.stop(); |
wim | 0:300d08d9b058 | 222 | |
wim | 0:300d08d9b058 | 223 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 224 | } |
wim | 0:300d08d9b058 | 225 | #endif |
wim | 0:300d08d9b058 | 226 | |
wim | 0:300d08d9b058 | 227 | |
wim | 0:300d08d9b058 | 228 | // @brief Write single character to the display using the 8x8 fontable |
wim | 0:300d08d9b058 | 229 | // @brief Start at current cursor location |
wim | 0:300d08d9b058 | 230 | // @param char chr character to write |
wim | 0:300d08d9b058 | 231 | // |
wim | 0:300d08d9b058 | 232 | void SSD1308::writeChar(char chr) { |
wim | 0:300d08d9b058 | 233 | |
wim | 0:300d08d9b058 | 234 | const uint8_t char_index = chr - 0x20; |
wim | 0:300d08d9b058 | 235 | |
wim | 0:300d08d9b058 | 236 | for (uint8_t i = 0; i < 8; i++) { |
wim | 0:300d08d9b058 | 237 | if (_inverted) { |
wim | 0:300d08d9b058 | 238 | _sendData( ~font_8x8[char_index][i] ); |
wim | 0:300d08d9b058 | 239 | } |
wim | 0:300d08d9b058 | 240 | else { |
wim | 0:300d08d9b058 | 241 | _sendData( font_8x8[char_index][i] ); |
wim | 0:300d08d9b058 | 242 | } |
wim | 0:300d08d9b058 | 243 | } |
wim | 0:300d08d9b058 | 244 | |
wim | 0:300d08d9b058 | 245 | } |
wim | 0:300d08d9b058 | 246 | |
wim | 0:300d08d9b058 | 247 | |
wim | 0:300d08d9b058 | 248 | // @brief Write a string to the display using the 8x8 font |
wim | 0:300d08d9b058 | 249 | // @brief Start at selected cursor location |
wim | 0:300d08d9b058 | 250 | // @param uint8_t row row number (0...ROWS/FONT_HEIGHT) |
wim | 0:300d08d9b058 | 251 | // @param uint8_t col column number (0...COLUMNS/FONT_WIDTH) |
wim | 0:300d08d9b058 | 252 | // @param uint16_t len number of chars in text |
wim | 0:300d08d9b058 | 253 | // @param const char * text pointer to text |
wim | 0:300d08d9b058 | 254 | // |
wim | 0:300d08d9b058 | 255 | void SSD1308::writeString(uint8_t row, uint8_t col, uint16_t len, const char * text) { |
wim | 0:300d08d9b058 | 256 | uint16_t index = 0; |
wim | 0:300d08d9b058 | 257 | setPageAddress(row, MAX_PAGE); |
wim | 0:300d08d9b058 | 258 | const uint8_t col_addr = FONT8x8_WIDTH*col; |
wim | 0:300d08d9b058 | 259 | setColumnAddress(col_addr, MAX_COL); |
wim | 0:300d08d9b058 | 260 | |
wim | 0:300d08d9b058 | 261 | while ((col+index) < CHARS && (index < len)) { |
wim | 0:300d08d9b058 | 262 | // write first line, starting at given position |
wim | 0:300d08d9b058 | 263 | writeChar(text[index++]); |
wim | 0:300d08d9b058 | 264 | } |
wim | 0:300d08d9b058 | 265 | |
wim | 0:300d08d9b058 | 266 | // write remaining lines |
wim | 0:300d08d9b058 | 267 | // write until the end of memory |
wim | 0:300d08d9b058 | 268 | // then wrap around again from the top. |
wim | 0:300d08d9b058 | 269 | if (index + 1 < len) { |
wim | 0:300d08d9b058 | 270 | setPageAddress(row + 1, MAX_PAGE); |
wim | 0:300d08d9b058 | 271 | setColumnAddress(0, MAX_COL); |
wim | 0:300d08d9b058 | 272 | bool wrapEntireScreen = false; |
wim | 0:300d08d9b058 | 273 | while (index + 1 < len) { |
wim | 0:300d08d9b058 | 274 | writeChar(text[index++]); |
wim | 0:300d08d9b058 | 275 | // if we've written the last character space on the screen, |
wim | 0:300d08d9b058 | 276 | // reset the page and column address so that it wraps around from the top again |
wim | 0:300d08d9b058 | 277 | if (!wrapEntireScreen && (row*CHARS + col + index) > 127) { |
wim | 0:300d08d9b058 | 278 | setPageAddress(0, MAX_PAGE); |
wim | 0:300d08d9b058 | 279 | setColumnAddress(0, MAX_COL); |
wim | 0:300d08d9b058 | 280 | wrapEntireScreen = true; |
wim | 0:300d08d9b058 | 281 | } |
wim | 0:300d08d9b058 | 282 | } |
wim | 0:300d08d9b058 | 283 | } |
wim | 0:300d08d9b058 | 284 | } |
wim | 0:300d08d9b058 | 285 | |
wim | 0:300d08d9b058 | 286 | |
wim | 0:300d08d9b058 | 287 | |
wim | 0:300d08d9b058 | 288 | // @brief Write large character (16x24 font) |
wim | 0:300d08d9b058 | 289 | // @param uint8_t row row number (0...MAX_ROW) |
wim | 0:300d08d9b058 | 290 | // @param uint8_t col column number (0...MAX_COL) |
wim | 0:300d08d9b058 | 291 | // @param char chr Used for displaying numbers 0 - 9 and '+', '-', '.' |
wim | 0:300d08d9b058 | 292 | // |
wim | 0:300d08d9b058 | 293 | void SSD1308::writeBigChar(uint8_t row, uint8_t col, char chr) { |
wim | 0:300d08d9b058 | 294 | |
wim | 0:300d08d9b058 | 295 | writeBitmap((uint8_t*) font_16x24[int(chr) - FONT16x24_START], |
wim | 0:300d08d9b058 | 296 | row, (row + FONT16x24_BYTES - 1), |
wim | 0:300d08d9b058 | 297 | col, (col + FONT16x24_WIDTH - 1)); |
wim | 0:300d08d9b058 | 298 | } |
wim | 0:300d08d9b058 | 299 | |
wim | 0:300d08d9b058 | 300 | |
wim | 0:300d08d9b058 | 301 | // @brief Write command that has no parameters |
wim | 0:300d08d9b058 | 302 | // |
wim | 0:300d08d9b058 | 303 | void SSD1308::_sendCommand(uint8_t command) { |
wim | 0:300d08d9b058 | 304 | // I2Cdev::writeByte(m_devAddr, COMMAND_MODE, command); |
wim | 0:300d08d9b058 | 305 | |
wim | 0:300d08d9b058 | 306 | #if(0) |
wim | 0:300d08d9b058 | 307 | char databytes[2]; |
wim | 0:300d08d9b058 | 308 | |
wim | 0:300d08d9b058 | 309 | databytes[0] = COMMAND_MODE; |
wim | 0:300d08d9b058 | 310 | databytes[1] = command; |
wim | 0:300d08d9b058 | 311 | _i2c.write(_writeOpcode, databytes, 2); // Write command |
wim | 0:300d08d9b058 | 312 | #endif |
wim | 0:300d08d9b058 | 313 | |
wim | 0:300d08d9b058 | 314 | _i2c.start(); |
wim | 0:300d08d9b058 | 315 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 316 | |
wim | 0:300d08d9b058 | 317 | _i2c.write(COMMAND_MODE); |
wim | 0:300d08d9b058 | 318 | _i2c.write(command); // Write Command |
wim | 0:300d08d9b058 | 319 | |
wim | 0:300d08d9b058 | 320 | _i2c.stop(); |
wim | 0:300d08d9b058 | 321 | |
wim | 0:300d08d9b058 | 322 | } |
wim | 0:300d08d9b058 | 323 | |
wim | 0:300d08d9b058 | 324 | // @brief Write command that has one parameter |
wim | 0:300d08d9b058 | 325 | // |
wim | 0:300d08d9b058 | 326 | void SSD1308::_sendCommand(uint8_t command, uint8_t param1) { |
wim | 0:300d08d9b058 | 327 | |
wim | 0:300d08d9b058 | 328 | // Note continuationbit is set, so COMMAND_MODE must be |
wim | 0:300d08d9b058 | 329 | // repeated before each databyte that serves as parameter! |
wim | 0:300d08d9b058 | 330 | |
wim | 0:300d08d9b058 | 331 | _i2c.start(); |
wim | 0:300d08d9b058 | 332 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 333 | |
wim | 0:300d08d9b058 | 334 | _i2c.write(COMMAND_MODE); |
wim | 0:300d08d9b058 | 335 | _i2c.write(command); // Write Command |
wim | 0:300d08d9b058 | 336 | _i2c.write(COMMAND_MODE); |
wim | 0:300d08d9b058 | 337 | _i2c.write(param1); // Write Param1 |
wim | 0:300d08d9b058 | 338 | |
wim | 0:300d08d9b058 | 339 | _i2c.stop(); |
wim | 0:300d08d9b058 | 340 | |
wim | 0:300d08d9b058 | 341 | } |
wim | 0:300d08d9b058 | 342 | |
wim | 0:300d08d9b058 | 343 | // @brief Write command that has two parameters |
wim | 0:300d08d9b058 | 344 | // |
wim | 0:300d08d9b058 | 345 | void SSD1308::_sendCommand(uint8_t command, uint8_t param1, uint8_t param2) { |
wim | 0:300d08d9b058 | 346 | |
wim | 0:300d08d9b058 | 347 | // Note continuationbit is set, so COMMAND_MODE must be |
wim | 0:300d08d9b058 | 348 | // repeated before each databyte that serves as parameter! |
wim | 0:300d08d9b058 | 349 | |
wim | 0:300d08d9b058 | 350 | _i2c.start(); |
wim | 0:300d08d9b058 | 351 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 352 | |
wim | 0:300d08d9b058 | 353 | _i2c.write(COMMAND_MODE); |
wim | 0:300d08d9b058 | 354 | _i2c.write(command); // Write Command |
wim | 0:300d08d9b058 | 355 | _i2c.write(COMMAND_MODE); |
wim | 0:300d08d9b058 | 356 | _i2c.write(param1); // Write Param1 |
wim | 0:300d08d9b058 | 357 | _i2c.write(COMMAND_MODE); |
wim | 0:300d08d9b058 | 358 | _i2c.write(param2); // Write Param2 |
wim | 0:300d08d9b058 | 359 | |
wim | 0:300d08d9b058 | 360 | _i2c.stop(); |
wim | 0:300d08d9b058 | 361 | |
wim | 0:300d08d9b058 | 362 | } |
wim | 0:300d08d9b058 | 363 | |
wim | 0:300d08d9b058 | 364 | #if(0) |
wim | 0:300d08d9b058 | 365 | // @brief Write command that has multiple parameters |
wim | 0:300d08d9b058 | 366 | // |
wim | 0:300d08d9b058 | 367 | void SSD1308::_sendCommands(uint8_t len, uint8_t* commands) { |
wim | 0:300d08d9b058 | 368 | |
wim | 0:300d08d9b058 | 369 | // I2Cdev::writeBytes(m_devAddr, COMMAND_MODE, len, commands); |
wim | 0:300d08d9b058 | 370 | // Note this original code is not correct, continuationbit is set, |
wim | 0:300d08d9b058 | 371 | // so COMMAND_MODE must be repeated before each databyte that serves as parameter! |
wim | 0:300d08d9b058 | 372 | |
wim | 0:300d08d9b058 | 373 | _i2c.start(); |
wim | 0:300d08d9b058 | 374 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 375 | |
wim | 0:300d08d9b058 | 376 | for (int i=0; i<len ; i++) { |
wim | 0:300d08d9b058 | 377 | _i2c.write(COMMAND_MODE); |
wim | 0:300d08d9b058 | 378 | _i2c.write(commands[i]); // Write Commands |
wim | 0:300d08d9b058 | 379 | } |
wim | 0:300d08d9b058 | 380 | _i2c.stop(); |
wim | 0:300d08d9b058 | 381 | |
wim | 0:300d08d9b058 | 382 | } |
wim | 0:300d08d9b058 | 383 | #endif |
wim | 0:300d08d9b058 | 384 | |
wim | 0:300d08d9b058 | 385 | // @brief Write databyte to display |
wim | 0:300d08d9b058 | 386 | // @brief Start at current cursor location |
wim | 0:300d08d9b058 | 387 | // @param uint8_t data databyte to write |
wim | 0:300d08d9b058 | 388 | // |
wim | 0:300d08d9b058 | 389 | void SSD1308::_sendData(uint8_t data){ |
wim | 0:300d08d9b058 | 390 | // I2Cdev::writeByte(m_devAddr, DATA_MODE, data); |
wim | 0:300d08d9b058 | 391 | |
wim | 0:300d08d9b058 | 392 | char databytes[2]; |
wim | 0:300d08d9b058 | 393 | |
wim | 0:300d08d9b058 | 394 | databytes[0] = DATA_MODE; |
wim | 0:300d08d9b058 | 395 | databytes[1] = data; |
wim | 0:300d08d9b058 | 396 | _i2c.write(_writeOpcode, databytes, 2); // Write Data |
wim | 0:300d08d9b058 | 397 | |
wim | 0:300d08d9b058 | 398 | } |
wim | 0:300d08d9b058 | 399 | |
wim | 0:300d08d9b058 | 400 | // @brief Write len bytes from buffer data to display, |
wim | 0:300d08d9b058 | 401 | // @brief Start at current cursor location |
wim | 0:300d08d9b058 | 402 | // @param uint8_t len number of bytes to write |
wim | 0:300d08d9b058 | 403 | // @param uint8_t* data pointer to data |
wim | 0:300d08d9b058 | 404 | // |
wim | 0:300d08d9b058 | 405 | void SSD1308::_sendData(uint8_t len, uint8_t* data) { |
wim | 0:300d08d9b058 | 406 | // I2Cdev::writeBytes(m_devAddr, DATA_MODE, len, data); |
wim | 0:300d08d9b058 | 407 | |
wim | 0:300d08d9b058 | 408 | _i2c.start(); |
wim | 0:300d08d9b058 | 409 | _i2c.write(_writeOpcode); |
wim | 0:300d08d9b058 | 410 | _i2c.write(DATA_MODE); |
wim | 0:300d08d9b058 | 411 | for (int i=0; i<len ; i++) { |
wim | 0:300d08d9b058 | 412 | _i2c.write(data[i]); // Write Data |
wim | 0:300d08d9b058 | 413 | } |
wim | 0:300d08d9b058 | 414 | _i2c.stop(); |
wim | 0:300d08d9b058 | 415 | |
wim | 0:300d08d9b058 | 416 | } |
wim | 0:300d08d9b058 | 417 | |
wim | 0:300d08d9b058 | 418 | |
wim | 0:300d08d9b058 | 419 | |
wim | 0:300d08d9b058 | 420 | void SSD1308::setHorizontalAddressingMode(){ |
wim | 0:300d08d9b058 | 421 | setMemoryAddressingMode(HORIZONTAL_ADDRESSING_MODE); |
wim | 0:300d08d9b058 | 422 | } |
wim | 0:300d08d9b058 | 423 | |
wim | 0:300d08d9b058 | 424 | void SSD1308::setVerticalAddressingMode() { |
wim | 0:300d08d9b058 | 425 | setMemoryAddressingMode(VERTICAL_ADDRESSING_MODE); |
wim | 0:300d08d9b058 | 426 | } |
wim | 0:300d08d9b058 | 427 | |
wim | 0:300d08d9b058 | 428 | void SSD1308::setPageAddressingMode(){ |
wim | 0:300d08d9b058 | 429 | setMemoryAddressingMode(PAGE_ADDRESSING_MODE); |
wim | 0:300d08d9b058 | 430 | } |
wim | 0:300d08d9b058 | 431 | |
wim | 0:300d08d9b058 | 432 | void SSD1308::setMemoryAddressingMode(uint8_t mode){ |
wim | 0:300d08d9b058 | 433 | |
wim | 0:300d08d9b058 | 434 | _sendCommand(SET_MEMORY_ADDRESSING_MODE, mode); |
wim | 0:300d08d9b058 | 435 | } |
wim | 0:300d08d9b058 | 436 | |
wim | 0:300d08d9b058 | 437 | |
wim | 0:300d08d9b058 | 438 | // @param uint8_t start startpage (valid range 0..MAX_PAGE) |
wim | 0:300d08d9b058 | 439 | // @param uint8_t end endpage (valid range start..MAX_PAGE) |
wim | 0:300d08d9b058 | 440 | // |
wim | 0:300d08d9b058 | 441 | void SSD1308::setPageAddress(uint8_t start, uint8_t end) { |
wim | 0:300d08d9b058 | 442 | |
wim | 0:300d08d9b058 | 443 | _sendCommand(SET_PAGE_ADDRESS, start, end); |
wim | 0:300d08d9b058 | 444 | } |
wim | 0:300d08d9b058 | 445 | |
wim | 0:300d08d9b058 | 446 | |
wim | 0:300d08d9b058 | 447 | // @param uint8_t start startcolumn (valid range 0..MAX_COL) |
wim | 0:300d08d9b058 | 448 | // @param uint8_t end endcolumn (valid range start..MAX_COL) |
wim | 0:300d08d9b058 | 449 | // |
wim | 0:300d08d9b058 | 450 | void SSD1308::setColumnAddress(uint8_t start, uint8_t end) { |
wim | 0:300d08d9b058 | 451 | |
wim | 0:300d08d9b058 | 452 | _sendCommand(SET_COLUMN_ADDRESS, start, end); |
wim | 0:300d08d9b058 | 453 | } |
wim | 0:300d08d9b058 | 454 | |
wim | 0:300d08d9b058 | 455 | // @brief Set Contrast |
wim | 0:300d08d9b058 | 456 | // @param uint8_t contrast (valid range 0x00 (lowest) - 0xFF (highest)) |
wim | 0:300d08d9b058 | 457 | void SSD1308::setContrastControl(uint8_t contrast) { |
wim | 0:300d08d9b058 | 458 | |
wim | 0:300d08d9b058 | 459 | _sendCommand(SET_CONTRAST, contrast); |
wim | 0:300d08d9b058 | 460 | } |
wim | 0:300d08d9b058 | 461 | |
wim | 0:300d08d9b058 | 462 | // @brief Enable Display |
wim | 0:300d08d9b058 | 463 | // |
wim | 0:300d08d9b058 | 464 | void SSD1308::setDisplayOn() { |
wim | 0:300d08d9b058 | 465 | _sendCommand(SET_DISPLAY_POWER_ON); |
wim | 0:300d08d9b058 | 466 | } |
wim | 0:300d08d9b058 | 467 | |
wim | 0:300d08d9b058 | 468 | // @brief Disable Display |
wim | 0:300d08d9b058 | 469 | // |
wim | 0:300d08d9b058 | 470 | void SSD1308::setDisplayOff() { |
wim | 0:300d08d9b058 | 471 | _sendCommand(SET_DISPLAY_POWER_OFF); |
wim | 0:300d08d9b058 | 472 | } |
wim | 0:300d08d9b058 | 473 | |
wim | 0:300d08d9b058 | 474 | // @brief Enable or Disable Display |
wim | 0:300d08d9b058 | 475 | // @param bool on |
wim | 0:300d08d9b058 | 476 | void SSD1308::setDisplayPower(bool on) { |
wim | 0:300d08d9b058 | 477 | if (on) { |
wim | 0:300d08d9b058 | 478 | setDisplayOn(); |
wim | 0:300d08d9b058 | 479 | } else { |
wim | 0:300d08d9b058 | 480 | setDisplayOff(); |
wim | 0:300d08d9b058 | 481 | } |
wim | 0:300d08d9b058 | 482 | } |
wim | 0:300d08d9b058 | 483 | |
wim | 0:300d08d9b058 | 484 | // @brief White pixels on Black background |
wim | 0:300d08d9b058 | 485 | // |
wim | 0:300d08d9b058 | 486 | void SSD1308::setDisplayNormal() { |
wim | 0:300d08d9b058 | 487 | _sendCommand(SET_NORMAL_DISPLAY); |
wim | 0:300d08d9b058 | 488 | } |
wim | 0:300d08d9b058 | 489 | |
wim | 0:300d08d9b058 | 490 | // @brief Black pixels on White background |
wim | 0:300d08d9b058 | 491 | // |
wim | 0:300d08d9b058 | 492 | void SSD1308::setDisplayInverse() { |
wim | 0:300d08d9b058 | 493 | _sendCommand(SET_INVERSE_DISPLAY); |
wim | 0:300d08d9b058 | 494 | } |
wim | 0:300d08d9b058 | 495 | |
wim | 0:300d08d9b058 | 496 | // @brief Blink display by fading in and out over a set number of frames |
wim | 0:300d08d9b058 | 497 | // @param bool on |
wim | 0:300d08d9b058 | 498 | // |
wim | 0:300d08d9b058 | 499 | void SSD1308::setDisplayBlink(bool on){ |
wim | 0:300d08d9b058 | 500 | if (on) { |
wim | 0:300d08d9b058 | 501 | _sendCommand(SET_FADE_BLINK, (BLINK_ENABLE | FADE_INTERVAL_128_FRAMES)); |
wim | 0:300d08d9b058 | 502 | } |
wim | 0:300d08d9b058 | 503 | else { |
wim | 0:300d08d9b058 | 504 | _sendCommand(SET_FADE_BLINK, FADE_BLINK_DISABLE); |
wim | 0:300d08d9b058 | 505 | } |
wim | 0:300d08d9b058 | 506 | } |
wim | 0:300d08d9b058 | 507 | |
wim | 0:300d08d9b058 | 508 | |
wim | 0:300d08d9b058 | 509 | // @brief Fade out display in set number of frames |
wim | 0:300d08d9b058 | 510 | // @param bool on |
wim | 0:300d08d9b058 | 511 | // |
wim | 0:300d08d9b058 | 512 | void SSD1308::setDisplayFade(bool on) { |
wim | 0:300d08d9b058 | 513 | if (on) { |
wim | 0:300d08d9b058 | 514 | _sendCommand(SET_FADE_BLINK, (FADE_OUT_ENABLE | FADE_INTERVAL_128_FRAMES)); |
wim | 0:300d08d9b058 | 515 | } |
wim | 0:300d08d9b058 | 516 | else { |
wim | 0:300d08d9b058 | 517 | _sendCommand(SET_FADE_BLINK, FADE_BLINK_DISABLE); |
wim | 0:300d08d9b058 | 518 | } |
wim | 0:300d08d9b058 | 519 | } |
wim | 0:300d08d9b058 | 520 | |
wim | 0:300d08d9b058 | 521 | // @brief Display Flip (Left/Right, Up/Down) |
wim | 0:300d08d9b058 | 522 | // @param bool left flip Left/Right |
wim | 0:300d08d9b058 | 523 | // @param bool down flip Up/Down |
wim | 0:300d08d9b058 | 524 | // |
wim | 0:300d08d9b058 | 525 | void SSD1308::setDisplayFlip(bool left, bool down) { |
wim | 0:300d08d9b058 | 526 | if (left) { |
wim | 0:300d08d9b058 | 527 | // column address 0 is mapped to SEG0 (Reset) |
wim | 0:300d08d9b058 | 528 | _sendCommand(SET_SEGMENT_REMAP_0); |
wim | 0:300d08d9b058 | 529 | } |
wim | 0:300d08d9b058 | 530 | else { |
wim | 0:300d08d9b058 | 531 | // column address 127 is mapped to SEG0 |
wim | 0:300d08d9b058 | 532 | _sendCommand(SET_SEGMENT_REMAP_127); |
wim | 0:300d08d9b058 | 533 | } |
wim | 0:300d08d9b058 | 534 | |
wim | 0:300d08d9b058 | 535 | if (down) { |
wim | 0:300d08d9b058 | 536 | // Reset mode |
wim | 0:300d08d9b058 | 537 | _sendCommand(SET_COMMON_REMAP_0); |
wim | 0:300d08d9b058 | 538 | } |
wim | 0:300d08d9b058 | 539 | else { |
wim | 0:300d08d9b058 | 540 | // Flip Up/Down (Need to rewrite display before H effect shows) |
wim | 0:300d08d9b058 | 541 | _sendCommand(SET_COMMON_REMAP_63); |
wim | 0:300d08d9b058 | 542 | } |
wim | 0:300d08d9b058 | 543 | |
wim | 0:300d08d9b058 | 544 | } |
wim | 0:300d08d9b058 | 545 | |
wim | 0:300d08d9b058 | 546 | // @brief Sets Internal Iref |
wim | 0:300d08d9b058 | 547 | // |
wim | 0:300d08d9b058 | 548 | void SSD1308::setInternalIref() { |
wim | 0:300d08d9b058 | 549 | // uint8_t cmds[2] = {SET_IREF_SELECTION, INTERNAL_IREF}; |
wim | 0:300d08d9b058 | 550 | // _sendCommands(2, cmds); |
wim | 0:300d08d9b058 | 551 | |
wim | 0:300d08d9b058 | 552 | _sendCommand(SET_IREF_SELECTION, INTERNAL_IREF); |
wim | 0:300d08d9b058 | 553 | } |
wim | 0:300d08d9b058 | 554 | |
wim | 0:300d08d9b058 | 555 | // @brief Sets External Iref (default) |
wim | 0:300d08d9b058 | 556 | // |
wim | 0:300d08d9b058 | 557 | void SSD1308::setExternalIref() { |
wim | 0:300d08d9b058 | 558 | // uint8_t cmds[2] = {SET_IREF_SELECTION, EXTERNAL_IREF}; |
wim | 0:300d08d9b058 | 559 | // _sendCommands(2, cmds); |
wim | 0:300d08d9b058 | 560 | _sendCommand(SET_IREF_SELECTION, EXTERNAL_IREF); |
wim | 0:300d08d9b058 | 561 | } |
wim | 0:300d08d9b058 | 562 | |
wim | 0:300d08d9b058 | 563 | |
wim | 0:300d08d9b058 | 564 | // @brief Low level Init |
wim | 0:300d08d9b058 | 565 | // @brief Init the configuration registers in accordance with the datasheet |
wim | 0:300d08d9b058 | 566 | // |
wim | 0:300d08d9b058 | 567 | void SSD1308::_init() { |
wim | 0:300d08d9b058 | 568 | |
wim | 0:300d08d9b058 | 569 | //not complete yet |
wim | 0:300d08d9b058 | 570 | _sendCommand(SET_DISPLAY_POWER_OFF); |
wim | 0:300d08d9b058 | 571 | |
wim | 0:300d08d9b058 | 572 | // column address 0 is mapped to SEG0 (Reset) |
wim | 0:300d08d9b058 | 573 | // row address 0 is mapped to COMM0 (Reset) |
wim | 0:300d08d9b058 | 574 | _sendCommand(SET_SEGMENT_REMAP_0); |
wim | 0:300d08d9b058 | 575 | _sendCommand(SET_COMMON_REMAP_0); |
wim | 0:300d08d9b058 | 576 | |
wim | 0:300d08d9b058 | 577 | _sendCommand(SET_COMMON_CONF, COMMON_BASE | COMMON_ALTERNATIVE | COMMON_LEFTRIGHT_NORMAL); |
wim | 0:300d08d9b058 | 578 | |
wim | 0:300d08d9b058 | 579 | setHorizontalAddressingMode(); // (Non-Reset) |
wim | 0:300d08d9b058 | 580 | |
wim | 0:300d08d9b058 | 581 | setExternalIref(); // (Reset) |
wim | 0:300d08d9b058 | 582 | |
wim | 0:300d08d9b058 | 583 | _sendCommand(SET_CONTRAST, 0x7F); // (Reset) |
wim | 0:300d08d9b058 | 584 | |
wim | 0:300d08d9b058 | 585 | _sendCommand(SET_NORMAL_DISPLAY); |
wim | 0:300d08d9b058 | 586 | |
wim | 0:300d08d9b058 | 587 | clearDisplay(); |
wim | 0:300d08d9b058 | 588 | |
wim | 0:300d08d9b058 | 589 | _sendCommand(SET_DISPLAY_POWER_ON); |
wim | 0:300d08d9b058 | 590 | } |
wim | 0:300d08d9b058 | 591 |