红外对射传感器实战指南：从原理到Arduino/CircuitPython应用

1. 项目概述

红外对射传感器，也叫红外遮断传感器，是我在自动化项目和互动装置里用得最多的基础传感器之一。它原理简单直接，但用好了能解决很多实际问题，比如统计人流、检测传送带上的物品、制作一个简单的防盗报警器，或者给一个互动展项设置一个“隐形”的触发机关。很多刚接触硬件的朋友可能会先尝试超声波测距或者PIR人体感应模块，但红外对射有它独特的优势：响应速度极快（几乎是光速）、检测区域是一条明确的“线”而非一个“面”或“扇区”，而且成本通常很低。

这次我想系统地聊聊怎么把这种传感器用起来，特别是结合Arduino和CircuitPython这两个最流行的嵌入式开发平台。网上资料虽然多，但往往只给个接线图和几行代码，很多关键的细节和实际调试中会遇到的坑都没讲清楚。比如，为什么接收端需要上拉电阻？环境光干扰到底有多严重？怎么判断一对传感器的有效距离？这些经验都是我在项目里一次次调试、一次次失败后总结出来的。我会从最基础的原理讲起，然后手把手带你完成硬件连接和代码编写，最后重点分享那些能让项目稳定运行的实战经验和避坑指南。无论你是想做一个简单的计数器，还是一个需要可靠触发的复杂系统，这篇文章都能给你提供可以直接“抄作业”的完整方案。

2. 红外对射传感器核心原理与选型

2.1 工作原理深度解析

红外对射传感器的核心思想，可以想象成在一条走廊的两端，一端有人持续吹口哨（发射红外光），另一端的人耳朵很灵，专门听这个频率的口哨声（接收红外光）。当中间没有人或物体时，听者能一直听到口哨声；一旦有人走过挡住了声音，听者就听不到了，从而知道中间有东西通过。技术上，发射端（Emitter）内部是一个红外发光二极管（IR LED），它会持续发出人眼不可见的红外光束。接收端（Receiver）通常是一个光电晶体管或专门的红外接收管，它对发射端发出的特定红外光波长最为敏感。

这里的关键在于“调制”。很多廉价或简单的对射传感器发射的是未经调制的恒定红外光。这就好比在嘈杂的菜市场里吹口哨，接收端可能无法区分你的口哨声和背景里的其他噪音（如阳光、白炽灯等发出的红外光）。因此，更可靠、抗干扰能力更强的方案是使用调制型红外对射传感器。发射端会以特定的频率（如38kHz）快速闪烁红外光，接收端则只对这个频率的闪烁信号有反应。这就像你和朋友约定用莫尔斯电码的节奏吹口哨，即使环境嘈杂，他也能精准地识别出你的信号。我们常见的红外遥控器就是使用这种原理。在选购时，如果你预计使用环境有较强的环境光（特别是含有红外成分的光源），强烈建议选择调制型传感器。

注意：本文示例中使用的是非调制型传感器，因其接线和代码最为简单直观，适合入门和理解基本原理。但在实际复杂环境中，调制型是更稳妥的选择。两者的接线方式类似，但代码逻辑或库的支持会有所不同。

2.2 与PIR、超声波传感器的对比

为什么在很多场合下，红外对射是比PIR（被动红外）或超声波模块更好的选择？这张对比表能清晰地说明问题：

特性	红外对射传感器	PIR运动传感器	超声波测距模块
检测原理	主动发射并接收红外光束，检测遮挡。	被动检测人体发出的红外热辐射变化。	发射超声波并接收回波，通过时间差测距。
检测形式	“线”检测，精确的一条线。	“面”检测，一个大致的热感应扇区。	“点”检测，测量前方特定点的距离。
响应速度	极快（微秒级），近乎瞬时。	较慢（通常有数秒延迟或复位时间）。	较快（毫秒级），但比红外光慢。
检测目标	任何不透明物体（无论有无生命）。	主要针对移动的、有热辐射的生命体。	任何能反射超声波的固体表面。
环境干扰	受强环境光（尤其是含红外的光）影响大。	受热源、气流影响，可能误触发。	受柔软表面、复杂角度影响，精度下降。
安装复杂度	较高，需精确对准发射和接收端。	低，只需朝向检测区域。	中，需考虑检测锥角。
成本	通常较低。	低。	相对较高。
典型应用	物体计数、安全光幕、转速测量、精准位置触发。	人体感应灯、安防报警。	避障、液位检测、简单测距。

