/* * SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD * * SPDX-License-Identifier: Apache-2.0 */ // The HAL layer for Touch Sensor (common part) #include "soc/soc_pins.h" #include "hal/touch_sensor_hal.h" #include "hal/touch_sensor_types.h" #include "soc/soc_caps.h" static int s_sleep_cycle = -1; static int s_meas_times = -1; void touch_hal_init(void) { touch_ll_stop_fsm(); touch_ll_intr_disable(TOUCH_PAD_INTR_MASK_ALL); touch_ll_intr_clear(TOUCH_PAD_INTR_MASK_ALL); touch_ll_clear_channel_mask(TOUCH_PAD_BIT_MASK_ALL); touch_ll_clear_trigger_status_mask(); touch_ll_set_meas_times(TOUCH_PAD_MEASURE_CYCLE_DEFAULT); touch_ll_set_sleep_time(TOUCH_PAD_SLEEP_CYCLE_DEFAULT); /* Configure the touch-sensor power domain into self-bias since bandgap-bias * level is different under sleep-mode compared to running-mode. self-bias is * always on after chip startup. */ touch_ll_sleep_low_power(true); touch_ll_set_voltage_high(TOUCH_PAD_HIGH_VOLTAGE_THRESHOLD); touch_ll_set_voltage_low(TOUCH_PAD_LOW_VOLTAGE_THRESHOLD); touch_ll_set_voltage_attenuation(TOUCH_PAD_ATTEN_VOLTAGE_THRESHOLD); touch_ll_set_idle_channel_connect(TOUCH_PAD_IDLE_CH_CONNECT_DEFAULT); /* Clear touch channels to initialize the channel value (benchmark, raw_data). * Note: Should call it after enable clock gate. */ touch_ll_clkgate(true); // Enable clock gate for touch sensor. touch_ll_reset_benchmark(TOUCH_PAD_MAX); touch_ll_sleep_reset_benchmark(); } void touch_hal_deinit(void) { touch_ll_reset_benchmark(TOUCH_PAD_MAX); touch_ll_sleep_reset_benchmark(); touch_ll_stop_fsm(); touch_ll_clkgate(false); touch_ll_clear_channel_mask(TOUCH_PAD_BIT_MASK_ALL); touch_ll_clear_trigger_status_mask(); touch_ll_intr_disable(TOUCH_PAD_INTR_MASK_ALL); touch_ll_timeout_disable(); touch_ll_waterproof_disable(); touch_ll_denoise_disable(); touch_pad_t prox_pad[SOC_TOUCH_PROXIMITY_CHANNEL_NUM] = {[0 ... (SOC_TOUCH_PROXIMITY_CHANNEL_NUM - 1)] = 0}; touch_ll_proximity_set_channel_num((const touch_pad_t *)prox_pad); touch_ll_sleep_set_channel_num(0); touch_ll_sleep_disable_proximity_sensing(); touch_ll_reset(); // Reset the touch sensor FSM. } void touch_hal_filter_set_config(const touch_filter_config_t *filter_info) { touch_ll_filter_set_filter_mode(filter_info->mode); touch_ll_filter_set_debounce(filter_info->debounce_cnt); touch_ll_filter_set_noise_thres(filter_info->noise_thr); touch_ll_filter_set_jitter_step(filter_info->jitter_step); touch_ll_filter_set_smooth_mode(filter_info->smh_lvl); } void touch_hal_filter_get_config(touch_filter_config_t *filter_info) { touch_ll_filter_get_filter_mode(&filter_info->mode); touch_ll_filter_get_debounce(&filter_info->debounce_cnt); touch_ll_filter_get_noise_thres(&filter_info->noise_thr); touch_ll_filter_get_jitter_step(&filter_info->jitter_step); touch_ll_filter_get_smooth_mode(&filter_info->smh_lvl); } void touch_hal_denoise_set_config(const touch_pad_denoise_t *denoise) { touch_ll_denoise_set_cap_level(denoise->cap_level); touch_ll_denoise_set_grade(denoise->grade); } void touch_hal_denoise_get_config(touch_pad_denoise_t *denoise) { touch_ll_denoise_get_cap_level(&denoise->cap_level); touch_ll_denoise_get_grade(&denoise->grade); } void touch_hal_denoise_enable(void) { touch_ll_clear_channel_mask(1U << SOC_TOUCH_DENOISE_CHANNEL); touch_ll_denoise_enable(); } void touch_hal_waterproof_set_config(const touch_pad_waterproof_t *waterproof) { touch_ll_waterproof_set_guard_pad(waterproof->guard_ring_pad); touch_ll_waterproof_set_sheild_driver(waterproof->shield_driver); } void touch_hal_waterproof_get_config(touch_pad_waterproof_t *waterproof) { touch_ll_waterproof_get_guard_pad(&waterproof->guard_ring_pad); touch_ll_waterproof_get_sheild_driver(&waterproof->shield_driver); } void touch_hal_waterproof_enable(void) { touch_ll_clear_channel_mask(1U << SOC_TOUCH_SHIELD_CHANNEL); touch_ll_waterproof_enable(); } bool touch_hal_enable_proximity(touch_pad_t touch_num, bool enabled) { int i = 0; touch_pad_t ch_num[SOC_TOUCH_PROXIMITY_CHANNEL_NUM] = {0}; touch_ll_proximity_get_channel_num(ch_num); if (enabled) { for (i = 0; i < SOC_TOUCH_PROXIMITY_CHANNEL_NUM; i++) { if (ch_num[i] == TOUCH_PAD_NUM0 || ch_num[i] >= TOUCH_PAD_MAX || ch_num[i] == touch_num) { ch_num[i] = touch_num; break; } } if (i == SOC_TOUCH_PROXIMITY_CHANNEL_NUM) { return false; } } else { for (i = 0; i < SOC_TOUCH_PROXIMITY_CHANNEL_NUM; i++) { if (ch_num[i] == touch_num) { ch_num[i] = TOUCH_PAD_NUM0; break; } } } touch_ll_proximity_set_channel_num(ch_num); return true; } void touch_hal_sleep_channel_enable(touch_pad_t pad_num, bool enable) { if (enable) { touch_ll_sleep_set_channel_num(pad_num); touch_ll_sleep_set_threshold(TOUCH_PAD_THRESHOLD_MAX); touch_ll_sleep_reset_benchmark(); } else { touch_ll_sleep_set_channel_num(TOUCH_PAD_NUM0); } } void touch_hal_sleep_channel_get_config(touch_pad_sleep_channel_t *slp_config) { touch_ll_sleep_get_channel_num(&slp_config->touch_num); slp_config->en_proximity = touch_ll_sleep_is_proximity_enabled(); } void touch_hal_sleep_channel_set_work_time(uint16_t sleep_cycle, uint16_t meas_times) { s_sleep_cycle = (int)sleep_cycle; s_meas_times = (int)meas_times; } void touch_hal_sleep_channel_get_work_time(uint16_t *sleep_cycle, uint16_t *meas_times) { if (s_meas_times < 0) { touch_ll_get_measure_times(meas_times); } else { *meas_times = (uint16_t)s_meas_times; } if (s_sleep_cycle < 0) { touch_ll_get_sleep_time(sleep_cycle); } else { *sleep_cycle = (uint16_t)s_sleep_cycle; } }