display using ILI93XX display controller

This is hardware specific configuration that configures the graphical service for use with the ILI93XX display controller display.

All the drawing functionality in this configuration is provided by the gfx_generic driver. This configuration includes information about the panel size, data type used for coordinates and color and functionality to convert RGB color to the color format native to the display.

Macros
#define	GFX_COLOR(r, g, b)   ILI93XX_COLOR(r, g, b)
#define	gfx_color(r, g, b)   gfx_ili93xx_color(r, g, b)
	ILI93XX display driver specific function, see gfx_ili93xx_color. More...
#define	GFX_COLOR_INVALID   GFX_COLOR(1, 2, 3)
	It is not possible to define a color that is outside the color spectrum for the ILI93XX driver, hence use a dark color as invalid color. More...
#define	GFX_COLOR_TRANSPARENT   GFX_COLOR(254, 0, 0)
#define	gfx_copy_pixels_from_screen(pixels, count)   ili93xx_copy_pixels_from_screen(pixels, count)
	ILI93XX display driver specific function, see ili93xx_copy_pixels_from_screen. More...
#define	gfx_copy_pixels_to_screen(pixels, count)   ili93xx_copy_pixels_to_screen(pixels, count)
	ILI93XX display driver specific function, see ili93xx_copy_pixels_to_screen. More...
#define	gfx_copy_progmem_pixels_to_screen(pixels, count)   ili93xx_copy_raw_pixel_24bits_to_screen(pixels, count)
	ILI93XX display driver specific function available for ATmega and ATXmega devices, see ili93xx_copy_progmem_pixels_to_screen. More...
#define	gfx_draw_bitmap(bmp, x, y)   gfx_generic_draw_bitmap(bmp, x, y)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_draw_bitmap_tiled(bmp, x1, y1, x2, y2, tile_origin_x, tile_origin_y)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_draw_circle(x, y, radius, color, octant_mask)   gfx_generic_draw_circle(x, y, radius, color, octant_mask)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_draw_filled_circle(x, y, radius, color, quadrant_mask)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_draw_filled_rect(x, y, width, height, color)   gfx_generic_draw_filled_rect(x, y, width, height, color)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_draw_horizontal_line(x, y, length, color)   gfx_generic_draw_horizontal_line(x, y, length, color)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_draw_line(x1, y1, x2, y2, color)   gfx_generic_draw_line(x1, y1, x2, y2, color)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_draw_line_pixel(x, y, color)
	ILI93XX display driver specific function, see gfx_ili93xx_draw_line_pixel. More...
#define	gfx_draw_pixel(x, y, color)   gfx_ili93xx_draw_pixel(x, y, color)
	ILI93XX display driver specific function, see gfx_ili93xx_draw_pixel. More...
#define	gfx_draw_rect(x, y, width, height, color)   gfx_generic_draw_rect(x, y, width, height, color)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_draw_vertical_line(x, y, length, color)   gfx_generic_draw_vertical_line(x, y, length, color)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_duplicate_pixel(color, count)   ili93xx_duplicate_pixel(color, count)
	ILI93XX display driver specific function, see ili93xx_duplicate_pixel. More...
#define	gfx_get_pixel(x, y)   gfx_ili93xx_get_pixel(x, y)
	ILI93XX display driver specific function, see gfx_ili93xx_get_pixel. More...
#define	gfx_get_pixmap(pixmap, map_width, map_x, map_y, x, y, width, height)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_init()   gfx_ili93xx_init()
	ILI93XX display driver specific function, see gfx_ili93xx_init. More...
#define	gfx_put_bitmap(bmp, map_x, map_y, x, y, width, height)   gfx_generic_put_bitmap(bmp, map_x, map_y, x, y, width, height)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_put_pixmap(pixmap, map_width, map_x, map_y, x, y, width, height)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_set_bottom_right_limit(x, y)   ili93xx_set_bottom_right_limit(x, y)
	ILI93XX display driver specific function, see ili93xx_set_bottom_right_limit. More...