选择建议：

• 需要精确知道物体何时通过一个特定点（如传送带上的产品计数），红外对射是首选。
• 只需要知道一个区域内是否有人移动（如走廊灯），PIR更合适且安装方便。
• 需要知道物体的距离或存在性，但检测路径上可能有视觉遮挡或非固体物体，超声波更适合。

2.3 传感器关键参数解读

拿到一对红外对射传感器，你需要关注以下几个参数，它们直接决定了你的项目能否成功：

1. 工作电压：常见为3.3V或5V。发射端电压影响发射功率和有效距离。接收端电压需与你的单片机逻辑电平匹配。
2. 有效距离：这是指在理想条件下，传感器能稳定工作的最大间距。标注为“10米”的传感器，在室外阳光下可能连1米都困难。这个参数是实验室条件下的，实际使用要打折扣。
3. 输出信号类型：
   • 数字输出（常开/常闭）：最常用。接收端内部相当于一个开关。光束连通时，开关一种状态；光束断开时，开关另一种状态。我们示例中的就是数字输出。
   • 模拟输出：较少见，输出信号强度与接收到的红外光强度成正比，可用于判断遮挡物的程度，但更易受干扰。
4. 响应时间：指从光束被遮断到输出信号变化的时间。对于高速计数应用（如测量电机转速），这个参数至关重要，需选择响应时间在微秒级的型号。
5. 对准方式：有的传感器带有对准指示灯或调校螺丝，这在安装间距较大时非常有用。没有的话，你就得靠万用表或代码读取信号来慢慢微调了。

3. 硬件连接与电路解析

3.1 元器件清单与引脚定义

开始接线前，请准备好以下物品：

• 红外对射传感器一对（含发射端Tx和接收端Rx）。
• 开发板一块（如Arduino Uno、ESP32、Adafruit Feather M0等）。
• 面包板和杜邦线若干。
• 可选：10kΩ电阻一个（如果您的单片机不支持或你不使用内部上拉电阻）。

通常，传感器的引线颜色遵循一个惯例（但务必以产品说明书为准）：

• 发射端（Tx）：两根线。
  • 红色：电源正极（VCC），接3.3V或5V。
  • 黑色：电源负极（GND），接地。
• 接收端（Rx）：三根线。
  • 红色：电源正极（VCC），接3.3V或5V。
  • 黑色：电源负极（GND），接地。
  • 黄色或白色：信号输出线（SIGNAL），接单片机数字输入引脚。

3.2 详细接线图与电流分析

接线顺序和原理如下：

1. 为发射端供电：将发射端的红线（VCC）连接到开发板的5V输出引脚。黑线（GND）连接到开发板的GND。这里选择5V而非3.3V，是为了获得更远的有效检测距离。因为发射端是一个IR LED，提高电压可以增加其发射功率（同时电流也会增大）。根据提供的资料，在5V下工作电流约为20mA，在3.3V下约为9mA。只要你的开发板5V引脚能提供超过20mA的电流（Arduino Uno的5V引脚标称可达数百mA），就完全没问题。
2. 为接收端供电并连接信号线：将接收端的红线（VCC）也连接到开发板的5V。黑线（GND）连接到GND。至此，发射端和接收端共享了电源和地，这为信号提供了一个共同的参考电平，是标准接法。关键的一步来了：将接收端的黄线（信号线）连接到开发板的某个数字输入引脚，例如我们示例中的引脚D4。
3. 上拉电阻的必要性：接收端的输出是“开集电极”或“开漏”结构。你可以把它想象成一个连接在信号线和地之间的“电子开关”。当光束畅通时，这个开关是断开的，信号线处于“悬空”状态。单片机无法读取一个悬空引脚的电平（会得到随机值）。因此，我们需要一个“上拉电阻”将信号线连接到VCC（如5V），给其一个默认的“高电平”。当光束被遮挡时，接收端内部的开关闭合，将信号线强行拉到GND，变为“低电平”。大多数现代单片机（如Arduino使用的AVR，ESP32，STM32等）都内置了可软件控制的上拉电阻，我们可以在代码中轻松启用它，这样就省去了外接一个物理电阻的麻烦。如果不使用内部上拉，则必须在信号线和5V之间外接一个10kΩ的电阻。

