1. 代码开发工具里的第一课:Arduino基础实验不是“烧进去就行”
在Arduino这类代码开发工具上做基础实验,最常见的翻车不是代码写不出来,而是上传设置、接线和库参数没有对齐。按键消抖和液晶显示屏字符输出看起来是两段独立例程,实际都在练同一件事:把引脚编号、上拉方式、串口波特率、库函数参数变成可重复验证的步骤。这套实验适合刚接触Arduino嵌入式开发的人,也适合已经能点亮屏幕、但一改引脚就乱的人。它解决的不是“写一个Demo”,而是让你能判断失败发生在工具链、接线还是代码逻辑上。
我建议先从按键程序入手,因为它能把串口输出、引脚输入和消抖逻辑一次跑通;再把同一套引脚核对习惯搬到LCD1602上。代码只是起点,真正决定实验效果的是接线是否完整、参数是否一致,以及你愿不愿意多调试几轮。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 用Arduino代码开发工具跑通按键消抖:引脚、上拉与串口验证
按键实验最容易让人产生“代码没问题,是板子坏了”的错觉。机械按键在按下和松开瞬间会有几毫秒到几十毫秒的抖动,代码如果只读一次电平,就会把一次按下识别成多次。这里用内部上拉输入,按键另一端接GND,按下时读到低电平;再用25ms延时做二次确认,最后用key和key1比较把长按限制成一次上报。
2.1 先定硬件与工具参数:四个按键、上拉输入、9600串口
接线前先把四个按键分别接到8、9、10、11号引脚,按键另一端接GND。代码里用INPUT_PULLUP打开内部上拉,所以不要外接下拉电阻去“帮忙”,否则按下电平会被拉扯得不清楚。打开Arduino代码开发工具后,新建一个Sketch,把下面代码完整贴进去,上传前确认板卡型号和串口端口选对。
c复制//独立按键例程,带消抖动
int k1 = 8, k2 = 9, k3 = 10, k4 = 11;
int key = 0;//定义键值
int key1 = 0;
void setup()
{
Serial.begin(9600);
pinMode(k1, INPUT_PULLUP);
pinMode(k2, INPUT_PULLUP);
pinMode(k3, INPUT_PULLUP);
pinMode(k4, INPUT_PULLUP);
}
//主循环,查询有无按键,有按键在屏幕显示结果
void loop()
{
read_key(); //读取按键
if (key != 0 )
{
Serial.print("K");
Serial.print(key);
Serial.println(" is pressed");
key = 0;
}
}
void read_key() { //
if (!digitalRead(k1) || !digitalRead(k2) || !digitalRead(k3) || !digitalRead(k4)) //同时读取4个按键值,有按下消抖动
{
delay (25); //消抖动延时
if (!digitalRead(k1) || !digitalRead(k2) || !digitalRead(k3) || !digitalRead(k4))
//再次读取按键值,确认有按键
{
if (!digitalRead(k1)) key = 1;//键值输出
if (!digitalRead(k2)) key = 2;
if (!digitalRead(k3)) key = 3;
if (!digitalRead(k4)) key = 4;
}
else key = 0;
}
if (key1 != key)
key1 = key;
else
key = 0;
}
这段代码的setup()只做两件事:把串口开到9600,把四个按键引脚设成内部上拉输入。loop()每轮调用read_key(),只要key不为0就打印“K几 is pressed”,然后立刻把key清零,避免同一个键值在后续逻辑里继续被消费。
参数可以这样记:
| 参数 | 材料中的值 | 作用与调整边界 |
|---|---|---|
| k1~k4 | 8、9、10、11 | 按键引脚,改引脚时四个判断要一起改 |
| INPUT_PULLUP | 四个引脚都设 | 内部上拉,按下为低电平,接GND |
| Serial | 9600 | 串口监视器也要选9600,否则乱码 |
| delay | 25ms | 消抖等待,手感太灵敏可小幅加,别加到明显迟滞 |
| key1 | 初值0 | 和key比较,保证一次按下只报一次 |
这里的25ms不是玄学数字,它是在“消抖要稳”和“按键响应别太肉”之间取的折中。如果你把delay(25)删掉,机械抖动会让串口连续打印多条;如果加到几百毫秒,快速点按就会丢动作。先按材料值跑通,再根据按键手感微调。
2.2 读代码:消抖延时和key1比较各管什么
read_key()的第一层判断是“四个引脚里有没有任意一个是低电平”。只要有低电平,就先等25ms,让触点抖动过去;第二层再读一次,如果仍然有低电平,才认为真的按下了。这个结构本质上是一个很轻量的软件消抖,不需要额外定时器,也不会把主循环完全堵死太久。
接着看按键赋值:四个if按顺序判断k1到k4,谁读到低电平就把key设成对应编号。这里默认同一时刻只按一个键;如果同时按两个键,后面的判断会覆盖前面的键值。做单键实验没问题,做组合键就要另写逻辑,不能直接在这段代码上叠。
最后三行是防连发:
c复制if (key1 != key)
key1 = key;
else
key = 0;
第一次按下时,key变成1,key1还是0,两者不同,于是key1被更新为1,key保留给loop()打印。下一轮如果手还按着,read_key()又把key设成1,但此时key1也是1,两者相同,key被清成0,于是不会重复上报。手指松开后,key回到0,key1是1,两者再次不同,key1被更新为0,系统回到待按状态。这个“锁存再释放”的小逻辑,删掉就会遇到长按连发。
常见改法是把四个按键改成数组循环,但材料里的写法是四个独立变量,改的时候要同步改pinMode、digitalRead和键值判断三处。不要只改引脚定义,否则串口打印的K编号和实际按键对不上。
2.3 上传后的验证:串口应看到什么,没看到先查哪三处
编译通过后上传,打开串口监视器,波特率选9600。按K1,串口应出现K1 is pressed;按K2到K4,编号依次变化。如果按下去没有任何输出,先查三处:串口监视器是否真的打开、端口是否选对、按键另一端是否接到GND。内部上拉已经打开,按键悬空不接GND时读数不会稳定变成低电平。
如果输出有但编号乱,检查k1~k4的定义和实际接线是否一一对应。如果一次按下打印很多条,先看key1比较有没有被误删,再看delay(25)是否被改成0。串口打印本身也会影响节奏,调试时不要一边开很多窗口一边怀疑代码。
提示:上传后如果串口没有反应,按一下板子复位再打开监视器;有些工具在打开监视器时会复位板卡,顺序不对容易误判。
3. 液晶显示屏字符输出:在代码开发工具里管理自定义字符
LCD1602的难点不在“写字符串”,而在库的构造参数、坐标和自定义字符编号。材料里用了一个LCD库,构造函数是LCD(int CS, int DATA, int CLK),显示前要调用initial_LCD1602()。自定义字符用8字节点阵数组描述,再用createChar绑定到编号,最后用Write_Char(byte(编号))显示。
3.1 8字节点阵与createChar:自定义心形、笑脸、手臂
先看动态表情这段代码。它定义了心形、笑脸、皱眉、手臂放下、手臂举起五个8字节数组,每个数组的8个二进制数对应字符点阵的8行。lcd.createChar(0, heart)把心形绑定到编号0,createChar(1, smiley)绑定到1,后面依次到4。
c复制#include <LCD.h>
LCD lcd (33, 31, 29);
// make some custom characters:
byte heart[8] = {
0b00000,
0b01010,
0b11111,
0b11111,
0b11111,
0b01110,
0b00100,
0b00000
};
byte smiley[8] = {
0b00000,
0b00000,
0b01010,
0b00000,
0b00000,
0b10001,
0b01110,
0b00000
};
byte frownie[8] = {
0b00000,
0b00000,
0b01010,
0b00000,
0b00000,
0b00000,
0b01110,
0b10001
};
byte armsDown[8] = {
0b00100,
0b01010,
0b00100,
0b00100,
0b01110,
0b10101,
0b00100,
0b01010
};
byte armsUp[8] = {
0b00100,
0b01010,
0b00100,
0b10101,
0b01110,
0b00100,
0b00100,
0b01010
};
void setup() {
// create a new character
lcd.createChar(0, heart);
// create a new character
lcd.createChar(1, smiley);
// create a new character
lcd.createChar(2, frownie);
// create a new character
lcd.createChar(3, armsDown);
// create a new character
lcd.createChar(4, armsUp);
// 初始化
lcd.initial_LCD1602();
// 向LCD打印消息
lcd.Write_String("I ");
lcd.Write_Char(byte(0));
lcd.Write_String(" Embedded! ");
lcd.Write_Char(byte(1));
}
void loop() {
int delayTime =400;
lcd.SET_XY(4, 1);
lcd.Write_Char(3);
lcd.SET_XY(10, 1);
lcd.Write_Char(3);
delay(delayTime);
lcd.SET_XY(4, 1);
lcd.Write_Char(4);
lcd.SET_XY(10, 1);
// draw him arms up:
lcd.Write_Char(4);
delay(delayTime);
}
这段代码的关键顺序是:先定义点阵数组,再createChar绑定编号,再initial_LCD1602()初始化,最后用Write_String和Write_Char把字符写到屏幕。Write_String("I ")写普通字符,Write_Char(byte(0))写编号0的心形。loop()里用SET_XY(4,1)和SET_XY(10,1)把两个手臂字符放在第二行的两个位置,每400ms切换armsDown和armsUp,形成动态表情。
参数表:
| 项目 | 材料中的值 | 说明 |
|---|---|---|
| LCD构造 | LCD lcd(33, 31, 29) |
对应库构造函数CS、DATA、CLK三个参数 |
| createChar编号 | 0~4 | 编号要和Write_Char(byte(n))一致 |
| 点阵数组 | 8个字节 | 每个字节对应一行,位数决定点亮位置 |
| SET_XY | (4,1)、(10,1) |
材料中x为列、y为行,坐标从0起算 |
| delayTime | 400ms | 动画切换间隔,改小会更快但更吃刷新 |
3.2 输出字符串与浮点数:SET_XY坐标和Write_data精度
第二段LCD代码演示自定义内容输出。它把字符串定义成str1,在setup()里初始化LCD,在loop()里用SET_XY(2,0)定位到第一行第3个地址,用Write_data(a,2)显示两位小数的浮点数,再Write_Char('c')显示单位字符;第二行用SET_XY(4,1)和Write_String(str1)显示字符串。末尾while(1);让程序停在一次显示之后。
c复制#include <LCD.h>
//char str1[ ] = "hi, DemoBoard!"; //定义字符串
char str1[ ] = "hi, DemoBoard!"; //定义字符串
LCD lcd(31, 32, 33);
void setup ()
{
lcd.initial_LCD1602();
}
void loop ()
{
lcd.SET_XY(2, 0); //第1行,第3个地址起开始显示
float a = -124.036;
lcd.Write_data(a, 2); //显示浮点数,2位小数点
lcd.Write_Char('c'); //显示ASCII码c
lcd.SET_XY(4, 1); //第2行,第5个地址起开始显示
lcd.Write_String(str1); //显示字符串
while (1); //显示一次后停止在这
}
这里有两个参数最容易改错。一个是SET_XY(x,y)里的x、y顺序:材料注释写“第1行,第3个地址起开始显示”对应的是SET_XY(2,0),说明x从0开始表示列,y从0开始表示行,所以2是第三列、0是第一行。另一个是Write_data(a,2)的第二个参数,它控制浮点数显示的小数位数;材料里a=-124.036配2位小数,屏幕上应显示约-124.04c。如果你把2改成0,小数部分会被截掉;改成3,屏幕宽度就要重新算,LCD1602每行只有16个字符位置。
字符串这里用了DemoBoard作为占位,不要照抄带有具体项目或机构名字的字符串。显示内容可以自定义,但长度要控制在屏幕宽度内,否则会被截断或换行到看不见的位置。
3.3 从静态到动态:刷新位置与清屏的取舍
动态表情那段每400ms重绘两个坐标,不调用整屏清屏,所以看起来是局部手臂在动。第二段代码用while(1);停在一次显示之后,适合“只显示一次结果”的场景,比如上电显示固定字符串。如果你要做温湿度实时显示,就不能停在while(1);里,需要把读取和显示放进循环;但材料没有给出温湿度传感器的读取代码和接线,动手时先把传感器读数单独在串口里验证稳定,再把数值接到Write_data,不要直接把未验证的变量塞进LCD。
清屏函数lcd.clear()在库接口里存在,但整屏清空会造成明显闪烁。局部刷新时优先用SET_XY定位后覆盖旧内容;如果新字符串比旧字符串短,记得在末尾补空格清掉残留字符。这个习惯在调试温湿度数值时特别有用,否则小数位变化会留下“鬼影”。
4. 代码开发工具实战避坑排查:5个现象与对应处置
基础实验的报错往往不报错,只是“没反应”。下面五条是从按键和LCD例程里能直接推出来的高频现象,按“现象→原因→解决”处理,比盲目换板子快。
4.1 串口无输出或乱码:先对波特率、端口和复位
现象:代码编译上传成功,按按键串口监视器一片空白,或者打印出一串看不懂的字符。
原因:最常见是串口监视器波特率和Serial.begin(9600)不一致;其次是上传端口和监视器端口不是同一个;还有打开监视器时板卡被复位,错过了最初的打印。按键接线没接GND时,内部上拉读到的一直是高电平,也不会有按键输出。
解决:先把串口监视器设为9600,确认端口与上传端口一致,按一下复位再按键。如果仍然乱码,检查Serial.begin是否被改成其他值而监视器没跟着改。接线层面确认按键另一端确实到GND,不要只看面包板孔位。
4.2 按键一次触发多次:别删key1比较和25ms延时
现象:按一下K1,串口连续打印好几条K1 is pressed,或者手指按住不放时消息刷屏。
原因:机械按键抖动被当成多次按下;或者key1比较逻辑被删掉,key在每轮循环里反复被置位。delay(25)只做了一次等待,如果后面没有锁存比较,长按仍然会重复上报。
解决:保留read_key()末尾的if (key1 != key)比较,不要为了“看起来简洁”把它删掉。消抖时间先用25ms,按一下仍然连发再小幅增加;如果增加后快速点按丢动作,就说明加过头了,回到25ms附近重新试。
4.3 LCD不显示或花屏:构造参数顺序与接线先对齐
现象:LCD背光有,但屏幕没有字符;或者偶尔显示一行乱码,重新插拔线又变。
原因:材料里两段LCD代码的构造参数并不相同,一段是LCD lcd(33, 31, 29),另一段是LCD lcd(31, 32, 33)。这两个值对应库构造函数的CS、DATA、CLK三个参数,顺序和实际接线必须一致。只改代码不改线,或者只改线不改代码,都会出现“程序跑了但屏幕不认”的情况。
解决:先以你手里LCD库头文件里的构造函数注释为准,确认三个参数分别代表什么,再把代码里的三个编号和板子上的三根信号线一一对应。不要因为两段代码都能编译就随便混用。接线核对完再检查供电和初始化调用,initial_LCD1602()没有执行时,后面的Write_String也不会正常显示。
| 代码段 | 构造参数 | 核对重点 |
|---|---|---|
| 动态表情 | LCD lcd(33, 31, 29) |
CS、DATA、CLK三线是否按这个顺序接 |
| 自定义内容 | LCD lcd(31, 32, 33) |
换段代码时三线是否同步改 |
| 初始化 | initial_LCD1602() |
必须在写字符前调用 |
4.4 自定义字符乱码:createChar编号与Write_Char编号一致
现象:屏幕上显示的不是心形或笑脸,而是几个方块、乱码,或者显示位置偏移。
原因:createChar(0, heart)把心形绑定到编号0,显示时却写了Write_Char(byte(1));或者点阵数组不是完整的8个字节,createChar读到越界数据。还有一种情况是SET_XY坐标算错,字符被写到屏幕外。
解决:把createChar的编号和Write_Char里的编号列成一张小表,0对心形、1对笑脸、2对皱眉、3对手臂放下、4对手臂举起。每次改数组或改显示位置后,重新核对编号和坐标。点阵数组保持8个字节,不要少写一行。
4.5 程序停在while(1):该停还是该刷新
现象:LCD只显示一次内容,之后无论怎么改传感器数值或按键,屏幕都不再变化。
原因:第二段LCD代码在loop()末尾写了while(1);,程序停在原地,后面的循环不会继续执行。这个写法适合“上电显示一次固定内容”,不适合需要动态刷新的场景。
解决:如果只是显示固定字符串,保留while(1);可以让画面稳定;如果要结合温湿度传感器或按键状态刷新,就删掉while(1);,把显示逻辑放回loop(),并控制刷新间隔,避免屏幕闪烁。删之前先想清楚是“只显示一次”还是“持续显示”,不要为了看动态效果把稳定显示也改掉。
5. 把实验代码收成可复用模板:参数表与上线前检查
我现在做这类Arduino基础实验,不会把引脚号和LCD构造参数散落在两个函数里。按键的k1~k4、消抖的delay(25)、串口的9600、LCD的LCD lcd(...)和delayTime,都先集中到文件顶部,改硬件时只动一处,减少“代码改了线没改”的低级翻车。
下面这张表是我每次上传前会扫一遍的检查项:
| 检查项 | 看什么 | 不通过时的表现 |
|---|---|---|
| 板卡与端口 | 工具里选的板卡、端口和实际连接一致 | 编译过但上传失败,或串口无输出 |
| 按键接线 | 8~11号引脚对K1~K4,另一端到GND | 按键无反应或编号错位 |
| 上拉设置 | 四个引脚都有INPUT_PULLUP |
读数悬空,按键时好时坏 |
| 消抖参数 | delay(25)和key1比较都在 |
一次按下多次打印 |
| LCD构造 | LCD lcd(...)三个参数与三根线一致 |
屏幕不显示或花屏 |
| 自定义字符 | createChar编号与Write_Char编号对应 |
显示方块或乱码 |
| 刷新逻辑 | 只显示一次就保留while(1);,要动态就删 |
屏幕停在第一帧 |
还有一个小技巧:先把按键程序单独跑通,确认串口能稳定打印K1~K4,再把LCD代码接进来。不要一上来就把按键、LCD、传感器全接在一起,否则出问题时你分不清是引脚冲突、库参数还是显示坐标。分模块验证,每通过一段再加下一段,这比一次全接省时间。
我有一次照抄两段LCD代码,只改了显示内容,没注意构造参数从(33,31,29)变成了(31,32,33),屏幕亮了但一直不出字符,排查了半天接线才发现代码里的三根信号线顺序已经换了。从那以后我每次把例程拼到一起,都强制先走一遍“引脚—构造参数—初始化—显示”的核对顺序,再谈动态效果。希望帮到你。
