简体中文
English
简体中文
日本語

Arduino 上手教程

2. 设备开发 & 案例程序

5. 扩展模块

6. 应用案例

CoreMatrix Button 按键

CoreMatrix 按键输入相关 API 与案例程序。

注意
使用时需要在主循环中包含 M5.update() 函数用于读取状态更新,并尽可能减少阻塞,否则可能无法及时获取按键变化状态。

案例程序

编译要求

  • M5Stack 板管理版本 >= 3.3.10-a
  • 开发板选项 = M5CoreMatrix
  • M5Unified 库版本 >= 0.2.29
  • M5GFX 库版本 >= 0.2.36

KEY1、KEY2、KEY3 分别连接 M5PM1 的 G0、G1、G2,通过上拉电阻连接到 3V3_L1,按下时为低电平,M5Unified 将三个按键映射为 M5.BtnA、M5.BtnB、M5.BtnC。

cpp
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
#include <M5Unified.h>

static void drawButtons(const bool pressed[3])
{
  M5.Display.startWrite();
  M5.Display.fillScreen(TFT_BLACK);

  for (int i = 0; i < 3; ++i) {
    const int x = 1 + i * 5;
    M5.Display.drawRect(x, 3, 4, 10, TFT_WHITE);
    if (pressed[i]) {
      M5.Display.fillRect(x + 1, 4, 2, 8, TFT_WHITE);
    }
  }

  M5.Display.endWrite();
  M5.Display.display();
}

void setup()
{
  auto cfg = M5.config();
  cfg.serial_baudrate = 115200;
  M5.begin(cfg);

  M5.Display.setColorDepth(8);
  M5.Display.setRotation(1);
  M5.Display.setBrightness(128);

  const bool pressed[3] = {false, false, false};
  drawButtons(pressed);
}

void loop()
{
  M5.update();

  const bool pressed[3] = {
    M5.BtnA.isPressed(),
    M5.BtnB.isPressed(),
    M5.BtnC.isPressed(),
  };

  static bool lastPressed[3] = {false, false, false};
  bool changed = false;
  for (int i = 0; i < 3; ++i) {
    if (pressed[i] != lastPressed[i]) {
      changed = true;
      lastPressed[i] = pressed[i];
    }
  }
  if (changed) {
    drawButtons(pressed);
  }

  if (M5.BtnA.wasPressed()) Serial.println("KEY1 pressed");
  if (M5.BtnB.wasPressed()) Serial.println("KEY2 pressed");
  if (M5.BtnC.wasPressed()) Serial.println("KEY3 pressed");

  if (M5.BtnA.wasClicked()) Serial.println("KEY1 clicked");
  if (M5.BtnB.wasClicked()) Serial.println("KEY2 clicked");
  if (M5.BtnC.wasClicked()) Serial.println("KEY3 clicked");

  delay(10);
}

点阵屏显示三个空心方框,分别对应 KEY1、KEY2、KEY3。按住按键时对应方框被填充,串口监视器会输出按下和单击事件。

API

CoreMatrix 按键部分使用了 M5Unified 库中的 Button_Class,更多按键相关的 API 可以参考下方文档:

Page Tools
PDF
On This Page