这是一篇学习笔记，跟踪按键驱动代码，仅供自己查阅。
以例子《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 heregpio_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_AW= 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_tstate_event_bits;xSemaphoreHandle lock;inttask_stack;inttask_prio;inttask_core;audio_thread_t audio_thread;bool ext_stack;bool run;esp_periph_event_tevent_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;}
