WipperSnapper_I2C_Driver_Out_Ssd1306.h

Go to the documentation of this file.

#ifndef WIPPERSNAPPER_I2C_DRIVER_OUT_SSD1306_H
#define WIPPERSNAPPER_I2C_DRIVER_OUT_SSD1306_H

#include "WipperSnapper_I2C_Driver_Out.h"
#include <Adafruit_SSD1306.h>
#include <Arduino.h>

#define WS_SSD1306_DEFAULT_WIDTH                                               \
  128 
#define WS_SSD1306_DEFAULT_HEIGHT                                              \
  64 


class WipperSnapper_I2C_Driver_Out_Ssd1306
    : public WipperSnapper_I2C_Driver_Out {

public:
  /*******************************************************************************/
  /*******************************************************************************/
  WipperSnapper_I2C_Driver_Out_Ssd1306(TwoWire *i2c, uint16_t sensorAddress)
      : WipperSnapper_I2C_Driver_Out(i2c, sensorAddress) {
    _i2c = i2c;
    _sensorAddress = sensorAddress;
    _width = WS_SSD1306_DEFAULT_WIDTH;
    _height = WS_SSD1306_DEFAULT_HEIGHT;
  }

  ~WipperSnapper_I2C_Driver_Out_Ssd1306() {
    if (_display != nullptr) {
      _display->clearDisplay();
      _display->display();
      _display->ssd1306_command(SSD1306_DISPLAYOFF);
      delete _display;
      _display = nullptr;
    }
  }

  bool begin() {
    // Attempt to create and allocate a SSD1306 obj.
    _display = new Adafruit_SSD1306(_width, _height, _i2c);
    if (!_display->begin(SSD1306_SWITCHCAPVCC, _sensorAddress))
      return false;
    // Configure the rotation, text size and color
    _display->setRotation(_rotation);
    _display->setTextSize(_text_sz);
    _display->setTextColor(SSD1306_WHITE);
    // Use full 256 char 'Code Page 437' font
    _display->cp437(true);
    // Clear the buffer
    _display->clearDisplay();
    _display->display();
    return true;
  }

  void ConfigureSSD1306(uint8_t width, uint8_t height, uint8_t text_size,
                        uint8_t rotation = 0) {
    _width = width;
    _height = height;
    _text_sz = text_size;
    _rotation = rotation;
  }

  void WriteMessageSSD1306(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(SSD1306_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();
      }
    }
  }

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

#endif // WIPPERSNAPPER_I2C_DRIVER_OUT_SSD1306_H