3、STM32F1系列HAL库 源码注释汉化 stm32f1xx_hal_gpio_ex.c & .h

本想着直接打包上传到CSDN，可现在资源审核好严格，直接给毙了。

随便贴点代码水水。到发文时为止，已汉化内容：

HAL库驱动头文件（hal.h文件，48个）
HAL库驱动文件（hal.c 文件，42个）
外设访问层头文件（stm32f1xxx.h 寄存器宏定义文件，15个）
工具链向量表（.s文件，43个）
LL库（正在进行）
...
 本汉化只对库中注释进行汉化，所有原版校对完成的文件，实际代码均与官方原库一致 使用方法按官方库即可。（除部分原版代码报错的调整，修改条目见：使用说明）

源库文件来自ST官网：

版本：V1.8.0 + V1.8.5更新补丁（2023/10/7（官方更新记录2023/4/7））

长期下载链接（更新地址）：

STM32F1汉化版HAL库https://10heart.lanzouj.com/s/stm32f1-cnstm32f1xx_hal_gpio_ex.c & stm32f1xx_hal_gpio_ex.h 源码注释汉化版

/**
  ******************************************************************************
  * @file    stm32f1xx_hal_gpio_ex.c
  * @author  MCD Application Team
  * @brief   HAL库 GPIO扩展模块驱动
  *          本文件提供了管理通用输入/输出（GPIO）扩展外设的以下功能的固件函数。
  *           + 扩展功能函数
  *
  ******************************************************************************
  * @attention
  *
  * 版权所有 (c) 2016 STMicroelectronics。
  * 保留所有权利。
  *
  * 本软件根据可以在此软件组件的根目录中找到的 LICENSE 文件中的条款进行许可。
  * 如果此软件没有附带 LICENSE 文件，则按原样提供。
  *
  ******************************************************************************
  @verbatim
  ==============================================================================
                    ##### GPIO 外设扩展特性 #####
  ==============================================================================
  [..] STM32F1系列的GPIO模块，管理着AFIO寄存器：
       (+) 可以使用 EVENTOUT Cortex 功能

                     ##### 如何使用驱动 #####
  ==============================================================================
  [..] 此驱动程序提供了使用 EVENTOUT Cortex 功能的函数。
    (#) 使用函数 HAL_GPIOEx_ConfigEventout() 配置 EVENTOUT Cortex 功能。
    (#) 使用 HAL_GPIOEx_EnableEventout() 激活 EVENTOUT Cortex 功能。
    (#) 使用 HAL_GPIOEx_DisableEventout() 停用 EVENTOUT Cortex 功能。

  @endverbatim
  ******************************************************************************
  */

/* 头文件 ------------------------------------------------------------------*/
#include "stm32f1xx_hal.h"

/** @addtogroup STM32F1xx_HAL_Driver
  * @{
  */

/** @defgroup GPIOEx GPIOEx
  * @brief GPIO HAL 模块驱动
  * @{
  */

#ifdef HAL_GPIO_MODULE_ENABLED

/** @defgroup GPIOEx_Exported_Functions GPIOEx 导出函数
  * @{
  */

/** @defgroup GPIOEx_Exported_Functions_Group1 扩展特性函数
 *  @brief    扩展特性函数
 *
@verbatim
  ==============================================================================
                 ##### 扩展特性函数 #####
  ==============================================================================
    [..]  本节提供了以下功能的函数：
    (+) 使用函数 HAL_GPIOEx_ConfigEventout() 配置 EVENTOUT Cortex 功能。
    (+) 使用 HAL_GPIOEx_EnableEventout() 激活 EVENTOUT Cortex 功能。
    (+) 使用 HAL_GPIOEx_DisableEventout() 停用 EVENTOUT Cortex 功能。

@endverbatim
  * @{
  */

/**
  * @brief  配置 EVENTOUT Cortex 信号将连接的端口和引脚
  * @param  GPIO_PortSource 选择用于输出 Cortex EVENTOUT 信号的端口。
  *   该参数可以是 @ref GPIOEx_EVENTOUT_PORT 中的值。
  * @param  GPIO_PinSource 选择用于输出 Cortex EVENTOUT 信号的引脚。
  *   该参数可以是 @ref GPIOEx_EVENTOUT_PIN 中的值。
  * @retval None
  */
void HAL_GPIOEx_ConfigEventout(uint32_t GPIO_PortSource, uint32_t GPIO_PinSource)
{
  /* 检查参数 */
  assert_param(IS_AFIO_EVENTOUT_PORT(GPIO_PortSource));
  assert_param(IS_AFIO_EVENTOUT_PIN(GPIO_PinSource));

  /* 应用新配置 */
  MODIFY_REG(AFIO->EVCR, (AFIO_EVCR_PORT) | (AFIO_EVCR_PIN), (GPIO_PortSource) | (GPIO_PinSource));
}

/**
  * @brief  启用事件输出
  * @retval None
  */
void HAL_GPIOEx_EnableEventout(void)
{
  SET_BIT(AFIO->EVCR, AFIO_EVCR_EVOE);
}

/**
  * @brief  禁用事件输出
  * @retval None
  */
void HAL_GPIOEx_DisableEventout(void)
{
  CLEAR_BIT(AFIO->EVCR, AFIO_EVCR_EVOE);
}

/**
  * @}
  */

/**
  * @}
  */

#endif /* HAL_GPIO_MODULE_ENABLED */

/**
  * @}
  */

/**
  * @}
  */

/**
  ******************************************************************************
  * @file    stm32f1xx_hal_gpio_ex.h
  * @author  MCD Application Team
  * @brief   HAL库 GPIO 扩展模块头文件
  ******************************************************************************
  * @attention
  *
  * 版权所有 (c) 2016 STMicroelectronics。
  * 保留所有权利。
  *
  * 本软件根据可以在此软件组件的根目录中找到的 LICENSE 文件中的条款进行许可。
  * 如果此软件没有附带 LICENSE 文件，则按原样提供。
  *
  ******************************************************************************
  */

/* 定义防止递归 -------------------------------------*/
#ifndef STM32F1xx_HAL_GPIO_EX_H
#define STM32F1xx_HAL_GPIO_EX_H

#ifdef __cplusplus
extern "C" {
#endif

/* 头文件 ------------------------------------------------------------------*/
#include "stm32f1xx_hal_def.h"

/** @addtogroup STM32F1xx_HAL_Driver
  * @{
  */

/** @defgroup GPIOEx GPIOEx
  * @{
  */
/* 导出类型 ------------------------------------------------------------*/
/* 导出常量 --------------------------------------------------------*/

/** @defgroup GPIOEx_Exported_Constants GPIOEx 导出常量
  * @{
  */

/** @defgroup GPIOEx_EVENTOUT Cortex 事件输出 配置
  * @brief 这个部分定义了使用Cortex 事件输出 信号
  * @{
  */

/** @defgroup GPIOEx_EVENTOUT_PIN 事件输出引脚
  * @{