mirror of
https://github.com/DCC-EX/CommandStation-EX.git
synced 2024-12-23 21:01:25 +01:00
43319fd3dd
Add new read/write functions to I2CManager class, and modify the LCD, OLED and PWM classes to use them effectively.
98 lines
3.1 KiB
C++
98 lines
3.1 KiB
C++
/* 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
|
|
* <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#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
|