Class implements interface functions to SH1107 displays. More...

#include <lcd_sh1107.h>

Inheritance diagram for InterfaceSH1107:

Collaboration diagram for InterfaceSH1107:

Public Member Functions
template<typename... Args>
	InterfaceSH1107 (NanoDisplayBase< InterfaceSH1107< I >> &base, int8_t dc, Args &&... data)
	Creates instance of interface to LCD display. More...

void	startBlock (lcduint_t x, lcduint_t y, lcduint_t w)
	Sets block in RAM of lcd display controller to write data to. More...

void	nextBlock ()
	Switches to the start of next RAM page for the block, specified by startBlock(). More...

void	endBlock ()
	Closes data send operation to lcd display.

void	setDataMode (uint8_t mode)
	Enables either data or command mode on SPI bus. More...

void	commandStart ()
	Starts communication with LCD display in command mode. More...

void	setStartLine (uint8_t line)
	Sets start line in GDRAM to begin display content with. More...

uint8_t	getStartLine ()
	Returns the current start line offset in GDRAM. More...

void	normalMode ()
	Switches display back to normal (non-inverted) mode. More...

void	invertMode ()
	Switches display to inverted mode. More...

void	setContrast (uint8_t contrast)
	Sets display contrast (brightness level). More...

void	displayOff ()
	Turns off the display (enters sleep mode). More...

void	displayOn ()
	Turns on the display, resuming normal output. More...

void	flipHorizontal (uint8_t mode)
	Performs horizontal flip. More...

void	flipVertical (uint8_t mode)
	Performs vertical flip. More...

void	setSegOffset (uint8_t offset)
	Sets segment (column) connection offset. More...

void	setDisplayOffset (uint8_t offset)
	Sets display offset according to datasheet. More...

Detailed Description

template<typename I>
class InterfaceSH1107

Class implements interface functions to SH1107 displays.

Definition at line 43 of file lcd_sh1107.h.

Constructor & Destructor Documentation

◆ InterfaceSH1107()

template<typename I>

template<typename... Args>

InterfaceSH1107< I >::InterfaceSH1107	(	NanoDisplayBase< InterfaceSH1107< I >> &	base,
		int8_t	dc,
		Args &&...	data
	)

inline

Creates instance of interface to LCD display.

Parameters

base	Reference to base class, which represents Display
dc	Data/command control pin number, for i2c communication should be -1
data	variable argument list, accepted by platform interface (PlatformI2c, PlatformSpi)

Definition at line 54 of file lcd_sh1107.h.

Member Function Documentation

◆ commandStart()

template<class I >

void InterfaceSH1107::commandStart ( )

Starts communication with LCD display in command mode.

To stop communication use m_intf.end().

Definition at line 74 of file lcd_sh1107.inl.

◆ displayOff()

template<class I >

void InterfaceSH1107::displayOff ( )

Turns off the display (enters sleep mode).

Contents of display RAM are preserved.

See also: displayOn()

Definition at line 119 of file lcd_sh1107.inl.

◆ displayOn()

template<class I >

void InterfaceSH1107::displayOn ( )

Turns on the display, resuming normal output.

See also: displayOff()

Definition at line 126 of file lcd_sh1107.inl.

◆ flipHorizontal()

template<class I >

void InterfaceSH1107::flipHorizontal ( uint8_t mode )

Performs horizontal flip.

Performs horizontal flip. To rotate the display by 180°, use both flipHorizontal() and flipVertical().

Parameters

mode	0 to disable horizontal flip, 1 to enable

See also: flipVertical()

Definition at line 133 of file lcd_sh1107.inl.

◆ flipVertical()

template<class I >

void InterfaceSH1107::flipVertical ( uint8_t mode )

Performs vertical flip.

Performs vertical flip. To rotate the display by 180°, use both flipHorizontal() and flipVertical().

Parameters

mode	0 to disable vertical flip, 1 to enable

See also: flipHorizontal()

Definition at line 140 of file lcd_sh1107.inl.

◆ getStartLine()

template<class I >

