CATALOG

会议室设备控制的难点在于:门禁、照明、传感器往往各自独立,改造布线成本高,且难以与现有办公系统(如OA、会议预订平台)打通。芯步的智能硬件提供标准HTTP API,可直接通过WiFi联网,用远程通断控制替代传统布线方案,既能单点控制也可与业务系统联动。

——基于芯步开放接口的HTTP远程通断控制

1. 背景与需求分析

现代会议室在使用过程中常面临管理难题:会议结束后忘记关灯关空调造成能源浪费;参会人员被锁在门外需要管理员手动开门;会议系统与门禁、照明各自独立,无法联动。

本方案基于芯步智能硬件的HTTP开放接口,在不进行复杂布线的前提下,将会议室的门禁、照明、传感器等设备统一接入企业办公网络,实现远程控制、状态监测与自动化联动。

方案适用于:

  • 需要与OA系统/会议预约平台对接的场景

  • 已部署或计划部署企业微信/钉钉/飞书等办公入口的场景

  • 多会议室、需集中管理的企业

2. 整体设计

2.1 核心架构

方案采用“云-管-边-端”四层架构:

层级组件说明
云端/本地服务器企业应用服务器部署控制逻辑,接收HTTP回调,对接OA系统
网络层企业WiFi/4G/以太网设备直连网络,无需独立网关
边缘控制层芯步智能设备门禁控制器、智能插座/通断器、传感器
执行层门锁、照明、空调被控制的物理设备

2.2 设备选型

基于芯步产品线,推荐以下设备组合:

设备类型推荐型号功能控制接口
智能通断器/继电器智能2路/4路继电器模块照明回路通断控制HTTP API
智能门禁控制器智能门禁一体机门锁控制、开门记录HTTP API
人体存在传感器智能人体存在雷达传感器[吸顶]人员检测、联动控制HTTP API + 状态上报
环境传感器温湿度传感器环境监测、空调节能状态上报+HTTP API

所有设备均通过WiFi 2.4GHz直接连接企业网络,支持私有化部署,可在纯局域网环境下运行。

3. 接口技术详解

3.1 通用调用规范

芯步开放接口采用标准HTTP协议,请求格式如下:

请求地址

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

请求方法:POST数据格式:JSONContent-Type:application/json

请求体示例

参数说明

  • device:目标设备的唯一ID(在芯步控制台获取)

  • order.power:1表示开启,0表示关闭

  • sign:签名,由AppSecret+时间戳等计算得出

  • ts:Unix时间戳(秒),用于防重放攻击

3.2 典型控制指令

(1)照明开关控制

(2)门禁远程开门

(3)批量控制(多设备同时操作)

由于接口单次仅支持一个设备,可通过并发请求或服务端批量调度实现:

3.3 状态上报与回调机制

芯步传感器类设备支持上行消息推送,当检测到状态变化时,主动推送数据到企业指定的服务器地址。

推送示例(人体传感器)

企业服务器接收到推送后可触发联动逻辑,例如:检测到“无人”状态持续15分钟后自动关灯关空调。

4. 场景实现详解

4.1 第一种场景:会议预约系统联动门禁

业务逻辑

  1. 员工通过OA/钉钉/企业微信预约会议室

  2. 预约成功后,系统在会议开始前5分钟自动授权该员工的门禁权限

  3. 会议期间,仅预约人员及审批通过的参会人可刷卡/人脸开门

  4. 会议结束后30分钟,自动收回权限

时序流程

会议预约 → OA回调企业服务器 → 调用芯步API → 门禁设备添加白名单
                                        ↓
                              设备返回成功 → 服务器记录授权日志

代码示例(Node.js)

4.2 第二种场景:人来灯亮与离开现场时延时关灯

业务逻辑

  1. 人体存在雷达传感器实时检测区域人员状态

  2. 检测到有人时,立即开启照明(响应时间80-120ms)

  3. 检测到无人时,启动15分钟倒计时

  4. 倒计时期间若再次检测到人,取消关灯;否则执行关灯

