【Java程序员学ESP32】06 ESP-IDF代码学习 - matrix-key 矩阵键盘

最新推荐文章于 2024-06-20 18:32:47 发布

半杯咖啡的代码

最新推荐文章于 2024-06-20 18:32:47 发布

阅读量832

点赞数

分类专栏： ESP32 文章标签：单片机 c++ java

本文链接：https://blog.csdn.net/edimy/article/details/129961063

版权

ESP32 专栏收录该内容

6 篇文章 5 订阅

订阅专栏

在学习Matrix key这个项目的代码前，先做了些功课，了解了一下什么是矩阵键盘，问问ChatGPT 😂：

在这里插入图片描述

找了张形象的照片

在这里插入图片描述
这样的矩阵排列的键盘大多采用Matrix Key的方式实现，还有一个被称为“鬼键”的Bug，不过可以通过给每个键增加一个二极管来解决，有兴趣可以搜索相关内容了解😊

是ESP32官网示例代码中通过实现一个Matrix Key来介绍Dedicated GPIO的使用。要想理解这个项目要搞清楚两个概念：
Matrix Key实现方式
项目中模拟了一个4 x 4矩阵键盘，如何才能监测一个按键是否被按下了呢，如图：

GPIO14   +-------+-------------------+--------------------+--------------------+--------------------+
                 |                   |                    |                    |                    
                 |       +           |       +            |       +            |       +            
                 |     +-+-+         |     +-+-+          |     +-+-+          |     +-+-+
                 +-----+   +-----+   +-----+   +-----+    +-----+   +-----+    +-----+   +-----+
                                 |                   |                    |                    |
                                 |                   |                    |                    |
GPIO15   +-------+-------------------+--------------------+--------------------+--------------------+
                 |               |   |               |    |               |                    |
                 |       +       |   |       +       |    |       +       |            +       |
                 |     +-+-+     |   |     +-+-+     |    |     +-+-+     |          +-+-+     |
                 +-----+   +-----+   +-----+   +-----+    +-----+   +-----+    +-----+   +-----+
                                 |                   |                    |                    |
                                 |                   |                    |                    |
GPIO16   +-------+-------------------+--------------------+--------------------+--------------------+
                 |               |   |               |    |               |    |               |
                 |       +       |   |       +       |    |       +       |    |       +       |
                 |     +-+-+     |   |     +-+-+     |    |     +-+-+     |    |     +-+-+     |
                 +-----+   +-----+   +-----+   +-----+    +-----+   +-----+    +-----+   +-----+
                                 |                   |                    |    |               |
                                 |                   |                    |    |               |
GPIO17   +--------+-------------------+-------------------+--------------------+--------------------+
                 |               |   |               |    |               |    |               |
                 |       +       |   |       +       |    |       +       |    |       +       |
                 |     +-+-+     |   |     +-+-+     |    |     +-+-+     |    |     +-+-+     |
                 +-----+   +-----+   +-----+   +-----+    +-----+   +-----+    +-----+   +-----+
                                 +                   +                    +                    +
                               GPIO10              GPIO11              GPIO12               GPIO13

扫描法

第一步：从P1口的高四位（四个行）输出高电平，低四位（四个列）输出低电平，假设有按键按下，从P1口的高四位读取键盘状态。判断高四位的四行哪一行变成了低电平，就知道是第几行；

第二步：从P1口的低四位（四个列）输出高电平，高四位（四个行）输出低电平，从P1口的低四位读取键盘状态。判断低四位的四列哪一行变成了低电平，就知道是第几列，将两次读取结果组合起来就可以得到当前按键的特征编码。

关键是需要控制四个GPIO口的输入输出高低电压，这里就用到了Dedicated GPIO（专用GPIO）。

Dedicated GPIO（专用GPIO）
任何配置为“专用”的 GPIO 都可以通过 CPU 指令直接访问，专用GPIO通过GPIO 捆绑包来控制。GPIO 捆绑包是一组 GPIO，该组 GPIO 可以在一个 CPU 周期内同时操作。也就是可以在一个CPU时间内将多个GPIO设置成高电平或者低电平。

具体实现方式还是来看代码吧：
首先还是用我们配置好的Clion（参考之前的文章）打开示例工程：
在这里插入图片描述

main函数开始看，这部分代码还是比较简单，逻辑也很清晰

void app_main(void)
{
    matrix_kbd_handle_t kbd = NULL;
    // Apply default matrix keyboard configuration
    matrix_kbd_config_t config = MATRIX_KEYBOARD_DEFAULT_CONFIG();
    // 设置四列对应的GPIO号
    config.col_gpios = (int[]) {
        10, 11, 12, 13
    };
    config.nr_col_gpios = 4;
    // 设置四行对应的GPIO号
    config.row_gpios = (int[]) {
        14, 15, 16, 17
    };
    config.nr_row_gpios = 4;
    // 安装驱动
    matrix_kbd_install(&config, &kbd);
    // 输出事件监听
    matrix_kbd_register_event_handler(kbd, example_matrix_kbd_event_handler, NULL);
    // 启动
    matrix_kbd_start(kbd);
}

