单片机编程入门：从点亮 LED 到读取传感器

单片机是一种集成了处理器、存储器和输入输出接口的微型计算机。它可以按程序读取按键或传感器信号，再控制 LED、电机、蜂鸣器等外部设备。和在电脑上运行的程序相比，单片机程序直接面对电压、电流和引脚状态：代码即使写得正确，接线、供电或电平不匹配，也可能无法正常工作，甚至损坏器件。

本文以 Arduino Uno R3 或兼容的 ATmega328P 开发板为例，使用 Arduino IDE 和常见的 Arduino C++ 函数，从让 LED 闪烁开始，再学习按键输入和模拟传感器读取。不同开发板的引脚编号、工作电压、ADC 分辨率和可用电流可能不同，实际操作前应查阅手上开发板及传感器的规格说明。

一、适用场景与能力边界

单片机适合执行任务明确、资源要求适中的嵌入式控制工作，例如读取温度并显示、检测开关状态、控制指示灯、定时采样、驱动简单执行器，以及在设备之间进行基础通信。它的优点是体积小、功耗低、启动快，通常可以长期重复执行固定程序。

但单片机并不是一台缩小的个人电脑。内存和处理能力有限，复杂图像识别、大型操作系统或高吞吐数据处理通常不适合直接放在入门级单片机上。Wi-Fi、蓝牙、存储卡等功能也要看具体芯片或开发板是否包含相应硬件，不能假定所有单片机都具备。

还要区分“控制逻辑能运行”和“设备可以安全投入实际使用”。课堂中的 LED 实验不等于已经具备工业控制、医疗或安全保护能力。涉及市电、高压、大电流、电池充电、加热器、电机等负载时，需要针对具体设备设计电气隔离、过流保护、温升控制和故障处理。未经验证的入门电路不应直接用于人身安全或关键设备。

二、准备开发环境与硬件

入门需要一块 Arduino Uno R3 或兼容板、USB 数据线、面包板、跳线、一只 LED、一个限流电阻（例如 220Ω 至 1kΩ），以及后续实验用的按键和电位器。建议先确认开发板芯片和逻辑电压：经典 Uno R3 的数字逻辑通常为 5V，但兼容板及其他 Arduino 型号可能使用 3.3V。USB 接口形状相同，不代表电气规格相同。

安装 Arduino IDE 后，连接开发板，在“工具”菜单中选择对应的开发板型号和端口。部分兼容板使用不同的 USB 转串口芯片，可能需要安装相应驱动。上传程序时如果失败，先检查端口、板型、数据线是否支持数据传输，以及是否有其他程序占用了串口。

三、认识引脚、电压与电流

开发板上的引脚不是可以随意连接的“电源口”。数字引脚通常用于读取高低电平或输出高低电平；模拟输入引脚用于测量一定范围内的电压；5V、3.3V 和 GND 则是供电及参考端。GND 是电路的共同参考点，传感器和开发板需要共享参考地，电路才能正确比较电压。

对经典 Uno R3 来说，模拟输入常见的读数范围是 0 到 1023，对应接近 0V 到参考电压的区间；默认参考通常与板上逻辑供电有关。这个结论不能直接套用到所有板子：不同型号的 ADC 位数、参考电压和可测范围可能不同。模拟输入电压不得超过器件和开发板允许的范围，尤其不能把 5V 信号直接接到只允许 3.3V 输入的引脚上。

数字输出也不能直接驱动任意负载。ATmega328P 数据手册中的引脚电流绝对最大额定值并不表示可以长期按该电流工作；实际允许的持续电流还受工作条件、端口总电流、芯片总功耗和开发板设计限制。LED 必须串联限流电阻，电机、继电器和大功率灯等负载通常需要合适的驱动电路，不能直接接在普通 GPIO 引脚上。

四、第一步：让 LED 闪烁

经典 Uno R3 的板载 LED 通常连接到 D13，也就是 Arduino 环境中的 LED_BUILTIN。先用板载 LED 验证开发板、IDE 和上传流程，不需要额外接线。新建草图，将下面程序上传到开发板：

const int ledPin = LED_BUILTIN;

void setup() {
  pinMode(ledPin, OUTPUT);
}

void loop() {
  digitalWrite(ledPin, HIGH);
  delay(500);

  digitalWrite(ledPin, LOW);
  delay(500);
}

setup() 在程序启动或复位时运行一次，适合设置引脚模式、启动串口等。loop() 会反复执行，因此灯会持续亮 500 毫秒、灭 500 毫秒。pinMode() 将引脚设为输出，digitalWrite() 则输出高或低电平。delay() 的参数单位是毫秒；在此期间，主循环会停下来，不能及时执行其他代码。

