Panel Management and Display Interface

Compounds
struct	panel
struct	panel_line
Typedefs
typedef unsigned short	key_t
typedef void(*	panel_enter_t )(struct panel *p)
typedef void(*	panel_exit_t )(struct panel *p)
typedef unsigned long(*	panel_refresh_t )(struct panel *p)
typedef void(*	panel_input_t )(struct panel *p, enum key_mode mode, button_t button)
Enumerations
enum	panel_justify { JUSTIFY_LEFT, JUSTIFY_RIGHT, JUSTIFY_CENTER }
Functions
void	panel_putchar (struct panel *p, lcd_line_t line, lcd_col_t col, unsigned char ch)
void	panel_putstring (struct panel *p, lcd_line_t line, lcd_col_t col, const char *str)
void	panel_putitem (struct panel *p, lcd_line_t line, lcd_col_t col, enum panel_justify mode, int field_len, const char *item)
void	panel_clear_line (struct panel *p, lcd_line_t line, lcd_col_t col)
unsigned char	panel_getchar_at (struct panel *p, lcd_line_t line, lcd_col_t col)
void	panel_refresh (void)
void	panel_touch (void)
int	panel_need_refresh (void)
int	panel_is_visible (struct panel *p)
void	panel_push (struct panel *p)
void	panel_pop (void)
void	panel_create (struct panel *p)
void	panel_initialize (void)
void	panel_setcursor (struct panel *p, lcd_line_t line, lcd_col_t col)
void	panel_show_cursor (struct panel *p, int mode)
void	panel_loop (void) __attribute__((noreturn))

Detailed Description

The panel module controls the LCD display and the keyboard. It reacts to keyboard events and manages all LCD display update.

A panel entity displays its data on the LCD. It does so using the panel_putXXX operations. It provides a keyboard input callback to react to keyboard events.

The panel module allows to push or pop panels.

Typedef Documentation

typedef void(* panel_enter_t)(struct panel *p)

Panel enter callback. Callback function invoked when the panel object is activated and has the LCD focus. This is called by panel_push and panel_pop on the panel which is activated. Parameters: p  Pointer to the panel object. Definition at line 68 of file panel.h.

typedef void(* panel_exit_t)(struct panel *p)

Panel leave callback. Callback function invoked when the panel object is deactivated and looses the LCD focus. This is called by panel_push and panel_pop on the panel which is deactivated. When a new panel is installed, the current active panel is first deactivated. Parameters: p  Pointer to the panel object. Definition at line 79 of file panel.h.

typedef void(* panel_input_t)(struct panel *p, enum key_mode mode, button_t button)

Panel input handler. Callback to handle the buttons for the panel. Parameters: p  Pointer to the panel object. mode  Whether the key is pressed or released button  Button which is pressed or released Definition at line 103 of file panel.h.

typedef unsigned long(* panel_refresh_t)(struct panel *p)

Panel refresh callback. Refresh the panel. This function is called by the panel main loop to automatically update the panel content. The function must update the panel using panel_putstring to show a newer or an up to date content. It must return the delay in milliseconds to wait before the next refresh. Parameters: p  Pointer to the panel object. Returns: The delay in milliseconds to wait before the next refresh Definition at line 92 of file panel.h.

Enumeration Type Documentation

enum panel_justify

Justification mode Definition at line 126 of file panel.h.

Function Documentation

void panel_clear_line (  struct panel *    p, lcd_line_t    line, lcd_col_t    col )

Clear the rest of the line. Clear the rest of the line line starting at col by writing spaces in it. Parameters: p  Pointer to the panel object line  Line to clear col  Column to start See also: panel_putchar, panel_refresh

void panel_create (  struct panel *    p )

Create the panel object. Parameters: p  Pointer to the panel object.

unsigned char panel_getchar_at (  struct panel *    p, lcd_line_t    line, lcd_col_t    col )

Return the character displayed on the panel. Parameters: p  Null or pointer to the panel object col  Column number line  Line number Returns: The character at the given position See also: panel_putchar

void panel_initialize (  void    )

Initialize the panel module. See also: panel_create

int panel_is_visible (  struct panel *    p )

Panel is visible. Return whether the panel is visible. Parameters: p  Pointer to the panel object Returns: true if the panel is visible See also: panel_push

int panel_need_refresh (  void    )

Returns true if the panel must be refreshed. Returns true if the LCD display is not synchronized with the active panel and a call to panel_refresh is necessary. Returns: true if the panel must be refreshed. See also: panel_refresh, panel_touch

void panel_pop (  void    )

Pop the active panel moving to the previous one. Pop the active panel and redraw the previous one. The to_exit handler of the active panel is called before deactivating it. The to_enter handler of the previous panel is called to activate it. See also: panel_push, panel_refresh

void panel_push (  struct panel *    p )

Push the panel. Push the panel p making it the active panel. The previous active panel is kept for later re-activation with panel_pop. Parameters: p  Pointer to the panel object See also: panel_pop

void panel_putchar (  struct panel *    p, lcd_line_t    line, lcd_col_t    col, unsigned char    ch )

Write the character on the panel. Write the character ch at position col, line on the panel. The character is not written on the LCD device but in an internal panel memory. The panel_refresh operation synchronizes the panel memory and the LCD display. Parameters: p  Pointer to the panel object col  Column where to write line  Line where to write ch  Character to write See also: panel_putstring, panel_refresh

void panel_putitem (  struct panel *    p, lcd_line_t    line, lcd_col_t    col, enum panel_justify    mode, int    field_len, const char *    item )

Write a justified string on the panel. Justify the string item according to the justification mode mode and the item length field_len. The justified string is then written on the panel p at position col, line. Parameters: p  Pointer to the panel object col  Column where to write line  Line where to write mode  Justification mode to use field_len  Length of the final item str  String to write See also: panel_putchar, panel_refresh

void panel_putstring (  struct panel *    p, lcd_line_t    line, lcd_col_t    col, const char *    str )

Write the string on the panel. Write the string str at position col, line on the panel. The string is not written on the LCD device but in an internal panel memory. The panel_refresh operation synchronizes the panel memory and the LCD display. Parameters: p  Pointer to the panel object col  Column where to write line  Line where to write str  String to write See also: panel_putchar, panel_refresh

void panel_refresh (  void    )

Refresh the panel. Refresh the LCD display to match the content with the active panel. This function optimizes by only updating the LCD part which has changed. This is the only function which calls the LCD print operations. See also: panel_putchar, panel_putstring, panel_redraw

void panel_touch (  void    )

Touch the panel. Forget any optimization about the LCD panel display. See also: panel_refresh