RTC(real-time clock)为操作系统中的实时时钟设备，为操作系统提供精准的实时时间和定时报警功能。当设备下电后，通过外置电池供电，RTC继续记录操作系统时间;设备上电后，RTC提供实时时钟给操作系统，确保断电后系统时间的连续性。但是BL602芯片没有内置RTC模块，也没有提供外置电池供电，但是提供的软件RTC功能可以在带电情况下使用。
本文将详细介绍如何使用Ai-WB2的bl_iot_sdk中的RTC模块。
一：RTC介绍
BL602芯片没有内置RTC模块，但是 b1_iot_sdk 提供了软件RTC功能。RTC支持两种计时模式：DEC模式和BCDQ模式。
RTC模块的HOSAL层APl在 components/platform/hosal/include/hosal_rtc.h 中定义。常用的API如下：
· int hosal_rtc_init(hosal_rtc_dev_t *rtc)：初始化RTC设备。参数说明如下：
· rtc：RTC设备实例。其定义如下：
- typedef struct {
- uint8_t port; /**< rtc port */
- hosal_rtc_config_t config; /**< rtc config */
- void *priv; /**< priv data */
- } hosal_rtc_dev_t;
- #define HOSAL_RTC_FORMAT_DEC 1 /**< RTC DEC format */
- #define HOSAL_RTC_FORMAT_BCD 2 /**< RTC BCD format */
- typedef struct {
- uint8_t format; /**< time formart DEC or BCD */
- } hosal_rtc_config_t;
· int hosal_rtc_set_time(hosal_rtc_dev_t *rtc, const hosal_rtc_time_t *time):设置RTC日期时间。参数说明如下：
· rtc：RTC设备
· time：需要设置的时间。其定义如下：
- /**
- * @brief RTC time struct
- */
- typedef struct {
- uint8_t sec; /**< DEC format:value range from 0 to 59, BCD format:value range from 0x00 to 0x59 */
- uint8_t min; /**< DEC format:value range from 0 to 59, BCD format:value range from 0x00 to 0x59 */
- uint8_t hr; /**< DEC format:value range from 0 to 23, BCD format:value range from 0x00 to 0x23 */
- uint8_t date; /**< DEC format:value range from 1 to 31, BCD format:value range from 0x01 to 0x31 */
- uint8_t month; /**< DEC format:value range from 1 to 12, BCD format:value range from 0x01 to 0x12 */
- uint16_t year; /**< DEC format:value range from 0 to 9999, BCD format:value range from 0x0000 to 0x9999 */
- } hosal_rtc_time_t;
· int hosal_rtc_get_time(hosal_rtc_dev_t *rtc, hosal_rtc_time_t *time)：查询当前时间。参数说明如下：
· rtc：RTC设备
· time：需要设置的时间
· 返回值：当调用成功时，返回0；否则返回非零值。
· int hosal_rtc_set_count(hosal_rtc_dev_t *rtc,uint64_t *time_stamp)：设置RTC新的计数值。参数说明如下：
· rtc：RTC设备
· time stamp：需要设置的时间
· 返回值：当调用成功时，返回0；否则返回非零值。
· int hosal_rtc_get_count(hosal_rtc_dev_t *rtc,uint64_t*time_stamp)：获取当前RTC的时间计数值。参数说明如下：
· rtc：RTC设备
· time stamp：返回当前的时间计数值
· 返回值：当调用成功时，返回0；否则返回非零值。
· int hosal_rtc_finalize(hosal_rtc_dev_t *rtc)：销毁当前RTC设备实例，释放相关资源。参数说明如下：
· rtc：RTC设备
· 返回值：当调用成功时，返回0；否则返回非零值。
二：RTC使用实例
- #include <stdio.h>
- #include <string.h>
- #include <FreeRTOS.h>
- #include <task.h>
- #include <stdio.h>
- #include <stdbool.h>
- #include <hosal_rtc.h>
- #include <blog.h>
- #define TAG "rtc_demo"
- static hosal_rtc_dev_t rtc;
- bool rtc_demo_init(void) {
- int ret1 = -1;
- /* init rtc DEC format*/
- hosal_rtc_dev_t rtc;
- rtc.port = 0;
- rtc.config.format = HOSAL_RTC_FORMAT_DEC;
- hosal_rtc_init(&rtc);
- /* set rtc time */
- hosal_rtc_time_t time_buf;
- time_buf.sec = 10;
- time_buf.min = 56;
- time_buf.hr = 10;
- time_buf.date = 26;
- time_buf.month = 4;
- time_buf.year = 23;
- ret1 = hosal_rtc_set_time(&rtc, &time_buf);
- if (ret1 == 0) {
- printf("set time sec = %d\r\n", time_buf.sec);
- printf("set time min = %d\r\n", time_buf.min);
- printf("set time hr = %d\r\n", time_buf.hr);
- printf("set time date = %d\r\n", time_buf.date);
- printf("set time month = %d\r\n", time_buf.month);
- printf("set time year = %d\r\n", time_buf.year + 2000);
- }
- return (ret1 == 0);
- }
- void rtc_task(void* params) {
- printf("rtc task started\r\n");
- bool ret = rtc_demo_init();
- hosal_rtc_time_t time_buf;
- if (!ret) {
- printf("rtc init failed\r\n");
- while (true) {
- vTaskDelay(1);
- }
- }
- printf("rtc task started\r\n");
- while (true) {
- memset(&time_buf, 0, sizeof(hosal_rtc_time_t));
- ret = hosal_rtc_get_time(&rtc, &time_buf);
- if(ret == 0){
- printf("set time sec = %d\r\n", time_buf.sec);
- printf("set time min = %d\r\n", time_buf.min);
- printf("set time hr = %d\r\n", time_buf.hr);
- printf("set time date = %d\r\n", time_buf.date);
- printf("set time month = %d\r\n", time_buf.month);
- printf("set time year = %d\r\n", time_buf.year + 2000);
- }
- vTaskDelay(1000 / portTICK_PERIOD_MS);
- }
- }
- void main(void) {
- printf("rtc demo inited\r\n");
- xTaskCreate(rtc_task, "rtc_task", 1024, NULL, 15, NULL);
- }
|
