CATALOG

这是一个偏向实战的对接方案,我尽量写得详细且不枯燥。

一、 我们面临什么痛点?

在智能照明或智慧工厂项目中,我们经常遇到这种尴尬:现场全是传统的 led 工矿灯、高压钠灯或者普通的家用吊灯。这些灯具本身没有“智能”可言,就是两根线——火线和零线。

想要控制它们?传统的做法是换智能灯具,成本太高;或者重新布线走弱电控制,工程太大。

核心思路是: 既然灯具是“傻”的,那我就给它的“电线”上加装一个聪明的“大脑”。这就好比家里的老式空调,加一个智能插座就能变智能。

我们今天的主角——芯步的 AC5-10A 智能通断器,就是这个“大脑”。

二、 为什么选 AC5-10A?

在开始写代码前,我们先看看这个硬件能干什么。它有几个很贴心的特性,非常适合做系统集成:

  1. 直接“串”进电路里:它支持 100-250V 交流输入,也就是可以直接接家里的火线零线。额定电流 10A,最大负载 2200W,无论是工厂照明还是商业照明,基本都够用

  2. 自带 WiFi,直连云端:这一点很重要。很多类似设备需要买网关(相当于一个中转站)。AC5-10A 不需要,它可以直连你项目现场的路由器 WiFi。这就省了一笔硬件成本和施工麻烦

  3. 支持“干接点”输入:它不仅有输出(控制灯),还有一路开关量输入。这意味着什么?如果现场工人不习惯用手机,你可以再接一个普通的墙壁开关接到这个口上,这样物理按键和远程控制都能用,两边都不耽误。

  4. 极度开放的 HTTP 接口:这是芯步的核心优势。它把复杂的物联网协议封装成了我们程序员最熟悉的 HTTP 请求,无论是 Java、Python、PHP 还是 Node.js,甚至是 shell 脚本,都能直接调

三、 对接逻辑架构

我们要做的是软硬件解耦

物理层: AC5-10A 设备串入灯具回路。网络层: 设备上电配网,连接互联网。云平台层: 芯步开放平台(管理设备状态)。应用层: 你的业务系统(通过 API 调用控制设备)。

一句话流程:你的系统 -> 调用芯步 API -> 云端下发指令 -> 设备 WiFi 接收 -> 继电器吸合/断开 -> 灯具亮/灭。

四、 实战对接步骤

这里我们主要讲软件怎么接。硬件的接线其实更简单:进线接市电 L/N,出线接灯具 L/N。

第一步:拿到设备的“身份证”

你得先知道这个设备在云端叫什么名字。

芯步提供了 获取设备详情 的接口。这个方法非常有用,不仅是拿 ID,你还能顺便知道设备在不在线(online 字段)。

小贴士:在实际开发中,先把这个接口调通。如果能正确返回灯具状态,说明网络通了,设备也配好网了,我们再往下进行

第二步:发送“开/关”指令

这是最核心的一步。我们要通过代码去扳动那个“开关”。

芯步的 设备控制 接口设计得极其简洁。控制指令是放在 JSON 里的,关键字段是 order

以下是一个后端发起请求的伪代码逻辑(非常口语化的解释):

1. 关灯操作:当你把灯的开关拨到“关”,电流被切断,灯灭了。通过接口实现就是发送 {"power":"0"}这里注意文档里的说明:1 代表打开,0 代表关闭

2. 开灯操作:发送 {"power":"1"}

3. 脉冲模式(酷炫功能):假设你控制的不是灯,而是一个电子门锁或者一个报警器,你只需要它接通 1 秒然后立刻断开。这时候你可以用 point 参数