CATALOG

芯步的2路智能开关通过HTTP接口可被任何后端系统调用,非常适合集成到共享自习室的门禁联动方案中。以下方案围绕“预约→身份验证→通电→计时→断电”的完整闭环展开,包含签名算法、命令格式、业务逻辑伪代码和异常处理机制。

解决方案:基于芯步2路开关的共享自习室门禁联动系统设计

一、 背景与需求

在无人值守的共享自习室场景中,痛点是“人”与“资源”的匹配。当用户通过小程序预约时段后,系统需要自动完成:

  1. 仅允许预约用户在对应时段进入特定房间(门禁)。

  2. 用户到达时自动开启该座位的电源(灯光、插座)。

  3. 若用户迟到或早退,需自动释放资源并断电。

  4. 超时未离开时的断电提醒与控制。

利用芯步“智能触摸墙壁开关2路”智能控制器2路产品,我们可以将其中一路(例如:路1)串联至门磁锁或电子插销,另一路(路2)串联至工位的总电源继电器。

二、 整体架构与核心设备

  • 硬件:芯步2路智能开关(Wi-Fi版)、电控锁、12V/220V电源适配器。

  • 软件层:你的业务后端(Java/Python/Go/Node.js等)、小程序/公众号。

  • 通信协议:HTTPS / HTTP(支持公网或局域网私有化部署)。

  • 核心接口:基于芯步开放平台的 device/control API

三、 集成步骤与技术实现细节

1. 前期准备:获取密钥与设备ID

在芯步控制台完成以下操作:

  • 注册开发者:获取 AppIDAppSecret

  • 添加设备:将2路开关通过Wi-Fi配网接入平台,记录下设备唯一ID(例如 12062178)。

  • 线路规划

    • 线路1 (power1):连接门锁控制器(常开/常闭型)。

    • 线路2 (power2):连接座位插座继电器或灯光。

2. 核心难点攻克:签名算法与HTTP请求

芯步的接口通过动态签名防止接口被恶意篡改。签名生成的逻辑如下:

  • 规则sign = md5( md5(AppSecret) + ts )

  • 步骤

    1. 将你的 AppSecret 进行一次MD5加密,得到 encoded_secret

    2. encoded_secret 与当前Unix时间戳 ts 拼接成字符串。

    3. 对该字符串再次进行MD5加密,得到最终的 sign

  • 请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

代码示例(Python,展示如何生成签名并发起控制请求):

3. 业务逻辑集成:从“预约”到“落座”的闭环

场景A:用户到达,扫码开门

  • 逻辑触发:用户在小程序点击“开门”,后端验证其当前时段是否有有效订单。

  • 动作:调用API开启线路1(门锁)。

  • 高级命令(延时自动关门):如果使用“先通后断”模式,可以防止门一直打开。

    • order = {"point1": "5000"} # 线路1接通5秒后自动断开(模拟按下门禁开关动作)

场景B:用户入座,自动供电

  • 逻辑触发:门锁开启后,或者用户点击“开始学习”。

  • 动作:开启线路2(座位电源)。

    • order = {"power2": 1}

场景C:结束订单,断电清理

  • 逻辑触发:用户点击“结束学习”或订单倒计时归零。

  • 动作:关闭线路2

    • order = {"power2": 0}

4. 异常情况处理机制
  • 迟到释放:用户预约了14:00-17:00,但14:30未开门。系统自动调用 {"power2": 0} 并释放工位。

  • 超时提醒与强制断电

    • 在订单结束前10分钟,通过语音播报设备提示。

    • 订单结束后,先尝试发送 {"power2": 0}。如果检测到设备在线但电流异常(如用户私接插排),可联动管理员。

  • 状态保持:芯步支持“状态保持”命令。例如,如果设置了 {"power1":{"keep":"1","revert":"10"}},用户手动物理按键关闭门锁后,系统会在10秒后强制恢复开门状态,避免用户误触将自己锁在门外

四、 功能优化:数据感知与联动

为了提升自习室的智能化水平,芯步不仅仅是控制开关,还可以集成传感器实现“反控”

  1. 人体存在传感器联动若系统检测到订单已结束,但“人体存在传感器”仍检测到座位有人,可以通过 [19654] 接口强制切断线路2,并触发告警提示“订单超时,即将断电”。

  2. 环境自适应通过温湿度传感器上报的数据,在你的服务器逻辑中判断:若温度 > 26°C 且座位 occupancy = 1,则自动接通线路2控制的落地风扇或排风扇,无需增加额外布线。

五、 总结

通过集成芯步2路智能开关的 HTTP API(关键参数:power1, power2, point1 等),共享自习室系统能够实现:

  • 低成本:利用继电器通断代替昂贵的闸机。

  • 高可靠性:签名机制保证接口安全,私有化部署选项保证内网低延迟。

  • 可扩展:两路独立控制分别管理“通行”与“用电”,逻辑清晰,符合消防规范。

开发者只需关注业务层的订单状态与 order 字段的映射,即可在数小时内完成硬件对接。