CATALOG

芯步的三开智能触摸开关通过标准HTTP接口接入软件系统,无需网关即可直连WiFi。以下方案涵盖接口协议、代码实现及餐厅场景配置。

解决方案:餐厅包厢照明控制——三开智能触摸开关的软件集成方案

1. 背景与目标

在餐厅包厢场景中,照明控制不仅需要实现基本开关功能,往往还需要根据用餐场景(如用餐、生日、烛光晚餐)切换不同的灯光氛围。芯步的智能触摸墙壁开关(3路)支持通过HTTP协议直接控制,无需额外网关。本方案的目标是指导开发者如何利用开放接口,将三开开关无缝集成至餐厅的SaaS或本地化软件项目中,实现远程控制、状态同步及场景联动。

2. 硬件选型与参数确认

项目实施选用芯步智能触摸墙壁开关(3路)其关键参数符合餐厅220V AC交流电布线标准,单路最大负载功率达1200W,足以覆盖包厢内常规筒灯、射灯及灯带负载。

  • 通信方式:WiFi 2.4GHz(直接连接路由器,无需网关)。

  • 控制路数:3路(例如:回路1: 主灯,回路2: 射灯/灯带,回路3: 氛围灯)。

  • 接口协议:HTTP/HTTPS。

3. 核心技术原理

芯步采用 “设备直连+ HTTP API” 的轻量级架构

  • 控制流:软件项目(App/PC) -> 云端API -> 路由器 -> 墙壁开关 -> 灯光负载。

  • 状态流:开关物理触摸/远程控制 -> 硬件主动上报 -> 软件服务器接收。

  • 关键特性:由于支持“私有化部署”和局域网通信,若软件部署在包厢内部服务器,控制指令无需经过外网,响应速度极快(局域网内实验数据为 80-120ms)

4. 软件集成实施步骤

4.1. 设备激活与凭证获取

在软件代码编写前,需完成物理设备的配置:

  1. 配网:使用芯步官方App或通过AP配网模式,将3路开关连接至餐厅包厢所在的WiFi网络。

  2. 获取关键凭证:在芯步开发者后台或通过App获取以下三个核心要素:

    • AppId: 应用唯一标识。

    • device ID: 该三开开关的唯一ID(例如:1234567)。

    • sign 生成规则:用于接口鉴权的签名算法。

4.2. 接口调用示例(后端/前端逻辑)

开关的控制接口非常标准化,适用于Java, Python, PHP, Node.js等任何支持HTTP请求的语言

请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={timestamp}

请求方法POSTBody (JSON)

逻辑解读:上述JSON指令代表“开启第1路灯光,关闭第2路,开启第3路”。

4.3. 包厢软件功能模块设计(参考代码逻辑)

在餐厅管理软件(如平板点餐系统或前台PC系统)中,开发以下三个功能模块:

A. 基础远程控制面板在包厢服务界面设置三个按钮,对应调用API。

  • 场景示例:服务员在门口平板点击“照明”,触发 power1=1

B. 场景模式联动(核心功能)利用三路独立控制的特性,预设餐厅特色场景:

  • 用餐模式power1=1 (主灯开), power2=0 (射灯关), power3=0 (氛围灯关) —— 仅保留基础照明

  • 浪漫/生日模式power1=0, power2=1, power3=1 —— 仅开启射灯和暖色氛围灯

  • 清洁模式power1=1, power2=1, power3=1 —— 全开

C. 状态实时同步餐厅软件需实现消息推送接收端

  • 机制:如果服务员误触了墙上的物理开关,开关会主动上报新状态power1=0

  • 实现:在软件服务器端配置一个接收接口(Webhook),接收芯步推送的状态变更数据,从而更新软件界面上的按钮状态,避免“软件显示开,实际灯已关”的尴尬

5. 总结

  • 无需网关,降低故障点:直接利用餐厅现有WiFi覆盖,硬件成本更低,布线更简单

  • 响应迅速:局域网直控或云端直控,无 Zigbee/蓝牙 网关的转发延迟。

  • 开发友好:基于标准HTTP协议,无需理解复杂的物联网底层协议(如CoAP或MQTT私有包),前端工程师即可完成对接

  • 可扩展性:未来如需增加“人体传感器”实现包厢人走灯灭,或增加“语音音柱”播放欢迎语,均可复用同样的API接口体系进行联动

通过以上步骤,开发者可快速将市售86型三开智能开关集成进餐厅的数字化管理系统中,提升包厢的科技感和服务响应效率。