实操心得：务必先接通电源，再将传感器对准。对准时，可以观察接收端（有些型号带指示灯）或通过后续的代码读取信号值。最土但最有效的方法是：用一张不透明的纸片在光束路径上来回移动，同时用Serial.println()输出信号值，观察值是否稳定变化。微调传感器角度，直到“有遮挡”和“无遮挡”时的读数区别最大、最稳定。

3.3 关于电源与接地的深入探讨

资料中提到“Note that you do not have to share power supply ground or power between the two”，这在理论上是正确的，因为信号是通过光传输的。但在99%的实际项目中，强烈建议将发射端和接收端的电源和地共接。原因有三：

1. 简化布线：共用一套电源系统（如同一个开发板）最为方便。
2. 确保电平兼容：共地确保了发射端电源和接收端电源（以及单片机）的“0V”基准是同一个，避免了因“地电位差”导致信号误判。
3. 稳定性：独立的电源如果特性有微小差异，可能会引入噪声。

只有在极特殊的情况下，例如发射端和接收端距离非常远（数十米以上），各自有独立的本地电源，并且两地之间存在较大的地电位差风险时，才会考虑使用光耦等器件进行隔离，并采用独立的电源系统。对于入门和绝大多数应用，共用电源和地是最佳实践。

4. Arduino平台实现详解

4.1 代码逐行解析与状态机思维

让我们深入分析提供的Arduino示例代码，并理解其背后的逻辑。代码的核心是监测一个数字引脚的状态变化。

/* IR Breakbeam sensor demo! */ #define LEDPIN 13 // 定义LED引脚，用于视觉指示 #define SENSORPIN 4 // 定义传感器信号线连接的引脚 // 变量声明： int sensorState = 0; // 存储传感器当前状态 int lastState = 0; // 存储传感器上一次的状态 void setup() { pinMode(LEDPIN, OUTPUT); // 设置LED引脚为输出模式 pinMode(SENSORPIN, INPUT); // 设置传感器引脚为输入模式 digitalWrite(SENSORPIN, HIGH); // 关键！启用内部上拉电阻 Serial.begin(9600); // 初始化串口通信，用于调试输出 }

在setup()函数中，digitalWrite(SENSORPIN, HIGH);这一行对于初学者可能有些费解。我们不是将引脚设为INPUT了吗，为什么还能对它进行digitalWrite？这正是Arduino框架为了方便用户而设计的功能。当引脚模式设置为INPUT后，再对其执行digitalWrite(HIGH)，实际上是启用该引脚内部的上述电阻。这是一个非常巧妙且重要的设计。

