206 lines
6.7 KiB
C++
206 lines
6.7 KiB
C++
/**
|
|
* 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 <Wire.h>
|
|
|
|
#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
|