#define	gfx_set_ext_handler(ext_draw_handler)   gfx_generic_set_ext_handler(ext_draw_handler)
	ILI93XX display driver uses generic gfx implementation for this function. More...
#define	gfx_set_limits(x1, y1, x2, y2)   ili93xx_set_limits(x1, y1, x2, y2)
	ILI93XX display driver specific function, see ili93xx_set_limits. More...
#define	gfx_set_orientation(flags)   gfx_ili93xx_set_orientation(flags)
	ILI93XX display driver specific function, see gfx_ili93xx_set_orientation. More...
#define	gfx_set_top_left_limit(x, y)   ili93xx_set_top_left_limit(x, y)
	ILI93XX display driver specific function, see ili93xx_set_top_left_limit. More...
#define	gfx_sync()   gfx_generic_sync()
	ILI93XX display driver uses generic gfx implementation for this function. More...

Functions
gfx_color_t	gfx_ili93xx_color (uint8_t r, uint8_t g, uint8_t b)
	Generate native color value from R/G/B values. More...
void	gfx_ili93xx_draw_line_pixel (gfx_coord_t x, gfx_coord_t y, gfx_color_t color)
	Draw a single pixel on the screen. More...
void	gfx_ili93xx_draw_pixel (gfx_coord_t x, gfx_coord_t y, gfx_color_t color)
	Draw a single pixel on the screen. More...
gfx_color_t	gfx_ili93xx_get_pixel (gfx_coord_t x, gfx_coord_t y)
	Get the color of a pixel on the display. More...
void	gfx_ili93xx_init (void)
	Initialize the ili93xx display controller. More...
void	gfx_ili93xx_set_orientation (uint8_t flags)
	Set display orientation. More...
#define	ILI93XX_LCD_CS   1
gfx_coord_t	gfx_height
gfx_coord_t	gfx_width
gfx_coord_t	gfx_min_x
gfx_coord_t	gfx_min_y
gfx_coord_t	gfx_max_x
gfx_coord_t	gfx_max_y

#define GFX_COLOR	(		r,
			g,
			b
	)		ILI93XX_COLOR(r, g, b)

#define gfx_color	(		r,
			g,
			b
	)		gfx_ili93xx_color(r, g, b)

ILI93XX display driver specific function, see gfx_ili93xx_color.

#define GFX_COLOR_INVALID   GFX_COLOR(1, 2, 3)

It is not possible to define a color that is outside the color spectrum for the ILI93XX driver, hence use a dark color as invalid color.

#define GFX_COLOR_TRANSPARENT   GFX_COLOR(254, 0, 0)

#define gfx_copy_pixels_from_screen	(		pixels,
			count
	)		ili93xx_copy_pixels_from_screen(pixels, count)

ILI93XX display driver specific function, see ili93xx_copy_pixels_from_screen.

#define gfx_copy_pixels_to_screen	(		pixels,
			count
	)		ili93xx_copy_pixels_to_screen(pixels, count)

ILI93XX display driver specific function, see ili93xx_copy_pixels_to_screen.

#define gfx_copy_progmem_pixels_to_screen	(		pixels,
			count
	)		ili93xx_copy_raw_pixel_24bits_to_screen(pixels, count)

ILI93XX display driver specific function available for ATmega and ATXmega devices, see ili93xx_copy_progmem_pixels_to_screen.

#define gfx_draw_bitmap	(		bmp,
			x,
			y
	)		gfx_generic_draw_bitmap(bmp, x, y)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_bitmap

#define gfx_draw_bitmap_tiled	(		bmp,
			x1,
			y1,
			x2,
			y2,
			tile_origin_x,
			tile_origin_y
	)

Value:

gfx_generic_draw_bitmap_tiled(bmp, x1, y1, x2, y2,\
        tile_origin_x, tile_origin_y)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_bitmap_tiled

