From 866cbb11bf930b8a01abe453347d271a19bcaf02 Mon Sep 17 00:00:00 2001 From: Joey Castillo Date: Tue, 8 Jul 2025 17:54:01 -0400 Subject: [PATCH] =?UTF-8?q?add=20local=20decimal=20time=20(K=C3=A8)=20face?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- movement_faces.h | 1 + watch-faces.mk | 1 + watch-faces/clock/ke_decimal_time_face.c | 142 +++++++++++++++++++++++ watch-faces/clock/ke_decimal_time_face.h | 57 +++++++++ 4 files changed, 201 insertions(+) create mode 100644 watch-faces/clock/ke_decimal_time_face.c create mode 100644 watch-faces/clock/ke_decimal_time_face.h diff --git a/movement_faces.h b/movement_faces.h index f5c087bc..3583e9a3 100644 --- a/movement_faces.h +++ b/movement_faces.h @@ -61,4 +61,5 @@ #include "totp_face.h" #include "tally_face.h" #include "probability_face.h" +#include "ke_decimal_time_face.h" // New includes go above this line. diff --git a/watch-faces.mk b/watch-faces.mk index 665ec4b7..eff50d27 100644 --- a/watch-faces.mk +++ b/watch-faces.mk @@ -36,4 +36,5 @@ SRCS += \ ./watch-faces/complication/tarot_face.c \ ./watch-faces/complication/kitchen_conversions_face.c \ ./watch-faces/complication/periodic_table_face.c \ + ./watch-faces/clock/ke_decimal_time_face.c \ # New watch faces go above this line. diff --git a/watch-faces/clock/ke_decimal_time_face.c b/watch-faces/clock/ke_decimal_time_face.c new file mode 100644 index 00000000..6737477c --- /dev/null +++ b/watch-faces/clock/ke_decimal_time_face.c @@ -0,0 +1,142 @@ +/* + * MIT License + * + * Copyright (c) 2025 Joey Castillo + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ + +#include +#include +#include "ke_decimal_time_face.h" +#include "watch_utility.h" + +static void _display_date(watch_date_time_t date_time) { + char buf[3]; + + watch_display_text_with_fallback(WATCH_POSITION_TOP_LEFT, watch_utility_get_long_weekday(date_time), watch_utility_get_weekday(date_time)); + snprintf(buf, sizeof(buf), "%2d", date_time.unit.day); + watch_display_text(WATCH_POSITION_TOP_RIGHT, buf); +} + +static void _display_time(ke_decimal_time_state_t *state, watch_date_time_t date_time, bool low_energy) { + char buf[7]; + uint32_t value = date_time.unit.hour * 3600 + date_time.unit.minute * 60 + date_time.unit.second; + + if (value == state->previous_time) return; + + value = value * 100; + value = value / 864; + snprintf(buf, sizeof(buf), "%04d#o", value); + + // if under 10%, display 0.00 instead of 00.00 + if (value < 1000) buf[0] = ' '; + + // if low energy, truncate at the tens place + if (low_energy) buf[3] = 0; + + watch_display_text(WATCH_POSITION_BOTTOM, buf); + + state->previous_time = value; +} + +void ke_decimal_time_face_setup(uint8_t watch_face_index, void ** context_ptr) { + (void) watch_face_index; + if (*context_ptr == NULL) { + *context_ptr = malloc(sizeof(ke_decimal_time_state_t)); + memset(*context_ptr, 0, sizeof(ke_decimal_time_state_t)); + // Do any one-time tasks in here; the inside of this conditional happens only at boot. + } + // Do any pin or peripheral setup here; this will be called whenever the watch wakes from deep sleep. +} + +void ke_decimal_time_face_activate(void *context) { + ke_decimal_time_state_t *state = (ke_decimal_time_state_t *)context; + + // force re-display of date and time in EVENT_ACTIVATE + state->previous_day = 0xFF; + state->previous_time = 0xFFFFFFFF; +} + +bool ke_decimal_time_face_loop(movement_event_t event, void *context) { + ke_decimal_time_state_t *state = (ke_decimal_time_state_t *)context; + watch_date_time_t date_time = movement_get_local_date_time(); + + switch (event.event_type) { + case EVENT_ACTIVATE: + watch_set_decimal_if_available(); + if (movement_alarm_enabled()) { + watch_set_indicator(WATCH_INDICATOR_SIGNAL); + } + // fall through + case EVENT_TICK: + _display_time(state, date_time, false); + if (state->previous_day != date_time.unit.day) { + _display_date(date_time); + state->previous_day = date_time.unit.day; + } + break; + case EVENT_LIGHT_BUTTON_UP: + // You can use the Light button for your own purposes. Note that by default, Movement will also + // illuminate the LED in response to EVENT_LIGHT_BUTTON_DOWN; to suppress that behavior, add an + // empty case for EVENT_LIGHT_BUTTON_DOWN. + break; + case EVENT_ALARM_BUTTON_UP: + // Just in case you have need for another button. + break; + case EVENT_TIMEOUT: + // Your watch face will receive this event after a period of inactivity. If it makes sense to resign, + // you may uncomment this line to move back to the first watch face in the list: + // movement_move_to_face(0); + break; + case EVENT_LOW_ENERGY_UPDATE: + // If you did not resign in EVENT_TIMEOUT, you can use this event to update the display once a minute. + // Avoid displaying fast-updating values like seconds, since the display won't update again for 60 seconds. + // You should also consider starting the tick animation, to show the wearer that this is sleep mode: + if (!watch_sleep_animation_is_running()) { + watch_start_sleep_animation(500); + watch_display_text(WATCH_POSITION_SECONDS, " "); + watch_display_text(WATCH_POSITION_MINUTES, " "); + } + _display_time(state, date_time, true); + break; + default: + // Movement's default loop handler will step in for any cases you don't handle above: + // * EVENT_LIGHT_BUTTON_DOWN lights the LED + // * EVENT_MODE_BUTTON_UP moves to the next watch face in the list + // * EVENT_MODE_LONG_PRESS returns to the first watch face (or skips to the secondary watch face, if configured) + // You can override any of these behaviors by adding a case for these events to this switch statement. + return movement_default_loop_handler(event); + } + + // return true if the watch can enter standby mode. Generally speaking, you should always return true. + // Exceptions: + // * If you are displaying a color using the low-level watch_set_led_color function, you should return false. + // * If you are sounding the buzzer using the low-level watch_set_buzzer_on function, you should return false. + // Note that if you are driving the LED or buzzer using Movement functions like movement_illuminate_led or + // movement_play_alarm, you can still return true. This guidance only applies to the low-level watch_ functions. + return true; +} + +void ke_decimal_time_face_resign(void *context) { + (void) context; + + // handle any cleanup before your watch face goes off-screen. +} + diff --git a/watch-faces/clock/ke_decimal_time_face.h b/watch-faces/clock/ke_decimal_time_face.h new file mode 100644 index 00000000..950a4e68 --- /dev/null +++ b/watch-faces/clock/ke_decimal_time_face.h @@ -0,0 +1,57 @@ +/* + * MIT License + * + * Copyright (c) 2025 Joey Castillo + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in all + * copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + * SOFTWARE. + */ + +#pragma once + +#include "movement.h" + +/* + * Kè (Decimal Time) + * + * This watch face is an optional replacement for the standard Clock face. + * Like the standard Clock face, it displays the time and weekday at the top, + * but the main line shows the percentage of the day that has passed, with midnight + * represented by 0% and 11:59 PM as 99.9%. + * + * Name comes from here: https://en.wikipedia.org/wiki/Traditional_Chinese_timekeeping#One-hundredth_of_a_day:_kè + * + */ + +typedef struct { + uint8_t previous_day; + uint32_t previous_time; +} ke_decimal_time_state_t; + +void ke_decimal_time_face_setup(uint8_t watch_face_index, void ** context_ptr); +void ke_decimal_time_face_activate(void *context); +bool ke_decimal_time_face_loop(movement_event_t event, void *context); +void ke_decimal_time_face_resign(void *context); + +#define ke_decimal_time_face ((const watch_face_t){ \ + ke_decimal_time_face_setup, \ + ke_decimal_time_face_activate, \ + ke_decimal_time_face_loop, \ + ke_decimal_time_face_resign, \ + NULL, \ +})