你提到的函数： ```c HAL_StatusTypeDef HAL_RTC_SetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format); ``` 是 STM32 HAL 库中用于设置 **实时时钟（RTC）时间** 的关键函数。下面我们详细解释这个函数的作用、参数含义、使用方法，并给出完整示例代码。 --- ## ✅ 函数说明 ### 原型： ```c HAL_StatusTypeDef HAL_RTC_SetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format); ``` ### 功能： 设置 RTC 模块的当前时间（小时、分钟、秒等）。 --- ## 🔹 参数详解 | 参数 | 类型 | 说明 | |------|------|------| | `hrtc` | `RTC_HandleTypeDef*` | 指向 RTC 句柄的指针，包含初始化和状态信息 | | `sTime` | `RTC_TimeTypeDef*` | 指向时间结构体的指针，包含要设置的时间值 | | `Format` | `uint32_t` | 时间格式：`RTC_FORMAT_BIN` 或 `RTC_FORMAT_BCD` | --- ### 📌 `RTC_TimeTypeDef` 结构体定义（常见字段） ```c typedef struct { uint8_t Hours; // 小时: 00-23 (24小时制) uint8_t Minutes; // 分钟: 00-59 uint8_t Seconds; // 秒: 00-59 uint8_t TimeFormat; // AM/PM 标志: RTC_HOURFORMAT12_AM / RTC_HOURFORMAT12_PM （仅12小时制） uint32_t SubSeconds; // 子秒（从 2^32 下数，可选） uint32_t DayLightSaving; // 是否启用夏令时 uint32_t StoreOperation; // 是否存储操作标志 } RTC_TimeTypeDef; ``` > ⚠️ 注意：如果你使用的是 24 小时制，则 `TimeFormat` 字段会被忽略。 --- ### 📌 `Format` 参数选项 | 值 | 含义 | |----|------| | `RTC_FORMAT_BIN` | 二进制格式（建议使用） | | `RTC_FORMAT_BCD` | BCD 编码格式（如：`0x12` 表示 12 点） | > 推荐使用 `RTC_FORMAT_BIN`，因为更直观易用。 --- ## ✅ 使用步骤（完整流程） ### 步骤 1：配置 RTC（通过 CubeMX 或手动初始化） 确保已在 `main.c` 中完成以下工作： - 启用了 RTC 时钟源（LSE、LSI 或 HSE 分频） - 初始化了 `hrtc` 实例（通常由 STM32CubeMX 自动生成） --- ### 步骤 2：调用 `HAL_RTC_SetTime()` 设置时间 #### 示例代码：将时间设为 14:30:25（24小时制） ```c #include "main.h" RTC_TimeTypeDef sTime = {0}; void SetCurrentTime(void) { HAL_StatusTypeDef status; sTime.Hours = 14; // 14:30:25 sTime.Minutes = 30; sTime.Seconds = 25; sTime.TimeFormat = RTC_HOURFORMAT12_AM; // 在24小时制下无效，可忽略 sTime.SubSeconds = 0; sTime.DayLightSaving = RTC_DAYLIGHTSAVING_NONE; sTime.StoreOperation = RTC_STOREOPERATION_RESET; status = HAL_RTC_SetTime(&hrtc, &sTime, RTC_FORMAT_BIN); if (status == HAL_OK) { printf("RTC time set successfully.\n"); } else { printf("Failed to set RTC time!\n"); } } ``` > 💡 提示：你需要先调用 `HAL_RTC_Init()` 初始化 RTC，否则会失败。 --- ## ✅ 完整注意事项与最佳实践 ### ❗ 必须注意的问题： 1. **RTC 时钟源必须已启动** - 如 LSE（外部晶振 32.768kHz）或 LSI（内部低速 RC） - 否则 `HAL_RTC_SetTime` 返回 `HAL_ERROR` 2. **避免频繁调用** - RTC 是低速外设，写入需要时间。 - 连续快速写入可能导致失败。 3. **不要在中断中长时间阻塞** - 虽然 `HAL_RTC_SetTime` 不是中断函数本身，但如果在回调中调用，请确保不会阻塞系统。 4. **校准问题** - 若需高精度时间，应配合外部晶振并进行校准（使用 `HAL_RTCEx_SetSmoothCalib()`） 5. **备份域保护** - 如果 MCU 复位后 RTC 数据丢失，请检查是否启用了备份域供电和 `__HAL_RCC_BKPSRAM_CLK_ENABLE()` --- ## ✅ 如何读取当前时间？ 配套函数： ```c HAL_StatusTypeDef HAL_RTC_GetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format); HAL_StatusTypeDef HAL_RTC_GetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format); ``` #### 示例：获取当前时间 ```c RTC_TimeTypeDef currentTime; RTC_DateTypeDef currentDate; HAL_RTC_GetTime(&hrtc, &currentTime, RTC_FORMAT_BIN); HAL_RTC_GetDate(&hrtc, &currentDate, RTC_FORMAT_BIN); printf("Current time: %02d:%02d:%02d\n", currentTime.Hours, currentTime.Minutes, currentTime.Seconds); ``` --- ## ✅ 常见返回值（`HAL_StatusTypeDef`） | 返回值 | 含义 | |--------|------| | `HAL_OK` | 成功 | | `HAL_ERROR` | 初始化错误或硬件故障 | | `HAL_BUSY` | RTC 正忙（正在执行操作） | | `HAL_TIMEOUT` | 操作超时 | 建议加入错误处理逻辑： ```c if (HAL_RTC_SetTime(&hrtc, &sTime, RTC_FORMAT_BIN) != HAL_OK) { Error_Handler(); // 自定义错误处理 } ``` ---