再来看下安装驱动的函数matrix_kbd_install，为了看起来清晰一些，省掉了部分初始化代码。这个方法中主要还是对GPIO的设置，开启了内部上拉电阻和开漏

esp_err_t matrix_kbd_install(const matrix_kbd_config_t *config, matrix_kbd_handle_t *mkbd_handle)
{
    ...
    //首先定义了一个结构体，这个结构体主要包含了行，列GPIO的编号，事件处理函数等
    matrix_kbd_t *mkbd = NULL;
    ...
    mkbd = calloc(1, sizeof(matrix_kbd_t) + (config->nr_row_gpios) * sizeof(uint32_t));
    ...
    mkbd->nr_col_gpios = config->nr_col_gpios;
    mkbd->nr_row_gpios = config->nr_row_gpios;

    // 每个GPIO都应该具备输入和输出功能
    // 假设外部电路中没有为每个键设置一个上拉电阻的话，开启内部上拉电阻及开漏
    gpio_config_t io_conf = {
        .mode = GPIO_MODE_INPUT_OUTPUT_OD,
        .pull_up_en = 1
    };
    //将配置应用到所有行和列的gpio
        for (int i = 0; i < config->nr_row_gpios; i++) {
        io_conf.pin_bit_mask = 1ULL << config->row_gpios[i];
        gpio_config(&io_conf);
    }

    dedic_gpio_bundle_config_t bundle_row_config = {
        .gpio_array = config->row_gpios,
        .array_size = config->nr_row_gpios,
        .flags = {
            .in_en = 1,
            .out_en = 1,
        },
    };
    //重点函数 -------------dedic_gpio_new_bundle -------------
    MKBD_CHECK(dedic_gpio_new_bundle(&bundle_row_config, &mkbd->row_bundle) == ESP_OK,
               "create row bundle failed", err, ESP_FAIL);
    ...省略列向配置

    // 这里禁用中断
    dedic_gpio_bundle_set_interrupt_and_callback(mkbd->row_bundle, (1 << config->nr_row_gpios) - 1,
            DEDIC_GPIO_INTR_NONE, NULL, NULL);
    dedic_gpio_bundle_set_interrupt_and_callback(mkbd->col_bundle, (1 << config->nr_col_gpios) - 1,
            DEDIC_GPIO_INTR_NONE, NULL, NULL);

    // 增加一个防抖动的timer时间
    mkbd->debounce_timer = xTimerCreate("kb_debounce", pdMS_TO_TICKS(config->debounce_ms), pdFALSE, mkbd, matrix_kbd_debounce_timer_callback);
    ...

    * mkbd_handle = mkbd;
    return ESP_OK;
...
}

这个方法中重点要看dedic_gpio_new_bundle这个库函数，这是idf库中dedic_gpio中定义的，意思就是前文中提到的GPIO捆绑包，将行向的四个GPIO注册为一个捆绑包

最后来看下执行扫描检测按键的函数matrix_kbd_start

esp_err_t matrix_kbd_start(matrix_kbd_handle_t mkbd_handle)
{
    ...
    // 将行向设置为高电平
    dedic_gpio_bundle_write(mkbd_handle->row_bundle, (1 << mkbd_handle->nr_row_gpios) - 1, (1 << mkbd_handle->nr_row_gpios) - 1);
    // 将列向设置为低电平
    dedic_gpio_bundle_write(mkbd_handle->col_bundle, (1 << mkbd_handle->nr_col_gpios) - 1, 0);

    for (int i = 0; i < mkbd_handle->nr_row_gpios; i++) {
        mkbd_handle->row_state[i] = (1 << mkbd_handle->nr_col_gpios) - 1;
    }

    // 开启行向的中断检测，某一行为低电平代表按键在这一行
    dedic_gpio_bundle_set_interrupt_and_callback(mkbd_handle->row_bundle, (1 << mkbd_handle->nr_row_gpios) - 1,
            DEDIC_GPIO_INTR_BOTH_EDGE, matrix_kbd_row_isr_callback, mkbd_handle);
    ...
}

dedic_gpio_bundle_write这个函数也是idf提供的，用于操作GPIO捆绑包。进到函数里面可以看到idf是通过汇编的指令完成操作的。回想一下GPIO bundle的介绍：
在这里插入图片描述
GPIO bundle和cpu有紧密的关系，在使用上也收到cpu的限制，这里提到的GPIO矩阵和IO MUX是另外两个概念，后续再继续学习~