1 changed files with 362 additions and 0 deletions
@ -0,0 +1,362 @@ |
|||
/**
|
|||
* @file drv_rtc_ds1307.c |
|||
* @brief DS1307 RTC driver for RT-Thread |
|||
* @author jiache (wanghuan3037@fiberhome.com) |
|||
* @version 1.1 |
|||
* @date 2025-12-13 |
|||
* |
|||
* Notes: |
|||
* - DS1307 requires 5V for reliable operation (not just 3.3V or backup battery). |
|||
* - Ensure I2C pull-up resistors are present. |
|||
* |
|||
* Kconfig usage (add to board/Kconfig): |
|||
* config BRD_RTC_DS1307 |
|||
* bool "Enable rtc ds1307" |
|||
* default n |
|||
* if BRD_RTC_DS1307 |
|||
* config DS1307_IIC_BUS |
|||
* string "Select I2C bus" |
|||
* default "i2c2" |
|||
* config BRD_RTC_DS1307_DEBUG |
|||
* bool "Enable DS1307 debug log" |
|||
* default n |
|||
* endif |
|||
*/ |
|||
|
|||
#include "board.h" |
|||
#include <rtdevice.h> |
|||
#include <rtthread.h> |
|||
#include <sys/time.h> |
|||
|
|||
|
|||
#define DBG_TAG "DS1307" |
|||
#ifdef BRD_RTC_DS1307_DEBUG |
|||
#define DBG_LVL DBG_LOG |
|||
#else |
|||
#define DBG_LVL DBG_INFO |
|||
#endif |
|||
#include <rtdbg.h> |
|||
|
|||
/* DS1307 I2C 7-bit address */ |
|||
#define DS1307_ADDR 0x68 |
|||
|
|||
/* Driver structure */ |
|||
typedef struct drv_rtc_ds1307 |
|||
{ |
|||
struct rt_i2c_bus_device *i2c_bus; |
|||
char *iic_name; |
|||
struct tm datetime; |
|||
struct timeval tick; |
|||
rt_thread_t thd_soft_update_sec; |
|||
} drv_rtc_ds1307_t; |
|||
|
|||
/* Default I2C bus name from Kconfig or hardcoded */ |
|||
#ifndef DS1307_IIC_BUS |
|||
#define DS1307_IIC_BUS "i2c2" |
|||
#endif |
|||
|
|||
static drv_rtc_ds1307_t ds1307 = { |
|||
.iic_name = DS1307_IIC_BUS, |
|||
}; |
|||
|
|||
/* Write multiple registers starting at reg */ |
|||
static rt_err_t write_reg(struct rt_i2c_bus_device *bus, rt_uint8_t reg, const rt_uint8_t *data, rt_size_t len) |
|||
{ |
|||
rt_uint8_t buf[16]; |
|||
if (len + 1 > sizeof(buf)) return -RT_EINVAL; |
|||
|
|||
buf[0] = reg; |
|||
rt_memcpy(&buf[1], data, len); |
|||
|
|||
struct rt_i2c_msg msg; |
|||
msg.addr = DS1307_ADDR; |
|||
msg.flags = RT_I2C_WR; |
|||
msg.buf = buf; |
|||
msg.len = len + 1; |
|||
|
|||
return (rt_i2c_transfer(bus, &msg, 1) == 1) ? RT_EOK : -RT_ERROR; |
|||
} |
|||
|
|||
/* Read multiple registers starting at reg */ |
|||
static rt_err_t read_regs(struct rt_i2c_bus_device *bus, rt_uint8_t reg, rt_uint8_t len, rt_uint8_t *buf) |
|||
{ |
|||
struct rt_i2c_msg msgs[2]; |
|||
msgs[0].addr = DS1307_ADDR; |
|||
msgs[0].flags = RT_I2C_WR; |
|||
msgs[0].buf = ® |
|||
msgs[0].len = 1; |
|||
|
|||
msgs[1].addr = DS1307_ADDR; |
|||
msgs[1].flags = RT_I2C_RD; |
|||
msgs[1].buf = buf; |
|||
msgs[1].len = len; |
|||
|
|||
return (rt_i2c_transfer(bus, msgs, 2) == 2) ? RT_EOK : -RT_ERROR; |
|||
} |
|||
|
|||
/* Read current time from DS1307 */ |
|||
static void ds1307_read_time(void) |
|||
{ |
|||
uint8_t buff[7]; |
|||
RT_ASSERT(ds1307.i2c_bus); |
|||
|
|||
if (read_regs(ds1307.i2c_bus, 0x00, 7, buff) != RT_EOK) |
|||
{ |
|||
LOG_E("Failed to read DS1307 registers"); |
|||
return; |
|||
} |
|||
|
|||
// BCD to decimal
|
|||
ds1307.datetime.tm_sec = (buff[0] & 0x7F); // mask CH bit
|
|||
ds1307.datetime.tm_sec = (ds1307.datetime.tm_sec >> 4) * 10 + (ds1307.datetime.tm_sec & 0x0F); |
|||
|
|||
ds1307.datetime.tm_min = (buff[1] >> 4) * 10 + (buff[1] & 0x0F); |
|||
ds1307.datetime.tm_hour = (buff[2] >> 4) * 10 + (buff[2] & 0x0F); |
|||
ds1307.datetime.tm_wday = (buff[3] & 0x07) - 1; // DS1307: 1=Sun → tm_wday: 0=Sun
|
|||
ds1307.datetime.tm_mday = (buff[4] >> 4) * 10 + (buff[4] & 0x0F); |
|||
ds1307.datetime.tm_mon = (buff[5] >> 4) * 10 + (buff[5] & 0x0F) - 1; // 0-based
|
|||
ds1307.datetime.tm_year = (buff[6] >> 4) * 10 + (buff[6] & 0x0F) + 100; // years since 1900
|
|||
|
|||
// Optional: update tick if libc is available
|
|||
#ifdef RT_USING_LIBC |
|||
ds1307.tick.tv_sec = mktime(&ds1307.datetime); |
|||
ds1307.tick.tv_usec = 0; |
|||
#endif |
|||
|
|||
LOG_I("RTC: %d-%02d-%02d %02d:%02d:%02d", |
|||
ds1307.datetime.tm_year + 1900, |
|||
ds1307.datetime.tm_mon + 1, |
|||
ds1307.datetime.tm_mday, |
|||
ds1307.datetime.tm_hour, |
|||
ds1307.datetime.tm_min, |
|||
ds1307.datetime.tm_sec); |
|||
|
|||
/* 设置日期为年月号 */ |
|||
set_date(ds1307.datetime.tm_year + 1900, ds1307.datetime.tm_mon + 1, ds1307.datetime.tm_mday); |
|||
/* 设置时间为点分秒 */ |
|||
set_time(ds1307.datetime.tm_hour, ds1307.datetime.tm_min, ds1307.datetime.tm_sec); |
|||
/* 获取时间 */ |
|||
time_t now = time(RT_NULL); |
|||
/* 打印输出时间信息 */ |
|||
rt_kprintf("DATE: %s", ctime(&now)); |
|||
} |
|||
|
|||
/* Software thread to maintain local time estimation */ |
|||
static void auto_update_current_datatime(void *parameter) |
|||
{ |
|||
uint32_t count = 0; |
|||
while (1) |
|||
{ |
|||
rt_thread_delay(RT_TICK_PER_SECOND); |
|||
ds1307.datetime.tm_sec++; |
|||
if (ds1307.datetime.tm_sec >= 60) |
|||
{ |
|||
ds1307.datetime.tm_sec = 0; |
|||
ds1307.datetime.tm_min++; |
|||
if (ds1307.datetime.tm_min >= 60) |
|||
{ |
|||
ds1307.datetime.tm_min = 0; |
|||
ds1307.datetime.tm_hour++; |
|||
if (ds1307.datetime.tm_hour >= 24) |
|||
{ |
|||
ds1307.datetime.tm_hour = 0; |
|||
// Note: day/month/year rollover not handled in soft update
|
|||
} |
|||
} |
|||
} |
|||
|
|||
// Sync with hardware every 10 minutes
|
|||
if (++count >= 600) // 600 seconds
|
|||
{ |
|||
ds1307_read_time(); |
|||
count = 0; |
|||
} |
|||
} |
|||
} |
|||
|
|||
/* Directly write struct tm to DS1307 (no time_t dependency) */ |
|||
static rt_err_t ds1307_write_tm(struct tm *tm) |
|||
{ |
|||
uint8_t buff[7]; |
|||
|
|||
// Seconds (bit7 = CH must be 0 to enable oscillator)
|
|||
buff[0] = ((tm->tm_sec / 10) << 4) | (tm->tm_sec % 10); |
|||
|
|||
// Minutes
|
|||
buff[1] = ((tm->tm_min / 10) << 4) | (tm->tm_min % 10); |
|||
|
|||
// Hours (24-hour mode, bit6=0)
|
|||
buff[2] = ((tm->tm_hour / 10) << 4) | (tm->tm_hour % 10); |
|||
|
|||
// Day of week: DS1307 uses 1=Sun, 2=Mon ... 7=Sat
|
|||
// tm_wday: 0=Sun, 1=Mon ... 6=Sat → so +1
|
|||
buff[3] = tm->tm_wday + 1; |
|||
|
|||
// Date
|
|||
buff[4] = ((tm->tm_mday / 10) << 4) | (tm->tm_mday % 10); |
|||
|
|||
// Month
|
|||
int month = tm->tm_mon + 1; // convert to 1-based
|
|||
buff[5] = ((month / 10) << 4) | (month % 10); |
|||
|
|||
// Year (last two digits only)
|
|||
int year = tm->tm_year + 1900; // full year
|
|||
buff[6] = (((year % 100) / 10) << 4) | (year % 10); |
|||
|
|||
rt_err_t err = write_reg(ds1307.i2c_bus, 0x00, buff, 7); |
|||
if (err == RT_EOK) |
|||
{ |
|||
ds1307.datetime = *tm; |
|||
#ifdef RT_USING_LIBC |
|||
ds1307.tick.tv_sec = mktime(tm); |
|||
ds1307.tick.tv_usec = 0; |
|||
#endif |
|||
} |
|||
return err; |
|||
} |
|||
|
|||
/* RTC ops */ |
|||
static rt_err_t ds1307_rtc_init(void) |
|||
{ |
|||
return RT_EOK; |
|||
} |
|||
|
|||
static rt_err_t ds1307_rtc_get_secs(time_t *sec) |
|||
{ |
|||
ds1307_read_time(); |
|||
#ifdef RT_USING_LIBC |
|||
*sec = ds1307.tick.tv_sec; |
|||
#else |
|||
*sec = 0; // fallback
|
|||
#endif |
|||
return RT_EOK; |
|||
} |
|||
|
|||
static rt_err_t ds1307_rtc_set_secs(time_t *sec) |
|||
{ |
|||
#ifdef RT_USING_LIBC |
|||
struct tm tm_time; |
|||
localtime_r(sec, &tm_time); |
|||
return ds1307_write_tm(&tm_time); |
|||
#else |
|||
LOG_E("Set by timestamp requires RT_USING_LIBC"); |
|||
return -RT_ERROR; |
|||
#endif |
|||
} |
|||
|
|||
static rt_err_t ds1307_rtc_get_timeval(struct timeval *tv) |
|||
{ |
|||
ds1307_read_time(); |
|||
*tv = ds1307.tick; |
|||
return RT_EOK; |
|||
} |
|||
|
|||
static rt_err_t ds1307_rtc_set_timeval(struct timeval *tv) |
|||
{ |
|||
#ifdef RT_USING_LIBC |
|||
struct tm tm_time; |
|||
localtime_r(&tv->tv_sec, &tm_time); |
|||
return ds1307_write_tm(&tm_time); |
|||
#else |
|||
LOG_E("Set by timeval requires RT_USING_LIBC"); |
|||
return -RT_ERROR; |
|||
#endif |
|||
} |
|||
|
|||
static const struct rt_rtc_ops ds1307_rtc_ops = |
|||
{ |
|||
ds1307_rtc_init, |
|||
ds1307_rtc_get_secs, |
|||
ds1307_rtc_set_secs, |
|||
RT_NULL, |
|||
RT_NULL, |
|||
ds1307_rtc_get_timeval, |
|||
ds1307_rtc_set_timeval, |
|||
}; |
|||
|
|||
static rt_rtc_dev_t ds1307_rtc_dev; |
|||
|
|||
/* Initialization and registration */ |
|||
static int rt_hw_ds1307_rtc_init(void) |
|||
{ |
|||
ds1307.i2c_bus = (struct rt_i2c_bus_device *)rt_device_find(ds1307.iic_name); |
|||
if (!ds1307.i2c_bus) |
|||
{ |
|||
LOG_E("I2C bus '%s' not found", ds1307.iic_name); |
|||
return -RT_ERROR; |
|||
} |
|||
|
|||
ds1307_read_time(); |
|||
|
|||
ds1307.thd_soft_update_sec = rt_thread_create("ds1307", |
|||
auto_update_current_datatime, |
|||
RT_NULL, |
|||
512, 10, 5); |
|||
if (ds1307.thd_soft_update_sec) |
|||
{ |
|||
rt_thread_startup(ds1307.thd_soft_update_sec); |
|||
} |
|||
|
|||
rt_err_t result = rt_hw_rtc_register(&ds1307_rtc_dev, "ds1307", RT_DEVICE_FLAG_RDWR, &ds1307); |
|||
if (result != RT_EOK) |
|||
{ |
|||
LOG_E("RTC register failed: %d", result); |
|||
return result; |
|||
} |
|||
|
|||
LOG_I("DS1307 RTC initialized successfully on %s", ds1307.iic_name); |
|||
return RT_EOK; |
|||
} |
|||
INIT_COMPONENT_EXPORT(rt_hw_ds1307_rtc_init); |
|||
|
|||
/* MSH Commands */ |
|||
#include <stdlib.h> |
|||
|
|||
int date_drv_set(int argc, char *argv[]) |
|||
{ |
|||
if (argc != 7) |
|||
{ |
|||
rt_kprintf("Usage: ds1307_set_time YYYY MM DD HH MM SS\n"); |
|||
rt_kprintf("Example: ds1307_set_time 2025 12 25 10 30 00\n"); |
|||
return -1; |
|||
} |
|||
|
|||
struct tm tm_time = {0}; |
|||
tm_time.tm_year = atoi(argv[1]) - 1900; |
|||
tm_time.tm_mon = atoi(argv[2]) - 1; |
|||
tm_time.tm_mday = atoi(argv[3]); |
|||
tm_time.tm_hour = atoi(argv[4]); |
|||
tm_time.tm_min = atoi(argv[5]); |
|||
tm_time.tm_sec = atoi(argv[6]); |
|||
|
|||
// Basic validation
|
|||
if (tm_time.tm_year < 100 || tm_time.tm_year > 200 || |
|||
tm_time.tm_mon < 0 || tm_time.tm_mon > 11 || |
|||
tm_time.tm_mday < 1 || tm_time.tm_mday > 31 || |
|||
tm_time.tm_hour < 0 || tm_time.tm_hour > 23 || |
|||
tm_time.tm_min < 0 || tm_time.tm_min > 59 || |
|||
tm_time.tm_sec < 0 || tm_time.tm_sec > 59) |
|||
{ |
|||
rt_kprintf("Error: Invalid date/time range!\n"); |
|||
return -1; |
|||
} |
|||
|
|||
rt_err_t err = ds1307_write_tm(&tm_time); |
|||
if (err != RT_EOK) |
|||
{ |
|||
rt_kprintf("Error: Failed to write DS1307!\n"); |
|||
return -1; |
|||
} |
|||
|
|||
rt_kprintf("Success: DS1307 time set.\n"); |
|||
return 0; |
|||
} |
|||
MSH_CMD_EXPORT(date_drv_set, Set DS1307 RTC time: YYYY MM DD HH MM SS); |
|||
|
|||
void date_drv(void) |
|||
{ |
|||
ds1307_read_time(); |
|||
} |
|||
MSH_CMD_EXPORT(date_drv, Read DS1307 RTC time); |
|||
|
|||
/* BRD_RTC_DS1307 */ |
|||
Loading…
Reference in new issue