CATALOG

芯步的开放接口基于标准HTTP协议,签名认证简单,可以很方便地将空调控制器集成到现有的软件项目中,无论是Web、小程序还是APP。下面从硬件选型、接口对接、定时任务设计到项目落地,逐一展开。

解决方案:基于芯步开放接口的店铺空调节能智控系统集成方案

1. 项目概述与硬件选型

在许多商业场景(如零售店、便利店、办公室)中,空调往往是耗电大户,且常因员工忘记关闭而造成巨大浪费。本方案的目标是利用芯步的智能硬件与开放API,将普通的空调升级为“智能定时空调”,实现远程控制和精细化定时管理。

硬件选型:虽然芯步提供多种智能硬件,针对“空调控制”这一特定需求,通常推荐以下两类设备的组合或单品:

  1. 空调智能红外控制器(推荐):

    • 作用:通过红外信号模拟空调遥控器。它具备WiFi联网能力,接收来自云端的指令,转发给空调。

    • 优势:不改动空调原有电路,即插即用,适用于挂机、柜机。

  2. 智能插座/万能遥控器:

    • 作用:对于不具备红外接入条件的中央空调或部分风机盘管,可通过RS485或强电通断配合第三方适配器控制

为什么选择芯步?芯步的产品(如智能语音音柱、传感器系列)普遍支持HTTP接口私有化部署,这意味着你的软件项目可以不依赖芯步官方的APP,直接通过API控制设备,且支持局域网直连(低延迟)和公网连接(远程控制)两种模式

2. 技术对接设计

本方案采用标准的物联网三层架构,将业务软件与硬件解耦。

  • 设备层:芯步智能控制器(连接店铺空调,状态:待机/运行)。

  • 网络层:通过WiFi 2.4G网络连接至芯步云(支持直连模式,无需网关)

  • 业务层(你的项目)

    • 通过调用芯步开放平台的 API 接口 下发指令。

    • 通过 消息推送 机制接收设备状态回传。

核心工作流程:软件项目(定时触发器) -> 调用开放接口(携带签名+设备ID) -> 芯步云 -> WiFi -> 硬件控制器 -> 红外/RS485 -> 空调执行动作。

3. 详细开发步骤:从接入到控制

3.1 准备工作:获取凭证与设备ID

在芯步开发者后台,你需要完成以下三步:

  1. 获取 AppId 和 AppSecret:这是你软件项目调用接口的“用户名”和“密码”。

  2. 添加设备:将购买的红外控制器通过配网添加到后台,获取唯一的 Device ID(例如:820720)

  3. 学习码配置:使用后台工具或API接口,让控制器学习空调的“开/关”、“模式”、“温度”等红外码。

3.2 核心接口对接

芯步的接口设计非常简洁,走标准的HTTP POST请求。

  • 接口地址http(s)://api.thingboot.com/{AppId}/device/control/

  • 鉴权方式:携带签名(Sign)和时间戳(ts),防止接口被恶意篡改。

  • 请求体格式:JSON

示例:在软件中实现“关闭空调”功能假设你需要开发一个函数来关闭某台空调,代码逻辑应构造如下HTTP请求:

参考来源:芯步传感器/控制器通用指令规范

进阶控制(温度与模式):如果硬件支持且已学习相关指令,你可以扩展 order 对象:

3.3 实现“定时控制”逻辑

这是本方案的核心——“将定时控制器接入软件”。你不需要在硬件层面做定时(虽然部分硬件支持),而是在软件项目中实现定时逻辑,这样更灵活,便于后续修改。

设计思路:

  1. 数据库设计:创建一张 device_timing_tasks 表,字段包括:device_id, cron_expression(如 0 0 22 * * ? 表示每晚10点),action(开关指令),is_active

  2. 任务调度:在你的后端服务(如 Java:Quartz, Python:APScheduler,或 Node.js:node-cron)中设置轮询或定时触发器。

  3. 执行链路

    • 当系统时间达到 09:00(开店时间)。

    • 后端调度器查询数据库,找出所有在9点需要执行“开启”任务的设备列表。

    • 调用芯步接口:循环列表,发送上述的 {“power”: 1} 指令。

    • 记录日志:记录下指令发送的结果(成功/失败)。

3.4 状态同步与反馈(可选但)

芯步的传感器类产品支持实时状态上报。虽然普通红外控制器是单向控制(无法感知空调是否真的启动了),但利用接口的消息推送功能:

  • 当你的软件发送命令后,芯步云会回调你的服务器,告知“指令已送达设备”。

  • 为了更精准(闭环控制),可以结合芯步的温湿度传感器:在软件逻辑中加入“如果温度低于18度,即使定时任务要开空调,也忽略指令”的节能逻辑。

4. 软件项目界面与功能设计

在具体的软件项目中,你可以为店铺管理员设计如下交互界面:

1. 设备控制面板

  • 展示当前店铺的空调状态(在线/离线)。

  • 手动开关按钮(实时调用API)。

  • 温度滑块(实时调用API设置温度)。

2. 定时策略配置

  • 周循环定时:周一至周五 09:00 开机,周一至周五 20:00 关机。

  • 一次性定时:除夕夜 18:00 全部关机。

  • 高级联动:(如果接入了传感器)当“人体存在传感器”检测到无人超过30分钟,自动触发“关闭空调”指令

3. 能耗与日志

  • 记录每次定时任务的执行情况。

  • 虽无直接电表数据,但可根据“开机时长”粗略估算能耗。

5. 常见问题与应对策略

Q1:红外控制器有方向性,担心控制失败怎么办?

  • 解决:在软件逻辑中增加“重试机制”。例如:发送关闭指令后,延迟5秒,再次发送一次关闭指令,确保空调收到信号。

Q2:网络断了,定时任务还生效吗?

  • 方案:采用混合模式。软件端的定时(云端定时)是主要方式;同时利用芯步设备固件可能支持的硬件定时(离线定时)作为备份,或者确保店铺路由器具备定时重启功能以保证WiFi稳定

Q3:如何接入到现有的小程序或APP中?

  • 解决:芯步接口支持任何支持HTTP协议的编程语言。前端直接通过HTTPS调用API即可(注意保管好 AppSecret,由后端代理转发,避免泄露)。

总结

通过上述方案,你可以在任何软件项目中,利用芯步标准的HTTP API设备ID体系,快速构建起一套稳定、灵活的店铺空调节能管理系统。核心在于将业务逻辑(定时、联动)放在软件层,利用芯步作为可靠的“执行层”,从而实现低成本、高效率的店铺智能化转型。