7802994854
* Move from .c to .h as needed for consistency. * When missing from both, copy from pull request or wiki. * When missing entirely, infer functionality from source code.
128 lines
5.0 KiB
C
128 lines
5.0 KiB
C
/*
|
|
* MIT License
|
|
*
|
|
* Copyright (c) 2022 Andreas Nebinger
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef INTERVAL_FACE_H_
|
|
#define INTERVAL_FACE_H_
|
|
|
|
/*
|
|
* INTERVAL TIMER face
|
|
*
|
|
* This face brings 9 customizable interval timers to the sensor watch,
|
|
* to be used as hiit training device and/or for time management techniques.
|
|
*
|
|
* - There are 9 interval timer slots, you can cycle through these with the
|
|
* alarm button (short press). For each timer slot, a short "slideshow"
|
|
* displaying the relevant details (like length of each phase - see below)
|
|
* is shown.
|
|
*
|
|
* - To start an interval timer, press and hold the alarm button.
|
|
*
|
|
* - To pause a running timer, press the alarm button (short press).
|
|
*
|
|
* - To completely abort a running timer, press and hold the alarm button.
|
|
*
|
|
* - Press and hold the light button to enter settings mode for each interval
|
|
* timer slot.
|
|
*
|
|
* - Each interval timer has 1 to 4 phases of customizable length like so:
|
|
* (1) prepare/warum up --> (2) work --> (3) break --> (4) cool down.
|
|
* When setting up or running a timer, each of these phases is displayed by
|
|
* the letters "PR" (prepare), "WO" (work), "BR" (break), "CD" (cool down).
|
|
*
|
|
* - Each of these phases is optional, you can set the corresponding
|
|
* minutes and seconds to zero. But at least one phase needs to be set, if
|
|
* you want to use the timer.
|
|
*
|
|
* - You can define the number of rounds either only for the work
|
|
* phase and/or for the combination of work + break phase. Let's say you
|
|
* want an interval timer that counts 3 rounds of 30 seconds work,
|
|
* followed by 20 seconds rest:
|
|
* work 30s --> work 30s --> work 30s --> break 20s
|
|
* You can do this by setting 30s for the "WO"rk phase and setting a 3
|
|
* in the lower right hand corner of the work page. The "LAP" indicator
|
|
* lights up at this position, to explain that we are setting laps here.
|
|
* After that, set the "BR"eak phase to 20s and leave the rest as it is.
|
|
*
|
|
* - If you want to set up a certain number of "full rounds", consisting
|
|
* of work phase(s) plus breaks, you can do so at the "BR"eak page. The
|
|
* number in the lower right hand corner determines the number of full
|
|
* rounds to be counted. A "-" means, that there is no limit and the
|
|
* timer keeps alternating between work and break phases.
|
|
*
|
|
* - This watch face comes with several pre-defined interval timers,
|
|
* suitable for hiit training (timer slots 1 to 4) as well as doing
|
|
* work according to the pomodoro principle (timer slots 5 to 6).
|
|
* Feel free to adjust the timer slots to your own needs (or completely
|
|
* wipe them ;-)
|
|
*/
|
|
|
|
#include "movement.h"
|
|
|
|
#define INTERVAL_TIMERS 9 // no of available customizable timers (be aware: only 4 bits reserved for this value in struct below)
|
|
|
|
typedef struct {
|
|
uint8_t warmup_minutes;
|
|
uint8_t warmup_seconds;
|
|
uint8_t work_minutes;
|
|
uint8_t work_seconds;
|
|
uint8_t break_minutes;
|
|
uint8_t break_seconds;
|
|
uint8_t cooldown_minutes;
|
|
uint8_t cooldown_seconds;
|
|
uint8_t work_rounds;
|
|
uint8_t full_rounds;
|
|
} interval_timer_setting_t;
|
|
|
|
typedef enum {
|
|
interval_state_intro,
|
|
interval_state_waiting,
|
|
interval_state_setting,
|
|
interval_state_running,
|
|
interval_state_pausing
|
|
} interval_timer_state_t;
|
|
|
|
typedef struct {
|
|
bool is_active;
|
|
uint8_t face_idx;
|
|
uint8_t timer_idx;
|
|
uint8_t timer_running_idx;
|
|
interval_timer_state_t face_state;
|
|
interval_timer_setting_t timer[INTERVAL_TIMERS];
|
|
} interval_face_state_t;
|
|
|
|
void interval_face_setup(movement_settings_t *settings, uint8_t watch_face_index, void ** context_ptr);
|
|
void interval_face_activate(movement_settings_t *settings, void *context);
|
|
bool interval_face_loop(movement_event_t event, movement_settings_t *settings, void *context);
|
|
void interval_face_resign(movement_settings_t *settings, void *context);
|
|
|
|
#define interval_face ((const watch_face_t) { \
|
|
interval_face_setup, \
|
|
interval_face_activate, \
|
|
interval_face_loop, \
|
|
interval_face_resign, \
|
|
NULL \
|
|
})
|
|
|
|
#endif // INTERVAL_FACE_H_
|