void loop(){ // 读取传感器引脚的当前状态（HIGH或LOW） sensorState = digitalRead(SENSORPIN); // 控制LED：光束被遮挡（LOW）时点亮LED if (sensorState == LOW) { digitalWrite(LEDPIN, HIGH); } else { digitalWrite(LEDPIN, LOW); } // 检测状态变化，并打印信息（边缘检测逻辑） if (sensorState && !lastState) { Serial.println("Unbroken"); // 从“遮挡”变为“连通” } if (!sensorState && lastState) { Serial.println("Broken"); // 从“连通”变为“遮挡” } // 更新“上一次状态”，为下一次循环做准备 lastState = sensorState; }

loop()函数中的后半部分是实现“事件触发”的精髓。它不是一个简单的if(sensorState == LOW) {打印“遮挡”;}，而是通过比较sensorState和lastState，只在状态发生变化的瞬间打印一次消息。这种逻辑称为“边缘检测”。

• if (sensorState && !lastState)：当前状态为HIGH（光束连通）且上一次状态为LOW（遮挡）。这意味着遮挡物刚刚移开，光束恢复连通。
• if (!sensorState && lastState)：当前状态为LOW（遮挡）且上一次状态为HIGH（连通）。这意味着刚刚有物体遮挡了光束。

这种写法避免了在光束持续被遮挡的整个过程中，串口监视器被重复的“Broken”消息刷屏，只在我们关心的“事件发生时刻”输出日志，对于后续实现计数、计时等功能至关重要。

4.2 功能扩展：物体计数器与防抖动处理

基础的开关检测很容易，但做一个稳定的计数器就需要考虑更多。直接套用上面的代码进行计数，可能会因为物体的抖动或传感器本身的噪声导致多次误计数。下面是一个增强版的计数器示例，加入了防抖动（Debounce）逻辑。

#define SENSORPIN 4 #define DEBOUNCE_DELAY 50 // 防抖动延时，单位毫秒 int sensorState; int lastStableState = HIGH; // 假设初始状态是连通 long lastDebounceTime = 0; // 上次状态变化的时间 int count = 0; // 计数器 void setup() { Serial.begin(9600); pinMode(SENSORPIN, INPUT_PULLUP); // 更简洁的启用内部上拉方式 } void loop() { int reading = digitalRead(SENSORPIN); // 读取原始值 // 防抖动核心逻辑：如果读数与上次稳定状态不同，则重置计时器 if (reading != lastStableState) { lastDebounceTime = millis(); } // 如果经过防抖动延时后，读数仍然保持与稳定状态不同，则认为发生了有效的状态变化 if ((millis() - lastDebounceTime) > DEBOUNCE_DELAY) { if (reading != sensorState) { sensorState = reading; // 检测下降沿：从HIGH（连通）变为LOW（遮挡），计一次数 if (sensorState == LOW) { count++; Serial.print("Count: "); Serial.println(count); // 这里可以添加其他动作，如控制继电器、发送网络请求等 } } } lastStableState = sensorState; // 更新稳定状态 // 注意：此处没有额外的delay，以保证循环响应速度 }

代码解析与参数选择：

• INPUT_PULLUP：在pinMode中直接使用这个参数，等同于INPUT+digitalWrite(pin, HIGH)，是更推荐的写法。
• 防抖动原理：机械振动或电气噪声可能导致信号在短时间内快速高低跳变。防抖动算法通过引入一个延时（DEBOUNCE_DELAY），只有信号在新状态上保持稳定超过这个延时，才被确认为真正的状态改变。50ms是一个适用于大多数低速物体（如人走过、箱子通过）的起始值。对于高速场景（如测量风扇转速），这个值需要减小到几个毫秒甚至更短，但可能会引入噪声风险，需要权衡。
• 计数逻辑：我们选择在光束被遮挡的瞬间（下降沿）计数。你也可以选择在光束恢复的瞬间（上升沿）计数，这取决于你的应用场景（例如，是物体前沿触发还是后沿触发）。

4.3 高级应用：测量物体通过速度

如果我们有两对红外对射传感器，安装时保持已知的固定距离，就可以估算物体的通过速度。这是工业流水线上常用的非接触测速方法。

接线：将两对传感器（Sensor A和Sensor B）的信号线分别接到Arduino的两个数字输入引脚（如D4和D5）。确保它们的发射-接收对彼此不会光学干扰（错开安装或使用不同频率的调制传感器）。

代码逻辑：

1. 当物体遮挡Sensor A时，记录时间t1。
2. 当物体遮挡Sensor B时，记录时间t2。
3. 已知两传感器间距d，则速度v = d / (t2 - t1)。

这里提供一个简化的概念代码框架：

#define SENSOR_A_PIN 4 #define SENSOR_B_PIN 5 #define DISTANCE_AB 0.1 // 单位：米，A和B传感器之间的距离 unsigned long timeA = 0; unsigned long timeB = 0; bool objectDetectedByA = false; void setup() { Serial.begin(115200); pinMode(SENSOR_A_PIN, INPUT_PULLUP); pinMode(SENSOR_B_PIN, INPUT_PULLUP); } void loop() { if (digitalRead(SENSOR_A_PIN) == LOW && !objectDetectedByA) { // 物体首次遮挡A timeA = micros(); // 使用micros()获取微秒级时间，更精确 objectDetectedByA = true; Serial.println("Object at A"); } if (objectDetectedByA && digitalRead(SENSOR_B_PIN) == LOW) { // 物体遮挡B（假设物体从A运动到B） timeB = micros(); float timeDelta = (timeB - timeA) / 1000000.0; // 转换为秒 float speed = DISTANCE_AB / timeDelta; // 计算速度，米/秒 Serial.print("Time: "); Serial.print(timeDelta, 6); Serial.print(" s, Speed: "); Serial.print(speed, 2); Serial.println(" m/s"); objectDetectedByA = false; // 重置状态，等待下一个物体 // 注意：这里需要一个机制确保物体完全通过B后再重置，防止重复触发。 // 一个简单的方法是加入短暂延时或等待B传感器恢复为HIGH。 delay(100); // 示例延时 } }

注意事项：实际应用中需要考虑物体长度、传感器响应时间差、以及如何防止一个物体触发多次计算等问题。通常需要实现一个简单的状态机来精确跟踪物体的位置。

5. CircuitPython平台实现详解

5.1 CircuitPython开发环境与数字I/O基础

CircuitPython是Adafruit主导的基于Python的开源嵌入式系统，其最大优势是代码可读性极高，开发体验接近在电脑上写Python脚本，非常适合快速原型开发和教育。使用CircuitPython读取数字传感器，核心是digitalio模块。

首先，你需要将支持CircuitPython的固件刷写到你的开发板（如Adafruit Feather M0、ESP32-S2等），并将其作为一个U盘挂载到电脑。之后，你可以直接用文本编辑器编辑code.py或main.py文件，保存后代码会自动运行。

接线与Arduino部分完全一致：发射端接3.3V/5V和GND；接收端VCC和GND接对应引脚，信号线（如黄线）接一个数字IO口（例如board.D5）。

5.2 代码实现与交互式调试

让我们深入看看提供的CircuitPython代码，并理解其背后的对象化编程思想。

import time import board import digitalio # 1. 创建DigitalInOut对象，并指定引脚 break_beam = digitalio.DigitalInOut(board.D5) # 2. 配置引脚方向为输入 break_beam.direction = digitalio.Direction.INPUT # 3. 启用内部上拉电阻 break_beam.pull = digitalio.Pull.UP # 主循环 while True: if not break_beam.value: # 当value为False时，表示光束被遮挡（引脚被拉低） print("Beam is broken!") time.sleep(1.0) # 每秒检查一次

逐行解析：

1. digitalio.DigitalInOut(board.D5)：创建一个代表硬件引脚D5的数字IO对象。board模块包含了所有板载引脚的定义，这种写法使得代码在不同型号的开发板间移植性很好。
2. break_beam.direction = digitalio.Direction.INPUT：明确设置该引脚为输入模式。这是必须的步骤。
3. break_beam.pull = digitalio.Pull.UP：启用内部上拉电阻。这是CircuitPython中启用上拉的语法，非常直观。你也可以设置为Pull.DOWN（如果支持）或None（不启用上下拉）。
4. break_beam.value：读取引脚的电平值。这是最关键的一点：当上拉电阻启用时，默认（光束连通）情况下，这个值是True（高电平）。当光束被遮挡，接收端内部开关闭合将引脚拉低，这个值变为False（低电平）。所以判断遮挡的条件是if not break_beam.value。

交互式调试（REPL）的强大之处： CircuitPython的REPL（交互式解释器）是绝佳的调试工具。按照示例，在串口终端中依次输入：

>>> import board >>> import digitalio >>> beam = digitalio.DigitalInOut(board.D5) >>> beam.direction = digitalio.Direction.INPUT >>> beam.pull = digitalio.Pull.UP >>> beam.value True # 此时应显示True，表示光束连通

然后用手挡住光束，再次输入beam.value，你会立刻看到输出变为False。这种即时反馈对于验证硬件连接、传感器对准情况无比方便。

5.3 状态监测与事件驱动优化

上面的示例代码使用time.sleep(1.0)进行每秒一次的轮询，这在很多应用中可能不够及时，也浪费CPU资源。我们可以利用time.monotonic()来实现非阻塞的定时检查，或者结合中断（虽然标准CircuitPython库对中断的支持因板而异，但通常有keypad等模块提供类似功能）。

这里展示一个使用时间戳进行非阻塞状态检查与边缘检测的改进版本：

import time import board import digitalio beam = digitalio.DigitalInOut(board.D5) beam.direction = digitalio.Direction.INPUT beam.pull = digitalio.Pull.UP current_state = beam.value last_state = current_state last_change_time = time.monotonic() debounce_interval = 0.05 # 50毫秒防抖动时间 while True: now = time.monotonic() reading = beam.value # 简易防抖动：只有读数稳定变化超过防抖动时间，才确认状态改变 if reading != last_state: last_change_time = now if (now - last_change_time) > debounce_interval: if reading != current_state: current_state = reading # 状态变化事件 if current_state: # 变为True，光束恢复 print("Beam Restored at", now) else: # 变为False，光束被遮挡 print("Beam Broken at", now) last_state = reading # 一个很短的延时，避免REPL被刷屏，在实际应用中可以根据需要调整或移除 time.sleep(0.01)

这个版本实现了和Arduino示例中类似的边缘检测和简易防抖动功能，打印出的消息只在状态真正改变时出现，并且带有时间戳，更利于后续的数据分析。

6. 实战调试技巧与常见问题排查

即使按照教程接线和编写代码，在实际部署中你还是很可能遇到传感器不工作或工作不稳定的情况。下面是我总结的排查清单和解决方案。

6.1 传感器完全无反应

现象：无论是否遮挡，LED不亮，串口无输出，或者输出值不变。

• 检查1：电源与接地：这是最常见的问题。用万用表测量发射端和接收端的VCC和GND引脚之间电压是否正确（5V或3.3V）。确保所有GND线都可靠地连接到了开发板的GND。
• 检查2：信号线连接：确认接收端的信号线（黄/白）确实连接到了代码中指定的数字引脚，并且没有接错到模拟引脚或其他特殊功能引脚上。
• 检查3：内部上拉是否启用：
  • Arduino：确认代码中有pinMode(pin, INPUT_PULLUP)或digitalWrite(pin, HIGH)（当引脚为INPUT模式时）。
  • CircuitPython：确认设置了pull = digitalio.Pull.UP。
  • 可以用万用表测量信号引脚对地电压。启用上拉后，在无遮挡时，电压应接近VCC（如5V）；遮挡时，电压应接近0V。
• 检查4：传感器对准：红外光束很窄，必须精确对准。在较远距离时，微小的角度偏差就会导致接收器完全收不到光。近距离对准后，再慢慢拉远距离调试。可以尝试在黑暗环境中进行初始对准。
• 检查5：传感器损坏：分别测试发射端和接收端。对于发射端，可以用手机摄像头（大部分手机CMOS对红外光敏感）观察，正常工作时应该能看到发射管发出微弱的紫白色光点。对于接收端，可以用一个已知好的红外遥控器对着它按键，同时用代码读取信号值，看是否有变化。

6.2 传感器工作不稳定，误触发频繁

现象：没有物体遮挡时，状态也会偶尔跳动；或者计数明显多于实际物体数量。

• 问题1：环境光干扰：这是非调制型传感器的天敌。日光、白炽灯、卤素灯都含有丰富的红外光。
  • 解决方案：
    1. 物理遮蔽：给传感器套上黑色热缩管或安装在不透明的管子里，只留出前端的小孔，大幅减少环境光进入的角度。
    2. 改用调制型传感器：这是最根本的解决方案。发射38kHz调制光，接收端只解调该频率的信号。
    3. 软件滤波：在代码中增加更严格的防抖动逻辑，或采用多次采样取平均值的算法来判断状态。例如，连续读取10次，如果8次以上是LOW才判定为遮挡。
• 问题2：电源噪声：如果电机、继电器等大功率设备与传感器共用电源，其开关可能引起电源电压波动，导致误触发。
  • 解决方案：
    1. 电源去耦：在传感器的VCC和GND引脚之间，就近焊接一个10μF的电解电容和一个0.1μF的陶瓷电容，用于滤除低频和高频噪声。
    2. 独立供电：为传感器模块使用独立的线性稳压电源（如LM7805），或与数字电路通过磁珠隔离。
• 问题3：机械振动：传感器安装不牢固，自身或连接线晃动，可能导致连接瞬时断开或对准偏移。
  • 解决方案：牢固安装传感器，并使用热熔胶或扎带固定好连接线。

6.3 检测距离不达标

现象：传感器在近距离工作正常，但稍微拉远距离就失效。

• 原因1：发射端功率不足：确保发射端接在了5V上（如果支持5V），而不是3.3V。5V供电能提供更强的发射功率和更远的距离。
• 原因2：对准精度：距离越远，光束发散导致光斑越大，但中心对准要求也越高。使用激光笔辅助对准是一个好办法：先将激光笔与发射端平行固定，用激光点瞄准接收端中心，然后再替换为红外传感器。
• 原因3：环境光过强：在室外或强光下，接收端被环境红外噪声“淹没”，无法识别出微弱的信号。必须使用调制型传感器，并尽可能加装遮光罩。
• 原因4：传感器本身性能限制：查看数据手册中的“有效距离”参数，那通常是在理想暗室条件下的指标。实际使用距离建议按标称值的50%-70%来规划。

6.4 计数遗漏或重复计数

现象：物体明明通过了，但计数器没加1；或者只通过一个物体，却加了2次或更多。

• 遗漏计数：通常是因为物体通过速度太快，而代码循环速度太慢，错过了状态变化的瞬间。减少loop()或while True循环中的delay()时间，使用millis()或time.monotonic()进行非阻塞计时。确保防抖动时间（DEBOUNCE_DELAY）小于物体遮挡光束的最短时间。
• 重复计数：
  1. 防抖动时间过短：物体边缘可能不平整或有小孔，导致光束在遮挡过程中出现短暂的“连通-遮挡-连通”抖动。适当增加防抖动时间（例如从50ms增加到100ms）。
  2. 状态机逻辑缺陷：在速度测量示例中，如果物体较长，可能同时遮挡两个传感器，或者离开A后还未到达B就重置了状态机。需要设计更严谨的状态机，例如使用“A遮挡 -> B遮挡 -> A恢复 -> B恢复”这样一个完整周期来定义一个物体通过。
  3. 物体反射干扰：对于高反射率的物体，红外光可能从物体表面反射到接收端，导致接收端在物体遮挡时依然收到信号。尝试调整传感器角度，避免正对反射面，或在接收端前加装小型遮光筒。

通过系统性地理解原理、动手实践、并运用这些调试技巧，你就能让红外对射传感器在各种项目中稳定可靠地工作，成为你感知物理世界的得力工具。