mirror of
				https://github.com/espressif/esp-idf.git
				synced 2025-11-04 06:11:06 +00:00 
			
		
		
		
	feat(gpio): add a dump API to dump IO configurations
Merges https://github.com/espressif/esp-idf/pull/12511
This commit is contained in:
		@@ -1,5 +1,5 @@
 | 
			
		||||
/*
 | 
			
		||||
 * SPDX-FileCopyrightText: 2015-2021 Espressif Systems (Shanghai) CO LTD
 | 
			
		||||
 * SPDX-FileCopyrightText: 2015-2023 Espressif Systems (Shanghai) CO LTD
 | 
			
		||||
 *
 | 
			
		||||
 * SPDX-License-Identifier: Apache-2.0
 | 
			
		||||
 */
 | 
			
		||||
@@ -39,6 +39,39 @@ extern const uint8_t GPIO_PIN_MUX_REG_OFFSET[SOC_GPIO_PIN_COUNT];
 | 
			
		||||
#define GPIO_LL_PRO_CPU_NMI_INTR_ENA  (BIT(3))
 | 
			
		||||
#define GPIO_LL_SDIO_EXT_INTR_ENA     (BIT(4))
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * @brief Get the configuration for an IO
 | 
			
		||||
 *
 | 
			
		||||
 * @param hw Peripheral GPIO hardware instance address.
 | 
			
		||||
 * @param gpio_num GPIO number
 | 
			
		||||
 * @param pu Pull-up enabled or not
 | 
			
		||||
 * @param pd Pull-down enabled or not
 | 
			
		||||
 * @param ie Input enabled or not
 | 
			
		||||
 * @param oe Output enabled or not
 | 
			
		||||
 * @param od Open-drain enabled or not
 | 
			
		||||
 * @param drv Drive strength value
 | 
			
		||||
 * @param fun_sel IOMUX function selection value
 | 
			
		||||
 * @param sig_out Outputting peripheral signal index
 | 
			
		||||
 * @param slp_sel Pin sleep mode enabled or not
 | 
			
		||||
 */
 | 
			
		||||
static inline void gpio_ll_get_io_config(gpio_dev_t *hw, uint32_t gpio_num,
 | 
			
		||||
                                         bool *pu, bool *pd, bool *ie, bool *oe, bool *od, uint32_t *drv,
 | 
			
		||||
                                         uint32_t *fun_sel, uint32_t *sig_out, bool *slp_sel)
 | 
			
		||||
{
 | 
			
		||||
    uint32_t bit_shift = (gpio_num < 32) ? gpio_num : (gpio_num - 32);
 | 
			
		||||
    uint32_t bit_mask = 1 << bit_shift;
 | 
			
		||||
    uint32_t iomux_reg_val = REG_READ(GPIO_PIN_MUX_REG[gpio_num]);
 | 
			
		||||
    *pu = (iomux_reg_val & FUN_PU_M) >> FUN_PU_S;
 | 
			
		||||
    *pd = (iomux_reg_val & FUN_PD_M) >> FUN_PD_S;
 | 
			
		||||
    *ie = (iomux_reg_val & FUN_IE_M) >> FUN_IE_S;
 | 
			
		||||
    *oe = (((gpio_num < 32) ? hw->enable : hw->enable1.val) & bit_mask) >> bit_shift;
 | 
			
		||||
    *od = hw->pin[gpio_num].pad_driver;
 | 
			
		||||
    *drv = (iomux_reg_val & FUN_DRV_M) >> FUN_DRV_S;
 | 
			
		||||
    *fun_sel = (iomux_reg_val & MCU_SEL_M) >> MCU_SEL_S;
 | 
			
		||||
    *sig_out = hw->func_out_sel_cfg[gpio_num].func_sel;
 | 
			
		||||
    *slp_sel = (iomux_reg_val & SLP_SEL_M) >> SLP_SEL_S;
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
  * @brief Enable pull-up on GPIO.
 | 
			
		||||
  *
 | 
			
		||||
@@ -669,6 +702,23 @@ static inline void gpio_ll_iomux_out(gpio_dev_t *hw, uint8_t gpio_num, int func,
 | 
			
		||||
    gpio_ll_iomux_func_sel(GPIO_PIN_MUX_REG[gpio_num], func);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
/**
 | 
			
		||||
 * @brief Get the GPIO number that is routed to the input peripheral signal through GPIO matrix.
 | 
			
		||||
 *
 | 
			
		||||
 * @param hw Peripheral GPIO hardware instance address.
 | 
			
		||||
 * @param in_sig_idx Peripheral signal index (tagged as input attribute).
 | 
			
		||||
 *
 | 
			
		||||
 * @return
 | 
			
		||||
 *    - -1     Signal bypassed GPIO matrix
 | 
			
		||||
 *    - Others GPIO number
 | 
			
		||||
 */
 | 
			
		||||
static inline int gpio_ll_get_in_signal_connected_io(gpio_dev_t *hw, uint32_t in_sig_idx)
 | 
			
		||||
{
 | 
			
		||||
    typeof(hw->func_in_sel_cfg[in_sig_idx]) reg;
 | 
			
		||||
    reg.val = hw->func_in_sel_cfg[in_sig_idx].val;
 | 
			
		||||
    return (reg.sig_in_sel ? reg.func_sel : -1);
 | 
			
		||||
}
 | 
			
		||||
 | 
			
		||||
#ifdef __cplusplus
 | 
			
		||||
}
 | 
			
		||||
#endif
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user