PaperdinkUIDateClass Class Reference

#include <date_time.h>

Inheritance diagram for PaperdinkUIDateClass:

Public Member Functions
int8_t	fetch_data (const char *time_zone, uint8_t week_start_offset=6)
void	display_day_date_style1_center (GxEPD2_GFX &display, uint16_t x, uint16_t y, uint16_t w)
void	display_day_date_style2_center (GxEPD2_GFX &display, uint16_t x, uint16_t y, uint16_t w)
void	display_last_updated_time_style1_center (GxEPD2_GFX &display, uint16_t x, uint16_t y, uint16_t w)
void	display_calendar (GxEPD2_GFX &display, uint16_t x, uint16_t y)

Public Attributes
char	wday [4]
char	month [4]
uint8_t	month_days
uint8_t	month_num
uint8_t	mday
uint8_t	mil_hour
uint8_t	hour
uint8_t	min
uint8_t	sec
uint8_t	day_offset
int	year
uint8_t	week_start_offset
Public Attributes inherited from PaperdinkUIBaseClass
const GFXfont *	font = &PAPERDINK_FONT_SML
const GFXfont *	font_bold = &PAPERDINK_FONT_SML_BOLD
int	primary_color = GxEPD_BLACK
int	secondary_color = GxEPD_WHITE
int	tertiary_color = GxEPD_BLACK

Detailed Description

Definition at line 9 of file date_time.h.

Member Function Documentation

display_calendar()

void PaperdinkUIDateClass::display_calendar	(	GxEPD2_GFX &	display,
		uint16_t	x,
		uint16_t	y )

Definition at line 120 of file date_time.cpp.

{
    int16_t xt, yt;
    uint16_t wt, ht;
 
    /* Space between text depends on the font
     * hence font is hardcoded.
     */
    display.setFont(&Gobold_Thin9pt7b);
    display.setTextSize(1);
    display.setTextColor(primary_color);
 
#define CAL_STRING "Mon   Tue   Wed   Thu   Fri   Sat   Sun"
 
    display.setCursor(x, y);
    display.print(CAL_STRING);
    display.getTextBounds(CAL_STRING, 0, 0, &xt, &yt, &wt, &ht);
    uint8_t num_offset, print_valid = 0;
    uint8_t day = 1;
 
    for (uint8_t j = 0; j <= 5; j++) {
        for (uint8_t i = 1; i <= 7 && day <= month_days; i++) {
            // you can hack around with this value to align your text properly based on what font, font size etc you are using
            num_offset = 21;                // 21 is what works for me for the first 2 columns
            if (i >= 3 && i <= 7)
                num_offset = 17;        // then I need to reduce to 17
            if (j == 0 && ((i - 1) == Paperdink_Date.day_offset || Paperdink_Date.day_offset == 0))
                // start from the offset in the month, ie which day does 1st of the month lie on
                print_valid = 1;
            if (print_valid) {
                display.setCursor(x + (i * (wt / 7)) - num_offset, y + ((j + 1) * ht) + ((j + 1) * 7));
                if (day == Paperdink_Date.mday) {
                    char str[3];
                    sprintf(str, "%d", day);
                    int16_t x2, y2;
                    uint16_t w2, h2;
                    display.getTextBounds(str, x + (i * (wt / 7)) - num_offset, y + ((j + 1) * ht) + ((j + 1) * 7), &x2, &y2, &w2, &h2);
                    display.fillRect(x2 - 4, y2 - 4, w2 + 8, h2 + 8, primary_color);
                    display.setTextColor(secondary_color);
                } else {
                    display.setTextColor(primary_color);
                }
                // once the offset is reached, start incrementing
                display.println(day);
                day += 1;
            }
        }
    }
}

display_day_date_style1_center()

void PaperdinkUIDateClass::display_day_date_style1_center	(	GxEPD2_GFX &	display,
		uint16_t	x,
		uint16_t	y,
		uint16_t	w )

Definition at line 58 of file date_time.cpp.

{
    int16_t xt, yt;
    uint16_t wt, ht, prev_height = 0, prev_width = 0;
    char date_str[7];
 
    display.setFont(font);
    display.setTextColor(primary_color);
    display.setTextSize(1);
 
    // Display day
    display.getTextBounds(wday, 0, 0, &xt, &yt, &wt, &ht);
    display.setCursor(x + ((w - wt) / 2), y + ht);
    display.println(wday);
    prev_height += y + ht;
 
    // Display date
    sprintf(date_str, "%d %s", mday, month);
    display.getTextBounds(date_str, 0, 0, &xt, &yt, &wt, &ht);
    display.setCursor(x + ((w - wt) / 2), prev_height + ht + 20);
    display.println(date_str);
}

display_day_date_style2_center()

void PaperdinkUIDateClass::display_day_date_style2_center	(	GxEPD2_GFX &	display,
		uint16_t	x,
		uint16_t	y,
		uint16_t	w )

Definition at line 81 of file date_time.cpp.