#define gfx_draw_circle	(		x,
			y,
			radius,
			color,
			octant_mask
	)		gfx_generic_draw_circle(x, y, radius, color, octant_mask)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_circle

#define gfx_draw_filled_circle	(		x,
			y,
			radius,
			color,
			quadrant_mask
	)

Value:

gfx_generic_draw_filled_circle(x, y, radius, color,\
        quadrant_mask)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_filled_circle

#define gfx_draw_filled_rect	(		x,
			y,
			width,
			height,
			color
	)		gfx_generic_draw_filled_rect(x, y, width, height, color)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_filled_rect

#define gfx_draw_horizontal_line	(		x,
			y,
			length,
			color
	)		gfx_generic_draw_horizontal_line(x, y, length, color)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_horizontal_line

#define gfx_draw_line	(		x1,
			y1,
			x2,
			y2,
			color
	)		gfx_generic_draw_line(x1, y1, x2, y2, color)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_line

#define gfx_draw_line_pixel	(		x,
			y,
			color
	)

Value:

gfx_ili93xx_draw_line_pixel(x, y,\
        color)

ILI93XX display driver specific function, see gfx_ili93xx_draw_line_pixel.

#define gfx_draw_pixel	(		x,
			y,
			color
	)		gfx_ili93xx_draw_pixel(x, y, color)

ILI93XX display driver specific function, see gfx_ili93xx_draw_pixel.

#define gfx_draw_rect	(		x,
			y,
			width,
			height,
			color
	)		gfx_generic_draw_rect(x, y, width, height, color)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_rect

#define gfx_draw_vertical_line	(		x,
			y,
			length,
			color
	)		gfx_generic_draw_vertical_line(x, y, length, color)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_draw_vertical_line

#define gfx_duplicate_pixel	(		color,
			count
	)		ili93xx_duplicate_pixel(color, count)

ILI93XX display driver specific function, see ili93xx_duplicate_pixel.

#define gfx_get_pixel	(		x,
			y
	)		gfx_ili93xx_get_pixel(x, y)

ILI93XX display driver specific function, see gfx_ili93xx_get_pixel.

#define gfx_get_pixmap	(		pixmap,
			map_width,
			map_x,
			map_y,
			x,
			y,
			width,
			height
	)

Value:

gfx_generic_get_pixmap(pixmap, map_width, map_x, map_y, x, y,\
        width, height)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_get_pixmap

#define gfx_init

(

)

gfx_ili93xx_init()

ILI93XX display driver specific function, see gfx_ili93xx_init.

#define gfx_put_bitmap	(		bmp,
			map_x,
			map_y,
			x,
			y,
			width,
			height
	)		gfx_generic_put_bitmap(bmp, map_x, map_y, x, y, width, height)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_put_bitmap

#define gfx_put_pixmap	(		pixmap,
			map_width,
			map_x,
			map_y,
			x,
			y,
			width,
			height
	)

Value:

gfx_generic_put_pixmap(pixmap, map_width, map_x, map_y, x, y,\
        width, height)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_put_pixmap

#define gfx_set_bottom_right_limit	(		x,
			y
	)		ili93xx_set_bottom_right_limit(x, y)

ILI93XX display driver specific function, see ili93xx_set_bottom_right_limit.

#define gfx_set_ext_handler

(

ext_draw_handler

)

gfx_generic_set_ext_handler(ext_draw_handler)

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_set_ext_handler

#define gfx_set_limits	(		x1,
			y1,
			x2,
			y2
	)		ili93xx_set_limits(x1, y1, x2, y2)

ILI93XX display driver specific function, see ili93xx_set_limits.

#define gfx_set_orientation

(

flags

)

gfx_ili93xx_set_orientation(flags)

ILI93XX display driver specific function, see gfx_ili93xx_set_orientation.

