4x4矩阵键盘接Arduino:扫描原理到密码验证

2026-11-08 07:33:15 79阅读

矩阵键盘是嵌入式输入里最经典的方案:16 个按键只吃 8 个 GPIO,一张薄膜键盘十几块钱,配上 Keypad 库十几行代码就能跑。这篇把 4x4 矩阵键盘接 Arduino 的完整链路理一遍——行列扫描原理、接线、装库、读键,再到把按键序列攒成密码验证。写之前对照了 lastminuteengineers 和 ArduinoGetStarted 两篇教程,加上 Keypad 库的 GitHub 仓库,代码原样搬运,可直接照抄复现。

4x4矩阵键盘接Arduino

16个键只占8个脚:矩阵扫描是怎么回事

先解决新手最容易懵的问题:16 个按键,为什么只用 8 根线?把 16 个键排成 4 行 4 列,每个键落在某一行与某一列的交叉点上,行线 4 根、列线 4 根,一共 8 根线引出来——这就是"矩阵"的含义。要是每个键单独接线,16 个键得吃掉 16 个 GPIO,UNO 直接不够分。

扫描逻辑不复杂:列线轮流拉低,行线作输入读取。某根列线为低时按下按键,对应行线就会被读到低电平,行列坐标一交叉,键位就定了。8 根线撑 16 个键,4x3、3x4 同理;照这个思路扩到 8x8,64 个键也只要 16 根线。省 IO 的代价是 CPU 要不停轮询,好在 Keypad 库把这件事整个包了。

4x3与4x4矩阵薄膜键盘外观

矩阵键盘行列引脚定义

引脚顺序要看清:薄膜排线从左到右一般是 R1、R2、R3、R4、C1、C2、C3、C4,但不同厂家排序有差异。接错的症状很典型——按一个键,串口吐出另一个键的字符。遇到这种情况别急着怀疑代码,先把排线和引脚映射表对着实物核一遍。

接线与Keypad库安装

按 ArduinoGetStarted 的接线图来:行线 R1-R4 接数字口 9、8、7、6,列线 C1-C4 接 5、4、3、2。引脚可以换,代码里两组数组跟着改就行,但行列对应关系不能乱。

4x4矩阵键盘接Arduino UNO接线图

库用 Mark Stanley 和 Alexander Brevig 维护的 Keypad 库,写这篇时库管理器里的最新版本是 3.1.1,IDE 的库管理器里搜 Keypad 直接装。这个库是从 Arduino Playground 的老页面迁到 GitHub 的(仓库 Chris--A/Keypad),装完建议先跑 examples 里的 HelloKeypad,能出键值说明环境和接线都没问题。

第一个程序:把按键读进串口

下面是 lastminuteengineers 教程里的 4x4 读键例程,逐字符原样搬运。头文件用引号形式书写,与尖括号写法在 Arduino 工具链下对库搜索路径等价,不影响编译。

#include "Keypad.h"

const byte ROWS = 4;  //four rows
const byte COLS = 4;  //four columns

char keys[ROWS][COLS] = {
  { '1', '2', '3', 'A' },
  { '4', '5', '6', 'B' },
  { '7', '8', '9', 'C' },
  { '*', '0', '#', 'D' }
};

byte rowPins[ROWS] = { 9, 8, 7, 6 };  //connect to the row pinouts of the keypad
byte colPins[COLS] = { 5, 4, 3, 2 };  //connect to the column pinouts of the keypad

//Create an object of keypad
Keypad keypad = Keypad(makeKeymap(keys), rowPins, colPins, ROWS, COLS);

void setup() {
  Serial.begin(9600);
}

void loop() {
  char key = keypad.getKey();  // Read the key

  // Print if key pressed
  if (key) {
    Serial.print("Key Pressed : ");
    Serial.println(key);
  }
}

烧录后打开串口监视器,波特率 9600,每按一个键就回显一行 Key Pressed。getKey() 是非阻塞的:没有按键时返回 0,loop 照常转,所以可以和其他任务混在同一个循环里跑。

串口监视器回显按键字符

多说一句库替你干了什么:轮询扫描、消抖、按键状态机都在 Keypad 类内部完成,3.0 之后的版本还支持多键同时检测,走 getKeys() 配事件回调。教程场景用 getKey() 就够了。

从读键到密码验证

