/** * The MIT License (MIT) * * Copyright (c) 2018 by ThingPulse, Daniel Eichhorn * Copyright (c) 2018 by Fabrice Weinberg * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. * * ThingPulse invests considerable time and money to develop these open source libraries. * Please support us by buying our products (and not the clones) from * https://thingpulse.com * */ #ifndef SH1106Wire_h #define SH1106Wire_h #include "OLEDDisplay.h" #include #define SH1106_SET_PUMP_VOLTAGE 0X30 #define SH1106_SET_PUMP_MODE 0XAD #define SH1106_PUMP_ON 0X8B #define SH1106_PUMP_OFF 0X8A //-------------------------------------- class SH1106Wire : public OLEDDisplay { private: uint8_t _address; uint8_t _sda; uint8_t _scl; bool _doI2cAutoInit = false; TwoWire* _wire = NULL; int _frequency; public: /** * Create and initialize the Display using Wire library * * Beware for retro-compatibility default values are provided for all parameters see below. * Please note that if you don't wan't SD1306Wire to initialize and change frequency speed ot need to * ensure -1 value are specified for all 3 parameters. This can be usefull to control TwoWire with multiple * device on the same bus. * * @param _address I2C Display address * @param _sda I2C SDA pin number, default to -1 to skip Wire begin call * @param _scl I2C SCL pin number, default to -1 (only SDA = -1 is considered to skip Wire begin call) * @param g display geometry dafault to generic GEOMETRY_128_64, see OLEDDISPLAY_GEOMETRY definition for other options * @param _i2cBus on ESP32 with 2 I2C HW buses, I2C_ONE for 1st Bus, I2C_TWO fot 2nd bus, default I2C_ONE * @param _frequency for Frequency by default Let's use ~700khz if ESP8266 is in 160Mhz mode, this will be limited to ~400khz if the ESP8266 in 80Mhz mode */ SH1106Wire(uint8_t _address, uint8_t _sda, uint8_t _scl, OLEDDISPLAY_GEOMETRY g = GEOMETRY_128_64, HW_I2C _i2cBus = I2C_ONE, int _frequency = 700000) { setGeometry(g); this->_address = _address; this->_sda = _sda; this->_scl = _scl; #if !defined(ARDUINO_ARCH_ESP32) this->_wire = &Wire; #else this->_wire = (_i2cBus==I2C_ONE) ? &Wire : &Wire1; #endif this->_frequency = _frequency; } bool connect() { #if !defined(ARDUINO_ARCH_ESP32) && !defined(ARDUINO_ARCH8266) _wire->begin(); #else // On ESP32 arduino, -1 means 'don't change pins', someone else has called begin for us. if(this->_sda != -1) _wire->begin(this->_sda, this->_scl); #endif // Let's use ~700khz if ESP8266 is in 160Mhz mode // this will be limited to ~400khz if the ESP8266 in 80Mhz mode. if(this->_frequency != -1) _wire->setClock(this->_frequency); return true; } void display(void) { initI2cIfNeccesary(); #ifdef OLEDDISPLAY_DOUBLE_BUFFER uint8_t minBoundY = UINT8_MAX; uint8_t maxBoundY = 0; uint8_t minBoundX = UINT8_MAX; uint8_t maxBoundX = 0; uint8_t x, y; // Calculate the Y bounding box of changes // and copy buffer[pos] to buffer_back[pos]; for (y = 0; y < (displayHeight / 8); y++) { for (x = 0; x < displayWidth; x++) { uint16_t pos = x + y * displayWidth; if (buffer[pos] != buffer_back[pos]) { minBoundY = min(minBoundY, y); maxBoundY = max(maxBoundY, y); minBoundX = min(minBoundX, x); maxBoundX = max(maxBoundX, x); } buffer_back[pos] = buffer[pos]; } yield(); } // If the minBoundY wasn't updated // we can savely assume that buffer_back[pos] == buffer[pos] // holdes true for all values of pos if (minBoundY == UINT8_MAX) return; // Calculate the colum offset uint8_t minBoundXp2H = (minBoundX + 2) & 0x0F; uint8_t minBoundXp2L = 0x10 | ((minBoundX + 2) >> 4 ); byte k = 0; for (y = minBoundY; y <= maxBoundY; y++) { sendCommand(0xB0 + y); sendCommand(minBoundXp2H); sendCommand(minBoundXp2L); for (x = minBoundX; x <= maxBoundX; x++) { if (k == 0) { _wire->beginTransmission(_address); _wire->write(0x40); } _wire->write(buffer[x + y * displayWidth]); k++; if (k == 16) { _wire->endTransmission(); k = 0; } } if (k != 0) { _wire->endTransmission(); k = 0; } yield(); } if (k != 0) { _wire->endTransmission(); } #else uint8_t * p = &buffer[0]; for (uint8_t y=0; y<8; y++) { sendCommand(0xB0+y); sendCommand(0x02); sendCommand(0x10); for( uint8_t x=0; x<8; x++) { _wire->beginTransmission(_address); _wire->write(0x40); for (uint8_t k = 0; k < 16; k++) { _wire->write(*p++); } _wire->endTransmission(); } } #endif } void setI2cAutoInit(bool doI2cAutoInit) { _doI2cAutoInit = doI2cAutoInit; } private: int getBufferOffset(void) { return 0; } inline void sendCommand(uint8_t command) __attribute__((always_inline)){ _wire->beginTransmission(_address); _wire->write(0x80); _wire->write(command); _wire->endTransmission(); } void initI2cIfNeccesary() { if (_doI2cAutoInit) { #ifdef ARDUINO_ARCH_AVR _wire->begin(); #else _wire->begin(this->_sda, this->_scl); #endif } } }; #endif