6-digit 7-segment LCD with battery indicator (HT1621). More...

#include <SegLCD_HT1621_6SegBat.h>

Inheritance diagram for SegLCD_HT1621_6SegBat:

Public Member Functions
	SegLCD_HT1621_6SegBat (uint8_t chipselect, uint8_t data, uint8_t write, uint8_t read=-1)

void	init () override
	Initialize GPIO pins for communication.

void	setBatteryLevel (uint8_t level)

size_t	write (uint8_t ch) override

Public Member Functions inherited from SegDriver_HT1621
	SegDriver_HT1621 (uint8_t chipselect, uint8_t data, uint8_t write, uint8_t read=-1)
	Constructor for HT1621 segment driver.

void	clear () override
	Clear all visible segments on the display.

void	flush (uint8_t startAddr, uint8_t length) override
	Flush specific range of buffered changes to the display.

virtual void	flush ()
	Flush all buffered changes to the display.

virtual void	flush (uint8_t startAddr, uint8_t length)
	Flush specific range of buffered changes to the display.

Public Member Functions inherited from SegDriver_3Wire
	SegDriver_3Wire (uint8_t chipselect, uint8_t data, uint8_t write, uint8_t read=-1)
	Constructor for 3-wire serial LCD driver.

void	on () override
	Turn the display on.

void	off () override
	Turn the display off.

void	command (uint8_t command) override
	Send command to the controller.

Public Member Functions inherited from SegLCDLib
virtual	~SegLCDLib ()
	Virtual destructor to ensure proper cleanup in derived classes.

void	home ()
	Set cursor to 0, 0 without clear display.

virtual void	setCursor (uint8_t row, uint8_t col)
	Set cursor on exact digit.

void	initBacklight (int8_t backlightPin, BacklightMode backlightMode=BACKLIGHT_DIGITAL, bool backlightActiveHigh=true)
	Initialize GPIO backlight control.

virtual void	setBacklight (bool state)
	Set backlight state (on/off).

virtual void	setBacklight (int brightness)
	Set backlight brightness (0-255).

void	setAutoFlush (bool enable)
	Enable or disable autoflush mode.

bool	getAutoFlush () const
	Get current autoflush state.

const uint8_t *	getRamBuffer () const
	Get pointer to internal RAM buffer (read-only).

size_t	getRamBufferSize () const
	Get size of internal RAM buffer in bytes.

Private Member Functions
void	_setDecimal (uint8_t row, uint8_t col, bool state) override
	Virtual method for setting decimal point.

uint8_t	_mapSegments (uint8_t val)

Static Private Attributes
static constexpr uint8_t	RAM_SIZE = 6

static constexpr uint8_t	DIGITS = 6

static constexpr uint8_t	DECIMAL_MIN_COL = 2

static constexpr uint8_t	DECIMAL_MAX_COL = 4

static constexpr uint8_t	DECIMAL_POINT_BIT = 0x80

static constexpr int8_t	DECIMAL_COL_OFFSET = -1

static constexpr uint8_t	MAX_BATTERY_LEVEL = 3

static constexpr uint8_t	BATTERY_MASK = 0x80

static constexpr uint8_t	BATTERY_LEVEL_SEG [3] = {2, 1, 0}

Additional Inherited Members
Public Types inherited from SegLCDLib
enum	BacklightMode { BACKLIGHT_DIGITAL , BACKLIGHT_PWM }
	Backlight mode for GPIO control. More...

Protected Member Functions inherited from SegDriver_HT1621
void	_setMode (ModeDrive drive=MODE_DRIVE_14, ModeBias bias=MODE_BIAS_13)
	Set the mode of the display.

Protected Member Functions inherited from SegDriver_3Wire
void	_writeRam (uint8_t data, uint8_t address)
	Write single byte to RAM at specified address.

virtual void	_writeRam (uint8_t *data, size_t length, uint8_t address)
	Write multiple bytes to RAM starting at specified address.

virtual void	_sendBits (uint16_t data, uint8_t bitCount=8)
	Send bits to the controller.

Protected Member Functions inherited from SegLCDLib
void	_setFlag (uint8_t mask)
	Set a specific flag bit.

void	_clearFlag (uint8_t mask)
	Clear a specific flag bit.

bool	_isFlagSet (uint8_t mask) const
	Check if a specific flag bit is set.

void	_clearAllFlags ()
	Clear all flags.

bool	_dotWrite (uint8_t ch, int8_t minCol, int8_t maxCol, int8_t ramOffset)
	Write decimal point.

void	_dotClearCur (int8_t minCol, int8_t maxCol)
	Clear current decimal (overwrite).

void	_colonClearIfNotFlagged (uint8_t ch, uint8_t colonCol, uint8_t colonFlag)
	Clear colon if its flag is not set.

virtual void	_setColon (uint8_t row, uint8_t col, bool state)
	Virtual method for setting colon.

void	_allocateBuffer (size_t size)
	Allocate RAM buffer for display data.

void	_writeRamMasked (uint8_t data, uint8_t address, uint8_t mask=0xFF)
	Write to display RAM with nibble-aware masking support.

uint8_t	_get_char_value (char ch)
	Helper method to convert a character to its segment representation.

uint16_t	_get_16char_value (char ch)
	Helper method to convert a character to its 16-segment representation.

