auxdisplay.h File Reference

Public API for auxiliary (textual/non-graphical) display drivers. More...

#include <stdint.h>
#include <stddef.h>
#include <zephyr/kernel.h>
#include <zephyr/device.h>
#include <syscalls/auxdisplay.h>

Go to the source code of this file.

Data Structures
struct	auxdisplay_light
	Light levels for brightness and/or backlight. If not supported by a display/driver, both minimum and maximum will be AUXDISPLAY_LIGHT_NOT_SUPPORTED. More...
struct	auxdisplay_capabilities
	Structure holding display capabilities. More...
struct	auxdisplay_custom_data
	Structure for a custom command. This may be extended by specific drivers. More...
struct	auxdisplay_character
	Structure for a custom character. More...

Macros
#define	AUXDISPLAY_LIGHT_NOT_SUPPORTED   0
	Used for minimum and maximum brightness/backlight values if not supported. More...

Typedefs
typedef uint32_t	auxdisplay_mode_t
	Used to describe the mode of an auxiliary (text) display. More...

Enumerations
enum	auxdisplay_position { AUXDISPLAY_POSITION_ABSOLUTE = 0 , AUXDISPLAY_POSITION_RELATIVE , AUXDISPLAY_POSITION_RELATIVE_DIRECTION , AUXDISPLAY_POSITION_COUNT }
	Used for moving the cursor or display position. More...
enum	auxdisplay_direction { AUXDISPLAY_DIRECTION_RIGHT = 0 , AUXDISPLAY_DIRECTION_LEFT , AUXDISPLAY_DIRECTION_COUNT }
	Used for setting character append position. More...

Functions
int	auxdisplay_display_on (const struct device *dev)
	Turn display on. More...
int	auxdisplay_display_off (const struct device *dev)
	Turn display off. More...
int	auxdisplay_cursor_set_enabled (const struct device *dev, bool enabled)
	Set cursor enabled status on an auxiliary display. More...
int	auxdisplay_position_blinking_set_enabled (const struct device *dev, bool enabled)
	Set cursor blinking status on an auxiliary display. More...
int	auxdisplay_cursor_shift_set (const struct device *dev, uint8_t direction, bool display_shift)
	Set cursor shift after character write and display shift. More...
int	auxdisplay_cursor_position_set (const struct device *dev, enum auxdisplay_position type, int16_t x, int16_t y)
	Set cursor (and write position) on an auxiliary display. More...
int	auxdisplay_cursor_position_get (const struct device *dev, int16_t *x, int16_t *y)
	Get current cursor on an auxiliary display. More...
int	auxdisplay_display_position_set (const struct device *dev, enum auxdisplay_position type, int16_t x, int16_t y)
	Set display position on an auxiliary display. More...
int	auxdisplay_display_position_get (const struct device *dev, int16_t *x, int16_t *y)
	Get current display position on an auxiliary display. More...
int	auxdisplay_capabilities_get (const struct device *dev, struct auxdisplay_capabilities *capabilities)
	Fetch capabilities (and details) of auxiliary display. More...
int	auxdisplay_clear (const struct device *dev)
	Clear display of auxiliary display and return to home position (note that this does not reset the display configuration, e.g. custom characters and display mode will persist). More...
int	auxdisplay_brightness_get (const struct device *dev, uint8_t *brightness)
	Get the current brightness level of an auxiliary display. More...
int	auxdisplay_brightness_set (const struct device *dev, uint8_t brightness)
	Update the brightness level of an auxiliary display. More...
int	auxdisplay_backlight_get (const struct device *dev, uint8_t *backlight)
	Get the backlight level details of an auxiliary display. More...
int	auxdisplay_backlight_set (const struct device *dev, uint8_t backlight)
	Update the backlight level of an auxiliary display. More...
int	auxdisplay_is_busy (const struct device *dev)
	Check if an auxiliary display driver is busy. More...
int	auxdisplay_custom_character_set (const struct device *dev, struct auxdisplay_character *character)
	Sets a custom character in the display, the custom character struct must contain the pixel data for the custom character to add and valid custom character index, if successful then the character_code variable in the struct will be set to the character code that can be used with the auxdisplay_write() function to show it. More...
int	auxdisplay_write (const struct device *dev, const uint8_t *data, uint16_t len)
	Write data to auxiliary display screen at current position. More...
int	auxdisplay_custom_command (const struct device *dev, struct auxdisplay_custom_data *data)
	Send a custom command to the display (if supported by driver) More...

Detailed Description

Public API for auxiliary (textual/non-graphical) display drivers.