CATALOG

适合开发者、展会搭建方、系统集成商阅读

一、写在前面:为什么展会现场需要“能编程的开关”

做过展会就知道,现场照明控制看起来简单,实际上挺折腾人的。展位要分区域亮灯、有的展品需要重点打光、有的区域要模拟“白天/夜晚”场景切换——普通开关根本搞不定。

如果自己从零做一套物联网控制方案,光硬件研发就够呛。芯步这款双路智能墙壁开关的优势在于:它本质上是一个“能联网、有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。

两种方式

  1. PC端配网:登录芯步官网 → 进入物联网控制台 → 添加现场WiFi(必须是2.4G频段)→ 用手机开热点模拟配网

  2. 小程序配网:微信搜“芯步小程序” → 登录账号 → 同样步骤添加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):

五、踩坑提醒(血的教训)

  1. WiFi必须是2.4G:这个开关不支持5G WiFi,展会现场的AP如果是双频合一,记得单独开个2.4G的SSID。

  2. 接线前断电:这玩意直接接220V市电,没电工经验的别自己上手,找个电工师傅帮忙,十几分钟就装好了。

  3. code:200不代表灯亮了:它只代表平台收到了指令。如果开关掉线,你收到200但灯没反应。配合状态查询接口或消息推送确认执行结果。

  4. LED灯负载别超300W/路:这是实测安全值,超了可能烧继电器。

六、总结:这东西到底值不值得用

如果你是做展会系统的开发者或集成商,自己从零做硬件+通信协议+后台,成本至少五位数起。而用芯步这套方案,一个开关几十到一百多块钱,接口半天就能对接完,所有代码都在本文里了。

适用场景:临时性展览、快闪店、样板间、需要快速部署的智能照明项目。不适用场景:需要调光(这个开关只能开关,不能调亮度)、需要脱离互联网纯本地运行(虽然它支持局域网,但第一次配网还是需要外网)。

有什么具体问题,欢迎留言交流,或者直接去芯步官网看产品手册,里面有更详细的签名算法和错误码说明。