编码转换: GBK -> UTF-8,所有.c/.h源文件中文注释统一UTF-8编码

This commit is contained in:
wangfq
2026-07-20 09:07:37 +08:00
parent b1637a13be
commit c3a12d5c3a
63 changed files with 2011 additions and 1969 deletions
+46 -46
View File
@@ -15,9 +15,9 @@
/*********************************************************************
* @fn LClk32K_Select
*
* @brief 32K 低频时钟来源
* @brief 32K 低频时钟来源
*
* @param hc - 选择32K使用内部还是外部
* @param hc - 选择32K使用内部还是外部
*
* @return none
*/
@@ -43,10 +43,10 @@ void LClk32K_Select(LClk32KTypeDef hc)
/*********************************************************************
* @fn LClk32K_Cfg
*
* @brief 32K 低频时钟电源配置
* @brief 32K 低频时钟电源配置
*
* @param hc - 选择内部32K还是外部32K
* @param s - 是否打开电源
* @param hc - 选择内部32K还是外部32K
* @param s - 是否打开电源
*
* @return none
*/
@@ -85,7 +85,7 @@ void LClk32K_Cfg(LClk32KTypeDef hc, FunctionalState s)
/*********************************************************************
* @fn HSECFG_Current
*
* @brief HSE晶体 偏置电流配置
* @brief HSE晶体 偏置电流配置
*
* @param c - 75%,100%,125%,150%
*
@@ -106,7 +106,7 @@ void HSECFG_Current(HSECurrentTypeDef c)
/*********************************************************************
* @fn HSECFG_Capacitance
*
* @brief HSE晶体 负载电容配置
* @brief HSE晶体 负载电容配置
*
* @param c - refer to HSECapTypeDef
*
@@ -127,7 +127,7 @@ void HSECFG_Capacitance(HSECapTypeDef c)
/*********************************************************************
* @fn LSECFG_Current
*
* @brief LSE晶体 偏置电流配置
* @brief LSE晶体 偏置电流配置
*
* @param c - 70%,100%,140%,200%
*
@@ -148,7 +148,7 @@ void LSECFG_Current(LSECurrentTypeDef c)
/*********************************************************************
* @fn LSECFG_Capacitance
*
* @brief LSE晶体 负载电容配置
* @brief LSE晶体 负载电容配置
*
* @param c - refer to LSECapTypeDef
*
@@ -169,11 +169,11 @@ void LSECFG_Capacitance(LSECapTypeDef c)
/*********************************************************************
* @fn Calibration_LSI
*
* @brief 校准内部32K时钟
* @brief 校准内部32K时钟
*
* @param cali_Lv - 校准等级选择 Level_32 2.4ms 1000ppm (32M 主频) 1100ppm (60M 主频)
* Level_64 4.4ms 800ppm (32M 主频) 1000ppm (60M 主频)
* Level_128 8.4ms 600ppm (32M 主频) 800ppm (60M 主频)
* @param cali_Lv - 校准等级选择 Level_32 2.4ms 1000ppm (32M 主频) 1100ppm (60M 主频)
* Level_64 4.4ms 800ppm (32M 主频) 1000ppm (60M 主频)
* Level_128 8.4ms 600ppm (32M 主频) 800ppm (60M 主频)
*
* @return none
*/
@@ -197,7 +197,7 @@ void Calibration_LSI(Cali_LevelTypeDef cali_Lv)
while(1)
{
// 粗调
// 粗调
sys_safe_access_enable();
R8_OSC_CAL_CTRL &= ~RB_OSC_CNT_TOTAL;
R8_OSC_CAL_CTRL |= 1;
@@ -217,7 +217,7 @@ void Calibration_LSI(Cali_LevelTypeDef cali_Lv)
sys_safe_access_disable();
}
while(!(R8_OSC_CAL_CTRL & RB_OSC_CNT_HALT)); // 用于丢弃
while(!(R8_OSC_CAL_CTRL & RB_OSC_CNT_HALT)); // 用于丢弃
SYS_DisableAllIrq(&irqv);
sys_safe_access_enable();
@@ -239,7 +239,7 @@ void Calibration_LSI(Cali_LevelTypeDef cali_Lv)
R16_OSC_CAL_CNT |= RB_OSC_CAL_OV_CLR;
SYS_RecoverIrq(irqv);
while(!(R8_OSC_CAL_CTRL & RB_OSC_CNT_HALT));
i = R16_OSC_CAL_CNT; // 实时校准后采样值
i = R16_OSC_CAL_CNT; // 实时校准后采样值
cnt_offset = (i & 0x3FFF) + R8_OSC_CAL_OV_CNT * 0x3FFF - 2000 * (freq_sys / 1000) / CAB_LSIFQ;
if(((cnt_offset > -37 * (freq_sys / 1000) / 60000) && (cnt_offset < 37 * (freq_sys / 1000) / 60000)) || retry > 2)
{
@@ -253,8 +253,8 @@ void Calibration_LSI(Cali_LevelTypeDef cali_Lv)
sys_safe_access_disable();
}
// 细调
// 配置细调参数后,丢弃2次捕获值(软件行为)上判断已有一次,这里只留一次
// 细调
// 配置细调参数后,丢弃2次捕获值(软件行为)上判断已有一次,这里只留一次
sys_safe_access_enable();
R8_OSC_CAL_CTRL &= ~RB_OSC_CNT_TOTAL;
R8_OSC_CAL_CTRL |= cali_Lv;
@@ -279,7 +279,7 @@ void Calibration_LSI(Cali_LevelTypeDef cali_Lv)
sys_safe_access_disable();
}
while(!(R8_OSC_CAL_CTRL & RB_OSC_CNT_HALT)); // 用于丢弃
while(!(R8_OSC_CAL_CTRL & RB_OSC_CNT_HALT)); // 用于丢弃
SYS_DisableAllIrq(&irqv);
sys_safe_access_enable();
@@ -304,7 +304,7 @@ void Calibration_LSI(Cali_LevelTypeDef cali_Lv)
sys_safe_access_enable();
R8_OSC_CAL_CTRL &= ~RB_OSC_CNT_EN;
sys_safe_access_disable();
i = R16_OSC_CAL_CNT; // 实时校准后采样值
i = R16_OSC_CAL_CNT; // 实时校准后采样值
cnt_offset = (i & 0x3FFF) + R8_OSC_CAL_OV_CNT * 0x3FFF - 4000 * (1 << cali_Lv) * (freq_sys / 1000000) / 256 * 1000/(CAB_LSIFQ/256);
cnt_offset = (cnt_offset > 0) ? ((((cnt_offset * 2*(100 )) / (1366 * ((1 << cali_Lv)/8) * (freq_sys/1000) / 60000)) + 1) / 2) : ((((cnt_offset * 2*(100)) / (1366 * ((1 << cali_Lv)/8) * (freq_sys/1000) / 60000)) - 1) / 2);
if((cnt_offset > 0)&&(((R16_INT32K_TUNE>>5)+cnt_offset)>0xFF))
@@ -354,14 +354,14 @@ void Calibration_LSI(Cali_LevelTypeDef cali_Lv)
/*********************************************************************
* @fn RTCInitTime
*
* @brief RTC时钟初始化当前时间
* @brief RTC时钟初始化当前时间
*
* @param y - 配置年,MAX_Y = BEGYEAR + 44
* @param mon - 配置月,MAX_MON = 12
* @param d - 配置日,MAX_D = 31
* @param h - 配置小时,MAX_H = 23
* @param m - 配置分钟,MAX_M = 59
* @param s - 配置秒,MAX_S = 59
* @param y - 配置年,MAX_Y = BEGYEAR + 44
* @param mon - 配置月,MAX_MON = 12
* @param d - 配置日,MAX_D = 31
* @param h - 配置小时,MAX_H = 23
* @param m - 配置分钟,MAX_M = 59
* @param s - 配置秒,MAX_S = 59
*
* @return none
*/
@@ -420,14 +420,14 @@ void RTC_InitTime(uint16_t y, uint16_t mon, uint16_t d, uint16_t h, uint16_t m,
/*********************************************************************
* @fn RTC_GetTime
*
* @brief 获取当前时间
* @brief 获取当前时间
*
* @param py - 获取到的年,MAX_Y = BEGYEAR + 44
* @param pmon - 获取到的月,MAX_MON = 12
* @param pd - 获取到的日,MAX_D = 31
* @param ph - 获取到的小时,MAX_H = 23
* @param pm - 获取到的分钟,MAX_M = 59
* @param ps - 获取到的秒,MAX_S = 59
* @param py - 获取到的年,MAX_Y = BEGYEAR + 44
* @param pmon - 获取到的月,MAX_MON = 12
* @param pd - 获取到的日,MAX_D = 31
* @param ph - 获取到的小时,MAX_H = 23
* @param pm - 获取到的分钟,MAX_M = 59
* @param ps - 获取到的秒,MAX_S = 59
*
* @return none
*/
@@ -465,9 +465,9 @@ void RTC_GetTime(uint16_t *py, uint16_t *pmon, uint16_t *pd, uint16_t *ph, uint1
/*********************************************************************
* @fn RTC_SetCycle32k
*
* @brief 基于LSE/LSI时钟,配置当前RTC 周期数
* @brief 基于LSE/LSI时钟,配置当前RTC 周期数
*
* @param cyc - 配置周期计数初值,MAX_CYC = 0xA8BFFFFF = 2831155199
* @param cyc - 配置周期计数初值,MAX_CYC = 0xA8BFFFFF = 2831155199
*
* @return none
*/
@@ -489,11 +489,11 @@ void RTC_SetCycle32k(uint32_t cyc)
/*********************************************************************
* @fn RTC_GetCycle32k
*
* @brief 基于LSE/LSI时钟,获取当前RTC 周期数
* @brief 基于LSE/LSI时钟,获取当前RTC 周期数
*
* @param none
*
* @return 当前周期数,MAX_CYC = 0xA8BFFFFF = 2831155199
* @return 当前周期数,MAX_CYC = 0xA8BFFFFF = 2831155199
*/
__HIGH_CODE
uint32_t RTC_GetCycle32k(void)
@@ -510,7 +510,7 @@ uint32_t RTC_GetCycle32k(void)
/*********************************************************************
* @fn RTC_TMRFunCfg
*
* @brief RTC定时模式配置(注意定时基准固定为32768Hz)
* @brief RTC定时模式配置(注意定时基准固定为32768Hz)
*
* @param t - refer to RTC_TMRCycTypeDef
*
@@ -529,9 +529,9 @@ void RTC_TMRFunCfg(RTC_TMRCycTypeDef t)
/*********************************************************************
* @fn RTC_TRIGFunCfg
*
* @brief RTC时间触发模式配置
* @brief RTC时间触发模式配置
*
* @param cyc - 相对当前时间的触发间隔时间,基于LSE/LSI时钟周期数
* @param cyc - 相对当前时间的触发间隔时间,基于LSE/LSI时钟周期数
*
* @return none
*/
@@ -554,9 +554,9 @@ void RTC_TRIGFunCfg(uint32_t cyc)
/*********************************************************************
* @fn RTC_ModeFunDisable
*
* @brief RTC 模式功能关闭
* @brief RTC 模式功能关闭
*
* @param m - 需要关闭的当前模式
* @param m - 需要关闭的当前模式
*
* @return none
*/
@@ -581,11 +581,11 @@ void RTC_ModeFunDisable(RTC_MODETypeDef m)
/*********************************************************************
* @fn RTC_GetITFlag
*
* @brief 获取RTC中断标志
* @brief 获取RTC中断标志
*
* @param f - refer to RTC_EVENTTypeDef
*
* @return 中断标志状态
* @return 中断标志状态
*/
uint8_t RTC_GetITFlag(RTC_EVENTTypeDef f)
{
@@ -602,7 +602,7 @@ uint8_t RTC_GetITFlag(RTC_EVENTTypeDef f)
/*********************************************************************
* @fn RTC_ClearITFlag
*
* @brief 清除RTC中断标志
* @brief 清除RTC中断标志
*
* @param f - refer to RTC_EVENTTypeDef
*