WipperSnapper_I2C_Driver_Out_Sh1107.h

Go to the documentation of this file.

#ifndef WIPPERSNAPPER_I2C_DRIVER_OUT_SH1107_H
#define WIPPERSNAPPER_I2C_DRIVER_OUT_SH1107_H

#include "WipperSnapper_I2C_Driver_Out.h"
#include <Adafruit_GFX.h>
#include <Adafruit_SH110X.h>
#include <Arduino.h>

#define WS_SH1107_DEFAULT_WIDTH                                                \
  128 
#define WS_SH1107_DEFAULT_HEIGHT                                               \
  64 

#define OLED_128X64_WING_WIDTH 128 
#define OLED_128X64_WING_HEIGHT 64 
#define OLED_128X64_WING_ROTATION_90 1 


class WipperSnapper_I2C_Driver_Out_SH1107
    : public WipperSnapper_I2C_Driver_Out {

public:
  /*******************************************************************************/
  /*******************************************************************************/
  WipperSnapper_I2C_Driver_Out_SH1107(TwoWire *i2c, uint16_t sensorAddress)
      : WipperSnapper_I2C_Driver_Out(i2c, sensorAddress) {
    _i2c = i2c;
    _sensorAddress = sensorAddress;
    _width = WS_SH1107_DEFAULT_WIDTH;
    _height = WS_SH1107_DEFAULT_HEIGHT;
  }

  ~WipperSnapper_I2C_Driver_Out_SH1107() {
    if (_display != nullptr) {
      _display->clearDisplay();
      _display->display();
      _display->oled_command(SH110X_DISPLAYOFF);
      delete _display;
      _display = nullptr;
    }
  }

  bool begin() {
    if (_width == OLED_128X64_WING_WIDTH &&
        _height == OLED_128X64_WING_HEIGHT &&
        _rotation == OLED_128X64_WING_ROTATION_90) {
      // featherwing needs to be rotated 90 degrees and swap w/h ctor args
      _display = new Adafruit_SH1107(_height, _width, _i2c);
    } else {
      _display = new Adafruit_SH1107(_width, _height, _i2c);
    }
    if (!_display->begin(_sensorAddress, true))
      return false;

    // Clear the buffer.
    _display->clearDisplay();
    _display->display();
    _display->setRotation(_rotation); // 0-3, not degrees for SH1107

    // Configure the text size and color
    _display->setTextSize(_text_sz);
    _display->setTextColor(SH110X_WHITE);
    _display->setCursor(0, 0);
    // Clear the buffer
    _display->clearDisplay();
    _display->display();
    return true;
  }

  void ConfigureSH1107(uint8_t width, uint8_t height, uint8_t text_size,
                       uint8_t rotation) {
    _width = width;
    _height = height;
    _text_sz = text_size;
    _rotation =
        rotation % 90; // SH1107 requires rotation to be 0-3, not degrees
  }
  void ConfigureSSD1306(uint8_t width, uint8_t height, uint8_t text_size,
                        uint8_t rotation) {
    // This is a SH1107, not a SSD1306, so we don't need to do anything here.
    ConfigureSH1107(width, height, text_size, rotation);
  }

  void WriteMessageSH1107(const char *message) {
    if (_display == nullptr)
      return;
    // Start with a fresh display buffer
    // and settings
    int16_t y_idx = 0;
    _display->clearDisplay();
    _display->setTextSize(_text_sz);
    _display->setTextColor(SH110X_WHITE);
    _display->setCursor(0, y_idx);
    _display->display();

    // Calculate the line height based on the text size (NOTE: base height is
    // 8px)
    int16_t line_height = 8 * _text_sz;
    uint16_t c_idx = 0;
    size_t msg_size = strlen(message);
    for (size_t i = 0; i < msg_size && c_idx < msg_size; i++) {
      if (message[i] == '\\' && i + 1 < msg_size &&
          (message[i + 1] == 'n' || message[i + 1] == 'r')) {
        // Handle \r\n sequence as a single newline
        if (message[i + 1] == 'r' && i + 3 < msg_size &&
            message[i + 2] == '\\' && message[i + 3] == 'n') {
          // Skip to the next line
          y_idx += line_height;
          _display->setCursor(0, y_idx);
          i += 3;
        } else if (message[i + 1] == 'n') {
          // Skip to the next line
          y_idx += line_height;
          _display->setCursor(0, y_idx);
          i++;
        }
      } else if (message[i] == 0xC2 && message[i + 1] == 0xB0) {
        _display->write(char(248));
        _display->display();
        i++;
      } else {
        _display->print(message[i]);
        _display->display();
      }
    }
  }

  void WriteMessageSSD1306(const char *message) {
    // This is a SH1107, not a SSD1306, so we just call the SH1107 write
    WriteMessageSH1107(message);
  }

protected:
  Adafruit_SH1107 *_display =
      nullptr;       
  uint8_t _width;    
  uint8_t _height;   
  uint8_t _rotation; 
  uint8_t _text_sz;  
};

#endif // WIPPERSNAPPER_I2C_DRIVER_OUT_SH1107_H