如何在STM32F103中正确使用正点原子提供的RTC库函数？

在STM32F103系列单片机上使用正点原子(RTC)库函数，你需要按照以下步骤操作：

1. **包含头文件**：首先在你的.c文件中包含RTC相关的头文件，如`rtctime.h`或`stm32f1xx_rtc.h`。

#include "rtctime.h"

2. **初始化RTC**：在程序开始时，通常需要对RTC进行初始化，这通常发生在系统启动或配置阶段。例如，通过HAL库你可以这样做：

RTC_HandleTypeDef hrtc;
RCC_OscInitTypeDef RCC_OscInitStruct;
RTC_InitTypeDef RTC_InitStructure;

// 初始化时钟源
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_LSE;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE; // 如果不需要外部时钟
HAL_RCC_OscConfig(&RCC_OscInitStruct);
HAL_RCC_ClockConfig(&RCC_OscInitTypeDef_Reload_HSE_Div1, FLASH_LATENCY_5);

// 初始化RTC
RTC_InitStructure.RTCSynchroMode = RTC_SYNCHRONOUS_MODE;
RTC_InitStructure.HoursFormat = RTC_HOUR_FORMAT_24;
RTC_InitStructure.AsynchPrediv = 127; // 根据手册设置预分频值
RTC_InitStructure.SynchPrediv = 2; // 根据手册设置同步预分频值
RTC_InitStructure.DateWeekDaySel = RTC_DATEWEEKDAYSel_Saturday;
HAL_RTC_Init(&hrtc);

3. **设置时间和日期**：使用`HAL_RTC_SetCounter()`、`HAL_RTC_SetDate()` 和 `HAL_RTC_SetTime()` 函数设置RTC的时间和日期。

HAL_RTC_SetCounter(&hrtc, (uint32_t)your_current_time); // 设置当前时间
HAL_RTC_SetDate(&hrtc, your_year, your_month, your_day);

4. **读取和获取时间**：当你需要读取RTC时间时，可以使用`HAL_RTC_GetCounter()`、`HAL_RTC_GetDate()` 和 `HAL_RTC_GetTime()` 获取。

(uint32_t)current_time = HAL_RTC_GetCounter(&hrtc);

5. **启用中断或定时器功能**：如果你需要利用RTC的闹钟或其他定时功能，记得配置相应的中断或事件处理程序。

6. **定期刷新时间**：如果需要保持时间准确，可以在应用程序周期性地调用`HAL_RTCEx_WakeUpTimer_ITConfig()` 或 `HAL_RTCEx_SoftwareWakeUpTimer()` 来更新时间。