ESP32音频框架 ESP-ADF 添加按键外设流程代码跟踪

这是一篇学习笔记，跟踪按键驱动代码，仅供自己查阅。
以例子《esp-adf\examples\player\pipeline_play_sdcard_music》的源码来分析。

1. 《play_sdcard_music_example.c》主函数app_main分析

下面直接贴出主函数中和按键相关的代码。

void app_main(void)
{
    
......
    ESP_LOGI(TAG, "[1.0] Initialize peripherals management");
    esp_periph_config_t periph_cfg = DEFAULT_ESP_PERIPH_SET_CONFIG();
    esp_periph_set_handle_t set = esp_periph_set_init(&periph_cfg);//------(1)
    ESP_LOGI(TAG, "[1.1] Initialize and start peripherals");
    audio_board_key_init(set);				//------(2)
    audio_board_sdcard_init(set, SD_MODE_1_LINE);
......
    ESP_LOGI(TAG, "[ 3 ] Create and start input key service");
    input_key_service_info_t input_key_info[] = INPUT_KEY_DEFAULT_INFO();//------(3)
    input_key_service_cfg_t input_cfg = INPUT_KEY_SERVICE_DEFAULT_CONFIG();//------(4)
    input_cfg.handle = set;		//------(5)
    periph_service_handle_t input_ser = input_key_service_create(&input_cfg);//------(6)
    input_key_service_add_key(input_ser, input_key_info, INPUT_KEY_NUM);//------(7)
    periph_service_set_callback(input_ser, input_key_service_cb,
    							 (void *)board_handle);//------(8)
......
}

这里对每一行代码进行分析，跟踪。

1.1 esp_periph_set_handle_t set = esp_periph_set_init(&periph_cfg);//------(1)

这个代码没有理解。函数的实现在《esp-adf\components\esp_peripherals\esp_peripherals.c》：

esp_periph_set_handle_t esp_periph_set_init(esp_periph_config_t *config)
{
    
    esp_periph_set_t *periph_sets = NULL;
    int _err_step = 1;
    bool _success =
        (
            (periph_sets                   = audio_calloc(1, sizeof(esp_periph_set_t))) && _err_step ++ &&
            (periph_sets->state_event_bits = xEventGroupCreate())                  && _err_step ++ &&
            (periph_sets->lock             = mutex_create())                       && _err_step ++
        );

    AUDIO_MEM_CHECK(TAG, _success, {
    
        goto _periph_init_failed;
    });

    STAILQ_INIT(&periph_sets->periph_list);

    //TODO: Should we uninstall gpio isr service??
    //TODO: Because gpio need for sdcard and gpio, then install isr here

    gpio_install_isr_service(ESP_INTR_FLAG_LEVEL1);

    periph_sets->run = false;
    xEventGroupClearBits(periph_sets->state_event_bits, STARTED_BIT);
    xEventGroupSetBits(periph_sets->state_event_bits, STOPPED_BIT);
    periph_sets->task_stack = config->task_stack;
    periph_sets->task_prio = config->task_prio;
    periph_sets->task_core = config->task_core;
    periph_sets->ext_stack = config->extern_stack;

    audio_event_iface_cfg_t event_cfg = AUDIO_EVENT_IFACE_DEFAULT_CFG();
    event_cfg.queue_set_size = 0;
    event_cfg.context = periph_sets;
    event_cfg.on_cmd = process_peripheral_event;
    periph_sets->event_handle.iface = audio_event_iface_init(&event_cfg);

    AUDIO_MEM_CHECK(TAG, periph_sets->event_handle.iface, goto _periph_init_failed);
    audio_event_iface_set_cmd_waiting_timeout(periph_sets->event_handle.iface, DEFAULT_ESP_PERIPH_WAIT_TICK);
    return periph_sets;

_periph_init_failed:
    if (periph_sets) {
    
        mutex_destroy(periph_sets->lock);
        vEventGroupDelete(periph_sets->state_event_bits);

        if (periph_sets->event_handle.iface) {
    
            audio_event_iface_destroy(periph_sets->event_handle.iface);
        }

        audio_free(periph_sets);
        periph_sets = NULL;
    }
    return NULL;
}

