Driver for arrays of LED 8x8 Matrices driven by MAX7219. More...

#include <modm/driver/display/max7219_matrix.hpp>

Inheritance diagram for modm::Max7219Matrix< SPI, CS, COLUMNS, ROWS >:

Public Member Functions
void	initialize ()
	Initialize the display.

virtual void	update () override
	Update the display with the content of the RAM buffer.

IOStream &	ascii ()
	set the output mode to ASCII style for integer types

IOStream &	bin ()
	set the output mode to binary style for integer types

void	clear () final

void	clearPixel (int16_t x, int16_t y) final

void	clearPixel (glcd::Point p)

void	drawCircle (glcd::Point center, uint16_t radius)

void	drawEllipse (glcd::Point center, int16_t rx, int16_t ry)

void	drawImage (glcd::Point start, modm::accessor::Flash< uint8_t > image)

void	drawImageRaw (glcd::Point start, uint16_t width, uint16_t height, modm::accessor::Flash< uint8_t > data) final

void	drawLine (glcd::Point start, glcd::Point end)

void	drawLine (int16_t x1, int16_t y1, int16_t x2, int16_t y2)

void	drawRectangle (glcd::Point start, uint16_t width, uint16_t height)

void	drawRectangle (int16_t x, int16_t y, uint16_t width, uint16_t height)

void	drawRoundedRectangle (glcd::Point start, uint16_t width, uint16_t height, uint16_t radius)

IOStream &	endl ()

virtual void	fillCircle (glcd::Point center, uint16_t radius)

void	fillRectangle (glcd::Point start, uint16_t width, uint16_t height)

void	fillRectangle (int16_t x, int16_t y, uint16_t width, uint16_t height)

IOStream &	flush ()

IOStream &	get (char &c)
	Reads one character and returns it if available. Otherwise, returns IOStream::eof.

IOStream &	get (char *s, size_t n)

template<size_t N>
IOStream &	get (char (&s)[N])

std::size_t	getBufferHeight () const final

std::size_t	getBufferWidth () const final

glcd::Point	getCursor () const

uint8_t	getFontHeight () const

uint16_t	getHeight () const final

bool	getPixel (int16_t x, int16_t y) const final

uint16_t	getStringWidth (const char *s) const

uint16_t	getWidth () const final

IOStream &	hex ()
	set the output mode to hexadecimal style for integer types

IOStream &	operator<< (const bool &v)

IOStream &	operator<< (const char &v)

IOStream &	operator<< (const uint8_t &v)

IOStream &	operator<< (const int16_t &v)

IOStream &	operator<< (const uint16_t &v)

IOStream &	operator<< (const int32_t &v)

IOStream &	operator<< (const uint32_t &v)

IOStream &	operator<< (const char *s)

IOStream &	operator<< (const std::string_view sv)

IOStream &	operator<< (const void *p)
	write the hex value of a pointer

template<class Ret , class... Args>
IOStream &	operator<< (Ret (*pointer)(Args...))
	Write the hex value of any function pointer.

IOStream &	operator<< (IOStream &(*format)(IOStream &))

void	setCursor (glcd::Point position)

void	setCursor (int16_t x, int16_t y)

void	setCursorX (int16_t x)

void	setCursorY (int16_t y)

void	setFont (const uint8_t *newFont)

void	setFont (const modm::accessor::Flash< uint8_t > *font)

void	setPixel (int16_t x, int16_t y) final

void	setPixel (glcd::Point p)

void	write (char c)

Static Public Member Functions
static uint8_t	getFontHeight (const modm::accessor::Flash< uint8_t > *font)

static uint16_t	getStringWidth (const char s, const modm::accessor::Flash< uint8_t > font)

Static Public Attributes
static constexpr char	eof = -1

Protected Member Functions
void	drawCircle4 (glcd::Point center, int16_t x, int16_t y)
	helper method for drawCircle() and drawEllipse()

void	drawHorizontalLine (glcd::Point start, uint16_t length) final

void	drawVerticalLine (glcd::Point start, uint16_t length) final

void	writeBin (uint8_t value)

void	writeHex (uint8_t value)

void	writeInteger (int16_t value)

void	writeInteger (uint16_t value)

void	writeInteger (int32_t value)

void	writeInteger (uint32_t value)

template<typename T >
void	writeIntegerMode (const T v)

void	writePointer (const void *value)

Protected Attributes
Max7219< SPI, CS, COLUMNS *ROWS >	max

uint8_t	buffer [BufferHeight][BufferWidth]

