/**********************************************************************
 * Copyright: (C)2026 LingYun IoT System Studio
 * Author: GuoWenxue<guowenxue@gmail.com>
 *
 * Description: ISL1208 RTC driver on ISKBoard
 *
 * ChangeLog:
 * Version    Date       Author            Description
 * V1.0.0  2026.07.08    GuoWenxue      Release initial version
 *
 ************************************************************************/

#ifndef __ISL1208_H
#define __ISL1208_H

#include "i2c_bitbang.h"

/**
 * @brief RTC 时间结构体 (标准十进制格式，应用层直接读写)
 */
typedef struct {
    uint8_t second;   /* 秒: 00 - 59 */
    uint8_t minute;   /* 分: 00 - 59 */
    uint8_t hour;     /* 时: 00 - 23 (固定为24小时制) */
    uint8_t day;      /* 日: 01 - 31 */
    uint8_t month;    /* 月: 01 - 12 */
    uint8_t year;     /* 年: 00 - 99 (代表 2000 - 2099 年) */
    uint8_t weekday;  /* 星期: 00 - 06 (00代表星期天) */
} rtc_time_t;

/**
 * @brief  ISL1208 硬件初始化与掉电自愈函数
 * @param  bus: 绑定的 I2C 物理总线指针 (如 &i2c1_bus)
 * @retval 0: 初始化成功; -1: 总线通信失败或芯片未响应
 */
extern int isl1208_init(i2c_bus_t *bus);

/**
 * @brief  应用层设置 RTC 时间接口函数（rtc_time_t格式）
 * @param  time  指向待写入时间数据的 rtc_time_t 结构体常指针
 * @retval 0:成功, -1:失败
 */
extern int isl1208_set_time(const rtc_time_t *time);

/**
 * @brief  应用层设置 RTC 时间接口函数（字符串格式）
 * @param  time_str  输入的时间字符串指针，格式如 "2026-01-01 10:00:00"
 * @retval 0:成功, -1:失败
 */
extern int isl1208_set_time_str(const char *time_str);

/**
 * @brief  应用层获取 RTC 时间接口函数
 * @param  time  指向用于接收时间数据的 rtc_time_t 结构体指针
 * @retval 0:成功, -1:失败
 */
extern int isl1208_get_time(rtc_time_t *time);

/**
 * @brief  应用层获取 RTC 时间接口函数（字符串格式）
 * @param  buf      用于存储格式化时间字符串的缓冲区指针
 * @param  buf_len  接收缓冲区长度（建议至少20字节）
 * @retval 0:成功, -1:失败
 */
extern int isl1208_get_time_str(char *buf, size_t buf_len);

/**
 * @brief  获取并格式化打印当前 RTC 时间接口函数
 * @retval 0:成功, -1:失败
 */
extern int isl1208_print_time(void);

#endif /* __ISL1208_H */