如果要使用外接 LED，可按下列方式连接：开发板数字引脚经限流电阻接到 LED 长脚（阳极），LED 短脚（阴极）接 GND。也可以把电阻接在 LED 的另一侧，只要电阻与 LED 串联即可。对于不同颜色的 LED，正向压降不同；用电阻估算电流时，可使用公式 I = (V供电 - VLED) / R。例如在 5V 电路中使用正向压降约 2V 的 LED 和 330Ω 电阻，电流约为 9mA。实际压降会随器件而变，电阻值应根据 LED、供电和引脚能力选择。若不确定，选较大的限流电阻通常比直接连接安全。

如果上传成功但外接 LED 不亮，优先检查极性、串联路径、GND 是否接通，以及程序使用的引脚是否和实际接线一致。板载 LED 的电路与外接 LED 不同，板载灯亮并不能证明外部接线正确。

五、按键输入：使用内部上拉

读取按键时，输入引脚不能长期悬空。悬空引脚可能受到环境噪声影响，读数在高低电平间变化。Arduino 的 INPUT_PULLUP 可以启用内部上拉电阻，简化常见按键接线：按键一端连接输入引脚，另一端连接 GND。未按下时读数通常为高，按下后引脚被接地，读数为低，因此逻辑与“按下为高”的直觉相反。

const int buttonPin = 2;
const int ledPin = LED_BUILTIN;

void setup() {
  pinMode(buttonPin, INPUT_PULLUP);
  pinMode(ledPin, OUTPUT);
}

void loop() {
  int buttonState = digitalRead(buttonPin);

  if (buttonState == LOW) {
    digitalWrite(ledPin, HIGH);
  } else {
    digitalWrite(ledPin, LOW);
  }
}

按住按键时灯亮，松开时灯灭。程序每次循环读取引脚状态，并根据结果更新 LED。机械按键在按下或松开时可能产生短暂抖动，表现为多个快速跳变。这个例子只控制 LED，通常能看出按键功能，但用于计数、切换模式等操作时，抖动可能导致一次按压被识别为多次。常见处理方法包括软件消抖（记录状态变化后，等待一段稳定时间再确认）、硬件 RC 滤波，或使用合适的专用电路；具体方案取决于响应时间和可靠性要求。

不要把按键误接到电源和 GND 之间后再直接连接一个配置错误的输入引脚。接线前确认按键内部触点结构；四脚轻触按键常有两组内部相连的脚，方向放错可能使引脚始终接通或始终断开。

六、读取模拟传感器：先从电位器开始

电位器可以作为可调分压器，用来模拟缓慢变化的传感器信号。将电位器两侧端子分别接到开发板的 5V 和 GND，中间端子（滑动端）接 A0。下面的程序读取模拟值，并通过串口输出。打开 IDE 的串口监视器，波特率选择 9600，可以观察旋转电位器时读数的变化。

const int sensorPin = A0;

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

void loop() {
  int sensorValue = analogRead(sensorPin);

  Serial.print("ADC value: ");
  Serial.println(sensorValue);

  delay(200);
}

经典 Uno R3 的 analogRead() 通常返回 0 到 1023 的整数，反映输入电压相对于 ADC 参考电压的位置。它读取的是电压，不会自动识别温度、光照或距离。实际传感器可能输出模拟电压，也可能通过数字接口提供数据；必须根据传感器数据手册确认供电、引脚定义、输出形式和允许电压。

不要把传感器的“模拟输出”想当然地接到 ADC。某些传感器输出电流或差分信号，需要转换电路；有些传感器模块包含放大或分压电路，但模块的电压范围也仍需确认。若输出电压可能高于开发板模拟输入允许范围，应使用适当的电平转换或分压方案，并考虑输入阻抗、测量精度和保护要求。简单分压并非适用于所有信号。

七、将读数换算为电压

如果 ADC 参考电压确实为 5V、分辨率为 10 位且读数范围为 0 到 1023，可以用下式估算输入电压：

float voltage = sensorValue * (5.0 / 1023.0);

例如把这行代码放在读取 sensorValue 之后，再用 Serial.println(voltage) 输出即可。这里的 5.0 必须与实际 ADC 参考电压相符，不能仅因为开发板标有“5V”就认定 ADC 参考一定精确为 5.000V。供电误差、参考源精度、噪声和 ADC 误差都会影响结果。对于需要准确测量的应用，应查看芯片与开发板规格，并使用经过校准的参考和合适的测量方法。