glcd::Point	cursor

modm::accessor::Flash< uint8_t >	font

Writer	writer

Detailed Description

template<typename SPI, typename CS, uint8_t COLUMNS = 1, uint8_t ROWS = 1>
class modm::Max7219Matrix< SPI, CS, COLUMNS, ROWS >

Driver for arrays of LED 8x8 Matrices driven by MAX7219.

Orientation of the module is with the connector to bottom. Multiple displays are connected from right to left.

Layout of the modules for a 24 pixel x 8 pixel display.

      CCCC BBBB
+----+----+----+
|    |    |    |
|    |    |    |
+----+----+----+
|MMMM|MMMM|MMMM|
+----+----+----+
 CCCC BBBB AAAA

MMMM is the Chip AAAA is connected to the microcontroller BBBB is connected to BBBB CCCC is connected to CCCC

Template Parameters

SPI	SPI Interface CS Chip Select of MAX7219
COLUMNS	Number of modules placed horizontally, from right to left.
ROW	Number of modules placed vertically

8x8 LED modules with MAX7219 are easily and cheaply available.

Member Function Documentation

void modm::MonochromeGraphicDisplay< Width, Height, BufferWidth, BufferHeight >::clear ( )

inheritedfinalvirtual

Set whole screen to backgroundColor

Implements modm::GraphicDisplay.

void modm::GraphicDisplay::clearPixel ( glcd::Point p )

inheritedinline

Set a pixel to backgroundColor

Parameters

p point

void modm::MonochromeGraphicDisplayVertical< Width, Height >::clearPixel	(	int16_t	x,
		int16_t	y
	)

inheritedfinalvirtual

Set a pixel to backgroundColor

Parameters

x	x-position
y	y-position

Implements modm::GraphicDisplay.

void modm::GraphicDisplay::drawCircle	(	glcd::Point	center,
		uint16_t	radius
	)

inherited

Draw a filled rectangle with rounded corners

Parameters

start	Upper left corner
width	Width of rectangle
height	Height of rectangle
radius	Rounding radius

Draw a circle

Uses the midpoint circle algorithm.

Parameters

center	Center of the circle
radius	Radius of the circle

void modm::GraphicDisplay::drawEllipse	(	glcd::Point	center,
		int16_t	rx,
		int16_t	ry
	)

inherited

Draw an ellipse.

Uses a variation of the midpoint algorithm. May be improved through simplification of the used formula.

Parameters

center	Center of the ellipse
rx	Radius in x-direction
ry	Radius in y-direction

void modm::GraphicDisplay::drawImage	(	glcd::Point	start,
		modm::accessor::Flash< uint8_t >	image
	)

inherited

Draw an image.

The first byte in the image data specifies the with, the second byte the height. Afterwards the actual image data.

Parameters

start	Upper left corner
image	Image data in Flash

See also: drawImage()

void modm::MonochromeGraphicDisplayVertical< Width, Height >::drawImageRaw	(	glcd::Point	start,
		uint16_t	width,
		uint16_t	height,
		modm::accessor::Flash< uint8_t >	data
	)

inheritedfinalvirtual

Draw an image.

Parameters

start	Upper left corner
width	Image width
height	Image height
data	Image data in Flash without any size information.

Reimplemented from modm::GraphicDisplay.

void modm::GraphicDisplay::drawLine	(	glcd::Point	start,
		glcd::Point	end
	)

inheritedinline

Draw a line.

Uses the faster drawHorizontalLine() or drawVerticalLine() if possible, otherwise the line is rastered with the Bresenham line algorithm.

Parameters

start	first point
end	second point

void modm::GraphicDisplay::drawLine	(	int16_t	x1,
		int16_t	y1,
		int16_t	x2,
		int16_t	y2
	)

inherited

Draw a line

Parameters

x1	Start x-position
y1	Start y-position
x2	End x-position
y3	End y-position

void modm::GraphicDisplay::drawRectangle	(	glcd::Point	start,
		uint16_t	width,
		uint16_t	height
	)

inherited

Draw a rectangle.

Parameters

start	Upper left corner
width	Width of rectangle
height	Height of rectangle

void modm::GraphicDisplay::drawRectangle	(	int16_t	x,
		int16_t	y,
		uint16_t	width,
		uint16_t	height
	)

inheritedinline

Draw a rectangle.

Parameters

x	Upper left corner x-position
y	Upper left corner y-position
width	Width of rectangle
height	Height of rectangle