实现的方式是

  • 方案A:云端联动——传感器上报状态→企业服务器处理逻辑→下发控制指令

  • 方案B:边缘联动——通过芯步平台规则引擎(需配置)实现设备间直接联动

状态流转

传感器上报{occupancy:1} → 服务器查设备状态 → 若灯未开则下发{power:1}
传感器上报{occupancy:0} → 服务器启动定时器(15min) → 期间无新上报 → 下发{power:0}

4.3 第三种场景:一键结束会议(全关模式)

业务逻辑:会议结束后,管理员或系统一键关闭所有设备

批量控制实现

4.4 场景四:远程控制与状态查询

远程开门:管理员通过手机APP或Web后台远程开启会议室门锁

状态查询接口

5. 与企业现有系统集成

5.1 对接企业微信/钉钉/飞书

集成架构

步骤动作说明
1企业自建应用在企业微信/钉钉管理后台创建自建应用
2获取凭证获取CorpID、Secret等接口凭证
3同步组织架构将企业用户ID与芯步设备白名单关联
4注册回调企业微信→企业服务器(会议预定事件)
5调用芯步API企业服务器→芯步设备(执行控制)

典型交互流程

  • 员工在钉钉预订会议室 → 钉钉回调企业服务器 → 服务器调用芯步API授权门禁

  • 员工在飞书点击“结束会议”按钮 → 飞书回调企业服务器 → 批量关灯/关空调/锁门

5.2 对接OA/会议预约系统

标准API对接流程:

  1. 在芯步开放平台获取AppId和AppSecret

  2. 在企业OA系统中配置回调地址(接收设备状态上报)

  3. 编写中间件:将OA的会议订单转换为设备控制指令

  4. 部署至企业服务器(支持私有化部署)

6. 安全与权限管理

6.1 接口签名机制

芯步API采用签名验证,防止非法调用:

签名算法

sign = md5(AppId + AppSecret + ts + 请求体JSON字符串)

服务端收到请求后,使用相同的算法重新计算签名并比对,确保请求未被篡改且来自合法应用。

6.2 网络隔离

部署模式适用场景安全措施
私有化部署(推荐)企业对数据安全要求高设备与服务器纯局域网通信,无公网暴露
混合部署需要远程管理的场景VPN接入 + API访问白名单 + TLS加密

6.3 门禁权限分级

  • 超级管理员:全部门禁管理权限

  • 楼层管理员:仅本楼层会议室门禁

  • 普通员工:仅已预约会议的临时开门权限

7. 实施步骤

阶段任务预计时间
1. 设备部署安装智能通断器(替换原有开关)、门禁控制器、传感器,设备配网绑定1-2天/会议室
2. 平台配置在芯步控制台创建设备、获取AppId/Secret、配置消息推送地址0.5天
3. 接口开发编写控制中间件、对接OA/钉钉、实现业务逻辑3-5天
4. 测试联调功能测试、异常处理、性能测试2-3天
5. 上线运行灰度开放、全量启用、监控告警配置1天

8. 预期效果

  • 节能降耗:通过无人自动关灯/关空调,预计可节省30%-50%的照明空调用电

  • 管理提效:管理员无需到场即可远程处理门禁/照明问题,响应时间从“小时级”降至“秒级”

  • 体验提升:员工参会无需等待开门,预约即授权;光线自动感应,到会即亮

  • 系统融合:会议室设备状态与OA系统打通,设备使用数据可量化、可追溯

9. 技术要点总结

  1. HTTP API为核心:所有设备控制均通过标准HTTP请求完成,对接门槛低

  2. 私有化部署支持:设备可在纯局域网运行,满足数据安全需求

  3. 双向通信:下行控制+上行状态推送,实现完整闭环

  4. 无缝集成:支持对接任何能发HTTP请求的系统(Web、APP、小程序、SaaS平台)

注:具体设备型号、API地址、接口参数以芯步官方最新文档为准,实施前请获取对应设备的产品手册。