284 lines
8.4 KiB
C
284 lines
8.4 KiB
C
// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef _DRIVER_RTC_GPIO_H_
|
|
#define _DRIVER_RTC_GPIO_H_
|
|
|
|
#include <stdint.h>
|
|
#include "esp_err.h"
|
|
#include "driver/gpio.h"
|
|
#include "soc/rtc_gpio_channel.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief Pin function information for a single GPIO pad's RTC functions.
|
|
*
|
|
* This is an internal function of the driver, and is not usually useful
|
|
* for external use.
|
|
*/
|
|
typedef struct {
|
|
uint32_t reg; /*!< Register of RTC pad, or 0 if not an RTC GPIO */
|
|
uint32_t mux; /*!< Bit mask for selecting digital pad or RTC pad */
|
|
uint32_t func; /*!< Shift of pad function (FUN_SEL) field */
|
|
uint32_t ie; /*!< Mask of input enable */
|
|
uint32_t pullup; /*!< Mask of pullup enable */
|
|
uint32_t pulldown; /*!< Mask of pulldown enable */
|
|
uint32_t slpsel; /*!< If slpsel bit is set, slpie will be used as pad input enabled signal in sleep mode */
|
|
uint32_t slpie; /*!< Mask of input enable in sleep mode */
|
|
uint32_t hold; /*!< Mask of hold enable */
|
|
uint32_t hold_force;/*!< Mask of hold_force bit for RTC IO in RTC_CNTL_HOLD_FORCE_REG */
|
|
uint32_t drv_v; /*!< Mask of drive capability */
|
|
uint32_t drv_s; /*!< Offset of drive capability */
|
|
int rtc_num; /*!< RTC IO number, or -1 if not an RTC GPIO */
|
|
} rtc_gpio_desc_t;
|
|
|
|
typedef enum {
|
|
RTC_GPIO_MODE_INPUT_ONLY , /*!< Pad input */
|
|
RTC_GPIO_MODE_OUTPUT_ONLY, /*!< Pad output */
|
|
RTC_GPIO_MODE_INPUT_OUTPUT, /*!< Pad pull input + output */
|
|
RTC_GPIO_MODE_DISABLED, /*!< Pad (output + input) disable */
|
|
} rtc_gpio_mode_t;
|
|
|
|
/**
|
|
* @brief Provides access to a constant table of RTC I/O pin
|
|
* function information.
|
|
*
|
|
* This is an internal function of the driver, and is not usually useful
|
|
* for external use.
|
|
*/
|
|
extern const rtc_gpio_desc_t rtc_gpio_desc[GPIO_PIN_COUNT];
|
|
|
|
/**
|
|
* @brief Determine if the specified GPIO is a valid RTC GPIO.
|
|
*
|
|
* @param gpio_num GPIO number
|
|
* @return true if GPIO is valid for RTC GPIO use. talse otherwise.
|
|
*/
|
|
inline static bool rtc_gpio_is_valid_gpio(gpio_num_t gpio_num)
|
|
{
|
|
return gpio_num < GPIO_PIN_COUNT
|
|
&& rtc_gpio_desc[gpio_num].reg != 0;
|
|
}
|
|
|
|
#define RTC_GPIO_IS_VALID_GPIO(gpio_num) rtc_gpio_is_valid_gpio(gpio_num) // Deprecated, use rtc_gpio_is_valid_gpio()
|
|
|
|
/**
|
|
* @brief Init a GPIO as RTC GPIO
|
|
*
|
|
* This function must be called when initializing a pad for an analog function.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_init(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief Init a GPIO as digital GPIO
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
*
|
|
* @return
|
|
* - ESP_OK success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_deinit(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief Get the RTC IO input level
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
*
|
|
* @return
|
|
* - 1 High level
|
|
* - 0 Low level
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
uint32_t rtc_gpio_get_level(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief Set the RTC IO output level
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
* @param level output level
|
|
*
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_set_level(gpio_num_t gpio_num, uint32_t level);
|
|
|
|
/**
|
|
* @brief RTC GPIO set direction
|
|
*
|
|
* Configure RTC GPIO direction, such as output only, input only,
|
|
* output and input.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
* @param mode GPIO direction
|
|
*
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_set_direction(gpio_num_t gpio_num, rtc_gpio_mode_t mode);
|
|
|
|
/**
|
|
* @brief RTC GPIO pullup enable
|
|
*
|
|
* This function only works for RTC IOs. In general, call gpio_pullup_en,
|
|
* which will work both for normal GPIOs and RTC IOs.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
*
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_pullup_en(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief RTC GPIO pulldown enable
|
|
*
|
|
* This function only works for RTC IOs. In general, call gpio_pulldown_en,
|
|
* which will work both for normal GPIOs and RTC IOs.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
*
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_pulldown_en(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief RTC GPIO pullup disable
|
|
*
|
|
* This function only works for RTC IOs. In general, call gpio_pullup_dis,
|
|
* which will work both for normal GPIOs and RTC IOs.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
*
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_pullup_dis(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief RTC GPIO pulldown disable
|
|
*
|
|
* This function only works for RTC IOs. In general, call gpio_pulldown_dis,
|
|
* which will work both for normal GPIOs and RTC IOs.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
*
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_pulldown_dis(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief Enable hold function on an RTC IO pad
|
|
*
|
|
* Enabling HOLD function will cause the pad to latch current values of
|
|
* input enable, output enable, output value, function, drive strength values.
|
|
* This function is useful when going into light or deep sleep mode to prevent
|
|
* the pin configuration from changing.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_hold_en(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief Disable hold function on an RTC IO pad
|
|
*
|
|
* Disabling hold function will allow the pad receive the values of
|
|
* input enable, output enable, output value, function, drive strength from
|
|
* RTC_IO peripheral.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12)
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_hold_dis(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief Helper function to disconnect internal circuits from an RTC IO
|
|
* This function disables input, output, pullup, pulldown, and enables
|
|
* hold feature for an RTC IO.
|
|
* Use this function if an RTC IO needs to be disconnected from internal
|
|
* circuits in deep sleep, to minimize leakage current.
|
|
*
|
|
* In particular, for ESP32-WROVER module, call
|
|
* rtc_gpio_isolate(GPIO_NUM_12) before entering deep sleep, to reduce
|
|
* deep sleep current.
|
|
*
|
|
* @param gpio_num GPIO number (e.g. GPIO_NUM_12).
|
|
* @return
|
|
* - ESP_OK on success
|
|
* - ESP_ERR_INVALID_ARG if GPIO is not an RTC IO
|
|
*/
|
|
esp_err_t rtc_gpio_isolate(gpio_num_t gpio_num);
|
|
|
|
/**
|
|
* @brief Disable force hold signal for all RTC IOs
|
|
*
|
|
* Each RTC pad has a "force hold" input signal from the RTC controller.
|
|
* If this signal is set, pad latches current values of input enable,
|
|
* function, output enable, and other signals which come from the RTC mux.
|
|
* Force hold signal is enabled before going into deep sleep for pins which
|
|
* are used for EXT1 wakeup.
|
|
*/
|
|
void rtc_gpio_force_hold_dis_all();
|
|
|
|
/**
|
|
* @brief Set RTC GPIO pad drive capability
|
|
*
|
|
* @param gpio_num GPIO number, only support output GPIOs
|
|
* @param strength Drive capability of the pad
|
|
*
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
*/
|
|
esp_err_t rtc_gpio_set_drive_capability(gpio_num_t gpio_num, gpio_drive_cap_t strength);
|
|
|
|
/**
|
|
* @brief Get RTC GPIO pad drive capability
|
|
*
|
|
* @param gpio_num GPIO number, only support output GPIOs
|
|
* @param strength Pointer to accept drive capability of the pad
|
|
*
|
|
* @return
|
|
* - ESP_OK Success
|
|
* - ESP_ERR_INVALID_ARG Parameter error
|
|
*/
|
|
esp_err_t rtc_gpio_get_drive_capability(gpio_num_t gpio_num, gpio_drive_cap_t* strength);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|