1. 项目缘起与整体设计思路1.1 为什么选择这个项目作为入门练手交通灯模拟几乎是每个接触单片机的人都会碰到的经典练手项目没有之一。原因很简单它的逻辑足够直观每个人每天都在路口看到红黄绿三色灯交替工作不需要额外解释需求同时它又涵盖了嵌入式开发中最核心的几个知识点——数字输入输出控制、定时器管理、状态机设计、多任务协调。把这几个点吃透了后面做更复杂的项目时心里就有底。我当初选这个题目其实是因为家里小孩问我“红绿灯为什么会自己变”我想与其嘴上解释不如直接搭一个出来给他看。结果一搭就发现纯三色灯太单调了路口明明还有倒计时读秒少了这个总感觉缺了灵魂。于是又加了一位数码管来做秒数显示整个项目的复杂度刚好卡在“有点挑战但不至于劝退”的区间。这个项目适合谁如果你刚学完Arduino的基础教程点亮过LED、按过按钮、用过delay()但还没独立做过一个完整的小系统那这个项目就是为你准备的。它不需要焊接不需要PCB一块面包板加几根杜邦线就能跑起来。做完之后你会对有限状态机这个概念有非常具体的体感而不是停留在书本上。1.2 系统功能定义与状态划分先把需求理清楚。一个标准的十字路口交通灯简化到单方向来看就是红、黄、绿三盏灯循环点亮配合一个倒计时显示。但如果你只做单方向那跟流水灯没什么区别。真正有意思的是做双向——东西方向和南北方向交替通行中间还要有黄灯过渡。我最终确定的方案是这样的东西方向和南北方向各有一组红黄绿灯共六盏LED。系统在四个状态之间循环状态东西方向南北方向持续时间数码管显示S0绿灯亮红灯亮10秒倒计时10→1S1黄灯亮红灯亮3秒倒计时3→1S2红灯亮绿灯亮10秒倒计时10→1S3红灯亮黄灯亮3秒倒计时3→1这个状态表是整个项目的灵魂。你把它想清楚了代码就是照着翻译而已。注意黄灯时间我设了3秒实际路口一般是3秒左右这个参数可以根据自己的喜好调整但建议不要低于2秒否则视觉上会感觉黄灯一闪而过不像真实的交通灯。1.3 核心器件选型与考量选型这块我踩过一些坑这里直接说结论。主控板Arduino Uno R3 是最稳妥的选择。它有14个数字IO口这个项目满打满算需要6个LED输出 1个数码管数据口 1个数码管时钟口 1个数码管锁存口 9个口Uno完全够用。Nano也可以体积更小适合后面想把它塞进小盒子里的场景。不建议一上来就用ESP32或STM32虽然性能更强但对你理解这个项目本身没有任何额外帮助反而增加环境配置的复杂度。数码管这里我强烈建议用TM1637驱动的四位数码管模块而不是裸的数码管。原因很实在——裸数码管需要8个IO口来做段选还要额外的位选口接线复杂不说代码里还得自己写动态扫描对新手来说调试难度陡增。TM1637模块只需要2根线CLK和DIO库函数直接调用显示数字就是一行代码的事。你可能会觉得“用模块是不是太偷懒了”但我的观点是把精力花在状态机逻辑上而不是跟数码管的引脚映射较劲这才是这个项目的学习重点。LED与电阻普通5mm红黄绿LED各两个配220Ω限流电阻六个。这里有个细节——红色LED的正向压降一般是1.8~2.2V黄绿的是2.0~2.4V用220Ω电阻在5V供电下电流大约在12~14mA亮度足够且不会烧。如果你想更精确可以用公式算R (Vcc - Vf) / I其中Vf是LED正向压降I是你想要的电流。比如红色LEDVf取2.0V想要10mA那R (5 - 2.0) / 0.01 300Ω。220Ω是偏亮一点但完全安全的通用值。面包板与杜邦线没什么好说的标准件。建议买那种带电源轨的面包板接线会清爽很多。2. 电路连接与关键细节解析2.1 完整接线方案与引脚分配接线这件事我的原则是先规划再动手。不要拿起线就插插到一半发现IO口不够用或者走线乱成一团那种感觉非常糟糕。下面是我用的引脚分配方案你可以直接照抄Arduino Uno 引脚分配 - D2 → 东西方向红灯 - D3 → 东西方向黄灯 - D4 → 东西方向绿灯 - D5 → 南北方向红灯 - D6 → 南北方向黄灯 - D7 → 南北方向绿灯 - D8 → TM1637 CLK - D9 → TM1637 DIO - 5V → 面包板正极轨 - GND → 面包板负极轨每个LED的正极长脚通过220Ω电阻接到对应的数字引脚负极短脚接到GND轨。TM1637模块的VCC接5VGND接GNDCLK和DIO分别接D8和D9。这里有一个非常容易犯的错误LED的长短脚搞反。长脚是正极短脚是负极这个大家都知道但实际插到面包板上时因为LED是圆的有时候真的会看走眼。我的建议是拿一个LED先接到5V和GND上试一下亮了就记住哪个脚接正极不亮就反过来。花十秒钟确认一下比后面debug半小时强。2.2 限流电阻的计算与选择前面提到了限流电阻的计算这里再展开说一下为什么不能省掉电阻。LED本质上是一个二极管它的伏安特性曲线非常陡峭——电压稍微超过正向压降电流就会急剧上升。如果你直接把LED接到5V和GND之间没有电阻限流那电流会瞬间冲到几百毫安LED要么当场烧掉要么亮度异常且寿命急剧缩短。220Ω这个值是怎么来的我们算一下最坏情况。假设红色LED的Vf是1.8V取最小值那么电阻上的电压是5 - 1.8 3.2V电流是3.2 / 220 ≈ 14.5mA。普通5mm LED的额定电流一般是20mA14.5mA在安全范围内。如果Vf取2.2V电流是(5-2.2)/220 ≈ 12.7mA也完全没问题。所以220Ω是一个兼顾亮度和安全的通用值。如果你手头只有330Ω的电阻也能用电流会降到8~9mA左右亮度稍暗但肉眼完全能接受。470Ω就有点暗了不太推荐。反过来如果你只有100Ω那电流会到30mA以上短时间测试可能没事但长期运行对LED寿命有影响不建议。2.3 面包板布线的实用技巧面包板布线看起来简单但实际做的时候很容易搞得像蜘蛛网。我总结了几条经验第一条电源轨先接好。先用两根线把Arduino的5V和GND引到面包板两侧的电源轨上后面所有需要供电的元件都从电源轨取电不要每个都单独拉一根线到Arduino。这样走线会清爽很多。第二条LED按方向分组摆放。东西方向的三个LED放在面包板左边一排南北方向的放在右边一排。这样你在调试的时候一眼就能看出哪组是哪组不用对着代码数引脚。第三条电阻跨接在电源轨和LED之间。具体做法是电阻一端插在面包板的某个空行另一端插在电源轨的GND上LED的正极通过杜邦线接到Arduino引脚负极插在电阻所在的那一行。这样每个LED都有独立的限流电阻而且走线规整。第四条TM1637模块放在面包板最边上。它的线比较硬放在中间会挡住其他元件的插拔。放在边上CLK和DIO两根线直接拉到D8和D9干净利落。注意面包板的电源轨有时候不是全通的中间可能有断点。拿到新面包板时用万用表蜂鸣档测一下电源轨的首尾是否导通不导通的话需要在断点处短接一下。这个坑我踩过当时调了半天以为代码有问题结果是电源轨不通。3. 代码实现与状态机设计3.1 有限状态机的代码结构这个项目的代码核心就是一个有限状态机。什么是有限状态机用大白话说就是系统在任何时刻都处于有限个状态中的某一个收到特定条件后切换到另一个状态。交通灯就是最典型的例子——它永远在S0、S1、S2、S3这四个状态里循环每个状态有确定的输出和确定的持续时间。我见过很多新手写交通灯用的是delay()堆叠的方式绿灯亮10秒delay(10000)然后黄灯亮3秒delay(3000)以此类推。这种写法能跑但有两个致命问题第一delay()期间CPU什么都做不了你没法同时处理数码管刷新第二代码冗长且难以修改想加一个“夜间模式”或者“紧急按钮”几乎要重写。正确的做法是用非阻塞式的时间管理。核心思路是记录上一次状态切换的时间点每次loop()时检查当前时间减去上次切换时间是否超过了当前状态的持续时间如果超过了就切换到下一个状态。这样loop()会以极快的速度反复执行你可以在里面同时做很多事情。3.2 非阻塞定时的实现原理Arduino的millis()函数返回的是从程序启动到现在的毫秒数类型是unsigned long。用它来做定时基本模板是这样的unsigned long previousMillis 0; const unsigned long interval 1000; void loop() { unsigned long currentMillis millis(); if (currentMillis - previousMillis interval) { previousMillis currentMillis; // 这里执行每隔interval毫秒要做的事情 } }这段代码的关键在于currentMillis - previousMillis这个减法。因为millis()会溢出大约50天后归零直接比较currentMillis previousMillis interval在溢出时会出错但用减法就不会——这是无符号数减法的特性即使溢出差值仍然是正确的。这个细节很多人不知道但它是写出健壮代码的关键。在我的交通灯代码里我用这个模板来驱动两个东西一个是状态切换的计时一个是数码管的倒计时刷新。两者互不干扰各跑各的。3.3 完整代码逐段解析下面是我最终版本的代码我把它拆成几段来讲。第一段头文件和常量定义。#include TM1637Display.h #define CLK 8 #define DIO 9 TM1637Display display(CLK, DIO); // 引脚定义 const int EW_RED 2, EW_YELLOW 3, EW_GREEN 4; const int NS_RED 5, NS_YELLOW 6, NS_GREEN 7; // 状态定义 enum State { S0, S1, S2, S3 }; State currentState S0; // 各状态持续时间毫秒 const unsigned long stateDurations[] {10000, 3000, 10000, 3000}; unsigned long stateStartTime 0; int lastDisplayedSecond -1;这里用enum来定义状态比用数字0、1、2、3可读性强得多。stateDurations数组把每个状态的持续时间集中管理想改时间只需要改这个数组不用去代码里到处找。第二段状态切换函数。void setState(State newState) { currentState newState; stateStartTime millis(); lastDisplayedSecond -1; // 强制刷新显示 // 先全部熄灭 digitalWrite(EW_RED, LOW); digitalWrite(EW_YELLOW, LOW); digitalWrite(EW_GREEN, LOW); digitalWrite(NS_RED, LOW); digitalWrite(NS_YELLOW, LOW); digitalWrite(NS_GREEN, LOW); switch (newState) { case S0: digitalWrite(EW_GREEN, HIGH); digitalWrite(NS_RED, HIGH); break; case S1: digitalWrite(EW_YELLOW, HIGH); digitalWrite(NS_RED, HIGH); break; case S2: digitalWrite(EW_RED, HIGH); digitalWrite(NS_GREEN, HIGH); break; case S3: digitalWrite(EW_RED, HIGH); digitalWrite(NS_YELLOW, HIGH); break; } }这个函数做了三件事更新状态变量、记录状态开始时间、根据新状态设置LED。注意lastDisplayedSecond -1这一行它的作用是强制下一次循环时刷新数码管显示避免状态切换后数码管还停留在上一个状态的数字。第三段主循环。void loop() { unsigned long elapsed millis() - stateStartTime; unsigned long duration stateDurations[currentState]; // 计算剩余秒数 int remainingSeconds (duration - elapsed 999) / 1000; if (remainingSeconds 0) remainingSeconds 0; // 只在秒数变化时刷新数码管 if (remainingSeconds ! lastDisplayedSecond) { display.showNumberDec(remainingSeconds, false, 2, 2); lastDisplayedSecond remainingSeconds; } // 检查是否该切换状态 if (elapsed duration) { State nextState (State)((currentState 1) % 4); setState(nextState); } }(duration - elapsed 999) / 1000这个表达式是向上取整的除法。比如剩余9500毫秒加上999变成10499除以1000得10表示还有10秒。剩余500毫秒时加上999变成1499除以1000得1表示还有1秒。这样倒计时会从10显示到1不会出现0符合真实交通灯的习惯。display.showNumberDec(remainingSeconds, false, 2, 2)这行代码中第一个参数是要显示的数字第二个参数false表示不显示前导零第三个参数2表示显示2位第四个参数2表示从第2位开始显示TM1637是4位数码管我从右边两位显示左边两位留空。3.4 数码管显示的处理细节TM1637库的showNumberDec函数有几个重载版本用起来很灵活。我简单说一下参数含义display.showNumberDec(number); // 显示数字自动处理位数 display.showNumberDec(number, leadingZero); // leadingZerotrue时显示前导零 display.showNumberDec(number, leadingZero, length, pos); // 指定显示长度和起始位置我选择从第2位开始显示、只显示2位是因为倒计时最多10秒两位数就够了。如果你想让显示更醒目可以显示4位比如0010、0009这样但我觉得没必要两位数更简洁。还有一个细节TM1637的亮度是可以调的。display.setBrightness(0x0f)设置最亮0x00最暗。我一般用0x0a左右太亮了晚上刺眼太暗了白天看不清。这个参数根据你的使用环境调整就行。实操心得TM1637模块的CLK和DIO引脚内部没有上拉电阻有些便宜的模块在长导线连接时会出现显示不稳定、闪烁的问题。如果你遇到了在CLK和DIO上各并一个4.7kΩ的上拉电阻到5V就能解决。我手头那个模块就是这个问题加了上拉之后稳如磐石。4. 调试过程与常见问题排查4.1 上电后LED不亮的排查思路这是最常见的问题没有之一。你兴冲冲地接好线、烧录代码结果灯一个都不亮。别慌按下面的顺序排查第一步确认电源。Arduino上的电源指示灯亮不亮如果那个灯都不亮说明板子没供电检查USB线是否插紧、电脑USB口是否正常。如果电源灯亮但LED不亮继续下一步。第二步确认LED方向。前面说过LED长脚是正极。如果你不确定拿一个LED直接接到5V和GND上记得串电阻看它亮不亮。不亮就反过来接。确认方向后再插回面包板。第三步确认电阻位置。电阻是串在LED回路里的不是并在LED两端。如果你把电阻并在LED两端那LED两端电压被电阻钳位永远不会亮。正确的接法是Arduino引脚 → LED正极 → LED负极 → 电阻 → GND。第四步确认代码引脚号。代码里写的EW_RED 2你实际接的是不是D2这个错误太常见了尤其是面包板上线多了之后很容易插错行。拿万用表测一下Arduino引脚和LED正极之间是否导通不导通就是接错了。第五步确认pinMode设置。所有LED引脚都必须设为OUTPUT。如果你忘了设引脚默认是高阻态LED不会亮。这个错误在代码里检查一下setup()函数就能发现。4.2 数码管显示异常的几种情况数码管的问题比LED更隐蔽一些因为涉及通信协议。常见的有以下几种情况一完全不显示。先检查VCC和GND是否接对TM1637模块的VCC是5VGND是地接反了不会烧但不会工作。然后检查CLK和DIO是否接在了代码定义的引脚上。如果都没问题试着把display.setBrightness()的值调大一些有可能是亮度设得太低。情况二显示乱码或闪烁。这通常是通信干扰导致的。前面提到的上拉电阻是一个解决方案。另外CLK和DIO的导线尽量短一些不要和LED的导线捆在一起走避免串扰。如果还不行降低通信速度——TM1637库默认的通信速度比较快你可以在TM1637Display构造函数里加一个参数来降速比如TM1637Display display(CLK, DIO, 100)100是延时微秒数值越大速度越慢但越稳定。情况三显示的数字不对。比如该显示10的时候显示1该显示3的时候显示30。这通常是showNumberDec的参数用错了。检查第三个参数显示位数和第四个参数起始位置。TM1637的4位数码管从左到右是第0、1、2、3位如果你想在右边两位显示起始位置应该是2。情况四倒计时跳变不流畅。比如从10直接跳到8中间少了9。这是因为你的刷新逻辑有问题。检查lastDisplayedSecond的更新时机确保每次秒数变化时都刷新了显示。另外remainingSeconds的计算要确保不会出现负数。4.3 状态切换逻辑的验证方法状态机逻辑写完之后怎么验证它是对的我的方法是串口打印 逻辑分析。在setState()函数里加一行Serial.println(currentState)然后在setup()里初始化串口Serial.begin(9600)。打开串口监视器你就能看到状态切换的顺序和时间间隔。正常的输出应该是0 1 2 3 0 1 ...每个数字之间的时间间隔应该是10秒、3秒、10秒、3秒循环。如果你看到的状态顺序不对或者时间间隔不对那就说明状态机的逻辑有问题。还有一种更直观的方法用LED的亮灭来验证。S0状态下东西绿灯亮、南北红灯亮S1状态下东西黄灯亮、南北红灯亮以此类推。你盯着看一轮完整的循环如果跟状态表一致那就没问题。注意串口打印本身会消耗时间如果你在loop()里频繁打印可能会影响状态切换的精度。建议只在setState()里打印一次不要在loop()里每帧都打印。4.4 常见问题速查表问题现象可能原因解决方法LED全部不亮电源未接通检查USB线和电源指示灯单个LED不亮LED方向反了调换LED正负极单个LED不亮电阻未串入回路检查电阻位置单个LED不亮引脚号写错核对代码与接线数码管不显示亮度设太低调大setBrightness值数码管闪烁通信干扰加4.7kΩ上拉电阻数码管乱码导线过长缩短CLK和DIO导线倒计时跳变刷新逻辑错误检查lastDisplayedSecond更新状态不切换millis溢出处理错误用减法而非加法比较状态切换太快持续时间单位错误确认是毫秒不是秒5. 功能扩展与进阶玩法5.1 加入行人过街按钮基础版本做完之后你可能会想能不能加一个按钮按下之后行人可以过街这个扩展非常实用而且实现起来不难。思路是这样的在南北方向绿灯的时候如果行人按钮被按下系统记录一个标志位。当南北方向绿灯时间结束后不直接切换到南北黄灯而是先让东西方向绿灯亮一段时间给行人过街的时间然后再继续正常循环。或者更简单的方式按钮按下后直接缩短当前方向的绿灯时间让它尽快切换到行人要过街的方向。代码上你需要一个外部中断或者轮询来检测按钮。我建议用轮询因为Arduino Uno只有两个外部中断引脚而这个项目里D2和D3已经被LED占用了。轮询的写法就是在loop()里加一行if (digitalRead(BUTTON_PIN) LOW)然后设置一个标志位。按钮需要接一个上拉电阻10kΩ到5V另一端接GND。这样按钮未按下时引脚是高电平按下时是低电平。或者直接用Arduino的内部上拉电阻pinMode(BUTTON_PIN, INPUT_PULLUP)省一个电阻。5.2 夜间模式与黄灯闪烁真实的交通灯在深夜时段比如晚上11点到早上6点会切换到黄灯闪烁模式提醒车辆注意观察、减速通过。这个功能用代码实现非常简单判断当前时间是否在夜间时段如果是就进入一个特殊状态只让黄灯以1Hz的频率闪烁数码管不显示或显示“--”。时间判断可以用millis()来模拟比如每24小时一个循环前6小时是夜间模式。但更实际的做法是加一个光敏电阻检测环境亮度天黑到一定程度就自动进入夜间模式。光敏电阻的接法是分压电路光敏电阻和10kΩ固定电阻串联中间点接到模拟引脚A0。analogRead(A0)的值越小说明越亮越大说明越暗。你可以设一个阈值比如大于800就进入夜间模式。5.3 用蜂鸣器增加提示音给交通灯加一个蜂鸣器在状态切换时发出提示音会让整个项目更有“产品感”。无源蜂鸣器可以用tone()函数驱动发出不同频率的声音。比如绿灯变黄灯时响一声短促的“嘀”黄灯变红灯时响两声。接线很简单蜂鸣器正极接一个数字引脚比如D10负极接GND。代码里在setState()函数里加一行tone(BUZZER_PIN, 1000, 100)表示以1000Hz频率响100毫秒。注意tone()函数会占用一个定时器如果你同时用了其他依赖定时器的库比如Servo库可能会有冲突。TM1637库不依赖定时器所以没问题。5.4 用 millis() 实现更复杂的时序当你把基础版本玩熟了之后可以尝试用millis()实现更复杂的时序逻辑。比如绿灯在最后3秒变成闪烁状态提醒驾驶员即将变灯。这个功能在真实路口很常见实现起来就是在S0和S2状态中判断剩余时间是否小于3秒如果是就让绿灯以2Hz频率闪烁。代码上你需要在loop()里加一个独立的计时器专门控制闪烁。不要用delay()否则会阻塞状态机的正常运行。具体做法是记录上一次闪烁切换的时间每次loop()时检查是否超过了闪烁间隔比如250毫秒如果超过了就翻转绿灯的电平。这个扩展会让你对非阻塞定时的理解更上一层楼。你会发现用millis()可以同时管理任意多个不同周期的任务它们互不干扰这就是协作式多任务的基本思想。6. 我在这个项目里踩过的坑先说一个最让我印象深刻的。我第一次做这个项目的时候倒计时显示总是比实际状态切换慢一秒。比如绿灯已经变黄灯了数码管还显示着“1”。我查了半天代码逻辑上没问题啊remainingSeconds的计算也是对的。后来我发现问题出在showNumberDec的刷新时机上。我在loop()里判断remainingSeconds ! lastDisplayedSecond时才刷新但状态切换后lastDisplayedSecond被重置为-1下一次loop()时remainingSeconds已经是新状态的持续时间了比如3秒所以数码管会先显示3然后2、1。但视觉上从10直接跳到3中间少了过渡感觉就是慢了一拍。解决办法是在setState()里立即刷新一次数码管显示新状态的初始秒数。这样状态切换和数码管刷新就是同步的视觉上流畅很多。第二个坑是LED的亮度不一致。红色LED在220Ω电阻下明显比绿色LED亮因为红色的正向压降更低电流更大。如果你追求视觉上的均匀可以给红色LED用330Ω电阻绿色和黄色用220Ω。这个细节在教科书里不会讲但实际做出来一眼就能看出来。第三个坑是关于enum的。我一开始用enum State { S0, S1, S2, S3 }然后在setState()里用switch判断。后来我想加一个S4状态比如全红状态结果发现stateDurations数组的长度是4(currentState 1) % 4也是4加一个状态要改好几个地方。后来我改成了用sizeof来动态计算数组长度(currentState 1) % (sizeof(stateDurations) / sizeof(stateDurations[0]))这样加状态只需要改数组和switch不用改取模的数字。这些小坑单独看都不大但每一个都花了我不少时间去排查。写出来是希望你能绕过它们把精力花在更有价值的地方。7. 写在最后的一点个人体会这个项目我从开始做到最终稳定运行大概花了两个周末的时间。第一个周末搭电路、写基础代码第二个周末调bug、加扩展功能。中间有几次想放弃觉得“不就是个红绿灯吗怎么这么多事”但每次解决一个问题之后那种“原来如此”的快感又让我继续坐下来。我现在回头看这个项目最大的价值不在于交通灯本身而在于它让我真正理解了状态机和非阻塞定时这两个概念。这两个东西在后面我做任何嵌入式项目时都在用可以说是最通用的基本功。如果你也在学Arduino我强烈建议你不要跳过这个项目哪怕你觉得它“太简单了”。简单的东西做到位比复杂的东西做到一半有价值得多。另外说一个实际的小建议做完之后用热熔胶把面包板上的线固定一下或者干脆把它移植到洞洞板上焊死。面包板上的线松了之后debug起来非常痛苦。我后来把它焊到了一块5x7cm的洞洞板上装进一个透明塑料盒里放在书桌上当小夜灯用还挺有成就感的。
