CATALOG

芯步的智能插座开放HTTP接口,签名验证机制规范,适合快速集成到现有社区管理后台。以下方案以10A定时智能插座为例,涵盖技术对接流程、核心代码逻辑及社区场景下的典型应用模式。

1. 项目概述与选型背景

在智慧社区建设中,对公共区域用电设备(如景观照明、灭蚊灯、信报箱照明、活动室空调)进行远程监控与节能管理是降本增效的关键。采用 芯步 10A 智能插座/墙壁插座 作为执行单元,具有部署快、改造成本低、计量精准的特点。

该系列产品的核心优势在于全系标配HTTP RESTful API,能够完美融入社区现有的物业管理系统或SaaS平台,无需额外的物联网网关

2. 硬件选型:10A智能插座规格说明

在项目中,根据安装环境的不同,主要推荐以下两种形态的设备:

  • 智能墙壁插座10A(86型): 适用于固定安装,如平行替换社区活动室、楼道原有的86型五孔插座。支持总额定功率2200W,部分型号(UNI-QC-10A-P)具备功率计量功能,可实时监测电压、电流及功耗

  • 智能插座10A(桌面/转换器型): 适用于即插即用场景,如临时活动、移动式设备控制,体积小巧,支持2位5孔

关键指标:

  • 额定参数: 10A / 100-250V AC / MAX 2200W。

  • 网络连接: Wi-Fi 2.4GHz(符合802.11 b/g/n)。

  • 核心功能: 远程通断控制、定时/倒计时任务、电量统计(计量版)

3. 技术对接方案:开放接口深度集成

芯步的开放接口采用通用的HTTP协议,签名机制规范,适合Java、Python、PHP或前端JavaScript调用。

3.1 接口鉴权机制

所有的控制指令都通过向特定URL POST JSON数据包实现。为了保证安全性,系统采用动态签名验证。

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

核心参数生成逻辑:

  1. AppId: 平台分配的应用标识。

  2. ts: 当前Unix时间戳(秒),用于防止重放攻击。

  3. sign: 授权签名。

    • 计算公式:sign = md5( md5(AppSecret) + ts )

    • 逻辑拆分: 先将开发者密码(AppSecret)进行一次MD5加密,得到字符串A;将字符串A拼接上时间戳ts得到字符串B;再将字符串B整体进行一次MD5加密

注意: 私有化部署或局域网使用时,可将域名替换为本地服务器地址。

3.2 核心控制指令下发

以“关闭社区3号机房的定时插座”为例。设备ID(device)可通过芯步平台后台获取或设备列表API拉取。

1. 即时通断控制:

  • 命令对象:{"power": 0}

  • 说明: 0代表关闭,1代表开启。

2. 定时/延时任务(无服务器任务):这是社区节能场景的核心特色。传统方案需要服务器维护定时任务队列,芯步支持通过命令直接在设备端设定延时。

  • 先通后断(Point): 适用于需要临时供电并自动关闭的场景(如快递柜检修临时供电)。

    • {"point": "3600000"}:表示立即开启插座,并在 1小时(3600000毫秒) 后自动关闭。

  • 先断后通(Reset): 适用于重启路由器、监控摄像头等场景。

    • {"reset": "60000"}:表示立即断开插座,等待1分钟后自动恢复通电

3. 批量控制:若需同时控制社区内多个不同区域的设备(如同时开启所有苑区的景观灯),可在device参数中用逗号拼接多个设备ID,或使用batch命令格式。

3.3 状态与数据获取(轮询与上报)

虽然控制响应极快(约80-120ms),但在双向管理系统中,通常采用以下策略:

  • 主动查询: 调用设备状态查询API获取当前开关状态及计量数据。

  1. 实时监听: 社区管理系统可配置回调URL,芯步平台在检测到设备状态变化(如过载自动断电)时,会主动推送数据到物业服务器

4. 项目实施流程

4.1 部署与配置阶段

  1. 安装接线:

    • 墙壁型:由电工安装,注意“左零右火”标准接线,安装后通过长按实体按键(5秒以上)使设备进入配网模式。

    • 桌面型:即插即用。

  2. 设备配网(零信任方案):

    • 开放式项目可采用扫码快连技术。物业管理人员通过微信小程序扫描设备二维码,输入Wi-Fi密码即可完成配网,无需暴露路由管理后台。

  3. 设备绑定:

    • 安装完成后,现场人员通过管理APP将设备ID(二维码下方的数字串)扫码登记到社区管理系统的指定房号或设备点位下。

4.2 软件集成步骤(以私有化部署为例)

  1. 引入依赖: 在后端代码中配置芯步的API域名及AppId/Secret。

  2. 编写服务类(Service): 封装签名生成逻辑和HTTP请求发送器。

  3. 业务逻辑关联: 将“前端按钮点击”映射为对应的JSON命令。

    • 例如:前端点击“打开路灯”,后端逻辑 -> order={"power":1}

5. 典型社区场景解决方案

第一种场景:社区公共照明节能

  • 痛点: 路灯、草坪灯按传统定时器控制,随季节变化需频繁人工调整,导致白昼亮灯浪费电。

  • 方案: 将10A智能插座接入回路。

  • 逻辑: 物业后台设置定时任务,基于经纬度自动识别日落时间,调用API下发{"power":1}。雨季光照不足时,人工远程一键开启或通过光感联动(需配合传感器)自动补光

第二种场景:电动自行车充电桩补充/临时用电

  • 痛点: 未安装智能充电桩的区域,居民在楼道私拉电线存在消防隐患。

  • 方案: 在小区空旷非机动车棚部署智能插座箱。

  • 逻辑: 居民扫描插座上的二维码(对接物业计费系统),系统调用API {"power":1} 开启插座,并启动倒计时任务 {"point": "10800000"} (3小时)。时间到自动断电,费用自动结算。这利用了插座的功率计量功能,检测到充满(功率骤降)时自动提前结束计费并断电。

第三种场景:活动中心与会议室管理

  • 痛点: 社区活动室空调、投影仪常被遗忘关闭,导致巨额电费浪费。

  • 方案: 采用带功率计量的10A墙壁插座。

  • 逻辑: 管理员可通过手机查看设备运行状态(实时功率)。若检测到设备电流、功率异常(如空调压缩机未关),可远程执行{"power":0}切断电源。

  • 高级联动: 结合“先断后通”(Reset)命令,实现设备的远程重启,解决设备死机问题,减少现场维护成本

6. 安全与运维保障

  1. 过载保护逻辑: 在软件层,每次收到状态上报时,系统检查功率是否超过2200W限值。若超限,立即下发{"power":0}指令,并标记设备为“故障隔离”状态,通知工程人员检查是否接入了大功率电暖气

  2. 断网重连机制: 设备内置Wi-Fi断线重连与看门狗功能。即使社区网络波动,设备也会保持本地最后一次执行的状态,不会出现设备随机通断的安全隐患。

通过上述方案,社区运营方仅需通过芯步的标准化HTTP接口,即可在无需了解底层嵌入式协议的情况下,快速构建起一个响应迅速(毫秒级)、逻辑清晰(支持复杂定时)的智能设施控制网络