1.2 audio_board_key_init(set); //------(2)

根据自己的开发板选择对应的按键IO口，我用“ESP32_A1S_Audio_Kit_v2_2”的文件替换掉“lyrat_v4_3”的文件。这样在menuconfig 配置时，直接选择 Audio HAL == lyrat_v4_3。
看看本函数的实现代码：《D:\study\esp-adf\components\audio_board\lyrat_v4_3\board.c》

esp_err_t audio_board_key_init(esp_periph_set_handle_t set)
{
    
    periph_button_cfg_t btn_cfg = {
    
        .gpio_mask =  ESP32_A1S_AUDIO_KEY1 | 
                      ESP32_A1S_AUDIO_KEY2 |
                      ESP32_A1S_AUDIO_KEY3 |
                      ESP32_A1S_AUDIO_KEY4 |
                      ESP32_A1S_AUDIO_KEY5 |
                      ESP32_A1S_AUDIO_KEY6 , //REC BTN & MODE BTN
    };
    esp_periph_handle_t button_handle = periph_button_init(&btn_cfg);
    AUDIO_NULL_CHECK(TAG, button_handle, return ESP_ERR_ADF_MEMORY_LACK);
    esp_err_t ret = ESP_OK;
    ret = esp_periph_start(set, button_handle);
    if (ret != ESP_OK) {
    
        return ret;
    }
    return ret;
}

1.3 input_key_service_info_t input_key_info[] =INPUT_KEY_DEFAULT_INFO()//------(3)

结合安可信的 ESP32-AUDIO-kit 底板按键部分原理图，可以更加清晰的理解。

通过电阻的选择，来决定使用电平值按键还是模拟值按键：
电平值按键：R55-R64 使用合适的电阻，R66-R70留空，需要6个IO口。
模拟值按键：R55-R64 留空，R66-R70 使用0R电阻，只需要1个IO口。
这个数据类型是一个结构体：

typedef struct {
    
    esp_periph_id_t  type;  /*!< ID of peripherals，--总线类型，和按键相关的总线有3种：电平总线和模拟输入总线，触摸按键总线 */
    int              user_id; /*!< The key's user id -- 用户自定义功能ID */
    int              act_id;  /*!< The key's action id -- 对应IO口 GPIO_NUM_x */
} input_key_service_info_t;
typedef enum {
    
    PERIPH_ID_BUTTON     = AUDIO_ELEMENT_TYPE_PERIPH + 1,   //--电平总线
    PERIPH_ID_TOUCH      = AUDIO_ELEMENT_TYPE_PERIPH + 2,	//--触摸总线
    PERIPH_ID_SDCARD     = AUDIO_ELEMENT_TYPE_PERIPH + 3,
    PERIPH_ID_WIFI       = AUDIO_ELEMENT_TYPE_PERIPH + 4,
    PERIPH_ID_FLASH      = AUDIO_ELEMENT_TYPE_PERIPH + 5,
    PERIPH_ID_AUXIN      = AUDIO_ELEMENT_TYPE_PERIPH + 6,
    PERIPH_ID_ADC        = AUDIO_ELEMENT_TYPE_PERIPH + 7,	//--模拟输入总线
    PERIPH_ID_CONSOLE    = AUDIO_ELEMENT_TYPE_PERIPH + 8,
    PERIPH_ID_BLUETOOTH  = AUDIO_ELEMENT_TYPE_PERIPH + 9,
    PERIPH_ID_LED        = AUDIO_ELEMENT_TYPE_PERIPH + 10,
    PERIPH_ID_SPIFFS     = AUDIO_ELEMENT_TYPE_PERIPH + 11,
    PERIPH_ID_ADC_BTN    = AUDIO_ELEMENT_TYPE_PERIPH + 12,
    PERIPH_ID_IS31FL3216 = AUDIO_ELEMENT_TYPE_PERIPH + 13,
    PERIPH_ID_GPIO_ISR   = AUDIO_ELEMENT_TYPE_PERIPH + 14,
    PERIPH_ID_WS2812     = AUDIO_ELEMENT_TYPE_PERIPH + 15,
    PERIPH_ID_AW2013     = AUDIO_ELEMENT_TYPE_PERIPH + 16,
    PERIPH_ID_LCD        = AUDIO_ELEMENT_TYPE_PERIPH + 17
} esp_periph_id_t;