Protected Attributes inherited from SegDriver_3Wire
uint8_t	_wr
	Write clock pin for the display.

uint8_t	_rd
	Read clock pin for the display.

uint8_t	_data
	Data pin for the display.

uint8_t	_cs
	Chip select pin for the display.

uint8_t	_maxAddress
	Maximum address for this controller.

Protected Attributes inherited from SegLCDLib
bool	_autoFlush = true
	Autoflush mode enabled flag (default: true for LCD API 1.0 compatibility).

int8_t	_backlightPin = -1
	Backlight GPIO pin (-1 if disabled)

BacklightMode	_backlightMode = BACKLIGHT_DIGITAL
	Backlight mode (DIGITAL or PWM)

bool	_backlightActiveHigh = true
	Backlight active high flag.

uint8_t	_backlightBrightness = 0
	Cached backlight brightness.

uint8_t	_displayFlags = 0
	LEDC channel for old ESP32 Arduino Core (2.0.x)

uint8_t *	_ramBuffer = nullptr
	Dynamic RAM buffer for display data (allocated by derived classes).

size_t	_ramBufferSize = 0
	Size of allocated RAM buffer in bytes.

uint8_t	_cursorRow = 0
	Current Row.

uint8_t	_cursorCol = 0
	Current Column.

Static Protected Attributes inherited from SegLCDLib
static constexpr uint8_t	FLAG_PENDING_DOT = 0x80
	Common flag for decimal handling when RAM offset is 0.

Detailed Description

6-digit 7-segment LCD with battery indicator (HT1621).

Features: battery level indicator, decimal points. Integrated HT1621 controller, 3-wire serial protocol.

See also: examples/HT1621/6DigBat/6DigBat.ino

Constructor & Destructor Documentation

◆ SegLCD_HT1621_6SegBat()

SegLCD_HT1621_6SegBat::SegLCD_HT1621_6SegBat	(	uint8_t	chipselect,
		uint8_t	data,
		uint8_t	write,
		uint8_t	read = `-1`
	)

Member Function Documentation

◆ _mapSegments()

uint8_t SegLCD_HT1621_6SegBat::_mapSegments ( uint8_t val )

private

◆ _setDecimal()

void SegLCD_HT1621_6SegBat::_setDecimal	(	uint8_t	row,
		uint8_t	col,
		bool	state
	)

overrideprivatevirtual

Virtual method for setting decimal point.

Each LCD has its own implementation with HW specifics. Default implementation is empty (no-op).

Reimplemented from SegLCDLib.

◆ init()

void SegLCD_HT1621_6SegBat::init ( )

overridevirtual

Initialize GPIO pins for communication.

Reimplemented from SegDriver_3Wire.

◆ setBatteryLevel()

void SegLCD_HT1621_6SegBat::setBatteryLevel ( uint8_t level )

◆ write()

size_t SegLCD_HT1621_6SegBat::write ( uint8_t ch )

overridevirtual

Reimplemented from SegLCDLib.

Field Documentation

◆ BATTERY_LEVEL_SEG

constexpr uint8_t SegLCD_HT1621_6SegBat::BATTERY_LEVEL_SEG[3] = {2, 1, 0}

staticconstexprprivate

◆ BATTERY_MASK

constexpr uint8_t SegLCD_HT1621_6SegBat::BATTERY_MASK = 0x80

staticconstexprprivate

◆ DECIMAL_COL_OFFSET

constexpr int8_t SegLCD_HT1621_6SegBat::DECIMAL_COL_OFFSET = -1

staticconstexprprivate

◆ DECIMAL_MAX_COL

constexpr uint8_t SegLCD_HT1621_6SegBat::DECIMAL_MAX_COL = 4

staticconstexprprivate

◆ DECIMAL_MIN_COL

constexpr uint8_t SegLCD_HT1621_6SegBat::DECIMAL_MIN_COL = 2

staticconstexprprivate

◆ DECIMAL_POINT_BIT

constexpr uint8_t SegLCD_HT1621_6SegBat::DECIMAL_POINT_BIT = 0x80

staticconstexprprivate

◆ DIGITS

constexpr uint8_t SegLCD_HT1621_6SegBat::DIGITS = 6

staticconstexprprivate

◆ MAX_BATTERY_LEVEL

constexpr uint8_t SegLCD_HT1621_6SegBat::MAX_BATTERY_LEVEL = 3

staticconstexprprivate

◆ RAM_SIZE

constexpr uint8_t SegLCD_HT1621_6SegBat::RAM_SIZE = 6

staticconstexprprivate

The documentation for this class was generated from the following files:

src/SegLCD_HT1621_6SegBat.h
src/SegLCD_HT1621_6SegBat.cpp

Public Member Functions

Private Member Functions

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SegLCD_HT1621_6SegBat()

Member Function Documentation

◆ _mapSegments()

◆ _setDecimal()

◆ init()

◆ setBatteryLevel()

◆ write()

Field Documentation

◆ BATTERY_LEVEL_SEG

◆ BATTERY_MASK

◆ DECIMAL_COL_OFFSET

◆ DECIMAL_MAX_COL

◆ DECIMAL_MIN_COL

◆ DECIMAL_POINT_BIT

◆ DIGITS

◆ MAX_BATTERY_LEVEL

◆ RAM_SIZE