Oled display settings for personal project
SSD1308.cpp@5:e564cde8e03e, 2017-12-18 (annotated)
- Committer:
- wim
- Date:
- Mon Dec 18 18:46:05 2017 +0000
- Revision:
- 5:e564cde8e03e
- Parent:
- 4:df92b0c0cb92
Fixed non-copyable issue (Thx kenjiArai)
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
wim | 1:b7e8f5139026 | 1 | /** @file SSD1308 I2C device class file |
wim | 1:b7e8f5139026 | 2 | * Based on Solomon Systech SSD1308 datasheet, rev. 1, 10/2008 |
wim | 1:b7e8f5139026 | 3 | * The SSD1308 is used for example in the Seeed 128x64 OLED Display |
wim | 1:b7e8f5139026 | 4 | * http://www.seeedstudio.com/depot/grove-oled-display-12864-p-781.html?cPath=163_167 |
wim | 1:b7e8f5139026 | 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 | 4:df92b0c0cb92 | 15 | // 2013-07-12 - Minor comment fix and placeholder for SSD1306 (WH) |
wim | 4:df92b0c0cb92 | 16 | // 2015-01-01 - Switch for optimised I2C calls to test on F401 (WH) |
wim | 5:e564cde8e03e | 17 | // 2017-12-18 - Fixed non-copyable issue (Thx kenjiArai) |
wim | 0:300d08d9b058 | 18 | // |
wim | 4:df92b0c0cb92 | 19 | /* |
wim | 1:b7e8f5139026 | 20 | ================================================================================ |
wim | 0:300d08d9b058 | 21 | I2Cdev device library code is placed under the MIT license |
wim | 0:300d08d9b058 | 22 | Copyright (c) 2011 Andrew Schamp |
wim | 5:e564cde8e03e | 23 | Copyright (c) 2012,2013,2017 WH (mbed port) |
wim | 0:300d08d9b058 | 24 | |
wim | 0:300d08d9b058 | 25 | Permission is hereby granted, free of charge, to any person obtaining a copy |
wim | 0:300d08d9b058 | 26 | of this software and associated documentation files (the "Software"), to deal |
wim | 0:300d08d9b058 | 27 | in the Software without restriction, including without limitation the rights |
wim | 0:300d08d9b058 | 28 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
wim | 0:300d08d9b058 | 29 | copies of the Software, and to permit persons to whom the Software is |
wim | 0:300d08d9b058 | 30 | furnished to do so, subject to the following conditions: |
wim | 0:300d08d9b058 | 31 | |
wim | 0:300d08d9b058 | 32 | The above copyright notice and this permission notice shall be included in |
wim | 0:300d08d9b058 | 33 | all copies or substantial portions of the Software. |
wim | 0:300d08d9b058 | 34 | |
wim | 0:300d08d9b058 | 35 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
wim | 0:300d08d9b058 | 36 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
wim | 0:300d08d9b058 | 37 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
wim | 0:300d08d9b058 | 38 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
wim | 0:300d08d9b058 | 39 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
wim | 0:300d08d9b058 | 40 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
wim | 0:300d08d9b058 | 41 | THE SOFTWARE. |
wim | 1:b7e8f5139026 | 42 | ================================================================================ |
wim | 0:300d08d9b058 | 43 | */ |
wim | 0:300d08d9b058 | 44 | #include "mbed.h" |
wim | 0:300d08d9b058 | 45 | #include "SSD1308.h" |
wim | 0:300d08d9b058 | 46 | |
wim | 0:300d08d9b058 | 47 | //#include "font_3x5.h" |
wim | 0:300d08d9b058 | 48 | //#include "font_5x7.h" |
wim | 0:300d08d9b058 | 49 | //#include "font_6x8.h" |
wim | 0:300d08d9b058 | 50 | #include "font_8x8.h" |
wim | 0:300d08d9b058 | 51 | //#include "font_8x12.h" |
wim | 0:300d08d9b058 | 52 | //#include "font_16x20.h" |
wim | 0:300d08d9b058 | 53 | #include "font_16x24.h" |
wim | 0:300d08d9b058 | 54 | |
wim | 4:df92b0c0cb92 | 55 | #if defined(TARGET_LPC1768) |
wim | 4:df92b0c0cb92 | 56 | #define I2C_OPTIMIZE 1 |
wim | 4:df92b0c0cb92 | 57 | #else |
wim | 4:df92b0c0cb92 | 58 | #define I2C_OPTIMIZE 0 |
wim | 4:df92b0c0cb92 | 59 | #endif |
wim | 4:df92b0c0cb92 | 60 | |
wim | 1:b7e8f5139026 | 61 | /** |
wim | 1:b7e8f5139026 | 62 | *@brief Constructor |
wim | 5:e564cde8e03e | 63 | *@param I2C *i2c reference to i2c |
wim | 1:b7e8f5139026 | 64 | *@param uint8_t deviceAddress slaveaddress |
wim | 1:b7e8f5139026 | 65 | */ |
wim | 5:e564cde8e03e | 66 | SSD1308::SSD1308(I2C *i2c, uint8_t deviceAddress) : _i2c(i2c) { |
wim | 0:300d08d9b058 | 67 | |
wim | 0:300d08d9b058 | 68 | _writeOpcode = deviceAddress & 0xFE; // low order bit = 0 for write |
wim | 0:300d08d9b058 | 69 | _readOpcode = deviceAddress | 0x01; // low order bit = 1 for read |
wim | 0:300d08d9b058 | 70 | |
wim | 0:300d08d9b058 | 71 | initialize(); |
wim | 0:300d08d9b058 | 72 | } |
wim | 0:300d08d9b058 | 73 | |
wim | 1:b7e8f5139026 | 74 | /** @brief High level Init, most settings remain at Power-On reset value |
wim | 1:b7e8f5139026 | 75 | */ |
wim | 0:300d08d9b058 | 76 | void SSD1308::initialize() { |
wim | 0:300d08d9b058 | 77 | setHorizontalAddressingMode(); |
wim | 0:300d08d9b058 | 78 | |
wim | 0:300d08d9b058 | 79 | clearDisplay(); |
wim | 0:300d08d9b058 | 80 | |
wim | 0:300d08d9b058 | 81 | setInverted(false); |
wim | 0:300d08d9b058 | 82 | |
wim | 0:300d08d9b058 | 83 | setDisplayOn(); |
wim | 0:300d08d9b058 | 84 | } |
wim | 0:300d08d9b058 | 85 | |
wim | 0:300d08d9b058 | 86 | |
wim | 1:b7e8f5139026 | 87 | /** @brief clear the display |
wim | 1:b7e8f5139026 | 88 | */ |
wim | 4:df92b0c0cb92 | 89 | #if (I2C_OPTIMIZE == 0) |
wim | 0:300d08d9b058 | 90 | // Standard version |
wim | 0:300d08d9b058 | 91 | void SSD1308::clearDisplay() { |
wim | 0:300d08d9b058 | 92 | |
wim | 0:300d08d9b058 | 93 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 94 | setPageAddress(0, MAX_PAGE); // all pages |
wim | 0:300d08d9b058 | 95 | setColumnAddress(0, MAX_COL); // all columns |
wim | 0:300d08d9b058 | 96 | |
wim | 0:300d08d9b058 | 97 | for (uint8_t page = 0; page < PAGES; page++) { |
wim | 0:300d08d9b058 | 98 | for (uint8_t col = 0; col < COLUMNS; col++) { |
wim | 0:300d08d9b058 | 99 | _sendData(0x00); |
wim | 0:300d08d9b058 | 100 | } |
wim | 0:300d08d9b058 | 101 | } |
wim | 0:300d08d9b058 | 102 | |
wim | 0:300d08d9b058 | 103 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 104 | } |
wim | 0:300d08d9b058 | 105 | #else |
wim | 0:300d08d9b058 | 106 | //Optimised version |
wim | 0:300d08d9b058 | 107 | // Save lots of I2C S,P, address and datacommands: |
wim | 0:300d08d9b058 | 108 | // Send S, address, DATA_MODE, data, data, data,...., P |
wim | 0:300d08d9b058 | 109 | // |
wim | 0:300d08d9b058 | 110 | void SSD1308::clearDisplay() { |
wim | 0:300d08d9b058 | 111 | |
wim | 0:300d08d9b058 | 112 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 113 | |
wim | 0:300d08d9b058 | 114 | setPageAddress(0, MAX_PAGE); // all pages |
wim | 0:300d08d9b058 | 115 | setColumnAddress(0, MAX_COL); // all columns |
wim | 0:300d08d9b058 | 116 | |
wim | 5:e564cde8e03e | 117 | _i2c->start(); |
wim | 5:e564cde8e03e | 118 | _i2c->write(_writeOpcode); |
wim | 5:e564cde8e03e | 119 | _i2c->write(DATA_MODE); |
wim | 0:300d08d9b058 | 120 | for (int i=0; i<(PAGES * COLUMNS); i++) { |
wim | 5:e564cde8e03e | 121 | _i2c->write(0x00); // Write Data |
wim | 0:300d08d9b058 | 122 | } |
wim | 5:e564cde8e03e | 123 | _i2c->stop(); |
wim | 0:300d08d9b058 | 124 | |
wim | 0:300d08d9b058 | 125 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 126 | } |
wim | 0:300d08d9b058 | 127 | #endif |
wim | 0:300d08d9b058 | 128 | |
wim | 0:300d08d9b058 | 129 | |
wim | 1:b7e8f5139026 | 130 | /** @brief fill the display |
wim | 1:b7e8f5139026 | 131 | * @param uint8_t pattern fillpattern vertical patch or 8 bits |
wim | 4:df92b0c0cb92 | 132 | * @param uint8_t start_page begin page (0..MAX_PAGE) |
wim | 4:df92b0c0cb92 | 133 | * @param uint8_t end_page end page (start_page..MAX_PAGE) |
wim | 4:df92b0c0cb92 | 134 | * @param uint8_t start_col begin column (0..MAX_COL) |
wim | 4:df92b0c0cb92 | 135 | * @param uint8_t end_col end column (start_col..MAX_COL) |
wim | 1:b7e8f5139026 | 136 | */ |
wim | 4:df92b0c0cb92 | 137 | #if (I2C_OPTIMIZE == 0) |
wim | 0:300d08d9b058 | 138 | //Standard version |
wim | 4:df92b0c0cb92 | 139 | |
wim | 4:df92b0c0cb92 | 140 | void SSD1308::fillDisplay(uint8_t pattern, |
wim | 4:df92b0c0cb92 | 141 | uint8_t start_page, uint8_t end_page, |
wim | 4:df92b0c0cb92 | 142 | uint8_t start_col, uint8_t end_col) { |
wim | 0:300d08d9b058 | 143 | |
wim | 4:df92b0c0cb92 | 144 | int count = (end_page - start_page + 1) * (end_col - start_col + 1); |
wim | 4:df92b0c0cb92 | 145 | |
wim | 4:df92b0c0cb92 | 146 | //setDisplayOff(); |
wim | 4:df92b0c0cb92 | 147 | setPageAddress(start_page, end_page); // set page window |
wim | 4:df92b0c0cb92 | 148 | setColumnAddress(start_col, end_col); // set column window |
wim | 4:df92b0c0cb92 | 149 | |
wim | 4:df92b0c0cb92 | 150 | for (int i=0; i<count; i++) { |
wim | 4:df92b0c0cb92 | 151 | _sendData(pattern); // Write Data |
wim | 4:df92b0c0cb92 | 152 | } |
wim | 0:300d08d9b058 | 153 | |
wim | 4:df92b0c0cb92 | 154 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 155 | } |
wim | 4:df92b0c0cb92 | 156 | |
wim | 0:300d08d9b058 | 157 | #else |
wim | 0:300d08d9b058 | 158 | |
wim | 0:300d08d9b058 | 159 | //Optimised version |
wim | 0:300d08d9b058 | 160 | // Save lots of I2C S,P, address and datacommands: |
wim | 0:300d08d9b058 | 161 | // Send S, address, DATA_MODE, data, data, data,...., P |
wim | 0:300d08d9b058 | 162 | // |
wim | 0:300d08d9b058 | 163 | void SSD1308::fillDisplay(uint8_t pattern, |
wim | 0:300d08d9b058 | 164 | uint8_t start_page, uint8_t end_page, |
wim | 0:300d08d9b058 | 165 | uint8_t start_col, uint8_t end_col) { |
wim | 0:300d08d9b058 | 166 | |
wim | 0:300d08d9b058 | 167 | int count = (end_page - start_page + 1) * (end_col - start_col + 1); |
wim | 0:300d08d9b058 | 168 | |
wim | 0:300d08d9b058 | 169 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 170 | setPageAddress(start_page, end_page); // set page window |
wim | 0:300d08d9b058 | 171 | setColumnAddress(start_col, end_col); // set column window |
wim | 0:300d08d9b058 | 172 | |
wim | 5:e564cde8e03e | 173 | _i2c->start(); |
wim | 5:e564cde8e03e | 174 | _i2c->write(_writeOpcode); |
wim | 5:e564cde8e03e | 175 | _i2c->write(DATA_MODE); |
wim | 0:300d08d9b058 | 176 | for (int i=0; i<count; i++) { |
wim | 5:e564cde8e03e | 177 | _i2c->write(pattern); // Write Data |
wim | 0:300d08d9b058 | 178 | } |
wim | 5:e564cde8e03e | 179 | _i2c->stop(); |
wim | 0:300d08d9b058 | 180 | |
wim | 0:300d08d9b058 | 181 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 182 | } |
wim | 0:300d08d9b058 | 183 | |
wim | 0:300d08d9b058 | 184 | #endif |
wim | 0:300d08d9b058 | 185 | |
wim | 0:300d08d9b058 | 186 | |
wim | 1:b7e8f5139026 | 187 | /** @brief write a bitmap to the display |
wim | 1:b7e8f5139026 | 188 | * @param uint8_t* data pointer to bitmap |
wim | 1:b7e8f5139026 | 189 | * @param uint8_t start_page begin page (0..MAX_PAGE) |
wim | 1:b7e8f5139026 | 190 | * @param uint8_t end_page end page (start_page..MAX_PAGE) |
wim | 1:b7e8f5139026 | 191 | * @param uint8_t start_col begin column (0..MAX_COL) |
wim | 1:b7e8f5139026 | 192 | * @param uint8_t end_col end column (start_col..MAX_COL) |
wim | 1:b7e8f5139026 | 193 | */ |
wim | 4:df92b0c0cb92 | 194 | #if (I2C_OPTIMIZE == 0) |
wim | 0:300d08d9b058 | 195 | //Standard version |
wim | 4:df92b0c0cb92 | 196 | void SSD1308::writeBitmap(uint8_t* data, |
wim | 4:df92b0c0cb92 | 197 | uint8_t start_page, uint8_t end_page, |
wim | 4:df92b0c0cb92 | 198 | uint8_t start_col, uint8_t end_col){ |
wim | 4:df92b0c0cb92 | 199 | |
wim | 4:df92b0c0cb92 | 200 | int count = (end_page - start_page + 1) * (end_col - start_col + 1); |
wim | 0:300d08d9b058 | 201 | |
wim | 0:300d08d9b058 | 202 | //setDisplayOff(); |
wim | 4:df92b0c0cb92 | 203 | setPageAddress(start_page, end_page); // set page window |
wim | 4:df92b0c0cb92 | 204 | setColumnAddress(start_col, end_col); // set column window |
wim | 0:300d08d9b058 | 205 | |
wim | 4:df92b0c0cb92 | 206 | for (int i=0; i<count; i++) { |
wim | 4:df92b0c0cb92 | 207 | _sendData(data[i]); // Write Data |
wim | 0:300d08d9b058 | 208 | } |
wim | 0:300d08d9b058 | 209 | |
wim | 0:300d08d9b058 | 210 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 211 | } |
wim | 4:df92b0c0cb92 | 212 | |
wim | 0:300d08d9b058 | 213 | #else |
wim | 0:300d08d9b058 | 214 | //Optimised version |
wim | 0:300d08d9b058 | 215 | // Save lots of I2C S,P, address and datacommands: |
wim | 0:300d08d9b058 | 216 | // Send S, address, DATA_MODE, data, data, data,...., P |
wim | 0:300d08d9b058 | 217 | // |
wim | 0:300d08d9b058 | 218 | void SSD1308::writeBitmap(uint8_t* data, |
wim | 0:300d08d9b058 | 219 | uint8_t start_page, uint8_t end_page, |
wim | 0:300d08d9b058 | 220 | uint8_t start_col, uint8_t end_col){ |
wim | 0:300d08d9b058 | 221 | |
wim | 0:300d08d9b058 | 222 | int count = (end_page - start_page + 1) * (end_col - start_col + 1); |
wim | 0:300d08d9b058 | 223 | |
wim | 0:300d08d9b058 | 224 | //setDisplayOff(); |
wim | 0:300d08d9b058 | 225 | setPageAddress(start_page, end_page); // set page window |
wim | 0:300d08d9b058 | 226 | setColumnAddress(start_col, end_col); // set column window |
wim | 0:300d08d9b058 | 227 | |
wim | 5:e564cde8e03e | 228 | _i2c->start(); |
wim | 5:e564cde8e03e | 229 | _i2c->write(_writeOpcode); |
wim | 5:e564cde8e03e | 230 | _i2c->write(DATA_MODE); |
wim | 0:300d08d9b058 | 231 | for (int i=0; i<count; i++) { |
wim | 5:e564cde8e03e | 232 | _i2c->write(data[i]); // Write Data |
wim | 0:300d08d9b058 | 233 | } |
wim | 5:e564cde8e03e | 234 | _i2c->stop(); |
wim | 0:300d08d9b058 | 235 | |
wim | 0:300d08d9b058 | 236 | //setDisplayOn(); |
wim | 0:300d08d9b058 | 237 | } |
wim | 4:df92b0c0cb92 | 238 | |
wim | 0:300d08d9b058 | 239 | #endif |
wim | 0:300d08d9b058 | 240 | |
wim | 0:300d08d9b058 | 241 | |
wim | 2:16c84a134393 | 242 | /** @brief write a progressbar to the display, Width is (PRG_MAX_SCALE + 2) pixels |
wim | 1:b7e8f5139026 | 243 | * @param uint8_t page begin page (0..MAX_PAGE) |
wim | 1:b7e8f5139026 | 244 | * @param uint8_t col begin column (0..MAX_COL) |
wim | 1:b7e8f5139026 | 245 | * @param int percentage value (0..100) |
wim | 1:b7e8f5139026 | 246 | */ |
wim | 1:b7e8f5139026 | 247 | #define PRG_MAX_SCALE 50 |
wim | 1:b7e8f5139026 | 248 | #define PRG_LEFT_EDGE 0xFF |
wim | 1:b7e8f5139026 | 249 | #define PRG_RIGHT_EDGE 0xFF |
wim | 1:b7e8f5139026 | 250 | #define PRG_ACTIVE 0xFF |
wim | 2:16c84a134393 | 251 | //#define PRG_ACTIVE 0xBD |
wim | 1:b7e8f5139026 | 252 | #define PRG_NOT_ACTIVE 0x81 |
wim | 1:b7e8f5139026 | 253 | |
wim | 4:df92b0c0cb92 | 254 | #if (I2C_OPTIMIZE == 0) |
wim | 1:b7e8f5139026 | 255 | //Standard version |
wim | 1:b7e8f5139026 | 256 | void SSD1308::writeProgressBar(uint8_t page, uint8_t col, int percentage) { |
wim | 1:b7e8f5139026 | 257 | uint8_t scale_value; |
wim | 1:b7e8f5139026 | 258 | |
wim | 2:16c84a134393 | 259 | if (percentage <= 0) { |
wim | 1:b7e8f5139026 | 260 | scale_value = 0; |
wim | 2:16c84a134393 | 261 | } else if (percentage >= 100) { |
wim | 2:16c84a134393 | 262 | scale_value = PRG_MAX_SCALE - 1; |
wim | 1:b7e8f5139026 | 263 | } |
wim | 1:b7e8f5139026 | 264 | else { |
wim | 1:b7e8f5139026 | 265 | scale_value = (percentage * PRG_MAX_SCALE) / 100; |
wim | 1:b7e8f5139026 | 266 | } |
wim | 1:b7e8f5139026 | 267 | |
wim | 1:b7e8f5139026 | 268 | //setDisplayOff(); |
wim | 1:b7e8f5139026 | 269 | setPageAddress(page, page); |
wim | 1:b7e8f5139026 | 270 | setColumnAddress(col, MAX_COL); |
wim | 1:b7e8f5139026 | 271 | |
wim | 1:b7e8f5139026 | 272 | _sendData(PRG_LEFT_EDGE); |
wim | 1:b7e8f5139026 | 273 | |
wim | 1:b7e8f5139026 | 274 | for (uint8_t col = 0; col < scale_value; col++) { |
wim | 1:b7e8f5139026 | 275 | _sendData(PRG_ACTIVE); |
wim | 1:b7e8f5139026 | 276 | } |
wim | 2:16c84a134393 | 277 | |
wim | 2:16c84a134393 | 278 | _sendData(PRG_ACTIVE); |
wim | 2:16c84a134393 | 279 | |
wim | 2:16c84a134393 | 280 | for (uint8_t col = (scale_value+1); col < PRG_MAX_SCALE; col++) { |
wim | 1:b7e8f5139026 | 281 | _sendData(PRG_NOT_ACTIVE); |
wim | 1:b7e8f5139026 | 282 | } |
wim | 1:b7e8f5139026 | 283 | |
wim | 1:b7e8f5139026 | 284 | _sendData(PRG_RIGHT_EDGE); |
wim | 1:b7e8f5139026 | 285 | |
wim | 1:b7e8f5139026 | 286 | //setDisplayOn(); |
wim | 1:b7e8f5139026 | 287 | } |
wim | 1:b7e8f5139026 | 288 | #else |
wim | 1:b7e8f5139026 | 289 | |
wim | 1:b7e8f5139026 | 290 | //Optimised version |
wim | 1:b7e8f5139026 | 291 | // Save lots of I2C S,P, address and datacommands: |
wim | 1:b7e8f5139026 | 292 | // Send S, address, DATA_MODE, data, data, data,...., P |
wim | 0:300d08d9b058 | 293 | // |
wim | 1:b7e8f5139026 | 294 | void SSD1308::writeProgressBar(uint8_t page, uint8_t col, int percentage) { |
wim | 1:b7e8f5139026 | 295 | uint8_t scale_value; |
wim | 1:b7e8f5139026 | 296 | |
wim | 2:16c84a134393 | 297 | if (percentage <= 0) { |
wim | 1:b7e8f5139026 | 298 | scale_value = 0; |
wim | 2:16c84a134393 | 299 | } else if (percentage >= 100) { |
wim | 2:16c84a134393 | 300 | scale_value = PRG_MAX_SCALE - 1 ; |
wim | 1:b7e8f5139026 | 301 | } |
wim | 1:b7e8f5139026 | 302 | else { |
wim | 1:b7e8f5139026 | 303 | scale_value = (percentage * PRG_MAX_SCALE) / 100; |
wim | 1:b7e8f5139026 | 304 | } |
wim | 1:b7e8f5139026 | 305 | |
wim | 1:b7e8f5139026 | 306 | //setDisplayOff(); |
wim | 1:b7e8f5139026 | 307 | setPageAddress(page, page); |
wim | 1:b7e8f5139026 | 308 | setColumnAddress(col, MAX_COL); |
wim | 1:b7e8f5139026 | 309 | |
wim | 5:e564cde8e03e | 310 | _i2c->start(); |
wim | 5:e564cde8e03e | 311 | _i2c->write(_writeOpcode); |
wim | 5:e564cde8e03e | 312 | _i2c->write(DATA_MODE); |
wim | 1:b7e8f5139026 | 313 | |
wim | 5:e564cde8e03e | 314 | _i2c->write(PRG_LEFT_EDGE); // Write Data |
wim | 1:b7e8f5139026 | 315 | |
wim | 1:b7e8f5139026 | 316 | for (uint8_t col = 0; col < scale_value; col++) { |
wim | 5:e564cde8e03e | 317 | _i2c->write(PRG_ACTIVE); // Write Data |
wim | 1:b7e8f5139026 | 318 | } |
wim | 1:b7e8f5139026 | 319 | |
wim | 5:e564cde8e03e | 320 | _i2c->write(PRG_ACTIVE); // Write Data |
wim | 2:16c84a134393 | 321 | |
wim | 2:16c84a134393 | 322 | for (uint8_t col = (scale_value+1); col < PRG_MAX_SCALE; col++) { |
wim | 5:e564cde8e03e | 323 | _i2c->write(PRG_NOT_ACTIVE); // Write Data |
wim | 1:b7e8f5139026 | 324 | } |
wim | 1:b7e8f5139026 | 325 | |
wim | 5:e564cde8e03e | 326 | _i2c->write(PRG_RIGHT_EDGE); // Write Data |
wim | 1:b7e8f5139026 | 327 | |
wim | 5:e564cde8e03e | 328 | _i2c->stop(); |
wim | 1:b7e8f5139026 | 329 | |
wim | 1:b7e8f5139026 | 330 | //setDisplayOn(); |
wim | 1:b7e8f5139026 | 331 | } |
wim | 1:b7e8f5139026 | 332 | #endif |
wim | 1:b7e8f5139026 | 333 | |
wim | 2:16c84a134393 | 334 | /** @brief write a level meter to the display, Width is (PRG_MAX_SCALE + 2) pixels |
wim | 2:16c84a134393 | 335 | * @param uint8_t page begin page (0..MAX_PAGE) |
wim | 2:16c84a134393 | 336 | * @param uint8_t col begin column (0..MAX_COL) |
wim | 2:16c84a134393 | 337 | * @param int percentage value (0..100) |
wim | 2:16c84a134393 | 338 | */ |
wim | 4:df92b0c0cb92 | 339 | #if (I2C_OPTIMIZE == 0) |
wim | 4:df92b0c0cb92 | 340 | void SSD1308::writeLevelBar(uint8_t page, uint8_t col, int percentage) { |
wim | 4:df92b0c0cb92 | 341 | uint8_t scale_value; |
wim | 4:df92b0c0cb92 | 342 | |
wim | 4:df92b0c0cb92 | 343 | if (percentage <= 0) { |
wim | 4:df92b0c0cb92 | 344 | scale_value = 0; |
wim | 4:df92b0c0cb92 | 345 | } else if (percentage >= 100) { |
wim | 4:df92b0c0cb92 | 346 | scale_value = PRG_MAX_SCALE - 1; |
wim | 4:df92b0c0cb92 | 347 | } |
wim | 4:df92b0c0cb92 | 348 | else { |
wim | 4:df92b0c0cb92 | 349 | scale_value = (percentage * PRG_MAX_SCALE) / 100; |
wim | 4:df92b0c0cb92 | 350 | } |
wim | 4:df92b0c0cb92 | 351 | |
wim | 4:df92b0c0cb92 | 352 | //setDisplayOff(); |
wim | 4:df92b0c0cb92 | 353 | setPageAddress(page, page); |
wim | 4:df92b0c0cb92 | 354 | setColumnAddress(col, MAX_COL); |
wim | 4:df92b0c0cb92 | 355 | |
wim | 4:df92b0c0cb92 | 356 | _sendData(PRG_LEFT_EDGE); |
wim | 4:df92b0c0cb92 | 357 | |
wim | 4:df92b0c0cb92 | 358 | for (uint8_t col = 0; col < scale_value; col++) { |
wim | 4:df92b0c0cb92 | 359 | _sendData(PRG_NOT_ACTIVE); // Write Data |
wim | 4:df92b0c0cb92 | 360 | } |
wim | 4:df92b0c0cb92 | 361 | |
wim | 4:df92b0c0cb92 | 362 | _sendData(PRG_ACTIVE); // Write Data at active meterlevel |
wim | 4:df92b0c0cb92 | 363 | |
wim | 4:df92b0c0cb92 | 364 | for (uint8_t col = scale_value+1; col < PRG_MAX_SCALE; col++) { |
wim | 4:df92b0c0cb92 | 365 | _sendData(PRG_NOT_ACTIVE); |
wim | 4:df92b0c0cb92 | 366 | } |
wim | 4:df92b0c0cb92 | 367 | |
wim | 4:df92b0c0cb92 | 368 | _sendData(PRG_RIGHT_EDGE); |
wim | 4:df92b0c0cb92 | 369 | |
wim | 4:df92b0c0cb92 | 370 | //setDisplayOn(); |
wim | 4:df92b0c0cb92 | 371 | } |
wim | 4:df92b0c0cb92 | 372 | #else |
wim | 2:16c84a134393 | 373 | //Optimised version |
wim | 2:16c84a134393 | 374 | // Save lots of I2C S,P, address and datacommands: |
wim | 2:16c84a134393 | 375 | // Send S, address, DATA_MODE, data, data, data,...., P |
wim | 2:16c84a134393 | 376 | // |
wim | 2:16c84a134393 | 377 | void SSD1308::writeLevelBar(uint8_t page, uint8_t col, int percentage) { |
wim | 2:16c84a134393 | 378 | uint8_t scale_value; |
wim | 2:16c84a134393 | 379 | |
wim | 2:16c84a134393 | 380 | if (percentage <= 0) { |
wim | 2:16c84a134393 | 381 | scale_value = 0; |
wim | 2:16c84a134393 | 382 | } else if (percentage >= 100) { |
wim | 2:16c84a134393 | 383 | scale_value = PRG_MAX_SCALE - 1; |
wim | 2:16c84a134393 | 384 | } |
wim | 2:16c84a134393 | 385 | else { |
wim | 2:16c84a134393 | 386 | scale_value = (percentage * PRG_MAX_SCALE) / 100; |
wim | 2:16c84a134393 | 387 | } |
wim | 2:16c84a134393 | 388 | |
wim | 2:16c84a134393 | 389 | //setDisplayOff(); |
wim | 2:16c84a134393 | 390 | setPageAddress(page, page); |
wim | 2:16c84a134393 | 391 | setColumnAddress(col, MAX_COL); |
wim | 1:b7e8f5139026 | 392 | |
wim | 5:e564cde8e03e | 393 | _i2c->start(); |
wim | 5:e564cde8e03e | 394 | _i2c->write(_writeOpcode); |
wim | 5:e564cde8e03e | 395 | _i2c->write(DATA_MODE); |
wim | 1:b7e8f5139026 | 396 | |
wim | 5:e564cde8e03e | 397 | _i2c->write(PRG_LEFT_EDGE); // Write Data |
wim | 2:16c84a134393 | 398 | |
wim | 2:16c84a134393 | 399 | for (uint8_t col = 0; col < scale_value; col++) { |
wim | 5:e564cde8e03e | 400 | _i2c->write(PRG_NOT_ACTIVE); // Write Data |
wim | 2:16c84a134393 | 401 | } |
wim | 2:16c84a134393 | 402 | |
wim | 5:e564cde8e03e | 403 | _i2c->write(PRG_ACTIVE); // Write Data at active meterlevel |
wim | 2:16c84a134393 | 404 | |
wim | 2:16c84a134393 | 405 | for (uint8_t col = scale_value+1; col < PRG_MAX_SCALE; col++) { |
wim | 5:e564cde8e03e | 406 | _i2c->write(PRG_NOT_ACTIVE); // Write Data |
wim | 2:16c84a134393 | 407 | } |
wim | 2:16c84a134393 | 408 | |
wim | 5:e564cde8e03e | 409 | _i2c->write(PRG_RIGHT_EDGE); // Write Data |
wim | 2:16c84a134393 | 410 | |
wim | 5:e564cde8e03e | 411 | _i2c->stop(); |
wim | 2:16c84a134393 | 412 | |
wim | 2:16c84a134393 | 413 | //setDisplayOn(); |
wim | 2:16c84a134393 | 414 | } |
wim | 4:df92b0c0cb92 | 415 | #endif |
wim | 1:b7e8f5139026 | 416 | |
wim | 1:b7e8f5139026 | 417 | /** @brief Write single character to the display using the 8x8 fontable |
wim | 1:b7e8f5139026 | 418 | * @brief Start at current cursor location |
wim | 1:b7e8f5139026 | 419 | * @param char chr character to write |
wim | 1:b7e8f5139026 | 420 | */ |
wim | 0:300d08d9b058 | 421 | void SSD1308::writeChar(char chr) { |
wim | 0:300d08d9b058 | 422 | |
wim | 0:300d08d9b058 | 423 | const uint8_t char_index = chr - 0x20; |
wim | 0:300d08d9b058 | 424 | |
wim | 0:300d08d9b058 | 425 | for (uint8_t i = 0; i < 8; i++) { |
wim | 0:300d08d9b058 | 426 | if (_inverted) { |
wim | 0:300d08d9b058 | 427 | _sendData( ~font_8x8[char_index][i] ); |
wim | 0:300d08d9b058 | 428 | } |
wim | 0:300d08d9b058 | 429 | else { |
wim | 0:300d08d9b058 | 430 | _sendData( font_8x8[char_index][i] ); |
wim | 0:300d08d9b058 | 431 | } |
wim | 0:300d08d9b058 | 432 | } |
wim | 0:300d08d9b058 | 433 | |
wim | 0:300d08d9b058 | 434 | } |
wim | 0:300d08d9b058 | 435 | |
wim | 0:300d08d9b058 | 436 | |
wim | 1:b7e8f5139026 | 437 | /** @brief Write a string to the display using the 8x8 font |
wim | 2:16c84a134393 | 438 | * @brief Start at selected cursor location, text will wrap around until it is done |
wim | 1:b7e8f5139026 | 439 | * @param uint8_t row row number (0...ROWS/FONT_HEIGHT) |
wim | 1:b7e8f5139026 | 440 | * @param uint8_t col column number (0...COLUMNS/FONT_WIDTH) |
wim | 1:b7e8f5139026 | 441 | * @param const char * text pointer to text |
wim | 1:b7e8f5139026 | 442 | */ |
wim | 2:16c84a134393 | 443 | void SSD1308::writeString(uint8_t row, uint8_t col, const char * text) { |
wim | 0:300d08d9b058 | 444 | uint16_t index = 0; |
wim | 2:16c84a134393 | 445 | uint16_t len = strlen(text); |
wim | 2:16c84a134393 | 446 | |
wim | 0:300d08d9b058 | 447 | setPageAddress(row, MAX_PAGE); |
wim | 0:300d08d9b058 | 448 | const uint8_t col_addr = FONT8x8_WIDTH*col; |
wim | 0:300d08d9b058 | 449 | setColumnAddress(col_addr, MAX_COL); |
wim | 0:300d08d9b058 | 450 | |
wim | 0:300d08d9b058 | 451 | while ((col+index) < CHARS && (index < len)) { |
wim | 0:300d08d9b058 | 452 | // write first line, starting at given position |
wim | 0:300d08d9b058 | 453 | writeChar(text[index++]); |
wim | 0:300d08d9b058 | 454 | } |
wim | 0:300d08d9b058 | 455 | |
wim | 0:300d08d9b058 | 456 | // write remaining lines |
wim | 0:300d08d9b058 | 457 | // write until the end of memory |
wim | 0:300d08d9b058 | 458 | // then wrap around again from the top. |
wim | 0:300d08d9b058 | 459 | if (index + 1 < len) { |
wim | 0:300d08d9b058 | 460 | setPageAddress(row + 1, MAX_PAGE); |
wim | 0:300d08d9b058 | 461 | setColumnAddress(0, MAX_COL); |
wim | 0:300d08d9b058 | 462 | bool wrapEntireScreen = false; |
wim | 0:300d08d9b058 | 463 | while (index + 1 < len) { |
wim | 0:300d08d9b058 | 464 | writeChar(text[index++]); |
wim | 0:300d08d9b058 | 465 | // if we've written the last character space on the screen, |
wim | 0:300d08d9b058 | 466 | // reset the page and column address so that it wraps around from the top again |
wim | 0:300d08d9b058 | 467 | if (!wrapEntireScreen && (row*CHARS + col + index) > 127) { |
wim | 0:300d08d9b058 | 468 | setPageAddress(0, MAX_PAGE); |
wim | 0:300d08d9b058 | 469 | setColumnAddress(0, MAX_COL); |
wim | 0:300d08d9b058 | 470 | wrapEntireScreen = true; |
wim | 0:300d08d9b058 | 471 | } |
wim | 0:300d08d9b058 | 472 | } |
wim | 0:300d08d9b058 | 473 | } |
wim | 0:300d08d9b058 | 474 | } |
wim | 0:300d08d9b058 | 475 | |
wim | 0:300d08d9b058 | 476 | |
wim | 0:300d08d9b058 | 477 | |
wim | 1:b7e8f5139026 | 478 | /** @brief Write large character (16x24 font) |
wim | 1:b7e8f5139026 | 479 | * @param uint8_t row row number (0...MAX_ROW) |
wim | 1:b7e8f5139026 | 480 | * @param uint8_t col column number (0...MAX_COL) |
wim | 1:b7e8f5139026 | 481 | * @param char chr Used for displaying numbers 0 - 9 and '+', '-', '.' |
wim | 1:b7e8f5139026 | 482 | */ |
wim | 0:300d08d9b058 | 483 | void SSD1308::writeBigChar(uint8_t row, uint8_t col, char chr) { |
wim | 0:300d08d9b058 | 484 | |
wim | 0:300d08d9b058 | 485 | writeBitmap((uint8_t*) font_16x24[int(chr) - FONT16x24_START], |
wim | 0:300d08d9b058 | 486 | row, (row + FONT16x24_BYTES - 1), |
wim | 0:300d08d9b058 | 487 | col, (col + FONT16x24_WIDTH - 1)); |
wim | 0:300d08d9b058 | 488 | } |
wim | 0:300d08d9b058 | 489 | |
wim | 0:300d08d9b058 | 490 | |
wim | 1:b7e8f5139026 | 491 | /** @brief Write command that has no parameters |
wim | 1:b7e8f5139026 | 492 | */ |
wim | 0:300d08d9b058 | 493 | void SSD1308::_sendCommand(uint8_t command) { |
wim | 0:300d08d9b058 | 494 | // I2Cdev::writeByte(m_devAddr, COMMAND_MODE, command); |
wim | 0:300d08d9b058 | 495 | |
wim | 4:df92b0c0cb92 | 496 | #if (I2C_OPTIMIZE == 0) |
wim | 0:300d08d9b058 | 497 | char databytes[2]; |
wim | 0:300d08d9b058 | 498 | |
wim | 0:300d08d9b058 | 499 | databytes[0] = COMMAND_MODE; |
wim | 0:300d08d9b058 | 500 | databytes[1] = command; |
wim | 5:e564cde8e03e | 501 | _i2c->write(_writeOpcode, databytes, 2); // Write command |
wim | 4:df92b0c0cb92 | 502 | #else |
wim | 4:df92b0c0cb92 | 503 | |
wim | 5:e564cde8e03e | 504 | _i2c->start(); |
wim | 5:e564cde8e03e | 505 | _i2c->write(_writeOpcode); |
wim | 0:300d08d9b058 | 506 | |
wim | 5:e564cde8e03e | 507 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 508 | _i2c->write(command); // Write Command |
wim | 0:300d08d9b058 | 509 | |
wim | 5:e564cde8e03e | 510 | _i2c->stop(); |
wim | 4:df92b0c0cb92 | 511 | #endif |
wim | 0:300d08d9b058 | 512 | } |
wim | 0:300d08d9b058 | 513 | |
wim | 1:b7e8f5139026 | 514 | /** @brief Write command that has one parameter |
wim | 1:b7e8f5139026 | 515 | */ |
wim | 0:300d08d9b058 | 516 | void SSD1308::_sendCommand(uint8_t command, uint8_t param1) { |
wim | 0:300d08d9b058 | 517 | |
wim | 0:300d08d9b058 | 518 | // Note continuationbit is set, so COMMAND_MODE must be |
wim | 0:300d08d9b058 | 519 | // repeated before each databyte that serves as parameter! |
wim | 4:df92b0c0cb92 | 520 | #if (I2C_OPTIMIZE == 0) |
wim | 4:df92b0c0cb92 | 521 | char databytes[4]; |
wim | 4:df92b0c0cb92 | 522 | |
wim | 4:df92b0c0cb92 | 523 | databytes[0] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 524 | databytes[1] = command; |
wim | 4:df92b0c0cb92 | 525 | databytes[2] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 526 | databytes[3] = param1; |
wim | 5:e564cde8e03e | 527 | _i2c->write(_writeOpcode, databytes, 4); // Write command |
wim | 4:df92b0c0cb92 | 528 | #else |
wim | 0:300d08d9b058 | 529 | |
wim | 5:e564cde8e03e | 530 | _i2c->start(); |
wim | 5:e564cde8e03e | 531 | _i2c->write(_writeOpcode); |
wim | 0:300d08d9b058 | 532 | |
wim | 5:e564cde8e03e | 533 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 534 | _i2c->write(command); // Write Command |
wim | 5:e564cde8e03e | 535 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 536 | _i2c->write(param1); // Write Param1 |
wim | 0:300d08d9b058 | 537 | |
wim | 5:e564cde8e03e | 538 | _i2c->stop(); |
wim | 4:df92b0c0cb92 | 539 | #endif |
wim | 0:300d08d9b058 | 540 | } |
wim | 0:300d08d9b058 | 541 | |
wim | 1:b7e8f5139026 | 542 | /** @brief Write command that has two parameters |
wim | 1:b7e8f5139026 | 543 | */ |
wim | 0:300d08d9b058 | 544 | void SSD1308::_sendCommand(uint8_t command, uint8_t param1, uint8_t param2) { |
wim | 0:300d08d9b058 | 545 | |
wim | 0:300d08d9b058 | 546 | // Note continuationbit is set, so COMMAND_MODE must be |
wim | 0:300d08d9b058 | 547 | // repeated before each databyte that serves as parameter! |
wim | 4:df92b0c0cb92 | 548 | #if (I2C_OPTIMIZE == 0) |
wim | 4:df92b0c0cb92 | 549 | char databytes[6]; |
wim | 4:df92b0c0cb92 | 550 | |
wim | 4:df92b0c0cb92 | 551 | databytes[0] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 552 | databytes[1] = command; |
wim | 4:df92b0c0cb92 | 553 | databytes[2] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 554 | databytes[3] = param1; |
wim | 4:df92b0c0cb92 | 555 | databytes[4] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 556 | databytes[5] = param2; |
wim | 5:e564cde8e03e | 557 | _i2c->write(_writeOpcode, databytes, 6); // Write command |
wim | 4:df92b0c0cb92 | 558 | #else |
wim | 5:e564cde8e03e | 559 | _i2c->start(); |
wim | 5:e564cde8e03e | 560 | _i2c->write(_writeOpcode); |
wim | 0:300d08d9b058 | 561 | |
wim | 5:e564cde8e03e | 562 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 563 | _i2c->write(command); // Write Command |
wim | 5:e564cde8e03e | 564 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 565 | _i2c->write(param1); // Write Param1 |
wim | 5:e564cde8e03e | 566 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 567 | _i2c->write(param2); // Write Param2 |
wim | 0:300d08d9b058 | 568 | |
wim | 5:e564cde8e03e | 569 | _i2c->stop(); |
wim | 4:df92b0c0cb92 | 570 | #endif |
wim | 0:300d08d9b058 | 571 | } |
wim | 0:300d08d9b058 | 572 | |
wim | 2:16c84a134393 | 573 | /** @brief Write command that has five parameters |
wim | 2:16c84a134393 | 574 | */ |
wim | 2:16c84a134393 | 575 | void SSD1308::_sendCommand(uint8_t command, uint8_t param1, uint8_t param2, |
wim | 2:16c84a134393 | 576 | uint8_t param3, uint8_t param4, |
wim | 2:16c84a134393 | 577 | uint8_t param5) { |
wim | 2:16c84a134393 | 578 | |
wim | 2:16c84a134393 | 579 | // Note continuationbit is set, so COMMAND_MODE must be |
wim | 2:16c84a134393 | 580 | // repeated before each databyte that serves as parameter! |
wim | 4:df92b0c0cb92 | 581 | #if (I2C_OPTIMIZE == 0) |
wim | 4:df92b0c0cb92 | 582 | char databytes[12]; |
wim | 4:df92b0c0cb92 | 583 | |
wim | 4:df92b0c0cb92 | 584 | databytes[0] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 585 | databytes[1] = command; |
wim | 4:df92b0c0cb92 | 586 | databytes[2] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 587 | databytes[3] = param1; |
wim | 4:df92b0c0cb92 | 588 | databytes[4] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 589 | databytes[5] = param2; |
wim | 4:df92b0c0cb92 | 590 | databytes[6] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 591 | databytes[7] = param3; |
wim | 4:df92b0c0cb92 | 592 | databytes[8] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 593 | databytes[9] = param4; |
wim | 4:df92b0c0cb92 | 594 | databytes[10] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 595 | databytes[11] = param5; |
wim | 5:e564cde8e03e | 596 | _i2c->write(_writeOpcode, databytes, 12); // Write command |
wim | 4:df92b0c0cb92 | 597 | #else |
wim | 5:e564cde8e03e | 598 | _i2c->start(); |
wim | 5:e564cde8e03e | 599 | _i2c->write(_writeOpcode); |
wim | 2:16c84a134393 | 600 | |
wim | 5:e564cde8e03e | 601 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 602 | _i2c->write(command); // Write Command |
wim | 5:e564cde8e03e | 603 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 604 | _i2c->write(param1); // Write Param1 |
wim | 5:e564cde8e03e | 605 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 606 | _i2c->write(param2); // Write Param2 |
wim | 5:e564cde8e03e | 607 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 608 | _i2c->write(param3); // Write Param3 |
wim | 5:e564cde8e03e | 609 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 610 | _i2c->write(param4); // Write Param4 |
wim | 5:e564cde8e03e | 611 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 612 | _i2c->write(param5); // Write Param5 |
wim | 2:16c84a134393 | 613 | |
wim | 5:e564cde8e03e | 614 | _i2c->stop(); |
wim | 4:df92b0c0cb92 | 615 | #endif |
wim | 2:16c84a134393 | 616 | } |
wim | 2:16c84a134393 | 617 | |
wim | 2:16c84a134393 | 618 | |
wim | 2:16c84a134393 | 619 | /** @brief Write command that has six parameters |
wim | 2:16c84a134393 | 620 | */ |
wim | 2:16c84a134393 | 621 | void SSD1308::_sendCommand(uint8_t command, uint8_t param1, uint8_t param2, |
wim | 2:16c84a134393 | 622 | uint8_t param3, uint8_t param4, |
wim | 2:16c84a134393 | 623 | uint8_t param5, uint8_t param6) { |
wim | 2:16c84a134393 | 624 | |
wim | 2:16c84a134393 | 625 | // Note continuationbit is set, so COMMAND_MODE must be |
wim | 2:16c84a134393 | 626 | // repeated before each databyte that serves as parameter! |
wim | 4:df92b0c0cb92 | 627 | #if (I2C_OPTIMIZE == 0) |
wim | 4:df92b0c0cb92 | 628 | char databytes[14]; |
wim | 4:df92b0c0cb92 | 629 | |
wim | 4:df92b0c0cb92 | 630 | databytes[0] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 631 | databytes[1] = command; |
wim | 4:df92b0c0cb92 | 632 | databytes[2] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 633 | databytes[3] = param1; |
wim | 4:df92b0c0cb92 | 634 | databytes[4] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 635 | databytes[5] = param2; |
wim | 4:df92b0c0cb92 | 636 | databytes[6] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 637 | databytes[7] = param3; |
wim | 4:df92b0c0cb92 | 638 | databytes[8] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 639 | databytes[9] = param4; |
wim | 4:df92b0c0cb92 | 640 | databytes[10] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 641 | databytes[11] = param5; |
wim | 4:df92b0c0cb92 | 642 | databytes[12] = COMMAND_MODE; |
wim | 4:df92b0c0cb92 | 643 | databytes[13] = param6; |
wim | 5:e564cde8e03e | 644 | _i2c->write(_writeOpcode, databytes, 14); // Write command |
wim | 4:df92b0c0cb92 | 645 | #else |
wim | 5:e564cde8e03e | 646 | _i2c->start(); |
wim | 5:e564cde8e03e | 647 | _i2c->write(_writeOpcode); |
wim | 2:16c84a134393 | 648 | |
wim | 5:e564cde8e03e | 649 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 650 | _i2c->write(command); // Write Command |
wim | 5:e564cde8e03e | 651 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 652 | _i2c->write(param1); // Write Param1 |
wim | 5:e564cde8e03e | 653 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 654 | _i2c->write(param2); // Write Param2 |
wim | 5:e564cde8e03e | 655 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 656 | _i2c->write(param3); // Write Param3 |
wim | 5:e564cde8e03e | 657 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 658 | _i2c->write(param4); // Write Param4 |
wim | 5:e564cde8e03e | 659 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 660 | _i2c->write(param5); // Write Param5 |
wim | 5:e564cde8e03e | 661 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 662 | _i2c->write(param6); // Write Param6 |
wim | 2:16c84a134393 | 663 | |
wim | 5:e564cde8e03e | 664 | _i2c->stop(); |
wim | 4:df92b0c0cb92 | 665 | #endif |
wim | 2:16c84a134393 | 666 | } |
wim | 2:16c84a134393 | 667 | |
wim | 2:16c84a134393 | 668 | |
wim | 0:300d08d9b058 | 669 | #if(0) |
wim | 1:b7e8f5139026 | 670 | /** @brief Write command that has multiple parameters |
wim | 1:b7e8f5139026 | 671 | */ |
wim | 0:300d08d9b058 | 672 | void SSD1308::_sendCommands(uint8_t len, uint8_t* commands) { |
wim | 0:300d08d9b058 | 673 | |
wim | 0:300d08d9b058 | 674 | // I2Cdev::writeBytes(m_devAddr, COMMAND_MODE, len, commands); |
wim | 0:300d08d9b058 | 675 | // Note this original code is not correct, continuationbit is set, |
wim | 0:300d08d9b058 | 676 | // so COMMAND_MODE must be repeated before each databyte that serves as parameter! |
wim | 0:300d08d9b058 | 677 | |
wim | 5:e564cde8e03e | 678 | _i2c->start(); |
wim | 5:e564cde8e03e | 679 | _i2c->write(_writeOpcode); |
wim | 0:300d08d9b058 | 680 | |
wim | 0:300d08d9b058 | 681 | for (int i=0; i<len ; i++) { |
wim | 5:e564cde8e03e | 682 | _i2c->write(COMMAND_MODE); |
wim | 5:e564cde8e03e | 683 | _i2c->write(commands[i]); // Write Commands |
wim | 0:300d08d9b058 | 684 | } |
wim | 5:e564cde8e03e | 685 | _i2c->stop(); |
wim | 0:300d08d9b058 | 686 | |
wim | 0:300d08d9b058 | 687 | } |
wim | 0:300d08d9b058 | 688 | #endif |
wim | 0:300d08d9b058 | 689 | |
wim | 1:b7e8f5139026 | 690 | /** @brief Write databyte to display |
wim | 1:b7e8f5139026 | 691 | * @brief Start at current cursor location |
wim | 1:b7e8f5139026 | 692 | * @param uint8_t data databyte to write |
wim | 1:b7e8f5139026 | 693 | */ |
wim | 0:300d08d9b058 | 694 | void SSD1308::_sendData(uint8_t data){ |
wim | 0:300d08d9b058 | 695 | |
wim | 4:df92b0c0cb92 | 696 | #if (I2C_OPTIMIZE == 0) |
wim | 4:df92b0c0cb92 | 697 | //I2C Blockwrite versions dont seem to work ? |
wim | 4:df92b0c0cb92 | 698 | //That may be related to fact that the SSD1308/SSD1306 does NOT return an acknowledge: blockwrite may abort the operation |
wim | 4:df92b0c0cb92 | 699 | //Noted for mbed lib v63 on 20/7/13 |
wim | 0:300d08d9b058 | 700 | char databytes[2]; |
wim | 0:300d08d9b058 | 701 | |
wim | 0:300d08d9b058 | 702 | databytes[0] = DATA_MODE; |
wim | 0:300d08d9b058 | 703 | databytes[1] = data; |
wim | 5:e564cde8e03e | 704 | _i2c->write(_writeOpcode, databytes, 2); // Write Data |
wim | 4:df92b0c0cb92 | 705 | |
wim | 4:df92b0c0cb92 | 706 | #else |
wim | 5:e564cde8e03e | 707 | _i2c->start(); |
wim | 5:e564cde8e03e | 708 | _i2c->write(_writeOpcode); |
wim | 5:e564cde8e03e | 709 | _i2c->write(DATA_MODE); |
wim | 5:e564cde8e03e | 710 | _i2c->write(data); |
wim | 5:e564cde8e03e | 711 | _i2c->stop(); |
wim | 4:df92b0c0cb92 | 712 | #endif |
wim | 4:df92b0c0cb92 | 713 | |
wim | 0:300d08d9b058 | 714 | } |
wim | 0:300d08d9b058 | 715 | |
wim | 1:b7e8f5139026 | 716 | /** @brief Write len bytes from buffer data to display, |
wim | 1:b7e8f5139026 | 717 | * @brief Start at current cursor location |
wim | 1:b7e8f5139026 | 718 | * @param uint8_t len number of bytes to write |
wim | 1:b7e8f5139026 | 719 | * @param uint8_t* data pointer to data |
wim | 1:b7e8f5139026 | 720 | */ |
wim | 0:300d08d9b058 | 721 | void SSD1308::_sendData(uint8_t len, uint8_t* data) { |
wim | 0:300d08d9b058 | 722 | // I2Cdev::writeBytes(m_devAddr, DATA_MODE, len, data); |
wim | 4:df92b0c0cb92 | 723 | #if (I2C_OPTIMIZE == 0) |
wim | 4:df92b0c0cb92 | 724 | for (int i=0; i<len ; i++) { |
wim | 4:df92b0c0cb92 | 725 | _sendData(data[i]); // Write Data |
wim | 4:df92b0c0cb92 | 726 | } |
wim | 4:df92b0c0cb92 | 727 | #else |
wim | 5:e564cde8e03e | 728 | _i2c->start(); |
wim | 5:e564cde8e03e | 729 | _i2c->write(_writeOpcode); |
wim | 5:e564cde8e03e | 730 | _i2c->write(DATA_MODE); |
wim | 0:300d08d9b058 | 731 | for (int i=0; i<len ; i++) { |
wim | 5:e564cde8e03e | 732 | _i2c->write(data[i]); // Write Data |
wim | 0:300d08d9b058 | 733 | } |
wim | 5:e564cde8e03e | 734 | _i2c->stop(); |
wim | 4:df92b0c0cb92 | 735 | #endif |
wim | 0:300d08d9b058 | 736 | } |
wim | 0:300d08d9b058 | 737 | |
wim | 0:300d08d9b058 | 738 | |
wim | 2:16c84a134393 | 739 | /** @brief Set Horizontal Addressing Mode (cursor incr left-to-right, top-to-bottom) |
wim | 2:16c84a134393 | 740 | * |
wim | 2:16c84a134393 | 741 | */ |
wim | 0:300d08d9b058 | 742 | void SSD1308::setHorizontalAddressingMode(){ |
wim | 0:300d08d9b058 | 743 | setMemoryAddressingMode(HORIZONTAL_ADDRESSING_MODE); |
wim | 0:300d08d9b058 | 744 | } |
wim | 0:300d08d9b058 | 745 | |
wim | 2:16c84a134393 | 746 | /** @brief Set Vertical Addressing Mode (cursor incr top-to-bottom, left-to-right) |
wim | 2:16c84a134393 | 747 | * |
wim | 2:16c84a134393 | 748 | */ |
wim | 0:300d08d9b058 | 749 | void SSD1308::setVerticalAddressingMode() { |
wim | 0:300d08d9b058 | 750 | setMemoryAddressingMode(VERTICAL_ADDRESSING_MODE); |
wim | 0:300d08d9b058 | 751 | } |
wim | 0:300d08d9b058 | 752 | |
wim | 2:16c84a134393 | 753 | /** @brief Set Page Addressing Mode (cursor incr left-to-right) |
wim | 2:16c84a134393 | 754 | * |
wim | 2:16c84a134393 | 755 | */ |
wim | 0:300d08d9b058 | 756 | void SSD1308::setPageAddressingMode(){ |
wim | 0:300d08d9b058 | 757 | setMemoryAddressingMode(PAGE_ADDRESSING_MODE); |
wim | 0:300d08d9b058 | 758 | } |
wim | 0:300d08d9b058 | 759 | |
wim | 2:16c84a134393 | 760 | /** @brief Set Addressing Mode |
wim | 2:16c84a134393 | 761 | * @param uint8_t mode |
wim | 2:16c84a134393 | 762 | */ |
wim | 0:300d08d9b058 | 763 | void SSD1308::setMemoryAddressingMode(uint8_t mode){ |
wim | 0:300d08d9b058 | 764 | |
wim | 0:300d08d9b058 | 765 | _sendCommand(SET_MEMORY_ADDRESSING_MODE, mode); |
wim | 0:300d08d9b058 | 766 | } |
wim | 0:300d08d9b058 | 767 | |
wim | 0:300d08d9b058 | 768 | |
wim | 1:b7e8f5139026 | 769 | /** @param uint8_t start startpage (valid range 0..MAX_PAGE) |
wim | 1:b7e8f5139026 | 770 | * @param uint8_t end endpage (valid range start..MAX_PAGE) |
wim | 1:b7e8f5139026 | 771 | */ |
wim | 0:300d08d9b058 | 772 | void SSD1308::setPageAddress(uint8_t start, uint8_t end) { |
wim | 0:300d08d9b058 | 773 | |
wim | 0:300d08d9b058 | 774 | _sendCommand(SET_PAGE_ADDRESS, start, end); |
wim | 0:300d08d9b058 | 775 | } |
wim | 0:300d08d9b058 | 776 | |
wim | 0:300d08d9b058 | 777 | |
wim | 1:b7e8f5139026 | 778 | /** @param uint8_t start startcolumn (valid range 0..MAX_COL) |
wim | 1:b7e8f5139026 | 779 | * @param uint8_t end endcolumn (valid range start..MAX_COL) |
wim | 1:b7e8f5139026 | 780 | */ |
wim | 0:300d08d9b058 | 781 | void SSD1308::setColumnAddress(uint8_t start, uint8_t end) { |
wim | 0:300d08d9b058 | 782 | |
wim | 0:300d08d9b058 | 783 | _sendCommand(SET_COLUMN_ADDRESS, start, end); |
wim | 0:300d08d9b058 | 784 | } |
wim | 0:300d08d9b058 | 785 | |
wim | 2:16c84a134393 | 786 | /** |
wim | 2:16c84a134393 | 787 | * @brief Set Display StartLine, takes one byte, 0x00-0x3F |
wim | 2:16c84a134393 | 788 | * @param uint8_t line startline (valid range 0..MAX_ROWS) |
wim | 2:16c84a134393 | 789 | */ |
wim | 2:16c84a134393 | 790 | void SSD1308::setDisplayStartLine(uint8_t line) { |
wim | 2:16c84a134393 | 791 | |
wim | 2:16c84a134393 | 792 | line = line & MAX_ROW; |
wim | 2:16c84a134393 | 793 | |
wim | 2:16c84a134393 | 794 | _sendCommand(SET_DISPLAY_START_LINE | line); |
wim | 2:16c84a134393 | 795 | } |
wim | 2:16c84a134393 | 796 | |
wim | 2:16c84a134393 | 797 | |
wim | 2:16c84a134393 | 798 | /** |
wim | 2:16c84a134393 | 799 | * @brief Set Column Start (for Page Addressing Mode only) |
wim | 2:16c84a134393 | 800 | * @param uint8_t column column start (valid range 0..MAX_COL) |
wim | 2:16c84a134393 | 801 | */ |
wim | 2:16c84a134393 | 802 | void SSD1308::setColumnStartForPageAddressingMode(uint8_t column) { |
wim | 2:16c84a134393 | 803 | |
wim | 2:16c84a134393 | 804 | column = column & MAX_COL; |
wim | 2:16c84a134393 | 805 | |
wim | 2:16c84a134393 | 806 | _sendCommand(SET_LOWER_COLUMN | ( column & 0x0F)); // lower nibble |
wim | 2:16c84a134393 | 807 | _sendCommand(SET_HIGHER_COLUMN | ((column>>4) & 0x0F)); // higher nibble |
wim | 2:16c84a134393 | 808 | } |
wim | 2:16c84a134393 | 809 | |
wim | 2:16c84a134393 | 810 | |
wim | 2:16c84a134393 | 811 | /** |
wim | 2:16c84a134393 | 812 | * @brief Set Page Start (for Page Addressing Mode only) |
wim | 2:16c84a134393 | 813 | * @param uint8_t page page start (valid range PAGE0 - PAGE7) |
wim | 2:16c84a134393 | 814 | */ |
wim | 2:16c84a134393 | 815 | void SSD1308::setPageStartForPageAddressingMode(uint8_t page) { |
wim | 2:16c84a134393 | 816 | |
wim | 2:16c84a134393 | 817 | page = page & MAX_PAGE; |
wim | 2:16c84a134393 | 818 | |
wim | 2:16c84a134393 | 819 | _sendCommand(SET_PAGE_START_ADDRESS | page); |
wim | 2:16c84a134393 | 820 | |
wim | 2:16c84a134393 | 821 | } |
wim | 2:16c84a134393 | 822 | |
wim | 2:16c84a134393 | 823 | |
wim | 1:b7e8f5139026 | 824 | /** @brief Set Contrast |
wim | 1:b7e8f5139026 | 825 | * @param uint8_t contrast (valid range 0x00 (lowest) - 0xFF (highest)) |
wim | 1:b7e8f5139026 | 826 | */ |
wim | 0:300d08d9b058 | 827 | void SSD1308::setContrastControl(uint8_t contrast) { |
wim | 0:300d08d9b058 | 828 | |
wim | 0:300d08d9b058 | 829 | _sendCommand(SET_CONTRAST, contrast); |
wim | 0:300d08d9b058 | 830 | } |
wim | 0:300d08d9b058 | 831 | |
wim | 1:b7e8f5139026 | 832 | /** @brief Enable Display |
wim | 1:b7e8f5139026 | 833 | */ |
wim | 0:300d08d9b058 | 834 | void SSD1308::setDisplayOn() { |
wim | 0:300d08d9b058 | 835 | _sendCommand(SET_DISPLAY_POWER_ON); |
wim | 0:300d08d9b058 | 836 | } |
wim | 0:300d08d9b058 | 837 | |
wim | 1:b7e8f5139026 | 838 | /** @brief Disable Display |
wim | 1:b7e8f5139026 | 839 | */ |
wim | 0:300d08d9b058 | 840 | void SSD1308::setDisplayOff() { |
wim | 0:300d08d9b058 | 841 | _sendCommand(SET_DISPLAY_POWER_OFF); |
wim | 0:300d08d9b058 | 842 | } |
wim | 0:300d08d9b058 | 843 | |
wim | 1:b7e8f5139026 | 844 | /** @brief Enable or Disable Display |
wim | 1:b7e8f5139026 | 845 | * @param bool on |
wim | 1:b7e8f5139026 | 846 | */ |
wim | 0:300d08d9b058 | 847 | void SSD1308::setDisplayPower(bool on) { |
wim | 0:300d08d9b058 | 848 | if (on) { |
wim | 0:300d08d9b058 | 849 | setDisplayOn(); |
wim | 0:300d08d9b058 | 850 | } else { |
wim | 0:300d08d9b058 | 851 | setDisplayOff(); |
wim | 0:300d08d9b058 | 852 | } |
wim | 0:300d08d9b058 | 853 | } |
wim | 0:300d08d9b058 | 854 | |
wim | 1:b7e8f5139026 | 855 | /** @brief Show White pixels on Black background |
wim | 1:b7e8f5139026 | 856 | */ |
wim | 0:300d08d9b058 | 857 | void SSD1308::setDisplayNormal() { |
wim | 0:300d08d9b058 | 858 | _sendCommand(SET_NORMAL_DISPLAY); |
wim | 0:300d08d9b058 | 859 | } |
wim | 0:300d08d9b058 | 860 | |
wim | 1:b7e8f5139026 | 861 | /** @brief Show Black pixels on White background |
wim | 1:b7e8f5139026 | 862 | */ |
wim | 0:300d08d9b058 | 863 | void SSD1308::setDisplayInverse() { |
wim | 0:300d08d9b058 | 864 | _sendCommand(SET_INVERSE_DISPLAY); |
wim | 0:300d08d9b058 | 865 | } |
wim | 0:300d08d9b058 | 866 | |
wim | 1:b7e8f5139026 | 867 | /** @brief Blink display by fading in and out over a set number of frames |
wim | 1:b7e8f5139026 | 868 | * @param bool on |
wim | 1:b7e8f5139026 | 869 | */ |
wim | 0:300d08d9b058 | 870 | void SSD1308::setDisplayBlink(bool on){ |
wim | 0:300d08d9b058 | 871 | if (on) { |
wim | 0:300d08d9b058 | 872 | _sendCommand(SET_FADE_BLINK, (BLINK_ENABLE | FADE_INTERVAL_128_FRAMES)); |
wim | 0:300d08d9b058 | 873 | } |
wim | 0:300d08d9b058 | 874 | else { |
wim | 0:300d08d9b058 | 875 | _sendCommand(SET_FADE_BLINK, FADE_BLINK_DISABLE); |
wim | 0:300d08d9b058 | 876 | } |
wim | 0:300d08d9b058 | 877 | } |
wim | 0:300d08d9b058 | 878 | |
wim | 0:300d08d9b058 | 879 | |
wim | 1:b7e8f5139026 | 880 | /** @brief Fade out display in set number of frames |
wim | 1:b7e8f5139026 | 881 | * @param bool on |
wim | 1:b7e8f5139026 | 882 | */ |
wim | 0:300d08d9b058 | 883 | void SSD1308::setDisplayFade(bool on) { |
wim | 0:300d08d9b058 | 884 | if (on) { |
wim | 0:300d08d9b058 | 885 | _sendCommand(SET_FADE_BLINK, (FADE_OUT_ENABLE | FADE_INTERVAL_128_FRAMES)); |
wim | 0:300d08d9b058 | 886 | } |
wim | 0:300d08d9b058 | 887 | else { |
wim | 0:300d08d9b058 | 888 | _sendCommand(SET_FADE_BLINK, FADE_BLINK_DISABLE); |
wim | 0:300d08d9b058 | 889 | } |
wim | 0:300d08d9b058 | 890 | } |
wim | 0:300d08d9b058 | 891 | |
wim | 1:b7e8f5139026 | 892 | /** @brief Display Flip (Left/Right, Up/Down) |
wim | 1:b7e8f5139026 | 893 | * @param bool left flip Left/Right |
wim | 1:b7e8f5139026 | 894 | * @param bool down flip Up/Down |
wim | 1:b7e8f5139026 | 895 | */ |
wim | 0:300d08d9b058 | 896 | void SSD1308::setDisplayFlip(bool left, bool down) { |
wim | 0:300d08d9b058 | 897 | if (left) { |
wim | 0:300d08d9b058 | 898 | // column address 0 is mapped to SEG0 (Reset) |
wim | 0:300d08d9b058 | 899 | _sendCommand(SET_SEGMENT_REMAP_0); |
wim | 0:300d08d9b058 | 900 | } |
wim | 0:300d08d9b058 | 901 | else { |
wim | 0:300d08d9b058 | 902 | // column address 127 is mapped to SEG0 |
wim | 0:300d08d9b058 | 903 | _sendCommand(SET_SEGMENT_REMAP_127); |
wim | 0:300d08d9b058 | 904 | } |
wim | 0:300d08d9b058 | 905 | |
wim | 0:300d08d9b058 | 906 | if (down) { |
wim | 0:300d08d9b058 | 907 | // Reset mode |
wim | 0:300d08d9b058 | 908 | _sendCommand(SET_COMMON_REMAP_0); |
wim | 0:300d08d9b058 | 909 | } |
wim | 0:300d08d9b058 | 910 | else { |
wim | 0:300d08d9b058 | 911 | // Flip Up/Down (Need to rewrite display before H effect shows) |
wim | 0:300d08d9b058 | 912 | _sendCommand(SET_COMMON_REMAP_63); |
wim | 0:300d08d9b058 | 913 | } |
wim | 0:300d08d9b058 | 914 | |
wim | 0:300d08d9b058 | 915 | } |
wim | 0:300d08d9b058 | 916 | |
wim | 1:b7e8f5139026 | 917 | /** @brief Sets Internal Iref |
wim | 1:b7e8f5139026 | 918 | */ |
wim | 0:300d08d9b058 | 919 | void SSD1308::setInternalIref() { |
wim | 0:300d08d9b058 | 920 | // uint8_t cmds[2] = {SET_IREF_SELECTION, INTERNAL_IREF}; |
wim | 0:300d08d9b058 | 921 | // _sendCommands(2, cmds); |
wim | 0:300d08d9b058 | 922 | |
wim | 0:300d08d9b058 | 923 | _sendCommand(SET_IREF_SELECTION, INTERNAL_IREF); |
wim | 0:300d08d9b058 | 924 | } |
wim | 0:300d08d9b058 | 925 | |
wim | 1:b7e8f5139026 | 926 | /** @brief Sets External Iref (default) |
wim | 1:b7e8f5139026 | 927 | */ |
wim | 0:300d08d9b058 | 928 | void SSD1308::setExternalIref() { |
wim | 0:300d08d9b058 | 929 | // uint8_t cmds[2] = {SET_IREF_SELECTION, EXTERNAL_IREF}; |
wim | 0:300d08d9b058 | 930 | // _sendCommands(2, cmds); |
wim | 0:300d08d9b058 | 931 | _sendCommand(SET_IREF_SELECTION, EXTERNAL_IREF); |
wim | 0:300d08d9b058 | 932 | } |
wim | 0:300d08d9b058 | 933 | |
wim | 0:300d08d9b058 | 934 | |
wim | 2:16c84a134393 | 935 | /** @brief Shows All Pixels On |
wim | 2:16c84a134393 | 936 | */ |
wim | 2:16c84a134393 | 937 | void SSD1308::setEntireDisplayOn(){ |
wim | 2:16c84a134393 | 938 | _sendCommand(SET_ENTIRE_DISPLAY_ON); |
wim | 2:16c84a134393 | 939 | } |
wim | 2:16c84a134393 | 940 | |
wim | 2:16c84a134393 | 941 | /** @brief Shows Pixels as RAM content |
wim | 2:16c84a134393 | 942 | */ |
wim | 2:16c84a134393 | 943 | void SSD1308::setEntireDisplayRAM(){ |
wim | 2:16c84a134393 | 944 | _sendCommand(SET_DISPLAY_GDDRAM); |
wim | 2:16c84a134393 | 945 | } |
wim | 2:16c84a134393 | 946 | |
wim | 2:16c84a134393 | 947 | /** @brief Shows Pixels On or as RAM content |
wim | 2:16c84a134393 | 948 | * @param bool on (true is All on, false is RAM content) |
wim | 2:16c84a134393 | 949 | */ |
wim | 2:16c84a134393 | 950 | void SSD1308::setEntireDisplay(bool on){ |
wim | 2:16c84a134393 | 951 | if (on) { |
wim | 2:16c84a134393 | 952 | setEntireDisplayOn(); // All Pixels on |
wim | 2:16c84a134393 | 953 | } |
wim | 2:16c84a134393 | 954 | else { |
wim | 2:16c84a134393 | 955 | setEntireDisplayRAM(); // Pixels are RAM content |
wim | 2:16c84a134393 | 956 | } |
wim | 2:16c84a134393 | 957 | } |
wim | 2:16c84a134393 | 958 | |
wim | 2:16c84a134393 | 959 | |
wim | 2:16c84a134393 | 960 | /** @brief Horizontal scroll by one column per interval |
wim | 2:16c84a134393 | 961 | * @param bool left select Left/Right scroll |
wim | 2:16c84a134393 | 962 | * @param uint8_t start_page begin page (0..MAX_PAGE) |
wim | 2:16c84a134393 | 963 | * @param uint8_t end_page end page (start_page..MAX_PAGE) |
wim | 2:16c84a134393 | 964 | * @param uint8_t interval scroll interval in frames (see codes above) |
wim | 2:16c84a134393 | 965 | */ |
wim | 2:16c84a134393 | 966 | void SSD1308::setContinuousHorizontalScroll(bool left, uint8_t start_page, uint8_t end_page, uint8_t interval) { |
wim | 2:16c84a134393 | 967 | if (left) { |
wim | 2:16c84a134393 | 968 | _sendCommand(SET_LEFT_HOR_SCROLL, 0x00, start_page, interval, end_page, 0x00, 0xFF); // Scroll Left |
wim | 2:16c84a134393 | 969 | } |
wim | 2:16c84a134393 | 970 | else { |
wim | 2:16c84a134393 | 971 | _sendCommand(SET_RIGHT_HOR_SCROLL, 0x00, start_page, interval, end_page, 0x00, 0xFF); // Scroll Right |
wim | 2:16c84a134393 | 972 | } |
wim | 2:16c84a134393 | 973 | |
wim | 2:16c84a134393 | 974 | } |
wim | 2:16c84a134393 | 975 | |
wim | 2:16c84a134393 | 976 | |
wim | 2:16c84a134393 | 977 | /** @brief Horizontal and Vertical scroll by one column per interval |
wim | 2:16c84a134393 | 978 | * @param bool left select Left/Right scroll |
wim | 2:16c84a134393 | 979 | * @param uint8_t start_page begin page (0..MAX_PAGE) |
wim | 2:16c84a134393 | 980 | * @param uint8_t end_page end page (start_page..MAX_PAGE) |
wim | 2:16c84a134393 | 981 | * @param uint8_t offset vert offset (0x01..0x63) |
wim | 2:16c84a134393 | 982 | * @param uint8_t interval scroll interval in frames (see codes above) |
wim | 2:16c84a134393 | 983 | */ |
wim | 2:16c84a134393 | 984 | void SSD1308::setContinuousVerticalAndHorizontalScroll(bool left, uint8_t start_page, uint8_t end_page, |
wim | 2:16c84a134393 | 985 | uint8_t offset, uint8_t interval) { |
wim | 2:16c84a134393 | 986 | if (left) { |
wim | 2:16c84a134393 | 987 | _sendCommand(SET_VERT_LEFT_HOR_SCROLL, 0x00, start_page, interval, end_page, offset); // Scroll Left |
wim | 2:16c84a134393 | 988 | } |
wim | 2:16c84a134393 | 989 | else { |
wim | 2:16c84a134393 | 990 | _sendCommand(SET_VERT_RIGHT_HOR_SCROLL, 0x00, start_page, interval, end_page, offset); // Scroll Right |
wim | 2:16c84a134393 | 991 | } |
wim | 2:16c84a134393 | 992 | |
wim | 2:16c84a134393 | 993 | } |
wim | 2:16c84a134393 | 994 | |
wim | 2:16c84a134393 | 995 | /** @brief Set Vertical scroll area |
wim | 2:16c84a134393 | 996 | * @param uint8_t topRowsFixed fixed rows (0..MAX_ROW) |
wim | 2:16c84a134393 | 997 | * @param uint8_t scrollRowsoffset scroll rows (topRowsFixed..ROWS) |
wim | 2:16c84a134393 | 998 | */ |
wim | 2:16c84a134393 | 999 | void SSD1308::setVerticalScrollArea(uint8_t topRowsFixed, uint8_t scrollRows) { |
wim | 2:16c84a134393 | 1000 | |
wim | 2:16c84a134393 | 1001 | if ((topRowsFixed + scrollRows) > ROWS) { |
wim | 2:16c84a134393 | 1002 | scrollRows = ROWS - topRowsFixed; |
wim | 2:16c84a134393 | 1003 | }; |
wim | 2:16c84a134393 | 1004 | |
wim | 2:16c84a134393 | 1005 | _sendCommand(SET_VERTICAL_SCROLL_AREA, topRowsFixed, scrollRows); |
wim | 2:16c84a134393 | 1006 | } |
wim | 2:16c84a134393 | 1007 | |
wim | 2:16c84a134393 | 1008 | /** @brief Activate or Deactivate Horizontal and Vertical scroll |
wim | 2:16c84a134393 | 1009 | * @brief Note: after deactivating scrolling, the RAM data needs to be rewritten |
wim | 2:16c84a134393 | 1010 | * @param bool on activate scroll |
wim | 2:16c84a134393 | 1011 | */ |
wim | 2:16c84a134393 | 1012 | void SSD1308::setDisplayScroll(bool on) { |
wim | 2:16c84a134393 | 1013 | if (on) { |
wim | 2:16c84a134393 | 1014 | _sendCommand(SET_ACTIVATE_SCROLL); // Scroll on |
wim | 2:16c84a134393 | 1015 | } |
wim | 2:16c84a134393 | 1016 | else { |
wim | 2:16c84a134393 | 1017 | _sendCommand(SET_DEACTIVATE_SCROLL); // Scroll off |
wim | 2:16c84a134393 | 1018 | } |
wim | 2:16c84a134393 | 1019 | } |
wim | 2:16c84a134393 | 1020 | |
wim | 2:16c84a134393 | 1021 | |
wim | 2:16c84a134393 | 1022 | |
wim | 1:b7e8f5139026 | 1023 | /** @brief Low level Init |
wim | 1:b7e8f5139026 | 1024 | * @brief Init the configuration registers in accordance with the datasheet |
wim | 1:b7e8f5139026 | 1025 | */ |
wim | 0:300d08d9b058 | 1026 | void SSD1308::_init() { |
wim | 0:300d08d9b058 | 1027 | |
wim | 2:16c84a134393 | 1028 | _sendCommand(SET_DISPLAY_POWER_OFF); // 0xAE |
wim | 0:300d08d9b058 | 1029 | |
wim | 0:300d08d9b058 | 1030 | // column address 0 is mapped to SEG0 (Reset) |
wim | 2:16c84a134393 | 1031 | // row address 0 is mapped to COM0 (Reset) |
wim | 2:16c84a134393 | 1032 | _sendCommand(SET_SEGMENT_REMAP_0); // 0xA0 (Reset) |
wim | 2:16c84a134393 | 1033 | _sendCommand(SET_COMMON_REMAP_0); // 0xC0 (Reset) |
wim | 2:16c84a134393 | 1034 | |
wim | 2:16c84a134393 | 1035 | setDisplayStartLine(0); // 0x40 (Reset) |
wim | 0:300d08d9b058 | 1036 | |
wim | 2:16c84a134393 | 1037 | _sendCommand(SET_COMMON_CONF, COMMON_BASE | COMMON_ALTERNATIVE | COMMON_LEFTRIGHT_NORMAL); // 0xDA, 0x12 (Reset) |
wim | 0:300d08d9b058 | 1038 | |
wim | 2:16c84a134393 | 1039 | // Pagemode or Horizontal mode |
wim | 2:16c84a134393 | 1040 | // setPageAddressingMode(); // 0x20, 0x02 (Reset) |
wim | 2:16c84a134393 | 1041 | // setColumnStartForPageAddressingMode(0); // 0x00, 0x10 (Reset = Column 0) |
wim | 2:16c84a134393 | 1042 | // setPageStartForPageAddressingMode(PAGE_0);// 0xBO (Reset = Page 0) |
wim | 2:16c84a134393 | 1043 | setHorizontalAddressingMode(); // 0x20, 0x00 (Non-Reset) |
wim | 2:16c84a134393 | 1044 | setColumnAddress(0, MAX_COL); // 0x21, 0x00, 0x37 (Reset) |
wim | 2:16c84a134393 | 1045 | setPageAddress(0, MAX_PAGE); // 0x22, 0x00, 0x07 (Reset) |
wim | 0:300d08d9b058 | 1046 | |
wim | 2:16c84a134393 | 1047 | setExternalIref(); // 0xAD, 0x10 (Reset) |
wim | 2:16c84a134393 | 1048 | |
wim | 2:16c84a134393 | 1049 | _sendCommand(SET_DISPLAY_CLOCK, 0x70); // 0xD5, 0x70 (Reset = 0x80) |
wim | 2:16c84a134393 | 1050 | _sendCommand(SET_PRECHARGE_TIME, 0x21); // 0xD9, 0x21 (Reset = 0x22) |
wim | 2:16c84a134393 | 1051 | _sendCommand(SET_VCOMH_DESELECT_LEVEL, 0x30); // 0xDB, 0x30 (Reset = 0x20) |
wim | 2:16c84a134393 | 1052 | _sendCommand(SET_MULTIPLEX_RATIO, 0x3F); // 0xA8, 0x3F (Reset) |
wim | 2:16c84a134393 | 1053 | _sendCommand(SET_DISPLAY_OFFSET, 0x00); // 0xD3, 0x00 (Reset) |
wim | 2:16c84a134393 | 1054 | |
wim | 2:16c84a134393 | 1055 | _sendCommand(SET_CONTRAST, 0x7F); // 0x81, 0x7F (Reset) |
wim | 0:300d08d9b058 | 1056 | |
wim | 2:16c84a134393 | 1057 | _sendCommand(SET_NORMAL_DISPLAY); // 0xA6 (Reset) |
wim | 2:16c84a134393 | 1058 | |
wim | 2:16c84a134393 | 1059 | setEntireDisplayRAM(); // 0xA4 (Reset) |
wim | 2:16c84a134393 | 1060 | setDisplayScroll(false); |
wim | 0:300d08d9b058 | 1061 | |
wim | 0:300d08d9b058 | 1062 | clearDisplay(); |
wim | 0:300d08d9b058 | 1063 | |
wim | 2:16c84a134393 | 1064 | _sendCommand(SET_DISPLAY_POWER_ON); // 0xAF |
wim | 0:300d08d9b058 | 1065 | } |
wim | 0:300d08d9b058 | 1066 |