ADC 读数也不等同于物理量。要把电压变成摄氏度、光照强度或压力值，还需要传感器的转换关系、器件型号及校准数据。不能只凭一个 ADC 数字就断定环境温度或光照值。

八、常见模拟传感器接法示例：光敏电阻

常见光敏电阻本身是随光照变化的电阻，通常要与固定电阻组成分压器，才能由 ADC 测量中点电压。一种接法是：5V 接光敏电阻，光敏电阻与固定电阻的连接点接 A0，固定电阻另一端接 GND。固定电阻的阻值会影响灵敏度和测量范围，应结合光敏电阻参数及目标光照范围选择。若把光敏电阻和固定电阻的位置互换，读数随光照变化的方向也会反过来。

用前一节的串口程序读取 A0，即可观察读数变化。它输出的是电压对应的 ADC 结果，并非经过标定的照度值。普通光敏电阻的特性通常不是线性关系；若要得到有意义的照度估算，需要器件曲线、分压参数和校准方法。不要把未经标定的 ADC 值标注成准确的 lux（勒克斯）。

九、让程序不只会“停下来等”

delay() 易于理解，适合最初的闪烁实验，但它会阻塞主循环。如果程序一边等待数秒，一边还要及时响应按键、读取多个传感器或处理通信，就可能错过事件。入门后可以用 millis() 做非阻塞定时。下面的程序每隔 500 毫秒切换一次 LED，不会因为等待而暂停整个循环：

const int ledPin = LED_BUILTIN;

unsigned long previousMillis = 0;
const unsigned long interval = 500;
bool ledState = false;

void setup() {
  pinMode(ledPin, OUTPUT);
}

void loop() {
  unsigned long currentMillis = millis();

  if (currentMillis - previousMillis >= interval) {
    previousMillis = currentMillis;
    ledState = !ledState;
    digitalWrite(ledPin, ledState);
  }

  // 可在这里继续读取按键或处理其他任务
}

使用无符号整数做时间差比较，可以自然处理 millis() 计数器回绕的情况，前提是采用“当前时间减去上次时间”的写法，并避免间隔超过计数类型能够可靠表示的范围。不要简单比较 currentMillis > previousMillis + interval，因为计数回绕时这种写法可能出错。

十、常见错误与排查顺序

• 选错板型或端口：检查 IDE 中的开发板型号和端口。上传错误信息常能提示是编译问题、连接问题还是串口占用。
• LED 不亮：确认 LED 极性、电阻是否串联、GND 是否共地、实际接线引脚与代码是否一致。先用板载 LED 区分是程序问题还是外接电路问题。
• 按键读数飘动：确认引脚已设置为 INPUT_PULLUP 或使用了外部上拉/下拉电阻，且输入端没有悬空。注意内部上拉接法通常是按下读到 LOW。
• 模拟值始终为零或满量程：检查传感器供电、GND、信号线是否接到模拟引脚；测量信号是否超出 ADC 范围；确认传感器输出类型及引脚顺序。
• 串口出现乱码或没有输出：让串口监视器的波特率与 Serial.begin() 参数一致，检查开发板端口，并确认 USB 线支持数据传输。
• 读数跳动：检查连线是否松动、参考电压与接地是否稳定。可在合理范围内做多次采样平均或滤波，但滤波不能修复错误接线、超范围输入或不合适的传感器电路。
• 开发板复位或发热：立即断电，检查短路、供电极性和外部负载电流。不要用 GPIO 直接驱动电机、线圈或大功率灯；感性负载通常还需按设计加续流保护，并使用合适的驱动器。

遇到问题时，建议按“电源与接地—接线—引脚模式—代码逻辑—串口信息”的顺序排查。一次只改变一个因素，并用万用表测量供电和关键节点电压，往往比盲目改代码更快定位问题。断电后再改线，尤其不要在不确定电源轨连接方式时让 5V 与 GND 短接。

十一、接下来可以学什么

完成 LED、按键和 ADC 入门后，可以继续学习定时器、PWM、数字滤波、I2C、SPI、UART，以及如何根据传感器数据手册编写驱动。学习新接口时，先确认供电电压、逻辑电平、通信时序和库的适用板型；通信接口名称相同，也不代表所有器件接线和参数都相同。

一个可靠的单片机项目，不只是“程序能够上传”。还要知道每个引脚的电气边界、输入代表什么、输出能够驱动什么，以及异常状态下设备会怎样。先用低电压、小电流的实验验证逻辑，再逐步增加复杂度；对传感器做标定，对负载使用合适的驱动与保护，并在目标使用环境中测试。这样从点亮一颗 LED 开始，才能稳妥地走向真正可用的嵌入式项目。