Mirrors/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2026-10-01 18:50:34 +03:00
Code Issues Packages Projects Releases Wiki Activity

feat(driver_gpio): support hysterisys filer in rtcio mode

Browse Source
This commit is contained in:
wanckl
2026-09-10 20:33:28 +08:00
parent 3d8d812662
commit e9483b09fd
10 changed files with 279 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files
components/esp_driver_gpio/include/driver/rtc_io.h
+24
View File
@@ -172,6 +172,30 @@ esp_err_t rtc_gpio_pullup_dis(gpio_num_t gpio_num);
*/
esp_err_t rtc_gpio_pulldown_dis(gpio_num_t gpio_num);
#if SOC_GPIO_SUPPORT_PIN_HYS_FILTER
/**
* @brief Enable RTC GPIO input hysteresis.
*
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
*
* @return
* - ESP_OK Success
* - ESP_ERR_INVALID_ARG The IO is not an RTC IO
*/
esp_err_t rtc_gpio_hysteresis_en(gpio_num_t gpio_num);
/**
* @brief Disable RTC GPIO input hysteresis.
*
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
*
* @return
* - ESP_OK Success
* - ESP_ERR_INVALID_ARG The IO is not an RTC IO
*/
esp_err_t rtc_gpio_hysteresis_dis(gpio_num_t gpio_num);
#endif
/**
* @brief Set RTC GPIO pad drive capability
*
components/esp_driver_gpio/src/rtc_io.c
+22
View File
@@ -184,6 +184,28 @@ esp_err_t rtc_gpio_pulldown_dis(gpio_num_t gpio_num)
return ESP_OK;
}
#if SOC_GPIO_SUPPORT_PIN_HYS_FILTER
esp_err_t rtc_gpio_hysteresis_en(gpio_num_t gpio_num)
{
ESP_RETURN_ON_FALSE(rtc_gpio_is_valid_gpio(gpio_num), ESP_ERR_INVALID_ARG, RTCIO_TAG, "RTCIO number error");
RTCIO_ENTER_CRITICAL();
rtcio_hal_input_hysteresis_soft_enable(rtc_io_number_get(gpio_num), true);
RTCIO_EXIT_CRITICAL();
return ESP_OK;
}
esp_err_t rtc_gpio_hysteresis_dis(gpio_num_t gpio_num)
{
ESP_RETURN_ON_FALSE(rtc_gpio_is_valid_gpio(gpio_num), ESP_ERR_INVALID_ARG, RTCIO_TAG, "RTCIO number error");
RTCIO_ENTER_CRITICAL();
rtcio_hal_input_hysteresis_soft_enable(rtc_io_number_get(gpio_num), false);
RTCIO_EXIT_CRITICAL();
return ESP_OK;
}
#endif
esp_err_t rtc_gpio_iomux_func_sel(gpio_num_t gpio_num, int func)
{
ESP_RETURN_ON_FALSE(rtc_gpio_is_valid_gpio(gpio_num), ESP_ERR_INVALID_ARG, RTCIO_TAG, "RTCIO number error");
components/esp_driver_gpio/test_apps/gpio_extensions/main/test_hysteresis.c
+99 -26
View File
@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2023-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Unlicense OR CC0-1.0
*/
@@ -8,6 +8,7 @@
#include "freertos/task.h"
#include "unity.h"
#include "driver/gpio.h"
#include "driver/rtc_io.h"
/**
* NOTE: To run this special feature test case, a slope analog signal is needed.
@@ -21,7 +22,7 @@
* | | +-----+ || | |
* | ESP32 | R:10k ++ + |
* | | |
* | GND |------------------------------+
* | GND_IO |------------------------------+
* +--------------+
*
* or you can connect your slop signals from signal generator to ESP32 pin
@@ -30,47 +31,119 @@
#define TEST_GPIO_HYS_IO 4
#define TEST_GPIO_WAVE_IO 5
#define TEST_GPIO_GND_IO 10 // The pin alwayse output 0 to use as near GND
static void test_gpio_hysteresis_intr_handler(void *args)
static int test_count_io_glitch_in_loop(int (*get_level_func)(gpio_num_t), gpio_num_t glitch_io, int loop_cnt)
{
esp_rom_printf("%" PRIu32 "\n", ++ * ((uint32_t *)args));
int glitch_cnt = 0;
int init_level = get_level_func(glitch_io);
while (init_level == get_level_func(glitch_io));
for (int i = 0; i < loop_cnt; i++) {
if (init_level != get_level_func(glitch_io)) {
init_level = !init_level;
glitch_cnt++;
}
}
return glitch_cnt;
}
static void test_check_glitch_result(int glitch_cnt, bool hys_en)
{
if (hys_en) {
TEST_ASSERT_EQUAL(1, glitch_cnt); // must only 1 edge if hysteresis is enabled
} else {
TEST_ASSERT_GREATER_THAN(10, glitch_cnt);
}
}
// This case is now tested only manually
TEST_CASE("GPIO Input hysteresis filter", "[gpio_filter][timeout=50][ignore]")
{
uint32_t intr_cnt = 0;
// prepare for wave and ground io
gpio_config_t gpio_cfg = {
.pin_bit_mask = (1 << TEST_GPIO_WAVE_IO),
.pin_bit_mask = BIT64(TEST_GPIO_WAVE_IO) | BIT64(TEST_GPIO_GND_IO),
.mode = GPIO_MODE_OUTPUT,
.pull_down_en = GPIO_PULLDOWN_ENABLE,
};
TEST_ESP_OK(gpio_config(&gpio_cfg));
TEST_ESP_OK(gpio_set_level(TEST_GPIO_GND_IO, 0));
gpio_cfg.pin_bit_mask = 1 << TEST_GPIO_HYS_IO;
// prepare for hysteresis io
gpio_cfg.pin_bit_mask = BIT64(TEST_GPIO_HYS_IO);
gpio_cfg.mode = GPIO_MODE_INPUT;
gpio_cfg.intr_type = GPIO_INTR_ANYEDGE;
gpio_cfg.hys_ctrl_mode = GPIO_HYS_SOFT_ENABLE;
TEST_ESP_OK(gpio_config(&gpio_cfg));
gpio_install_isr_service(0);
gpio_isr_handler_add(TEST_GPIO_HYS_IO, test_gpio_hysteresis_intr_handler, &intr_cnt);
printf("Initial level ...\n");
gpio_set_level(TEST_GPIO_WAVE_IO, 0);
vTaskDelay(3000);
for (int hys_en = 0; hys_en < 2; hys_en++) {
printf("Test with hysteresis %s\n", hys_en ? "enabled" : "disabled");
gpio_cfg.hys_ctrl_mode = hys_en ? GPIO_HYS_SOFT_ENABLE : GPIO_HYS_SOFT_DISABLE;
TEST_ESP_OK(gpio_config(&gpio_cfg));
// generate 3 rising and falling slopes to test gpio interrupt
for (uint8_t i = 0; i < 3; i++) {
printf("----rising %dth: ", i);
gpio_set_level(TEST_GPIO_WAVE_IO, 1);
int glitch_cnt = test_count_io_glitch_in_loop(gpio_get_level, TEST_GPIO_HYS_IO, 1000000);
printf("glitch_cnt: %d\n", glitch_cnt);
test_check_glitch_result(glitch_cnt, hys_en);
printf("----falling %dth: ", i);
gpio_set_level(TEST_GPIO_WAVE_IO, 0);
glitch_cnt = test_count_io_glitch_in_loop(gpio_get_level, TEST_GPIO_HYS_IO, 1000000);
printf("glitch_cnt: %d\n", glitch_cnt);
test_check_glitch_result(glitch_cnt, hys_en);
}
// generate 5 rising and falling slopes to test gpio interrupt
for (uint8_t i = 0; i < 5; i++) {
printf("----falling %dth\n", i);
gpio_set_level(TEST_GPIO_WAVE_IO, 0);
vTaskDelay(1500);
printf("----rising %dth\n", i);
gpio_set_level(TEST_GPIO_WAVE_IO, 1);
vTaskDelay(1500);
}
gpio_isr_handler_remove(TEST_GPIO_HYS_IO);
gpio_uninstall_isr_service();
TEST_ESP_OK(gpio_reset_pin(TEST_GPIO_HYS_IO));
TEST_ESP_OK(gpio_reset_pin(TEST_GPIO_WAVE_IO));
// should shot ISR exactly 10 times
TEST_ASSERT_UINT32_WITHIN(1, 10, intr_cnt);
TEST_ESP_OK(gpio_reset_pin(TEST_GPIO_GND_IO));
}
#if SOC_RTCIO_INPUT_OUTPUT_SUPPORTED
TEST_CASE("RTCIO Input hysteresis filter", "[gpio_filter][timeout=50][ignore]")
{
// prepare for wave and ground io
gpio_config_t gpio_cfg = {
.pin_bit_mask = BIT64(TEST_GPIO_WAVE_IO) | BIT64(TEST_GPIO_GND_IO),
.mode = GPIO_MODE_OUTPUT,
.pull_down_en = GPIO_PULLDOWN_ENABLE,
};
TEST_ESP_OK(gpio_config(&gpio_cfg));
TEST_ESP_OK(gpio_set_level(TEST_GPIO_GND_IO, 0));
// prepare for hysteresis io
TEST_ESP_OK(rtc_gpio_init(TEST_GPIO_HYS_IO));
TEST_ESP_OK(rtc_gpio_set_direction(TEST_GPIO_HYS_IO, RTC_GPIO_MODE_INPUT_ONLY));
int (*io_get_level)(gpio_num_t) = (int (*)(gpio_num_t)) rtc_gpio_get_level;
printf("Initial level ...\n");
gpio_set_level(TEST_GPIO_WAVE_IO, 0);
vTaskDelay(3000);
for (int hys_en = 0; hys_en < 2; hys_en++) {
printf("Test with hysteresis %s\n", hys_en ? "enabled" : "disabled");
hys_en ? rtc_gpio_hysteresis_en(TEST_GPIO_HYS_IO) : rtc_gpio_hysteresis_dis(TEST_GPIO_HYS_IO);
// generate 3 rising and falling slopes to test gpio interrupt
for (uint8_t i = 0; i < 3; i++) {
printf("----rising %dth: ", i);
gpio_set_level(TEST_GPIO_WAVE_IO, 1);
int glitch_cnt = test_count_io_glitch_in_loop(io_get_level, TEST_GPIO_HYS_IO, 1000000);
printf("glitch_cnt: %d\n", glitch_cnt);
test_check_glitch_result(glitch_cnt, hys_en);
printf("----falling %dth: ", i);
gpio_set_level(TEST_GPIO_WAVE_IO, 0);
glitch_cnt = test_count_io_glitch_in_loop(io_get_level, TEST_GPIO_HYS_IO, 1000000);
printf("glitch_cnt: %d\n", glitch_cnt);
test_check_glitch_result(glitch_cnt, hys_en);
}
}
TEST_ESP_OK(rtc_gpio_deinit(TEST_GPIO_HYS_IO));
TEST_ESP_OK(gpio_reset_pin(TEST_GPIO_WAVE_IO));
TEST_ESP_OK(gpio_reset_pin(TEST_GPIO_GND_IO));
}
#endif