给结构体数组input_key_info[]赋予初始值 INPUT_KEY_DEFAULT_INFO()
这是一个宏定义，具体如下：

......	//这里全部使用电平值按键
#define BUTTON_REC_ID GPIO_NUM_36 //KEY1
#define BUTTON_MODE_ID GPIO_NUM_19 //KEY3
#define BUTTON_SET_ID GPIO_NUM_5 //KEY2 -- old==GPIO_NUM_13
#define BUTTON_PLAY_ID GPIO_NUM_23 //KEY4
#define BUTTON_VOLUP_ID GPIO_NUM_18 //KEY5
#define BUTTON_VOLDOWN_ID GPIO_NUM_36 //KEY6 -- old==GPIO_NUM_5
......
#define INPUT_KEY_DEFAULT_INFO() {
       \ {
       \ .type = PERIPH_ID_BUTTON, \ .user_id = INPUT_KEY_USER_ID_REC, \ .act_id = BUTTON_REC_ID, \ }, \ {
       \ .type = PERIPH_ID_BUTTON, \ .user_id = INPUT_KEY_USER_ID_MODE, \ .act_id = BUTTON_MODE_ID, \ }, \ {
       \ .type = PERIPH_ID_BUTTON, \ .user_id = INPUT_KEY_USER_ID_SET, \ .act_id = BUTTON_SET_ID, \ }, \ {
       \ .type = PERIPH_ID_BUTTON, \ .user_id = INPUT_KEY_USER_ID_PLAY, \ .act_id = BUTTON_PLAY_ID, \ }, \ {
       \ .type = PERIPH_ID_BUTTON, \ .user_id = INPUT_KEY_USER_ID_VOLUP, \ .act_id = BUTTON_VOLUP_ID, \ }, \ {
       \ .type = PERIPH_ID_BUTTON, \ .user_id = INPUT_KEY_USER_ID_VOLDOWN, \ .act_id = BUTTON_VOLDOWN_ID, \ } \ }

1.4 input_key_service_cfg_t input_cfg = INPUT_KEY_SERVICE_DEFAULT_CONFIG();//------(4)

input_cfg.handle = set; //------(5)
(4)(5)行共同对input_cfg 进行初始化。
set这个句柄我看不懂。

这个是按键服务配置结构体，看看里面包含了哪些内容：

// <esp-adf\components\esp_peripherals\esp_peripherals.c>
typedef struct esp_periph_sets {
    
    EventGroupHandle_t                              state_event_bits;
    xSemaphoreHandle                                lock;
    int                                             task_stack;
    int                                             task_prio;
    int                                             task_core;
    audio_thread_t                                  audio_thread;
    bool                                            ext_stack;
    bool                                            run;
    esp_periph_event_t                              event_handle;
    STAILQ_HEAD(esp_periph_list_item, esp_periph)   periph_list;
} esp_periph_set_t;
// <esp-adf\components\esp_peripherals\include\esp_peripherals.h>
typedef struct esp_periph_sets *esp_periph_set_handle_t;
//<esp-adf\components\input_key_service\include\input_key_service.h>
typedef struct {
    
    periph_service_config_t based_cfg; /*!< Peripheral service configuration */
    esp_periph_set_handle_t handle;    /*!< Peripheral set handle */
} input_key_service_cfg_t;
#define INPUT_KEY_SERVICE_DEFAULT_CONFIG() {
       \ .based_cfg = {
       \ .task_stack = INPUT_KEY_SERVICE_TASK_STACK_SIZE, \ .task_prio = INPUT_KEY_SERVICE_TASK_PRIORITY, \ .task_core = INPUT_KEY_SERVICE_TASK_ON_CORE, \ .extern_stack = false \ } \ }

