校园公共照明最头疼的问题就是：日常需要自动运行节约能源，但遇到晚上搞活动、临时打扫卫生，又得让人能临时开灯。这篇方案会结合芯步的开放接口，告诉你具体怎么通过API调用，在后台或手机端实现“点动/自锁”两种模式的灵活切换。
1. 分析：为什么我们需要点动和自锁？
在校园里，路灯、走廊灯、教室灯通常有两个需求打架：
日常模式（自锁/互锁）：晚上6点自动开灯，早上6点自动关灯，保持状态不变。这需要“自锁”功能，即一直通电。
临时模式（点动）：半夜保安巡逻，或者有学生晚归，需要路灯亮一下，人走灯灭；或者维修工测试线路，需要“点一下动一下”。
传统方案的痛点在于：要去配电箱拨弄继电器，或者重新写PLC代码，非常麻烦。芯步方案的优势在于：通过API远程修改设备的工作模式，把物理按钮的动作逻辑抽象成软件指令。
2. 硬件选型
要实现这个方案，我们需要选对硬件。根据芯步的产品生态，推荐使用 智能断路器 或 工业级智能继电器模块。
这里我们假设选用的是 芯步兼容的 1路/多路 WiFi 智能继电器模块（类似于市面上支持定制固件的通用模块）。
关键参数：这类设备通常支持“点动”、“自锁”、“互锁”三种模式。
对接前提：确认设备固件支持模式切换指令。芯步的开放接口允许我们直接修改设备的产品参数或下发特定JSON指令。
3. 接口调用逻辑设计
我们要利用芯步的开放 API 来做两件事：
查状态：获取当前设备是在“点动”还是“自锁”模式。
改模式：发送指令切换模式。
控开关：在特定模式下控制通断。
核心依据芯步的接口规范，我们将通过 HTTP 或 MQTT 方式与云平台交互。
3.1 关键API应用
获取设备详情：通过
GET device/info接口获取设备当前的自定义属性（custom_params），里面应该包含work_mode字段（例如：0=自锁，1=点动）。下发设备指令：通过
POST device/control接口。
4. 具体实现步骤
我们分三步走，把“物理概念”变成“手机上的两个按钮”。
第一步：设备初始化配置
在部署智能断路器时，我们通过后台接口预设默认状态。
场景设定：校园路灯。初始化代码逻辑（伪代码思路）：
第二步：模式切换的核心逻辑
这是本方案最精华的部分。我们需要在管理后台（比如校园后勤APP或网页）做一个开关，拨动一下，设备底层的工作逻辑就变了。
模式 A：自锁模式
场景：晚上 19：00 - 23：00 正常照明。
需求：按一下开，灯一直亮；按一下关，灯一直灭。
指令下发：后台调用接口，将继电器的工作参数设为
"relay_type": "self_locking"。用户交互：点击“开启” -> 继电器吸合 -> 电压导通 -> 常亮。
模式 B：点动模式
场景：凌晨 2：00，保安巡逻路过。如果按自锁，灯亮了忘了关浪费电。
需求：按住才亮，松手就灭（类似门铃）。
指令下发：后台调用接口，将继电器工作参数设为
"relay_type": "momentary"，并设置点动持续时间，例如"momentary_time": 500（毫秒）。用户交互：点击“临时照明” -> 继电器吸合 0.5 秒 -> 自动断开 -> 灯灭。
第三步：利用“设备详情”接口做状态同步
为了防止误判，我们要利用芯步的 device/info 接口做一个反馈机制。
参考数据结构（基于芯步返回示例扩展）：
在管理界面上，我们实时读取 state.work_mode 的值，如果为 1，按钮显示为“当前模式：点动（临时）”；如果为 0，显示为“当前模式：自锁（常开）”。
5. 落地应用场景演示
让我们把这个方案放到具体的高校图书馆自习室里看效果：
第一种场景：闭馆前的清场
情况：管理员需要在闭馆前逐层提醒学生离开。
操作：在手机上进入管理后台，将该层走廊灯切换为 点动模式。
执行：管理员按下“点亮”按钮，灯光亮起 10 秒后自动熄灭。既能照亮路，又不用管理员回头关灯。
接口调用
command: "momentary_on", time: 10。
第二种场景：周末的社团活动
情况：周六晚上，学生会要用活动室。
操作：学生会长在APP申请权限，后勤审批后，远程将该活动室的灯切换为 自锁模式。
执行：学生进入后，按一下墙上的智能开关（或手机点一下），灯一直亮；活动结束，再按一下，灯灭。
接口调用
command: "set_mode", mode: "self_locking"。
6. 总结
通过芯步的开放接口，我们把复杂的电气逻辑（点动/自锁）封装成了简单的 API 调用。
这套方案的精髓在于：
无需重新布线：通过 API 修改软件参数就改变了物理设备的行为。
精准控制：利用
device/info接口实时同步设备状态，避免后台显示“开”实际却是“关”的尴尬。降本增效：后勤人员不用随身携带螺丝刀去配电箱调模式了，点几下鼠标就行。
只要你会调用 HTTP 接口，结合芯步提供的设备详情和控制接口，就能轻松在校园里落地这套“点动/自锁”智能切换的照明方案。