适合开发者、展会搭建方、系统集成商阅读
一、写在前面:为什么展会现场需要“能编程的开关”
做过展会就知道,现场照明控制看起来简单,实际上挺折腾人的。展位要分区域亮灯、有的展品需要重点打光、有的区域要模拟“白天/夜晚”场景切换——普通开关根本搞不定。
如果自己从零做一套物联网控制方案,光硬件研发就够呛。芯步这款双路智能墙壁开关的优势在于:它本质上是一个“能联网、有API”的硬件,你只需要把它接到你的系统里,用HTTP接口发指令就行。
本文就讲讲怎么把这个开关“收编”进你自己的项目,别怕,不复杂,个把小时就能跑通。
二、先认识一下这个“双路开关”能干啥
基础参数(快速过一下)
型号:UNI-KG-2,标准的86型面板,可以直接替换展位上的普通开关
控制路数:2路独立控制,相当于一个面板管两盏灯或两路设备
额定电流:10A/路,LED灯的话每路不超过300W
通信方式:WiFi 2.4GHz,走HTTP接口控制
安装:零火线供电,接线前记得关总闸
它听什么“话”
这个开关听的是HTTP命令,不是语音(当然你要接语音助手也行,那得你自己写中间层)。核心参数就三个:
| 指令 | 作用 | 取值范围 |
|---|---|---|
| power1 | 控制第1路开关 | 1=开,0=关 |
| power2 | 控制第2路开关 | 1=开,0=关 |
就这么简单。
另外它还有一些高级玩法,比如point1(第1路瞬间打开后自动关闭,适合“点亮一下再灭”的效果)、reset1(第1路先关闭再打开,复位用),还有状态保持功能——这个在展会场景下特别实用,后面细说。
三、对接步骤:从零到跑通
第一步:配网,让开关“上线”
拿到开关,首先得让它连上展会的WiFi。
两种方式
PC端配网:登录芯步官网 → 进入物联网控制台 → 添加现场WiFi(必须是2.4G频段)→ 用手机开热点模拟配网
小程序配网:微信搜“芯步小程序” → 登录账号 → 同样步骤添加WiFi
配网成功后,开关指示灯会从闪烁变常亮,同时在控制台的“设备列表”里能看到它,记住那个设备ID,后面调用接口全靠它。
第二步:获取你的“钥匙”——AppID和签名
要调用接口,需要三个东西:
AppID:你的应用ID,在控制台的“开发设置”里找到
AppSecret:你的开发者密码,不要泄露
签名(sign)
md5(md5(AppSecret) + ts),其中ts是当前Unix时间戳(秒)
口语化解释:签名就是个“临时密码”,每次请求都不一样,防止别人伪造你的指令。
代码示例(Python版,好理解):
第三步:发指令,让开关动起来
用POST请求,JSON格式,发到上面那个URL。
返回结果解读:如果收到{"code": 200},说明平台收到指令并成功下发了。但注意——这不代表开关真的执行了,只是说明指令没发错。如果开关离线或者命令内容有问题,还得看异步消息推送来确认执行结果。
实际测试中,从发指令到灯亮,延迟大概80-120毫秒,基本感觉不到延迟。
四、展会场景下的实战配置
场景1:分区独立控制
假设你有个展位,分A区和B区:
你的中控系统可以做个简单界面,两个按钮就行。
场景2:自动演示模式(状态保持)
这是个很实用的功能。比如你希望展区默认关灯,但允许观众按墙上开关临时开灯,10秒后自动恢复关灯——用状态保持命令:
下发这个命令后,即使用户手动按开关把灯打开,10秒后开关也会自动恢复成关闭状态。
展会结束自动关灯?定时命令安排上:
reset1的单位是毫秒,3600000毫秒=1小时。
场景3:多设备批量控制
如果你不只有一个开关,而是控制整个展区的所有开关,可以创建分组
或者直接批量发指令:device参数里用逗号分隔多个设备ID。
场景4:对接你的现有系统
无论你是用Vue写的中控大屏、用UniApp做的小程序,还是用C#写的桌面控制台,本质都一样——发HTTP请求。芯步的接口支持任何能发HTTP请求的编程语言。
举个前端JavaScript的例子(用fetch):
五、踩坑提醒(血的教训)
WiFi必须是2.4G:这个开关不支持5G WiFi,展会现场的AP如果是双频合一,记得单独开个2.4G的SSID。
接线前断电:这玩意直接接220V市电,没电工经验的别自己上手,找个电工师傅帮忙,十几分钟就装好了。
code:200不代表灯亮了:它只代表平台收到了指令。如果开关掉线,你收到200但灯没反应。配合状态查询接口或消息推送确认执行结果。
LED灯负载别超300W/路:这是实测安全值,超了可能烧继电器。
六、总结:这东西到底值不值得用
如果你是做展会系统的开发者或集成商,自己从零做硬件+通信协议+后台,成本至少五位数起。而用芯步这套方案,一个开关几十到一百多块钱,接口半天就能对接完,所有代码都在本文里了。
适用场景:临时性展览、快闪店、样板间、需要快速部署的智能照明项目。不适用场景:需要调光(这个开关只能开关,不能调亮度)、需要脱离互联网纯本地运行(虽然它支持局域网,但第一次配网还是需要外网)。
有什么具体问题,欢迎留言交流,或者直接去芯步官网看产品手册,里面有更详细的签名算法和错误码说明。