#define gfx_set_top_left_limit	(		x,
			y
	)		ili93xx_set_top_left_limit(x, y)

ILI93XX display driver specific function, see ili93xx_set_top_left_limit.

#define gfx_sync

(

)

gfx_generic_sync()

ILI93XX display driver uses generic gfx implementation for this function.

See gfx_generic_sync

#define ILI93XX_LCD_CS   1

Referenced by gfx_ili93xx_init().

gfx_color_t gfx_ili93xx_color	(	uint8_t	r,
		uint8_t	g,
		uint8_t	b
	)

Generate native color value from R/G/B values.

Converts 8-bit R/G/B values to a color value native to the display.

The macro GFX_COLOR does the same, only allows the preprocessor to handle the calculations.

Parameters

r	8-bit red value.
g	8-bit green value.
b	8-bit blue value.

Returns

Color value in display native format.

References GFX_COLOR.

void gfx_ili93xx_draw_line_pixel	(	gfx_coord_t	x,
		gfx_coord_t	y,
		gfx_color_t	color
	)

Draw a single pixel on the screen.

This function draws a single pixel on screen only setting top limit which makes it more suitable for line drawing. If outside the clipping region, nothing is drawn.

Parameters

x	X coordinate of the pixel to be drawn.
y	Y coordinate of the pixel to be drawn.
color	Color value of the pixel in display native format.

References gfx_max_x, gfx_max_y, gfx_min_x, gfx_min_y, gfx_set_top_left_limit, and ili93xx_write_gram().

void gfx_ili93xx_draw_pixel	(	gfx_coord_t	x,
		gfx_coord_t	y,
		gfx_color_t	color
	)

Draw a single pixel on the screen.

Draw a single pixel on screen setting top and bottom limits. If outside the clipping region, nothing is drawn.

Parameters

x	X coordinate of the pixel to be drawn.
y	Y coordinate of the pixel to be drawn.
color	Color value of the pixel in display native format.

References gfx_max_x, gfx_max_y, gfx_min_x, gfx_min_y, gfx_set_limits, and ili93xx_write_gram().

gfx_color_t gfx_ili93xx_get_pixel	(	gfx_coord_t	x,
		gfx_coord_t	y
	)

Get the color of a pixel on the display.

Parameters

x	X coordinate of the pixel to be sampled.
y	Y coordinate of the pixel to be sampled.

Returns

Color value of the pixel at (x, y) in display native format, or GFX_COLOR_INVALID if outside the clipping region.

References GFX_COLOR_INVALID, gfx_max_x, gfx_max_y, gfx_min_x, gfx_min_y, gfx_set_limits, and ili93xx_read_gram().

void gfx_ili93xx_init

(

void

)

Initialize the ili93xx display controller.

This function will be called when calling gfx_init. It will draw a black background to the display and enable the display backlight if available.

References ili93xx_opt_t::background_color, COLOR_BLACK, COLOR_WHITE, ili93xx_opt_t::foreground_color, GFX_COLOR, gfx_draw_filled_rect, gfx_height, gfx_width, ili93xx_display_on(), ili93xx_init(), ILI93XX_LCD_CS, ILI93XX_LCD_HEIGHT, ILI93XX_LCD_WIDTH, ili93xx_opt_t::ul_height, and ili93xx_opt_t::ul_width.

void gfx_ili93xx_set_orientation

(

uint8_t

flags

)

Set display orientation.

Set the display orientation

Parameters

flags

References gfx_height, gfx_width, ILI93XX_LCD_HEIGHT, ILI93XX_LCD_WIDTH, ili93xx_set_orientation(), ILI93XX_SWITCH_XY_HEIGHT, and ILI93XX_SWITCH_XY_WIDTH.

gfx_coord_t gfx_height

gfx_coord_t gfx_max_x

gfx_coord_t gfx_max_y

gfx_coord_t gfx_min_x

gfx_coord_t gfx_min_y

gfx_coord_t gfx_width