uint8_t InterfaceSH1107::getStartLine ( )

Returns the current start line offset in GDRAM.

Returns: current start line value

See also: setStartLine()

Definition at line 92 of file lcd_sh1107.inl.

◆ invertMode()

template<class I >

void InterfaceSH1107::invertMode ( )

Switches display to inverted mode.

In this mode, lit pixels become dark and dark pixels become lit.

See also: normalMode()

Definition at line 104 of file lcd_sh1107.inl.

◆ nextBlock()

template<class I >

void InterfaceSH1107::nextBlock ( )

Switches to the start of next RAM page for the block, specified by startBlock().

For SSD1306 it does nothing, while for SH1106 the function moves cursor to next page.

Definition at line 55 of file lcd_sh1107.inl.

◆ normalMode()

template<class I >

void InterfaceSH1107::normalMode ( )

Switches display back to normal (non-inverted) mode.

See also: invertMode()

Definition at line 97 of file lcd_sh1107.inl.

◆ setContrast()

template<class I >

void InterfaceSH1107::setContrast ( uint8_t contrast )

Sets display contrast (brightness level).

Higher values produce brighter output.

Parameters

contrast contrast value (0–255), refer to SH1107 datasheet

See also: displayOn()

Definition at line 111 of file lcd_sh1107.inl.

◆ setDataMode()

template<class I >

void InterfaceSH1107::setDataMode ( uint8_t mode )

Enables either data or command mode on SPI bus.

Parameters

mode	1 to enable data mode, or 0 to enable command mode

Definition at line 66 of file lcd_sh1107.inl.

◆ setDisplayOffset()

template<class I >

void InterfaceSH1107::setDisplayOffset ( uint8_t offset )

Sets display offset according to datasheet.

Parameters

offset display offset in range 0 - 127

Definition at line 152 of file lcd_sh1107.inl.

◆ setSegOffset()

template<class I >

void InterfaceSH1107::setSegOffset ( uint8_t offset )

Sets segment (column) connection offset.

Some manufactures connect left column of display matrix to SH1107 starting at non-zero segment output line. This causes some shift comparing to GDDRAM content. Use this function to fix that

Parameters

offset index of the segment corresponding to first column

Definition at line 147 of file lcd_sh1107.inl.

◆ setStartLine()

template<class I >

void InterfaceSH1107::setStartLine ( uint8_t line )

Sets start line in GDRAM to begin display content with.

Used for hardware scrolling effects.

Parameters

line	start line in range 0–127

See also: getStartLine()

Definition at line 83 of file lcd_sh1107.inl.

◆ startBlock()

template<class I >

void InterfaceSH1107< I >::startBlock	(	lcduint_t	x,
		lcduint_t	y,
		lcduint_t	w
	)

Sets block in RAM of lcd display controller to write data to.

Sets block in RAM of lcd display controller to write data to. For SH1107 it uses horizontal addressing mode, while for sh1106 the function uses page addressing mode. Width can be specified as 0, thus the library will set the right boundary to region of RAM block to the right column of the display.

Parameters

x	- column (left region)
y	- row (top region)
w	- width of the block in pixels to control

Warning: - this function initiates session (i2c or spi) and does not close it. To close session, please, call endBlock().

Definition at line 35 of file lcd_sh1107.inl.

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

src/v2/lcd/sh1107/lcd_sh1107.h
src/v2/lcd/sh1107/lcd_sh1107.inl

Public Member Functions

Detailed Description

template<typename I> class InterfaceSH1107< I >

Constructor & Destructor Documentation

◆ InterfaceSH1107()

Member Function Documentation

◆ commandStart()

◆ displayOff()

◆ displayOn()

◆ flipHorizontal()

◆ flipVertical()

◆ getStartLine()

◆ invertMode()

◆ nextBlock()

◆ normalMode()

◆ setContrast()

◆ setDataMode()

◆ setDisplayOffset()

◆ setSegOffset()

◆ setStartLine()

◆ startBlock()

template<typename I>
class InterfaceSH1107< I >