KTV或餐饮包间里,灯光通常不止是“开”和“关”——朋友聚会需要亮一点烘托气氛,商务宴请可能需要柔和的暖光,服务员打扫时又要最亮。要实现这种精细控制,关键是用对硬件:芯步的8路控制器里,有一款是支持PWM调光或0-10V调光接口的(普通开关型控制器只能通断,调不了亮度,这一点要先确认好)。下面说下具体怎么做。
一、 选型与准备:不仅仅是开关,更是调光器
要实现“无级调节亮度”,我们选用的硬件是芯步的 “智能8路调光控制器” (具体型号类似 UNI-KZJ-8DIM 或者基于PWM输出的继电器模块)。
产品核心能力:
8路独立输出:意味着你可以控制包间里的主灯、灯带、筒灯、壁灯、甚至洗手间射灯,互不干扰。
调光支持:这才是核心。这款控制器通常支持 PWM(脉冲宽度调制) 或 0-10V 调光信号,配合对应的驱动电源,就能把普通LED灯变成可调光灯。
开放接口:芯步的设备都开放 HTTP 接口,这意味着你的平板、手机或收银系统可以通过发送一条简单的网络指令来控制它。
准备工作:
硬件:8路调光控制器 x1、可调光LED灯带/筒灯(必须配合调光驱动电源)、WiFi路由器(2.4G频段)。
软件账号:注册芯步开发者账号,在后台获取
AppID、AppKey以及设备的唯一Device ID。
二、 硬件接线:电工也能看懂
别被“接口”吓到,物理接线其实很简单:
供电:给控制器接上220V电源(记得断电操作)。
接灯
把包间里的灯光回路分成最多8组(例如:大厅主灯、卡座射灯、走廊灯带、氛围壁灯)。
将灯的驱动电源输入端接到控制器对应的“输出端”。
关键点:为了实现调光,你的灯必须是“可调光驱动”配合的。如果是普通开关,只能通断;但我们现在接的是调光控制器,它能改变电流波形,让灯变暗。
网络:确保控制器通电后黄色指示灯闪烁(表示进入配网模式)。
三、 软件对接:让系统“认识”这8盏灯
这是最核心的环节,也是你问的“开放接口”怎么用。芯步的API设计得很直白,你可以直接用任何编程语言(如Python、Java、PHP,甚至通过Postman工具)调用。
第一步:获取设备状态(看看灯当前啥情况)在你想调光之前,系统需要知道设备在线不。可以调用 获取设备详情 接口。
接口地址
http(s)://api.thingboot.com/{你的AppID}/device/info/请求方式:GET 或 POST
必须参数
device=你的设备ID以及经过算法加密的sign签名。
如果返回的 online.status 是 1,说明设备在线,可以干活了。
第二步:控制某一路灯光亮度(重点!)这是你要的“远程调节”。官方文档中,针对调光控制器,控制指令通常包含在 state 参数中。
假设你想把 第1路 的灯光亮度调到 70%(注意:这里很多设备参数是0-100,也有的是0-255,具体看文档)。
发送指令示例逻辑:
URL
http(s)://api.thingboot.com/{AppID}/device/send/POST Body (JSON 格式)
注:具体的参数名(比如是 dimmer1 还是 channel1_bright)要看一下你买的那个具体型号的产品手册,但逻辑都是这样。
第三步:场景联动(高级玩法)你可以把你的业务系统连起来。比如:
KTV点歌系统联动:当客人点一首“抒情慢歌”时,系统自动调用API,把第1路亮度调至30%,第2路调至50%,营造氛围。
服务员打扫模式:在手持PAD上点一下,调用API将所有的8路灯光亮度调到100%(最亮),方便搞卫生。
定时关闭