读键只是半截活,密码验证的本质是把按键序列攒成字符串去比对。ArduinoGetStarted 的例程思路很清晰:星号键清空输入,井号键触发比对,其余字符依次追加进 input_password,井号按下时和预设密码比对并给出结论。例程原样搬运,注意它的 keymap 是 4x3 布局——换 4x4 键盘时,把 keymap 和两组引脚数组换成上一节 4x4 的定义即可,验证逻辑一行不用动。

/*
 * Created by ArduinoGetStarted.com
 *
 * This example code is in the public domain
 *
 * Tutorial page: https://arduinogetstarted.com/tutorials/arduino-keypad
 */

#include "Keypad.h"

const int ROW_NUM = 4; //four rows
const int COLUMN_NUM = 3; //three columns

char keys[ROW_NUM][COLUMN_NUM] = {
  {'1','2','3'},
  {'4','5','6'},
  {'7','8','9'},
  {'*','0','#'}
};

byte pin_rows[ROW_NUM] = {9, 8, 7, 6}; //connect to the row pinouts of the keypad
byte pin_column[COLUMN_NUM] = {5, 4, 3}; //connect to the column pinouts of the keypad

Keypad keypad = Keypad( makeKeymap(keys), pin_rows, pin_column, ROW_NUM, COLUMN_NUM );

const String password = "1234"; // change your password here
String input_password;

void setup(){
  Serial.begin(9600);
  input_password.reserve(32); // maximum input characters is 33, change if needed
}

void loop(){
  char key = keypad.getKey();

  if (key){
    Serial.println(key);

    if(key == '*') {
      input_password = ""; // clear input password
    } else if(key == '#') {
      if(password == input_password) {
        Serial.println("password is correct");
        // DO YOUR WORK HERE
        
      } else {
        Serial.println("password is incorrect, try again");
      }

      input_password = ""; // clear input password
    } else {
      input_password += key; // append new character to input password string
    }
  }
}

串口里先按星号清空、输入 1234、按井号,就能看到 password is correct。要换密码改 password 那一行;要支持多个密码,用多个字符串逐个比对即可,ArduinoGetStarted 的密码门锁教程就是这个思路的加长版,后面还接了执行器做开锁动作,本文不展开。

复现小结与三个坑

  • 引脚映射是第一大坑:排线顺序和代码数组的顺序必须一一对应,串口回显错键先查这里,再查代码。
  • 串口没输出先查两处:波特率是不是 9600、行线有没有接反。行线的输入模式由库在 begin 阶段处理,不要自己再额外接上拉下拉去"帮忙"。
  • input_password.reserve(32) 不是装饰:它给字符串预分配内存,避免 loop 里反复追加导致堆碎片,例程注释写明最大 33 个字符,超长密码要改这个值。

整套复现成本很低:一块 UNO、一张 4x4 薄膜键盘、8 根杜邦线、一个 3.1.1 的 Keypad 库。真正值得花时间的是把行列扫描吃透——这是很多更复杂输入方案的底子,自制键盘固件、旋转编码器阵列,走的都是同一套扫描思想。


作者:开源复现员
链接:https://www.aiddithome.com/p/1047dcaa00615e.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
5条评论
胶佬憨憨
1楼 · 2026-11-08 07:34:12

getKey() 非阻塞这点很实用,配合 millis 做状态机正好,不然 delay 一加整个循环都卡住。

只看不说话
2楼 · 2026-11-08 07:34:12

试了密码那段例程,1234 按井号确实回 correct,星号清空也好使。keymap 是 4x3 的这点楼主特意标出来了,比一些教程直接甩代码强。

线比代码多
3楼 · 2026-11-08 07:34:12

reserve(32) 那个细节加分,好多人写 String 追加都不管内存碎片,跑久了真的会出怪问题。

周五下班搞一搞
4楼 · 2026-11-08 07:34:12

8 根线撑 16 个键这个思路第一次见还是拆计算器的时候,现在轮到自己接线才明白行列交叉的妙处。

老张装机
5楼 · 2026-11-08 07:34:11

这篇文章把行列扫描讲到位了。之前接 4x4 键盘按 1 出 7,查了半天代码,最后发现是排线顺序和 colPins 数组对不上,跟文里说的第一大坑一模一样。引号形式的 #include 一开始还以为抄错了,查了 GCC 文档才知道对库搜索路径是等价的,学到了。