settings.h

Go to the documentation of this file.

#pragma once
#include <pebble.h>


typedef enum
{
    SETTING_TEMPERATURE_UNIT,          
    SETTING_DATE_FORMAT,               
    SETTING_THEME,                     
    SETTING_STEPS_MODE,                
    SETTING_DISTANCE_UNIT,             
    SETTING_TIME_FORMAT,               
    SETTING_BLUETOOTH_ICON,            
    SETTING_QUIET_TIME_ICON,           
    SETTING_BLUETOOTH_VIBE_CONNECT,    
    SETTING_BLUETOOTH_VIBE_DISCONNECT, 
    SETTING_HOURLY_VIBE,               
    SETTING_BATTERY_DISPLAY,           
    SETTING_HEADER_FONT,               
    SETTING_COUNT                      
} SettingId;

typedef enum
{
    SETTING_BOOL,     
    SETTING_ENUM_U8,  
    SETTING_CSTRING,  
    SETTING_COLOR     
} SettingType;

typedef struct
{
    SettingId   id;               
    const uint32_t *message_key;  
    SettingType type;             
    uint16_t    offset;           
    uint16_t    size;             
    uint8_t     enum_count;       
    uint32_t    default_num;      
    const char *default_str;      
    bool        affects_layout;   
    bool        affects_weather;  
} SettingField;

typedef struct SettingsSchema
{
    uint32_t key;                     
    uint8_t version;                  
    uint16_t min_versioned_size;      
    void *blob;                       
    uint16_t blob_size;               
    const SettingField *fields;       
    uint8_t field_count;              
    bool (*migrate)(int stored_size); 
    const struct SettingsSchema *companion; 
} SettingsSchema;

#define SETTINGS_BLOB_SIZE(blob) \
    (sizeof(blob) + 0 * sizeof(struct { \
        _Static_assert(sizeof(blob) <= PERSIST_DATA_MAX_LENGTH, \
                       "settings struct is over 256 bytes, so move some fields into a companion schema"); \
        char unused; \
    }))

typedef struct
{
    bool changed;         
    bool layout_changed;  
    bool weather_changed; 
} SettingsInbound;

void settings_init(const SettingsSchema *schema);

bool settings_was_fresh(void);

void settings_save(void);

void settings_mark_restored(void);

uint8_t settings_u8(SettingId id);

const char *settings_str(SettingId id);

void settings_set_u8(SettingId id, uint8_t value);

uint8_t settings_enum_count(SettingId id);

uint32_t settings_serialized_size_max(void);

bool settings_serialize(DictionaryIterator *iter);

SettingsInbound settings_apply_inbox(DictionaryIterator *iter);