cts.h

Go to the documentation of this file.

/*
 * Copyright (c) 2024 Croxel Inc.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_SERVICES_CTS_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_SERVICES_CTS_H_

 
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif

#define BT_CTS_ATT_ERR_VALUES_IGNORED 0x80U

#define BT_CTS_FRACTION_256_MAX_VALUE 255U

#define BT_CTS_TIMEZONE_DEFAULT_VALUE -128

#define BT_CTS_TIMEZONE_INCREMENT_MIN 15U

#define BT_CTS_DST_INCREMENT_MIN 15U

#define BT_CTS_TIMEZONE_MIN -48

#define BT_CTS_TIMEZONE_MAX 56

enum bt_cts_dst_offset {
        BT_CTS_DST_OFFSET_STANDARD_TIME = 0,
        BT_CTS_DST_OFFSET_HALF_HOUR_DAYLIGHT_TIME = 2,
        BT_CTS_DST_OFFSET_DAYLIGHT_TIME = 4,
        BT_CTS_DST_OFFSET_DOUBLE_DAYLIGHT_TIME = 8,
        BT_CTS_DST_OFFSET_UNKNOWN = 255,
};

enum bt_cts_update_reason {
        /* Unknown reason of update no bit is set */
        BT_CTS_UPDATE_REASON_UNKNOWN = 0,
        /* When time is changed manually e.g. through UI */
        BT_CTS_UPDATE_REASON_MANUAL = BIT(0),
        /* If time is changed through external reference */
        BT_CTS_UPDATE_REASON_EXTERNAL_REF = BIT(1),
        /* time changed due to timezone adjust */
        BT_CTS_UPDATE_REASON_TIME_ZONE_CHANGE = BIT(2),
        /* time changed due to dst offset change */
        BT_CTS_UPDATE_REASON_DAYLIGHT_SAVING = BIT(3),
};

struct bt_cts_time_format {
        uint16_t year;
        uint8_t mon;
        uint8_t mday;
        uint8_t hours;
        uint8_t min;
        uint8_t sec;
        uint8_t wday;
        uint8_t fractions256;
        uint8_t reason;
} __packed;

struct bt_cts_local_time {
        int8_t timezone_offset;
        enum bt_cts_dst_offset dst_offset;
};

struct bt_cts_cb {
        void (*notification_changed)(bool enabled);

        int (*cts_time_write)(struct bt_cts_time_format *cts_time);

        int (*fill_current_cts_time)(struct bt_cts_time_format *cts_time);

        int (*cts_local_time_write)(const struct bt_cts_local_time *cts_local_time);

        int (*fill_current_cts_local_time)(struct bt_cts_local_time *local_time);
};

int bt_cts_init(const struct bt_cts_cb *cb);

int bt_cts_send_notification(enum bt_cts_update_reason reason);

int bt_cts_time_to_unix_ms(const struct bt_cts_time_format *ct_time, int64_t *unix_ms);

int bt_cts_time_from_unix_ms(struct bt_cts_time_format *ct_time, int64_t unix_ms);

int bt_cts_local_time_to_ms(const struct bt_cts_local_time *local_time, int32_t *relative_ms);
 
#ifdef __cplusplus
}
#endif

 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_SERVICES_CTS_H_ */