{
    int16_t xt, yt;
    uint16_t wt, ht, prev_height = 0, prev_width = 0;
    char mday_str[3];
 
    display.setFont(font);
    display.setTextColor(secondary_color);
    display.setTextSize(1);
 
    // Display day
    sprintf(mday_str, "%02d", Paperdink_Date.mday);
    display.getTextBounds(mday_str, 0, 0, &xt, &yt, &wt, &ht);
    display.setCursor(x + ((w - wt) / 2), y + ht);
    display.println(mday_str);
    prev_height += y + ht;
 
    // Display month
    display.getTextBounds(Paperdink_Date.month, 0, 0, &xt, &yt, &wt, &ht);
    display.setCursor(x + ((w - wt) / 2), prev_height + ht + 5);
    display.println(Paperdink_Date.month);
}

display_last_updated_time_style1_center()

void PaperdinkUIDateClass::display_last_updated_time_style1_center	(	GxEPD2_GFX &	display,
		uint16_t	x,
		uint16_t	y,
		uint16_t	w )

Definition at line 104 of file date_time.cpp.

{
    int16_t xt, yt;
    uint16_t wt, ht, prev_height = 0, prev_width = 0;
    char time_str[] = "Updated at: XX:XX";
 
    display.setFont(font);
    display.setTextColor(primary_color);
    display.setTextSize(1);
 
    sprintf(&time_str[12], "%02d:%02d", mil_hour, min);
    display.getTextBounds(time_str, 0, 0, &xt, &yt, &wt, &ht);
    display.setCursor(x + ((w - wt) / 2), y + ht);
    display.print(time_str);
}

fetch_data()

int8_t PaperdinkUIDateClass::fetch_data	(	const char *	time_zone,
		uint8_t	week_start_offset = 6 )

Definition at line 4 of file date_time.cpp.

{
    struct tm timeinfo;
    time_t epoch;
    const int MONTHS[] = { 0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 };
 
    for (uint8_t i = 0; i < CONFIG_TIME_RETRY_COUNT; i++) {
        configTime(0, 0, NTP_SERVER);
 
        Serial.printf("TZ: %s\r\n", time_zone);
        setenv("TZ", time_zone, 1);
 
        if (!getLocalTime(&timeinfo)) {
            Serial.println("Failed to obtain time. Retrying...");
            delay(1000);
            if (i == CONFIG_TIME_RETRY_COUNT)
                return -1;
        } else {
            break;
        }
    }
 
    epoch = mktime(&timeinfo);
 
    sscanf(ctime(&epoch), "%s %s %hhd %hhd:%hhd:%hhd %d", wday, month, &mday, &mil_hour, &min, &sec, &year);
 
    month_num = timeinfo.tm_mon + 1;
    // Gives offset of first day of the month with respect to Monday
    // https://www.tondering.dk/claus/cal/chrweek.php#calcdow
    // 0=Sunday, 1=Monday ... 6=Saturday
    uint16_t a = (14 - month_num) / 12;
    uint16_t y = year - a;
    uint16_t m = month_num + (12 * a) - 2;
 
    day_offset = (1 + y + (y / 4) - (y / 100) + (y / 400) + ((31 * m) / 12)) % 7;
    // Change the offset based on user preference
    day_offset = (day_offset + week_start_offset) % 7;
 
    // Convert to 12 hour
    if (mil_hour > 12)
        hour = mil_hour - 12;
    else
        hour = mil_hour;
 
    // Get number of days in a month
    month_days = MONTHS[month_num];
    // Handle leap years
    if (month_num == 1 && (((year % 4 == 0) && (year % 100 != 0)) || (year % 400 == 0)))
        month_days = 29;
 
    Serial.printf("Time is %d %d:%d:%d on %s on the %d/%d/%d . It is the month of %s. day_offset: %d\r\n", mil_hour, hour, min, sec, wday, mday, month_num, year, month, day_offset);
    return 0;
}

Member Data Documentation

day_offset

uint8_t PaperdinkUIDateClass::day_offset

Definition at line 21 of file date_time.h.

hour

uint8_t PaperdinkUIDateClass::hour

Definition at line 18 of file date_time.h.

mday

uint8_t PaperdinkUIDateClass::mday

Definition at line 16 of file date_time.h.

mil_hour

uint8_t PaperdinkUIDateClass::mil_hour

Definition at line 17 of file date_time.h.

min

uint8_t PaperdinkUIDateClass::min

Definition at line 19 of file date_time.h.

month

char PaperdinkUIDateClass::month[4]

Definition at line 13 of file date_time.h.

month_days

uint8_t PaperdinkUIDateClass::month_days

Definition at line 14 of file date_time.h.

month_num

uint8_t PaperdinkUIDateClass::month_num

Definition at line 15 of file date_time.h.

sec

uint8_t PaperdinkUIDateClass::sec

Definition at line 20 of file date_time.h.

wday

char PaperdinkUIDateClass::wday[4]

Definition at line 12 of file date_time.h.

week_start_offset

uint8_t PaperdinkUIDateClass::week_start_offset

Definition at line 24 of file date_time.h.

year

int PaperdinkUIDateClass::year

Definition at line 22 of file date_time.h.

---

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

• src/ui/date_time/date_time.h
• src/ui/date_time/date_time.cpp