void modm::GraphicDisplay::drawRoundedRectangle	(	glcd::Point	start,
		uint16_t	width,
		uint16_t	height,
		uint16_t	radius
	)

inherited

Draw a rectangle with rounded corners

Parameters

start	Upper left corner
width	Width of rectangle
height	Height of rectangle
radius	Rounding radius

void modm::GraphicDisplay::fillCircle	(	glcd::Point	center,
		uint16_t	radius
	)

inheritedvirtual

Draw a filled circle.

Parameters

center	Center of the circle
radius	Radius of the circle

Reimplemented in modm::ili9341< Interface, Reset, Backlight, BufferSize >.

void modm::GraphicDisplay::fillRectangle	(	glcd::Point	start,
		uint16_t	width,
		uint16_t	height
	)

inherited

Draw a filled rectangle.

Parameters

start	Upper left corner
width	Width of rectangle
height	Height of rectangle

void modm::GraphicDisplay::fillRectangle	(	int16_t	x,
		int16_t	y,
		uint16_t	width,
		uint16_t	height
	)

inheritedinline

Draw a rectangle.

Parameters

x	Upper left corner x-position
y	Upper left corner y-position
width	Width of rectangle
height	Height of rectangle

IOStream & modm::IOStream::get	(	char *	s,
		size_t	n
	)

inherited

reads characters into NULL delimited c string in contrast to the standard implementation, this does not care about newline characters in the input

std::size_t modm::MonochromeGraphicDisplay< Width, Height, BufferWidth, BufferHeight >::getBufferHeight ( ) const

inheritedinlinefinalvirtual

Buffer-array size of second dimension

Implements modm::GraphicDisplay.

std::size_t modm::MonochromeGraphicDisplay< Width, Height, BufferWidth, BufferHeight >::getBufferWidth ( ) const

inheritedinlinefinalvirtual

Buffer-array size of first dimension

Implements modm::GraphicDisplay.

uint8_t modm::GraphicDisplay::getFontHeight ( ) const

inherited

Get the height of a character.

uint16_t modm::MonochromeGraphicDisplay< Width, Height, BufferWidth, BufferHeight >::getHeight ( ) const

inheritedinlinefinalvirtual

Number of pixel in vertical direction.

Implements modm::GraphicDisplay.

uint16_t modm::GraphicDisplay::getStringWidth ( const char * s ) const

inherited

Get the width of (null terminated) string.

uint16_t modm::MonochromeGraphicDisplay< Width, Height, BufferWidth, BufferHeight >::getWidth ( ) const

inheritedinlinefinalvirtual

Number of pixel in horizontal direction.

Implements modm::GraphicDisplay.

void modm::GraphicDisplay::setCursor ( glcd::Point position )

inheritedinline

Set the cursor for text drawing.

Parameters

position Cursor position

void modm::GraphicDisplay::setCursor	(	int16_t	x,
		int16_t	y
	)

inheritedinline

Set the cursor for text drawing.

Parameters

x	Cursor x-position
y	Cursor y-position

void modm::GraphicDisplay::setCursorX ( int16_t x )

inheritedinline

Set the cursor x-position for text drawing.

Parameters

x	Cursor x-position

void modm::GraphicDisplay::setCursorY ( int16_t y )

inheritedinline

Set the cursor y-position for text drawing.

Parameters

y	Cursor y-position

void modm::GraphicDisplay::setFont ( const uint8_t * newFont )

inheritedinline

Set a new font.

Default font is modm::font::FixedWidth5x8.

Parameters

newFont Active font

See also: modm::font

void modm::GraphicDisplay::setPixel ( glcd::Point p )

inheritedinline

Set a pixel to foregroundColor

Parameters

p point

void modm::MonochromeGraphicDisplayVertical< Width, Height >::setPixel	(	int16_t	x,
		int16_t	y
	)

inheritedfinalvirtual

Set a pixel to foregroundColor

Parameters

x	x-position
y	y-position

Implements modm::GraphicDisplay.

void modm::GraphicDisplay::write ( char c )

inherited

Write a single character.

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

max7219_matrix.hpp

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

template<typename SPI, typename CS, uint8_t COLUMNS = 1, uint8_t ROWS = 1> class modm::Max7219Matrix< SPI, CS, COLUMNS, ROWS >

Member Function Documentation

template<typename SPI, typename CS, uint8_t COLUMNS = 1, uint8_t ROWS = 1>
class modm::Max7219Matrix< SPI, CS, COLUMNS, ROWS >