mirror of
https://github.com/google/pebble
synced 2026-10-17 00:34:11 +02:00
Import of the watch repository from Pebble
This commit is contained in:
Matthieu Jeanson
Katharine Berry
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,178 @@
|
||||
/*
|
||||
* Copyright 2024 Google LLC
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
|
||||
#include "board/board.h"
|
||||
|
||||
#include "util/time/time.h"
|
||||
#include <stdbool.h>
|
||||
#include <stdint.h>
|
||||
|
||||
//! @file alarm.h
|
||||
//! Allows a user to set an alarm for a given time in the future. When this time arrives, a
|
||||
//! PEBBLE_ALARM_CLOCK_EVENT event will be put.
|
||||
//!
|
||||
//! These alarm settings will be persisted across watch resets.
|
||||
|
||||
#define SMART_ALARM_RANGE_S (30 * SECONDS_PER_MINUTE)
|
||||
#define SMART_ALARM_SNOOZE_DELAY_S (1 * SECONDS_PER_MINUTE)
|
||||
#define SMART_ALARM_MAX_LIGHT_SLEEP_S (30 * SECONDS_PER_MINUTE)
|
||||
#define SMART_ALARM_MAX_SMART_SNOOZE (SMART_ALARM_RANGE_S / SMART_ALARM_SNOOZE_DELAY_S)
|
||||
|
||||
#define ALARMS_APP_HIGHLIGHT_COLOR PBL_IF_COLOR_ELSE(GColorJaegerGreen, GColorBlack)
|
||||
|
||||
typedef int AlarmId; //! A unique ID that can be used to refer to each configured alarm.
|
||||
|
||||
#define ALARM_INVALID_ID (-1)
|
||||
|
||||
typedef enum AlarmKind {
|
||||
ALARM_KIND_EVERYDAY = 0, // Alarms of this type will happen each day
|
||||
ALARM_KIND_WEEKENDS, // Alarms of this type will happen Monday - Friday
|
||||
ALARM_KIND_WEEKDAYS, // Alarms of this type happen Saturaday and Sunday
|
||||
ALARM_KIND_JUST_ONCE, // Alarms of this type will happen next time the specified time occurs
|
||||
ALARM_KIND_CUSTOM, // Alarms of this type happen on specified days
|
||||
} AlarmKind;
|
||||
|
||||
typedef enum AlarmType {
|
||||
AlarmType_Basic,
|
||||
AlarmType_Smart,
|
||||
AlarmTypeCount,
|
||||
} AlarmType;
|
||||
|
||||
typedef struct AlarmInfo {
|
||||
int hour; //<! Range 0-23, where 0 is 12am
|
||||
int minute; //<! Range is 0-59
|
||||
AlarmKind kind; //<! The kind of recurrence the alarm will have
|
||||
//! A bool for each weekday (Sunday = index 0) enabled
|
||||
bool (*scheduled_days)[DAYS_PER_WEEK];
|
||||
bool enabled; //<! Whether the alarm to go off at the specified time
|
||||
bool is_smart; //<! Whether the alarm is a Smart Alarm
|
||||
} AlarmInfo;
|
||||
|
||||
typedef void (*AlarmForEach)(AlarmId id, const AlarmInfo *info, void *context);
|
||||
|
||||
//! Creates an alarm
|
||||
//! @param info The alarm configuration to be created with
|
||||
AlarmId alarm_create(const AlarmInfo *info);
|
||||
|
||||
//! @param id The alarm that should be updated
|
||||
//! @param hour Range 0-23, where 0 is 12am
|
||||
//! @param minute Range is 0-59
|
||||
void alarm_set_time(AlarmId id, int hour, int minute);
|
||||
|
||||
//! @param id The alarm that should be updated
|
||||
//! @param kind The new kind of the alarm
|
||||
//! @note The CUSTOM kind will be ignored
|
||||
void alarm_set_kind(AlarmId id, AlarmKind kind);
|
||||
|
||||
//! @param id The alarm that should be updated
|
||||
//! @param scheduled_days[DAYS_PER_WEEK] A bool for each weekday (Sunday = index 0) enabled
|
||||
//! each weekday that is marked as true
|
||||
void alarm_set_custom(AlarmId id, const bool scheduled_days[DAYS_PER_WEEK]);
|
||||
|
||||
//! @param id The alarm that should be updated
|
||||
//! @param smart Whether the alarm is a smart alarm
|
||||
void alarm_set_smart(AlarmId id, bool smart);
|
||||
|
||||
//! @param id The alarm for which the scheduled_days array should be updated for
|
||||
//! @param scheduled_days[DAYS_PER_WEEK] An empty bool array for each weekday (Sunday = index 0)
|
||||
//! that is to be updated. Alarms will run on each weekday that is marked as true
|
||||
//! @return True if the alarm exists, False otherwise
|
||||
bool alarm_get_custom_days(AlarmId id, bool scheduled_days[DAYS_PER_WEEK]);
|
||||
|
||||
//! @param id The alarm that should be modified
|
||||
//! @param enable Whether to enable the alarm
|
||||
void alarm_set_enabled(AlarmId id, bool enable);
|
||||
|
||||
//! @param id The alarm that should be deleted
|
||||
void alarm_delete(AlarmId id);
|
||||
|
||||
//! @param id The alarm that is being queried
|
||||
//! @return True if the alarm exists and is not disabled, Flase otherwise
|
||||
bool alarm_get_enabled(AlarmId id);
|
||||
|
||||
//! @param id The alarm that should be deleted
|
||||
//! @param hour_out Hour which the alarm is scheduled for
|
||||
//! @param minute_out Minute which the alarm is scheduled for
|
||||
//! @return True if the alarm is scheduled, False if not (disabled / doesn't exist)
|
||||
bool alarm_get_hours_minutes(AlarmId id, int *hour_out, int *minute_out);
|
||||
|
||||
//! @param id The alarm that is being queried
|
||||
//! @param kind_out The type of alarm
|
||||
//! @return True if the alarm exists, False otherwise
|
||||
bool alarm_get_kind(AlarmId id, AlarmKind *kind_out);
|
||||
|
||||
//! @param next_alarm_time_out The time of the next enabled alarm
|
||||
//! @return True if at least one alarm is enabled, False if no alarms are enabled.
|
||||
bool alarm_get_next_enabled_alarm(time_t *next_alarm_time_out);
|
||||
|
||||
//! @return True if the next enabled alarm is a smart alarm, False if no alarms are enabled or the
|
||||
//! next alarm is not smart.
|
||||
bool alarm_is_next_enabled_alarm_smart(void);
|
||||
|
||||
//! @param id The alarm that is being queried
|
||||
//! @param time_out The number of seconds until the alarm is scheduled to go off
|
||||
//! @return True if the alarm is scheduled, False if not (disabled / doesn't exist)
|
||||
bool alarm_get_time_until(AlarmId id, time_t *time_out);
|
||||
|
||||
//! Starts a snooze timer for the current snooze delay.
|
||||
void alarm_set_snooze_alarm(void);
|
||||
|
||||
//! @return Snooze delay in minutes.
|
||||
uint16_t alarm_get_snooze_delay(void);
|
||||
|
||||
//! Set the snooze delay for all alarms
|
||||
//! @param delay_m snooze delay in minutes.
|
||||
void alarm_set_snooze_delay(uint16_t delay_m);
|
||||
|
||||
//! Dismisses the most recently triggered alarm.
|
||||
void alarm_dismiss_alarm(void);
|
||||
|
||||
//! Runs the callback for each alarm pairing
|
||||
void alarm_for_each(AlarmForEach cb, void *context);
|
||||
|
||||
//! @return True if the max number of alarms hasn't been saved, False otherwise
|
||||
bool alarm_can_schedule(void);
|
||||
|
||||
//! Call this when the clock time has changed. This will reschedule all the alarms so they'll go
|
||||
//! off at the right time. This is required because the alarm subsystem registers timers that go
|
||||
//! off at a number of seconds as opposed to an absolute time, and the number of seconds before
|
||||
//! the timer goes off changes when the clock time changes.
|
||||
void alarm_handle_clock_change(void);
|
||||
|
||||
void alarm_init(void);
|
||||
|
||||
//! Enable or disable alarms globally.
|
||||
void alarm_service_enable_alarms(bool enable);
|
||||
|
||||
//! Get the string (e.g. "Weekends") for a given AlarmKind and all-caps specification
|
||||
const char *alarm_get_string_for_kind(AlarmKind kind, bool all_caps);
|
||||
|
||||
//! For an alarm of type custom, retrieve a string representing the days that the alarm is set for
|
||||
//! Example: 1 day: ("Mondays", "Tuesdays"), multiple days: ("Mon,Sat,Sun", "Tue,Thu")
|
||||
//! @param [in] scheduled_days[DAYS_PER_WEEK] A bool for each weekday (Sunday = index 0) enabled
|
||||
//! @param [out] alarm_day_text A character array that is to be updated with the days. It should
|
||||
//! have a minimum of 28 bytes allocated
|
||||
void alarm_get_string_for_custom(bool scheduled_days[DAYS_PER_WEEK], char *alarm_day_text);
|
||||
|
||||
#if CAPABILITY_HAS_HEALTH_TRACKING
|
||||
//! Set the alarms app version opened
|
||||
void alarm_prefs_set_alarms_app_opened(uint8_t version);
|
||||
|
||||
//! Get the alarms app version opened
|
||||
uint8_t alarm_prefs_get_alarms_app_opened(void);
|
||||
#endif
|
||||
@@ -0,0 +1,89 @@
|
||||
/*
|
||||
* Copyright 2024 Google LLC
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
#include "alarm_pin.h"
|
||||
|
||||
#include "apps/system_app_ids.h"
|
||||
#include "kernel/pbl_malloc.h"
|
||||
#include "services/common/i18n/i18n.h"
|
||||
#include "services/normal/blob_db/pin_db.h"
|
||||
#include "services/normal/timeline/attribute.h"
|
||||
#include "services/normal/timeline/timeline.h"
|
||||
#include "services/normal/timeline/timeline_resources.h"
|
||||
|
||||
|
||||
// ----------------------------------------------------------------------------------------------
|
||||
//! Sets attributes for an alarm pin
|
||||
static void prv_set_pin_attributes(AttributeList *list, AlarmType type, AlarmKind kind) {
|
||||
const bool is_smart = (type == AlarmType_Smart);
|
||||
attribute_list_add_cstring(list, AttributeIdTitle,
|
||||
is_smart ? i18n_get("Smart Alarm", list) : i18n_get("Alarm", list));
|
||||
attribute_list_add_resource_id(list, AttributeIdIconPin,
|
||||
is_smart ? TIMELINE_RESOURCE_SMART_ALARM :
|
||||
TIMELINE_RESOURCE_ALARM_CLOCK);
|
||||
attribute_list_add_resource_id(list, AttributeIdIconTiny, TIMELINE_RESOURCE_ALARM_CLOCK);
|
||||
const bool all_caps = false;
|
||||
const char *alarm_string = i18n_get(alarm_get_string_for_kind(kind, all_caps), list);
|
||||
attribute_list_add_cstring(list, AttributeIdSubtitle, alarm_string);
|
||||
attribute_list_add_uint8(list, AttributeIdAlarmKind, kind);
|
||||
}
|
||||
|
||||
// ----------------------------------------------------------------------------------------------
|
||||
static void prv_set_edit_action_attributes(AttributeList *list) {
|
||||
attribute_list_add_cstring(list, AttributeIdTitle, i18n_get("Edit", list));
|
||||
}
|
||||
|
||||
// ----------------------------------------------------------------------------------------------
|
||||
void alarm_pin_add(time_t alarm_time, AlarmId id, AlarmType type, AlarmKind kind, Uuid *uuid_out) {
|
||||
const unsigned num_actions = 1; // We are just supporting "edit" for now
|
||||
TimelineItemActionGroup action_group = {
|
||||
.num_actions = num_actions,
|
||||
.actions = task_zalloc_check(sizeof(TimelineItemAction) * num_actions),
|
||||
};
|
||||
AttributeList edit_attr_list = {0};
|
||||
prv_set_edit_action_attributes(&edit_attr_list);
|
||||
action_group.actions[0] = (TimelineItemAction) {
|
||||
.id = (uint8_t) id, // id is guarenteed to be valid here, and we only support 10 alarms
|
||||
.type = TimelineItemActionTypeOpenWatchApp,
|
||||
.attr_list = edit_attr_list,
|
||||
};
|
||||
|
||||
AttributeList pin_attr_list = {0};
|
||||
prv_set_pin_attributes(&pin_attr_list, type, kind);
|
||||
TimelineItem *item = timeline_item_create_with_attributes(alarm_time, 0, TimelineItemTypePin,
|
||||
LayoutIdAlarm, &pin_attr_list, &action_group);
|
||||
item->header.from_watch = true;
|
||||
item->header.parent_id = (Uuid)UUID_ALARMS_DATA_SOURCE;
|
||||
|
||||
pin_db_insert_item_without_event(item);
|
||||
|
||||
i18n_free_all(&pin_attr_list);
|
||||
i18n_free_all(&edit_attr_list);
|
||||
attribute_list_destroy_list(&pin_attr_list);
|
||||
attribute_list_destroy_list(&edit_attr_list);
|
||||
task_free(action_group.actions);
|
||||
|
||||
if (uuid_out) {
|
||||
*uuid_out = item->header.id;
|
||||
}
|
||||
|
||||
timeline_item_destroy(item);
|
||||
}
|
||||
|
||||
// ----------------------------------------------------------------------------------------------
|
||||
void alarm_pin_remove(Uuid *alarm_id) {
|
||||
pin_db_delete((uint8_t *)alarm_id, sizeof(Uuid));
|
||||
}
|
||||
@@ -0,0 +1,24 @@
|
||||
/*
|
||||
* Copyright 2024 Google LLC
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
|
||||
#include "util/uuid.h"
|
||||
#include "services/normal/alarms/alarm.h"
|
||||
|
||||
void alarm_pin_add(time_t alarm_time, AlarmId id, AlarmType type, AlarmKind kind, Uuid *uuid_out);
|
||||
|
||||
void alarm_pin_remove(Uuid *alarm_id);
|
||||
Reference in New Issue
Block a user