Example 38: IR obstacle sensor

Synchronized Device Documentation

This page corresponds to the synchronized Chinese source. Commands, JSON examples, API paths, field names, and screenshots are kept aligned with the Chinese device-side source documentation.

What This Page Covers

• Overview
• Wiring
• JSON Configuration Example
• PeriphExec Linkage
• Notes

Source Reference

The detailed operational source is preserved below so implementation details stay exact while the English navigation, titles, and reading path remain available.

示例38:红外避障传感器

实验概述

红外避障传感器发射红外光，通过检测反射信号判断前方是否有障碍物。检测到障碍物时输出低电平，适用于自动避障小车、距离检测等。

硬件接线

开发板标识	GPIO引脚	连接设备
OUT	GPIO4	红外避障模块 DO输出

模块上电位器可调节检测距离（2~30cm）。

JSON 配置示例

{
  "peripherals": [
    {
      "id": "ir_obstacle_01",
      "name": "红外避障",
      "type": 11,
      "enabled": false,
      "pins": [4],
      "params": {}
    }
  ]
}

外设执行联动

场景：避障停车（轮询触发）

功能：检测到障碍物时停止电机

Web界面配置步骤

步骤1：确保已配置电机外设

• 电机IN1：motor_in1（GPIO输出）
• 电机IN2：motor_in2（GPIO输出）

步骤2：创建规则

1. 点击左侧菜单 外设配置 → 切换到 外设执行管理 标签
2. 点击 新增规则 按钮
3. 填写基础配置：
   • 规则名称：避障停车
   • 上报数据：✅ 启用
   • 启用：✅ 启用

步骤3：配置触发器（轮询触发）

1. 点击 添加触发 按钮

2. 填写触发器配置：

   字段	填写内容	说明
   触发类型	选择 轮询触发	定时检测条件
   目标外设	选择 ir_obstacle_01	红外避障
   轮询间隔	50	50ms（快速响应）
   条件表达式	value == 0	有障碍物（低电平）

步骤4：配置动作（需要2个动作）

动作1：停止电机IN1

1. 点击 添加动作 按钮
2. 填写：
   • 动作类型：选择 低电平
   • 目标外设：选择 motor_in1

动作2：停止电机IN2

1. 再次点击 添加动作 按钮

2. 填写：

   • 动作类型：选择 低电平
   • 目标外设：选择 motor_in2

3. 点击 保存 按钮

红外避障传感器说明

状态	输出电平	说明
无障碍物	高电平（1）	正常行驶
有障碍物	低电平（0）	需要停车

应用场景

场景	说明	检测距离
避障小车	前方障碍检测	2-30cm
限位开关	机械位置限制	2-30cm
物体检测	流水线计数	2-30cm

注意事项

1. 检测距离：可通过电位器调节，典型 2-30cm
2. 颜色影响：黑色物体吸收红外线，可能检测距离缩短
3. 环境光：强红外光源（阳光）可能干扰
4. 安装角度：传感器朝向需正对检测方向