Example 25: laser 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.

示例25:激光传感器

实验概述

激光发射模块通过 GPIO 高低电平控制激光的开启和关闭，可用于激光对射检测、激光指示器等应用。配合光敏接收器可实现激光对射报警。

硬件接线

开发板标识	GPIO引脚	连接设备
LASER	GPIO15	激光发射模块（高电平发射）

激光模块通常为低功率 Class IIIA（<5mW），3.3V 或 5V 供电。

JSON 配置示例

{
  "peripherals": [
    {
      "id": "laser_01",
      "name": "激光模块",
      "type": 12,
      "enabled": false,
      "pins": [15],
      "params": { "initialState": 0 }
    }
  ]
}

外设执行联动

场景：远程控制激光开关（平台触发）

功能：通过云平台下发指令控制激光开启/关闭

Web界面配置步骤

步骤1：创建规则

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

步骤2：配置触发器

1. 点击 添加触发 按钮

2. 填写触发器配置：

   字段	填写内容	说明
   触发类型	选择 平台触发	接收云平台指令
   操作符	选择 设置模式	接收数据作为动作参数

步骤3：配置动作

1. 点击 添加动作 按钮

2. 填写：

   • 动作类型：选择 高电平 或 低电平
   • 目标外设：选择 laser_01

3. 点击 保存 按钮

测试方法：

通过云平台发送：

• 1 或 HIGH → 激光开启
• 0 或 LOW → 激光关闭

注意事项

1. 安全：激光直射眼睛有害，操作时避免直视光束
2. 功耗：激光模块工作电流约 30mA，可直接由 GPIO 驱动（或通过三极管）
3. 散热：长时间连续工作需考虑散热
4. 对射应用：配合光敏电阻（GPIO_ANALOG_INPUT）实现对射检测