1.5 periph_service_handle_t input_ser = input_key_service_create(&input_cfg);//------(6)

创建按键服务句柄，函数实现在《esp-adf\components\input_key_service\input_key_service.c》。

periph_service_handle_t input_key_service_create(input_key_service_cfg_t *input_key_config)
{
    
    AUDIO_NULL_CHECK(TAG, input_key_config, return NULL);
    periph_service_config_t *input_cfg = &input_key_config->based_cfg;

    periph_service_config_t service_cfg = {
    
        .task_stack = input_cfg->task_stack,
        .task_prio  = input_cfg->task_prio,
        .task_core  = input_cfg->task_core,
        .extern_stack = input_cfg->extern_stack,
        .task_func  = input_key_service_task,
        .service_start = input_key_service_start,
        .service_stop = input_key_service_stop,
        .service_destroy = input_key_service_destroy,
        .service_ioctl = NULL,
        .service_name = "input_key_service",
    };

    input_key_service_t *input_key_ser = NULL;
    periph_service_handle_t input_key_handle = NULL;

    input_key_ser = (input_key_service_t *)audio_calloc(1, sizeof(input_key_service_t));
    AUDIO_NULL_CHECK(TAG, input_key_ser, goto _create_service_failed);

    if (input_key_config->handle) {
    
        input_key_ser->periph_set_handle = input_key_config->handle;
    } else {
    
        ESP_LOGE(TAG, "peripherals set handle is NULL");
        free(input_key_ser);
        return NULL;
    }
    input_key_ser->ser_state = PERIPH_SERVICE_STATE_UNKNOWN;

    STAILQ_INIT(&input_key_ser->input_info_list);

    service_cfg.user_data = (void *)input_key_ser;

    input_key_handle = periph_service_create(&service_cfg);
    AUDIO_NULL_CHECK(TAG, input_key_handle, goto _create_service_failed);

    return input_key_handle;

_create_service_failed:
    if (input_key_handle) {
    
        audio_free(input_key_handle);
        input_key_handle = NULL;
    }
    if (input_key_ser) {
    
        audio_free(input_key_ser);
        input_key_ser = NULL;
    }
    return NULL;
}

1.6 input_key_service_add_key(input_ser, input_key_info, INPUT_KEY_NUM);//------(7)

把包含6个按键信息的数组input_key_info添加到按键服务函数中。
《esp-adf\components\input_key_service\input_key_service.c》

esp_err_t input_key_service_add_key(periph_service_handle_t input_key_handle, input_key_service_info_t *input_key_info, int add_key_num)
{
    
    AUDIO_NULL_CHECK(TAG, input_key_handle, return ESP_ERR_INVALID_ARG);
    AUDIO_NULL_CHECK(TAG, input_key_info, return ESP_ERR_INVALID_ARG);
    if (add_key_num <= 0) {
    
        return ESP_FAIL;
    }

    input_key_service_t *input_key_ser = periph_service_get_data(input_key_handle);
    AUDIO_NULL_CHECK(TAG, input_key_ser, return ESP_FAIL);

    for (int i = 0; i < add_key_num; i++) {
    
        input_key_node_t *input_key_node = (input_key_node_t *)audio_calloc(1, sizeof(input_key_node_t));
        AUDIO_NULL_CHECK(TAG, input_key_node, return ESP_FAIL);
        memcpy(&input_key_node->input_key_info, &input_key_info[i], sizeof(input_key_service_info_t));
        STAILQ_INSERT_TAIL(&input_key_ser->input_info_list, input_key_node, entries);
    }
    return ESP_OK;
}