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