一、简介
实时时钟的缩写是RTC(Real_Time Clock)。RTC 是集成电路，通常称为时钟芯片。
实时时钟芯片是日常生活中应用最为广泛的消费类电子产品之一。它为人们提供精确的实时时间，或者为电子系统提供精确的时间基准，目前实时时钟芯片大多采用精度较高的晶体振荡器作为时钟源。有些时钟芯片为了在主电源掉电时，还可以工作，需要外加电池供电。
二、修改配置文件
如在 ble5_simple_peripheral_cc2640r2lp_app/TOOLS/src/app_ble.cfg
添加以下两行：
var Seconds = xdc.useModule('ti.sysbios.hal.Seconds');
var SecondsProxy = xdc.useModule('ti.sysbios.hal.SecondsClock');
三、移植文件
链接：https://pan.baidu.com/s/1egd_3o6sImBc6uFaYcAvNw 提取码：p4qy
将 board_rtc.c 、 board_rtc.h 两个文件拖拽至CCS工程的Application文件夹下
3.1 board_rtc.c
/*********************************************************************
* INCLUDES
*/
#include "_hal_types.h"
#include <time.h>
#include <ti/sysbios/hal/Seconds.h>
#include "board_rtc.h"
/*********************************************************************
* PUBLIC FUNCTIONS
*/
/**
@brief 设置RTC时间
@param timeNow -[in] 当前时间
@return 无
*/
void RTC_SetTime(uint32 timeNow)
{
Seconds_set(timeNow);
}
/**
@brief 获取RTC时间
@param 无
@return 当前时间
*/
uint32 RTC_GetTime(void)
{
return Seconds_get();
}
3.2 board_rtc.h
#ifndef _BOARD_RTC_H_
#define _BOARD_RTC_H_
/*********************************************************************
* INCLUDES
*/
#include "_hal_types.h"
/*********************************************************************
* API FUNCTIONS
*/
void RTC_SetTime(uint32 timeNow);
uint32 RTC_GetTime(void);
#endif /* _BOARD_RTC_H_ */
四、API调用
需包含头文件 board_rtc.h
RTC_SetTime
| 功能 | 设置RTC时间 |
|---|---|
| 函数定义 | void RTC_SetTime(uint32 timeNow) |
| 参数 | timeNow：当前时间（Unix时间戳） |
| 返回 | 无 |
RTC_GetTime
| 功能 | 获取RTC时间 |
|---|---|
| 函数定义 | uint32 RTC_GetTime(void) |
| 参数 | 无 |
| 返回 | 当前时间（Unix时间戳） |
五、使用例子
1）添加头文件（例 simple_peripheral.c 中）
#include "board_rtc.h"
2）添加设置时间函数（simple_peripheral.c 的 SimplePeripheral_processGapMessage 函数 GAP_DEVICE_INIT_DONE_EVENT设备初始化完成事件中）
static void SimplePeripheral_processGapMessage(gapEventHdr_t *pMsg)
{
switch(pMsg->opcode)
{
/*================================== 设备初始化完成事件 ==================================*/
case GAP_DEVICE_INIT_DONE_EVENT:
{
uint32 timeNow = 1412800000; /* Wed, 08 Oct 2014 20:26:40 GMT */
RTC_SetTime(timeNow);
}
}
3）获取当前时间
/* Use overridden time() function to get the current time.
* Use standard C RTS library functions with return from time().
* Assumes Seconds_set() has been called as above */
time_t t1 = time(NULL);
struct tm *ltm = localtime(&t1);
char *curTime = asctime(ltm);
System_printf("Time(GMT): %s\n", curTime);
4）tm时间结构体
struct tm
{
int tm_sec; /* seconds after the minute - [0,59] */
int tm_min; /* minutes after the hour - [0,59] */
int tm_hour; /* hours after the midnight - [0,23] */
int tm_mday; /* day of the month - [1,31] */
int tm_mon; /* months since January - [0,11] */
int tm_year; /* years since 1900 */
int tm_wday; /* days since Sunday - [0,6] */
int tm_yday; /* days since Jan 1st - [0,365] */
int tm_isdst; /* Daylight Savings Time flag */
};
• 由 Leung 写于 2019 年 11 月 8 日
• 参考：TI-RTOS Kernel (SYS/BIOS) User's Guide - 5.4Seconds Module
