mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
74aff2b9d2
1. Use esp_log API for LEDC and GPIO code. 2. Modify some API return value. 3. Add ledc_set_pin() for LEDC 4. Modify typo in uart.h Questions: In uart driver ISR handler, I used xxxFromISR , like xSemaphoreGiveFromISR, do those FromISR functions need to be put in IRAM?
310 lines
10 KiB
C
310 lines
10 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.
|
|
#include <esp_types.h>
|
|
#include "esp_err.h"
|
|
#include "esp_intr.h"
|
|
#include "freertos/FreeRTOS.h"
|
|
#include "freertos/xtensa_api.h"
|
|
#include "driver/gpio.h"
|
|
#include "soc/soc.h"
|
|
#include "esp_log.h"
|
|
|
|
const char* GPIO_TAG = "GPIO";
|
|
#define GPIO_CHECK(a, str, ret_val) if (!(a)) { \
|
|
ESP_LOGE(GPIO_TAG,"%s:%d (%s):%s\n", __FILE__, __LINE__, __FUNCTION__, str); \
|
|
return (ret_val); \
|
|
}
|
|
|
|
const uint32_t GPIO_PIN_MUX_REG[GPIO_PIN_COUNT] = {
|
|
GPIO_PIN_REG_0,
|
|
GPIO_PIN_REG_1,
|
|
GPIO_PIN_REG_2,
|
|
GPIO_PIN_REG_3,
|
|
GPIO_PIN_REG_4,
|
|
GPIO_PIN_REG_5,
|
|
GPIO_PIN_REG_6,
|
|
GPIO_PIN_REG_7,
|
|
GPIO_PIN_REG_8,
|
|
GPIO_PIN_REG_9,
|
|
GPIO_PIN_REG_10,
|
|
GPIO_PIN_REG_11,
|
|
GPIO_PIN_REG_12,
|
|
GPIO_PIN_REG_13,
|
|
GPIO_PIN_REG_14,
|
|
GPIO_PIN_REG_15,
|
|
GPIO_PIN_REG_16,
|
|
GPIO_PIN_REG_17,
|
|
GPIO_PIN_REG_18,
|
|
GPIO_PIN_REG_19,
|
|
0,
|
|
GPIO_PIN_REG_21,
|
|
GPIO_PIN_REG_22,
|
|
GPIO_PIN_REG_23,
|
|
0,
|
|
GPIO_PIN_REG_25,
|
|
GPIO_PIN_REG_26,
|
|
GPIO_PIN_REG_27,
|
|
0,
|
|
0,
|
|
0,
|
|
0,
|
|
GPIO_PIN_REG_32,
|
|
GPIO_PIN_REG_33,
|
|
GPIO_PIN_REG_34,
|
|
GPIO_PIN_REG_35,
|
|
GPIO_PIN_REG_36,
|
|
GPIO_PIN_REG_37,
|
|
GPIO_PIN_REG_38,
|
|
GPIO_PIN_REG_39
|
|
};
|
|
|
|
esp_err_t gpio_set_intr_type(gpio_num_t gpio_num, gpio_int_type_t intr_type)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
GPIO_CHECK(intr_type < GPIO_INTR_MAX, "GPIO interrupt type error\n", ESP_ERR_INVALID_ARG);
|
|
GPIO.pin[gpio_num].int_type = intr_type;
|
|
return ESP_OK;
|
|
}
|
|
|
|
esp_err_t gpio_intr_enable(gpio_num_t gpio_num)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
if(xPortGetCoreID() == 0) {
|
|
GPIO.pin[gpio_num].int_ena = GPIO_PRO_CPU_INTR_ENA; //enable pro cpu intr
|
|
} else {
|
|
GPIO.pin[gpio_num].int_ena = GPIO_APP_CPU_INTR_ENA; //enable pro cpu intr
|
|
}
|
|
return ESP_OK;
|
|
}
|
|
|
|
esp_err_t gpio_intr_disable(gpio_num_t gpio_num)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
GPIO.pin[gpio_num].int_ena = 0; //disable GPIO intr
|
|
return ESP_OK;
|
|
}
|
|
|
|
static esp_err_t gpio_output_disable(gpio_num_t gpio_num)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
if(gpio_num < 32) {
|
|
GPIO.enable_w1tc = (0x1 << gpio_num);
|
|
} else {
|
|
GPIO.enable1_w1tc.data = (0x1 << (gpio_num - 32));
|
|
}
|
|
return ESP_OK;
|
|
}
|
|
|
|
static esp_err_t gpio_output_enable(gpio_num_t gpio_num)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_OUTPUT_GPIO(gpio_num), "GPIO output gpio_num error\n", ESP_ERR_INVALID_ARG);
|
|
if(gpio_num < 32) {
|
|
GPIO.enable_w1ts = (0x1 << gpio_num);
|
|
} else {
|
|
GPIO.enable1_w1ts.data = (0x1 << (gpio_num - 32));
|
|
}
|
|
return ESP_OK;
|
|
}
|
|
|
|
esp_err_t gpio_set_level(gpio_num_t gpio_num, uint32_t level)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
if(level) {
|
|
if(gpio_num < 32) {
|
|
GPIO.out_w1ts = (1 << gpio_num);
|
|
} else {
|
|
GPIO.out1_w1ts.data = (1 << (gpio_num - 32));
|
|
}
|
|
} else {
|
|
if(gpio_num < 32) {
|
|
GPIO.out_w1tc = (1 << gpio_num);
|
|
} else {
|
|
GPIO.out1_w1tc.data = (1 << (gpio_num - 32));
|
|
}
|
|
}
|
|
return ESP_OK;
|
|
}
|
|
|
|
int gpio_get_level(gpio_num_t gpio_num)
|
|
{
|
|
if(gpio_num < 32) {
|
|
return (GPIO.in >> gpio_num) & 0x1;
|
|
} else {
|
|
return (GPIO.in1.data >> (gpio_num - 32)) & 0x1;
|
|
}
|
|
}
|
|
|
|
esp_err_t gpio_set_pull_mode(gpio_num_t gpio_num, gpio_pull_mode_t pull)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
GPIO_CHECK(pull <= GPIO_FLOATING, "GPIO pull mode error\n", ESP_ERR_INVALID_ARG);
|
|
esp_err_t ret = ESP_OK;
|
|
switch(pull) {
|
|
case GPIO_PULLUP_ONLY:
|
|
PIN_PULLUP_EN(GPIO_PIN_MUX_REG[gpio_num]);
|
|
PIN_PULLDWN_DIS(GPIO_PIN_MUX_REG[gpio_num]);
|
|
break;
|
|
case GPIO_PULLDOWN_ONLY:
|
|
PIN_PULLUP_DIS(GPIO_PIN_MUX_REG[gpio_num]);
|
|
PIN_PULLDWN_EN(GPIO_PIN_MUX_REG[gpio_num]);
|
|
break;
|
|
case GPIO_PULLUP_PULLDOWN:
|
|
PIN_PULLUP_EN(GPIO_PIN_MUX_REG[gpio_num]);
|
|
PIN_PULLDWN_EN(GPIO_PIN_MUX_REG[gpio_num]);
|
|
break;
|
|
case GPIO_FLOATING:
|
|
PIN_PULLUP_DIS(GPIO_PIN_MUX_REG[gpio_num]);
|
|
PIN_PULLDWN_DIS(GPIO_PIN_MUX_REG[gpio_num]);
|
|
break;
|
|
default:
|
|
ESP_LOGE(GPIO_TAG, "Unknown pull up/down mode,gpio_num=%u,pull=%u\n",gpio_num,pull);
|
|
ret = ESP_ERR_INVALID_ARG;
|
|
break;
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
esp_err_t gpio_set_direction(gpio_num_t gpio_num, gpio_mode_t mode)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
if(gpio_num >= 34 && (mode & (GPIO_MODE_DEF_OUTPUT))) {
|
|
ESP_LOGE(GPIO_TAG, "io_num=%d can only be input\n",gpio_num);
|
|
return ESP_ERR_INVALID_ARG;
|
|
}
|
|
esp_err_t ret = ESP_OK;
|
|
if(mode & GPIO_MODE_DEF_INPUT) {
|
|
PIN_INPUT_ENABLE(GPIO_PIN_MUX_REG[gpio_num]);
|
|
} else {
|
|
PIN_INPUT_DISABLE(GPIO_PIN_MUX_REG[gpio_num]);
|
|
}
|
|
if(mode & GPIO_MODE_DEF_OUTPUT) {
|
|
if(gpio_num < 32) {
|
|
GPIO.enable_w1ts = (0x1 << gpio_num);
|
|
} else {
|
|
GPIO.enable1_w1ts.data = (0x1 << (gpio_num - 32));
|
|
}
|
|
} else {
|
|
if(gpio_num < 32) {
|
|
GPIO.enable_w1tc = (0x1 << gpio_num);
|
|
} else {
|
|
GPIO.enable1_w1tc.data = (0x1 << (gpio_num - 32));
|
|
}
|
|
}
|
|
if(mode & GPIO_MODE_DEF_OD) {
|
|
GPIO.pin[gpio_num].pad_driver = 1;
|
|
} else {
|
|
GPIO.pin[gpio_num].pad_driver = 0;
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
esp_err_t gpio_config(gpio_config_t *pGPIOConfig)
|
|
{
|
|
uint64_t gpio_pin_mask = (pGPIOConfig->pin_bit_mask);
|
|
uint32_t io_reg = 0;
|
|
uint32_t io_num = 0;
|
|
uint64_t bit_valid = 0;
|
|
if(pGPIOConfig->pin_bit_mask == 0 || pGPIOConfig->pin_bit_mask >= (((uint64_t) 1) << GPIO_PIN_COUNT)) {
|
|
ESP_LOGE(GPIO_TAG, "GPIO_PIN mask error \n");
|
|
return ESP_ERR_INVALID_ARG;
|
|
}
|
|
if((pGPIOConfig->mode) & (GPIO_MODE_DEF_OUTPUT)) {
|
|
//GPIO 34/35/36/37/38/39 can only be used as input mode;
|
|
if((gpio_pin_mask & ( GPIO_SEL_34 | GPIO_SEL_35 | GPIO_SEL_36 | GPIO_SEL_37 | GPIO_SEL_38 | GPIO_SEL_39))) {
|
|
ESP_LOGE(GPIO_TAG, "GPIO34-39 can only be used as input mode\n");
|
|
return ESP_ERR_INVALID_ARG;
|
|
}
|
|
}
|
|
do {
|
|
io_reg = GPIO_PIN_MUX_REG[io_num];
|
|
if(((gpio_pin_mask >> io_num) & BIT(0)) && io_reg) {
|
|
ESP_LOGI(GPIO_TAG, "Gpio%02d |Mode:",io_num);
|
|
if((pGPIOConfig->mode) & GPIO_MODE_DEF_INPUT) {
|
|
ESP_LOGI(GPIO_TAG, "INPUT ");
|
|
PIN_INPUT_ENABLE(GPIO_PIN_MUX_REG[io_num]);
|
|
} else {
|
|
PIN_INPUT_DISABLE(GPIO_PIN_MUX_REG[io_num]);
|
|
}
|
|
if((pGPIOConfig->mode) & GPIO_MODE_DEF_OD) {
|
|
ESP_LOGI(GPIO_TAG, "OD ");
|
|
GPIO.pin[io_num].pad_driver = 1; /*0x01 Open-drain */
|
|
} else {
|
|
GPIO.pin[io_num].pad_driver = 0; /*0x00 Normal gpio output */
|
|
}
|
|
if((pGPIOConfig->mode) & GPIO_MODE_DEF_OUTPUT) {
|
|
ESP_LOGI(GPIO_TAG, "OUTPUT ");
|
|
gpio_output_enable(io_num);
|
|
} else {
|
|
gpio_output_disable(io_num);
|
|
}
|
|
if(pGPIOConfig->pull_up_en) {
|
|
ESP_LOGI(GPIO_TAG, "PU ");
|
|
PIN_PULLUP_EN(io_reg);
|
|
} else {
|
|
PIN_PULLUP_DIS(io_reg);
|
|
}
|
|
if(pGPIOConfig->pull_down_en) {
|
|
ESP_LOGI(GPIO_TAG, "PD ");
|
|
PIN_PULLDWN_EN(io_reg);
|
|
} else {
|
|
PIN_PULLDWN_DIS(io_reg);
|
|
}
|
|
ESP_LOGI(GPIO_TAG, "Intr:%d |\n",pGPIOConfig->intr_type);
|
|
gpio_set_intr_type(io_num, pGPIOConfig->intr_type);
|
|
if(pGPIOConfig->intr_type) {
|
|
gpio_intr_enable(io_num);
|
|
} else {
|
|
gpio_intr_disable(io_num);
|
|
}
|
|
PIN_FUNC_SELECT(io_reg, PIN_FUNC_GPIO); /*function number 2 is GPIO_FUNC for each pin */
|
|
} else if(bit_valid && (io_reg == 0)) {
|
|
ESP_LOGW(GPIO_TAG, "io_num=%d does not exist\n",io_num);
|
|
}
|
|
io_num++;
|
|
} while(io_num < GPIO_PIN_COUNT);
|
|
return ESP_OK;
|
|
}
|
|
|
|
esp_err_t gpio_isr_register(uint32_t gpio_intr_num, void (*fn)(void*), void * arg)
|
|
{
|
|
GPIO_CHECK(fn, "GPIO ISR null\n", ESP_ERR_INVALID_ARG);
|
|
ESP_INTR_DISABLE(gpio_intr_num);
|
|
intr_matrix_set(xPortGetCoreID(), ETS_GPIO_INTR_SOURCE, gpio_intr_num);
|
|
xt_set_interrupt_handler(gpio_intr_num, fn, arg);
|
|
ESP_INTR_ENABLE(gpio_intr_num);
|
|
return ESP_OK;
|
|
}
|
|
|
|
/*only level interrupt can be used for wake-up function*/
|
|
esp_err_t gpio_wakeup_enable(gpio_num_t gpio_num, gpio_int_type_t intr_type)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
esp_err_t ret = ESP_OK;
|
|
if((intr_type == GPIO_INTR_LOW_LEVEL) || (intr_type == GPIO_INTR_HIGH_LEVEL)) {
|
|
GPIO.pin[gpio_num].int_type = intr_type;
|
|
GPIO.pin[gpio_num].wakeup_enable = 0x1;
|
|
} else {
|
|
ESP_LOGE(GPIO_TAG, "GPIO wakeup only support Level mode,but edge mode set. gpio_num:%u\n",gpio_num);
|
|
ret = ESP_ERR_INVALID_ARG;
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
esp_err_t gpio_wakeup_disable(gpio_num_t gpio_num)
|
|
{
|
|
GPIO_CHECK(GPIO_IS_VALID_GPIO(gpio_num), "GPIO number error\n", ESP_ERR_INVALID_ARG);
|
|
GPIO.pin[gpio_num].wakeup_enable = 0;
|
|
return ESP_OK;
|
|
}
|