/* Based on Arduino SSD1306Ascii Library, Copyright (C) 2015 by William Greiman * Modifications (C) 2021 Neil McKechnie * * This Library is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This Library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this software. If not, see * . */ #ifndef SSD1306Ascii_h #define SSD1306Ascii_h #include "Arduino.h" #include "SSD1306font.h" #include "SSD1306init.h" class SSD1306AsciiWire : public Print { public: using Print::write; SSD1306AsciiWire() {} // Initialize the display controller. void begin(const DevType* dev, uint8_t i2cAddr); // Clear the display and set the cursor to (0, 0). void clear(); // Clear a region of the display. void clear(uint8_t c0, uint8_t c1, uint8_t r0, uint8_t r1); // The current column in pixels. inline uint8_t col() const { return m_col; } // The display hight in pixels. inline uint8_t displayHeight() const { return m_displayHeight; } // The display height in rows with eight pixels to a row. inline uint8_t displayRows() const { return m_displayHeight / 8; } // The display width in pixels. inline uint8_t displayWidth() const { return m_displayWidth; } // Set the cursor position to (0, 0). inline void home() { setCursor(0, 0); } // Initialize the display controller. void init(const DevType* dev); // the current row number with eight pixels to a row. inline uint8_t row() const { return m_row; } /** * @brief Set the display contrast. * * @param[in] value The contrast level in th range 0 to 255. */ void setContrast(uint8_t value); /** * @brief Set the cursor position. * * @param[in] col The column number in pixels. * @param[in] row the row number in eight pixel rows. */ void setCursor(uint8_t col, uint8_t row); /** * @brief Set the current font. * * @param[in] font Pointer to a font table. */ void setFont(const uint8_t* font); /** * @brief Display a character. * * @param[in] c The character to display. * @return one for success else zero. */ size_t write(uint8_t c); private: uint8_t m_col; // Cursor column. uint8_t m_row; // Cursor RAM row. uint8_t m_displayWidth; // Display width. uint8_t m_displayHeight; // Display height. uint8_t m_colOffset; // Column offset RAM to SEG. const uint8_t* m_font = NULL; // Current font. // Only fixed size 5x7 fonts in a 6x8 cell are supported. const uint8_t fontWidth = 5; const uint8_t fontHeight = 7; const uint8_t letterSpacing = 1; uint8_t m_fontFirstChar; uint8_t m_fontCharCount; uint8_t m_i2cAddr; static const uint8_t blankPixels[]; }; #endif // SSD1306Ascii_h