feat: add date and day label to home

Within this commit, we add labels to show date and the day name in the
home screen for better user-experience. This implementation uses exact
coordinates.

Author: electricalgorithm

src/display/screens/home/home.c

@@ -4,21 +4,40 @@
 // Holds the home screen object.
 lv_obj_t *home_screen;
 lv_obj_t *label_clock;
+lv_obj_t *label_date;
+lv_obj_t *label_day;
 
 void home_screen_init() {
     // Create the screen object which is the LV object with no parent.
     home_screen = lv_obj_create(NULL);
     // Remove the ability to scroll the screen.
     lv_obj_remove_flag(home_screen, LV_OBJ_FLAG_SCROLLABLE);
 
+    // Render items in the screen.
+    render_clock_label();
+    render_date_label();
+    render_day_label();
+    
+    // Add an event handler for all possible events.
+    lv_obj_add_event_cb(home_screen, home_screen_event, LV_EVENT_ALL, NULL);
+}
+
+void home_screen_event(lv_event_t * e) {
+    // lv_event_code_t event_code = lv_event_get_code(e);lv_obj_t * target = lv_event_get_target(e);
+}
+
+void render_clock_label() {
     // Create a new label and expand its size to content size and align it to center.
     label_clock = lv_label_create(home_screen);
     lv_obj_set_width(label_clock, LV_SIZE_CONTENT);
     lv_obj_set_height(label_clock, LV_SIZE_CONTENT);
     lv_obj_set_align(label_clock, LV_ALIGN_CENTER);
+
+    // Align to center but with upward Y offset.
+    lv_obj_align(label_clock, LV_ALIGN_CENTER, 0, -20);
 
     // Set the default text.
-    lv_label_set_text(label_clock, "HH\nMM");
+    lv_label_set_text(label_clock, "HH:mm");
 
     // Format the clock text string.
     /* 1. Set the letter spacing to 5. (Between letters)
@@ -32,13 +51,30 @@ void home_screen_init() {
     lv_obj_set_style_text_align(label_clock, LV_TEXT_ALIGN_AUTO, LV_PART_MAIN | LV_STATE_DEFAULT);
     lv_obj_set_style_text_decor(label_clock, LV_TEXT_DECOR_NONE, LV_PART_MAIN | LV_STATE_DEFAULT);
     lv_obj_set_style_text_font(label_clock, &lv_font_montserrat_46, LV_PART_MAIN | LV_STATE_DEFAULT);
+}
 
-    // Add an event handler for all possible events.
-    lv_obj_add_event_cb(home_screen, home_screen_event, LV_EVENT_ALL, NULL);
+void render_date_label() {
+    // Create a new label and expand its size to content size and align it to center.
+    label_date = lv_label_create(home_screen);
+
+    // Align it to the bottom of the clock label with a margin of 2x5y pixels.
+    lv_obj_align_to(label_date, label_clock, LV_ALIGN_OUT_BOTTOM_MID, -65, 0);
+
+    // Set the default text.
+    lv_label_set_text(label_date, "YYYY-MM-DD");
+    lv_obj_set_style_text_font(label_date, &lv_font_montserrat_18, LV_PART_MAIN | LV_STATE_DEFAULT);
 }
 
-void home_screen_event(lv_event_t * e) {
-    // lv_event_code_t event_code = lv_event_get_code(e);lv_obj_t * target = lv_event_get_target(e);
+void render_day_label() {
+    // Create a new label and expand its size to content size and align it to center.
+    label_day = lv_label_create(home_screen);
+
+    // Align it to the bottom of the clock label with a margin of 2x5y pixels.
+    lv_obj_align_to(label_day, label_clock, LV_ALIGN_OUT_BOTTOM_MID, +45, 0);
+
+    // Set the default text.
+    lv_label_set_text(label_day, "DAY");
+    lv_obj_set_style_text_font(label_day, &lv_font_montserrat_18, LV_PART_MAIN | LV_STATE_DEFAULT);
 }
 
 uint8_t home_screen_set_clock(uint8_t hour, uint8_t minute) {
@@ -50,3 +86,23 @@ uint8_t home_screen_set_clock(uint8_t hour, uint8_t minute) {
     lv_disp_flush_ready(lv_disp_get_default());
     return 0;
 }
+
+uint8_t home_screen_set_date(uint16_t year, uint8_t month, uint8_t day) {
+    // Check if the label_date is NULL.
+    if (label_date == NULL) return 1;
+    // Set the text of the label_date to the current date in "YYYY-MM-DD" format.
+    lv_label_set_text_fmt(label_date, "%04u-%02d-%02d", year,  month + 1, day);
+    // Update the display.
+    lv_disp_flush_ready(lv_disp_get_default());
+    return 0;
+}
+
+uint8_t home_screen_set_day(const char* day) {
+    // Check if the label_clock is NULL.
+    if (label_day == NULL) return 1;
+    // Set the text of the label_day to the 3 character day name.
+    lv_label_set_text(label_day, day);
+    // Update the display.
+    lv_disp_flush_ready(lv_disp_get_default());
+    return 0;
+}

src/display/screens/home/home.h

@@ -14,9 +14,15 @@ extern lv_obj_t *home_screen;
 void home_screen_init();
 void home_screen_event(lv_event_t * e);
 
-// Set the time on the clock. Returns 0 if successful, 1 otherwise.
-uint8_t home_screen_set_clock(uint8_t hour, uint8_t minute);
+// Render labels.
+void render_clock_label();
+void render_date_label();
+void render_day_label();
 
+// Set the values on the home-screen. Returns 0 if successful, 1 otherwise.
+uint8_t home_screen_set_clock(uint8_t hour, uint8_t minute);
+uint8_t home_screen_set_date(uint16_t year, uint8_t month, uint8_t day);
+uint8_t home_screen_set_day(const char* day);
 
 #ifdef __cplusplus
 } // extern "C"

src/main.c

@@ -34,14 +34,13 @@ int8_t utc_zone = +1;
 // Define timers to track real time.
 void update_unix_time_callback(struct k_timer *timer);
 void update_clock_view_callback(struct k_timer *timer);
+void update_date_day_view_callback(struct k_timer *timer);
 K_TIMER_DEFINE(unix_time_timer, update_unix_time_callback, NULL);
 K_TIMER_DEFINE(clock_view_timer, update_clock_view_callback, NULL);
+K_TIMER_DEFINE(date_day_view_timer, update_date_day_view_callback, NULL);
 
 // Define the weekday names.
-const char* weekdays[] = {
-    "Sunday", "Monday", "Tuesday", "Wednesday",
-    "Thursday", "Friday", "Saturday"
-};
+const char* weekdays[] = { "SUN", "MON", "TUE", "WED", "THU", "FRI", "SAT" };
 
 int main(void) {
 	int ret;
@@ -54,8 +53,9 @@ int main(void) {
     }
 
 	// Start the timer to track the real time.
-	k_timer_start(&unix_time_timer, K_MSEC(0), K_MSEC(1000));
-	k_timer_start(&clock_view_timer, K_SECONDS(60), K_SECONDS(60));
+	k_timer_start(&unix_time_timer, K_MSEC(60), K_MSEC(1000));
+	k_timer_start(&clock_view_timer, K_MSEC(60), K_SECONDS(30));
+    k_timer_start(&date_day_view_timer, K_MSEC(60), K_MINUTES(1));
 
     // Check if the display device is ready.
 	const struct device *display_dev = DEVICE_DT_GET(DT_CHOSEN(zephyr_display));
@@ -132,4 +132,31 @@ void update_clock_view_callback(struct k_timer *timer) {
     if (ret != 0) {
         LOG_ERR("Failed to update the clock view.");
     }
+}
+
+/* UPDATE_DATE_DAY_VIEW_CALLBACK
+ */
+void update_date_day_view_callback(struct k_timer *timer) {
+    // Get the device twin to find UTC zone.
+    device_twin_t* device_twin = get_device_twin_instance();
+
+    // Construct the local time from UNIX time and save it.
+    utc_time_t local_time = unix_to_localtime(unix_time, device_twin->utc_zone);
+    device_twin->current_time = local_time;
+
+    // Update the date view.
+    uint8_t ret = home_screen_set_date(
+        device_twin->current_time.year,
+        device_twin->current_time.month,
+        device_twin->current_time.day
+    );
+    if (ret != 0) {
+        LOG_ERR("Failed to update the date view.");
+    }
+
+    // Update the day view.
+    ret = home_screen_set_day(weekdays[device_twin->current_time.weekday]);
+    if (ret != 0) {
+        LOG_ERR("Failed to update the day view.");
+    }
 }