HAL_GPIO_DeInit怎么用

`HAL_GPIO_DeInit` 是STM32Cube库中的一个函数，用于初始化GPIO（通用输入/输出）端口，使其回到未配置的状态。这个函数主要用于释放之前通过`HAL_GPIO_Init`或其他GPIO配置函数设置的GPIO资源。

使用 `HAL_GPIO_DeInit(GPIOx, GPIO_Pin)` 的步骤如下：

1. 首先，需要包含头文件 `<stm32f4xx_hal_gpio.h>`，它包含了 `HAL_GPIO_DeInit` 函数声明。
2. 确定你要操作的GPIO外设寄存器，例如 GPIOA、GPIOB等，这里用 `GPIOx` 表示，通常 `x` 可能是 A、B、C、D...之一。
3. 然后指定你想要重置初始化的特定引脚，`GPIO_Pin`是一个枚举值，表示该GPIO的某一位，如 `GPIO_PIN_0`、`GPIO_PIN_15`等。
4. 调用函数 `HAL_GPIO_DeInit(GPIOx, GPIO_Pin)` ，传入上述两个参数。函数执行后，指定的GPIO引脚将恢复到默认的未连接状态，不再有任何预设的功能或模式。

注意，使用前需确保你已经正确配置了GPIO，并且理解这一步骤对后续程序的影响，因为如果某个GPIO还在使用，直接清除其配置可能会导致意想不到的结果。

相关问题

解析代码extern __IO uint16_t ADC1_Value; extern __IO uint16_t ADC2_Value; ADC_HandleTypeDef hadc1; ADC_HandleTypeDef hadc2; void MX_ADC1_Init(void){ ADC_ChannelConfTypeDef sConfig; hadc1.Instance = ADC1; hadc1.Init.ScanConvMode = ADC_SCAN_DISABLE; hadc1.Init.ContinuousConvMode = DISABLE; hadc1.Init.DiscontinuousConvMode = DISABLE; hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START; hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc1.Init.NbrOfConversion = 1; if (HAL_ADC_Init(&hadc1) != HAL_OK) { _Error_Handler(__FILE__, __LINE__); } sConfig.Channel = ADC_CHANNEL_4; sConfig.Rank = ADC_REGULAR_RANK_1; sConfig.SamplingTime = ADC_SAMPLETIME_1CYCLE_5; if (HAL_ADC_ConfigChannel(&hadc1, &sConfig) != HAL_OK) { _Error_Handler(__FILE__, __LINE__); }} void MX_ADC2_Init(void){ ADC_ChannelConfTypeDef sConfig; hadc2.Instance = ADC2; hadc2.Init.ScanConvMode = ADC_SCAN_DISABLE; hadc2.Init.ContinuousConvMode = DISABLE; hadc2.Init.DiscontinuousConvMode = DISABLE; hadc2.Init.ExternalTrigConv = ADC_SOFTWARE_START; hadc2.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc2.Init.NbrOfConversion = 1; if (HAL_ADC_Init(&hadc2) != HAL_OK) { _Error_Handler(__FILE__, __LINE__); } sConfig.Channel = ADC_CHANNEL_5; sConfig.Rank = ADC_REGULAR_RANK_1; sConfig.SamplingTime = ADC_SAMPLETIME_1CYCLE_5; if (HAL_ADC_ConfigChannel(&hadc2, &sConfig) != HAL_OK) { _Error_Handler(__FILE__, __LINE__); }} void HAL_ADC_MspInit(ADC_HandleTypeDef* adcHandle){ GPIO_InitTypeDef GPIO_InitStruct; if(adcHandle->Instance==ADC1) { __HAL_RCC_ADC1_CLK_ENABLE(); GPIO_InitStruct.Pin = GPIO_PIN_4; GPIO_InitStruct.Mode = GPIO_MODE_ANALOG; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); HAL_NVIC_SetPriority(ADC1_2_IRQn, 0, 0); HAL_NVIC_EnableIRQ(ADC1_2_IRQn); } else if(adcHandle->Instance==ADC2) { __HAL_RCC_ADC2_CLK_ENABLE(); GPIO_InitStruct.Pin = GPIO_PIN_5; GPIO_InitStruct.Mode = GPIO_MODE_ANALOG; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); HAL_NVIC_SetPriority(ADC1_2_IRQn, 0, 0); HAL_NVIC_EnableIRQ(ADC1_2_IRQn); }} void HAL_ADC_MspDeInit(ADC_HandleTypeDef* adcHandle){ if(adcHandle->Instance==ADC1) { __HAL_RCC_ADC1_CLK_DISABLE(); HAL_GPIO_DeInit(GPIOA, GPIO_PIN_4); } else if(adcHandle->Instance==ADC2) { __HAL_RCC_ADC2_CLK_DISABLE(); HAL_GPIO_DeInit(GPIOA, GPIO_PIN_5); }} void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadcx){ if(hadcx==&hadc1){ ADC1_Value=HAL_ADC_GetValue(hadcx);} if(hadcx==&hadc2){ ADC2_Value=HAL_ADC_GetValue(hadcx);}}

这段代码是一个使用 STM32 的 ADC（模数转换器）的程序。它初始化了两个 ADC 实例，分别为 ADC1 和 ADC2，并配置了它们的参数。其中，ADC1 的采样通道为 4，ADC2 的采样通道为 5。在初始化过程中，还对 ADC 的外部触发进行了配置。在 ADC 转换完成后，会调用 HAL_ADC_ConvCpltCallback 回调函数，将转换结果存储在 ADC1_Value 和 ADC2_Value 中。同时，该程序还定义了 HAL_ADC_MspInit 和 HAL_ADC_MspDeInit 函数，用于初始化和反初始化 ADC 的 GPIO 和 NVIC。

HAL_GPIO_DeIni函数

### 关于 `HAL_GPIO_DeInit` 函数

#### 功能描述
该函数用于将指定的 GPIO 外设寄存器恢复至默认重置值。这会清除之前对该 GPIO 的任何配置，使其回到初始未配置的状态。

#### 参数说明
- **GPIOx**: 指向要反初始化的 GPIO 端口寄存器基地址指针 (GPIOA, GPIOB,...)[^3]

此函数不返回任何值，并且不需要额外的参数传递给它来执行其操作。

#### 使用场景
当应用程序需要完全释放某个 GPIO 资源或将特定端口重新设定为出厂设置时可以调用这个方法。通常情况下，在程序结束前或者准备切换到另一种工作模式时可能会用到此类功能。

#### 示例代码
下面是一个简单的例子展示了如何使用 `HAL_GPIO_DeInit` 来取消对 GPIOC 上第 4 号引脚的所有先前配置：

// 定义使用的 GPIO 和 PIN 编号
#define LED_PIN    GPIO_PIN_4
#define LED_PORT   GPIOC  

int main(void){
  
  /* 初始化系统 */
  HAL_Init();
    
  // ...其他初始化代码...

  // 假设在此之前已经完成了某些针对 PC4 引脚的操作
  
  // 清除所有与PC4相关的配置并将其置于复位状态
  HAL_GPIO_DeInit(LED_PORT, LED_PIN);
  
  while(1){
      // 主循环...
  }
}

通过上述方式，可以在必要时候有效地清理掉不再需要的硬件资源，从而确保系统的稳定性和安全性。