lcd.h

Go to the documentation of this file.

#ifndef _LCD_H
#define _LCD_H
 
#include <inttypes.h>
#include <stdio.h>
#include "Timer.h"
 
 
 
extern FILE _lcdout;
 
#define lcdout (&_lcdout)
 
extern void lcd_init(void);
 
extern void lcd_refresh(void);
 
extern void lcd_refresh_noclear(void);
 
extern void lcd_clear(void);
 
extern void lcd_home(void);
 
/*extern void lcd_no_display(void);
extern void lcd_display(void);
extern void lcd_no_blink(void);
extern void lcd_blink(void);
extern void lcd_no_cursor(void);
extern void lcd_cursor(void);
extern void lcd_scrollDisplayLeft(void);
extern void lcd_scrollDisplayRight(void);
extern void lcd_leftToRight(void);
extern void lcd_rightToLeft(void);
extern void lcd_autoscroll(void);
extern void lcd_no_autoscroll(void);*/
 
extern void lcd_set_cursor(uint8_t col, uint8_t row);
 
void lcd_set_cursor_column(uint8_t col);
 
extern void lcd_createChar_P(uint8_t, const uint8_t*);
 
 
// char c is non-standard, however it saves 1B on stack
extern int lcd_putc(char c);
extern int lcd_putc_at(uint8_t c, uint8_t r, char ch);
 
extern int lcd_puts_P(const char* str);
extern int lcd_puts_at_P(uint8_t c, uint8_t r, const char* str);
extern int lcd_printf_P(const char* format, ...);
extern void lcd_space(uint8_t n);
 
extern void lcd_printNumber(unsigned long n, uint8_t base);
 
extern void lcd_print(const char*);
extern uint8_t lcd_print_pad(const char* s, uint8_t len);
 
uint8_t lcd_print_pad_P(const char* s, uint8_t len);
extern void lcd_print(char, int = 0);
extern void lcd_print(unsigned char, int = 0);
extern void lcd_print(int, int = 10);
extern void lcd_print(unsigned int, int = 10);
extern void lcd_print(long, int = 10);
extern void lcd_print(unsigned long, int = 10);
 
#define ESC_2J     "\x1b[2J"
#define ESC_25h    "\x1b[?25h"
#define ESC_25l    "\x1b[?25l"
#define ESC_H(c,r) "\x1b["#r";"#c"H"
 
 
 
#define LCD_UPDATE_INTERVAL    100
#define LCD_TIMEOUT_TO_STATUS 30000ul 
#define LCD_TIMEOUT_TO_STATUS_BABYSTEP_Z 90000ul 
 
 
 
typedef void (*lcd_longpress_func_t)(void);
 
typedef void (*lcd_charsetup_func_t)(void);
 
typedef void (*lcd_lcdupdate_func_t)(void);
 
//Set to none-zero when the LCD needs to draw, decreased after every draw. Set to 2 in LCD routines so the LCD gets at least 1 full redraw (first redraw is partial)
extern uint8_t lcd_draw_update;
 
extern int16_t lcd_encoder;
 
extern uint8_t lcd_click_trigger;
 
extern uint8_t lcd_update_enabled;
 
extern LongTimer lcd_timeoutToStatus;
 
extern uint32_t lcd_next_update_millis;
 
extern lcd_longpress_func_t lcd_longpress_func;
extern bool lcd_longpress_trigger;
 
extern lcd_lcdupdate_func_t lcd_lcdupdate_func;
 
 
 
extern uint8_t lcd_clicked(void);
 
extern void lcd_beeper_quick_feedback(void);
 
//Cause an LCD refresh, and give the user visual or audible feedback that something has happened
extern void lcd_quick_feedback(void);
 
extern void lcd_knob_update();
 
extern void lcd_update(uint8_t lcdDrawUpdateOverride);
 
extern void lcd_update_enable(uint8_t enabled);
 
extern void lcd_buttons_update(void);
 
class LcdUpdateDisabler
{
public:
    LcdUpdateDisabler(): m_updateEnabled(lcd_update_enabled)
    {
        lcd_update_enable(false);
    }
    ~LcdUpdateDisabler()
    {
        lcd_update_enable(m_updateEnabled);
    }
 
private:
    bool m_updateEnabled;
};
 
 
#define LCD_CLICKED (lcd_click_trigger)
 
 
//Custom characters defined in the first 8 characters of the LCD
#define LCD_STR_ARROW_RIGHT  "\x7E" //from the default character set
#define LCD_STR_ARROW_LEFT   "\x7F" //from the default character set
#define LCD_STR_BEDTEMP      "\x80"
#define LCD_STR_DEGREE       "\x81"
#define LCD_STR_THERMOMETER  "\x82"
#define LCD_STR_UPLEVEL      "\x83"
#define LCD_STR_REFRESH      "\x84"
#define LCD_STR_FOLDER       "\x85"
#define LCD_STR_FEEDRATE     "\x86"
#define LCD_STR_CLOCK        "\x87"
#define LCD_STR_ARROW_2_DOWN "\x88"
#define LCD_STR_CONFIRM      "\x89"
#define LCD_STR_SOLID_BLOCK  "\xFF"  //from the default character set
 
extern void lcd_frame_start();
 
inline void lcd_consume_click()
{
    lcd_click_trigger = 0;
    lcd_longpress_trigger = 0;
}
 
 
#endif //_LCD_H