芯步的开放接口基于标准HTTP协议,签名认证简单,可以很方便地将空调控制器集成到现有的软件项目中,无论是Web、小程序还是APP。下面从硬件选型、接口对接、定时任务设计到项目落地,逐一展开。
解决方案:基于芯步开放接口的店铺空调节能智控系统集成方案
1. 项目概述与硬件选型
在许多商业场景(如零售店、便利店、办公室)中,空调往往是耗电大户,且常因员工忘记关闭而造成巨大浪费。本方案的目标是利用芯步的智能硬件与开放API,将普通的空调升级为“智能定时空调”,实现远程控制和精细化定时管理。
硬件选型:虽然芯步提供多种智能硬件,针对“空调控制”这一特定需求,通常推荐以下两类设备的组合或单品:
空调智能红外控制器(推荐):
作用:通过红外信号模拟空调遥控器。它具备WiFi联网能力,接收来自云端的指令,转发给空调。
优势:不改动空调原有电路,即插即用,适用于挂机、柜机。
智能插座/万能遥控器:
作用:对于不具备红外接入条件的中央空调或部分风机盘管,可通过RS485或强电通断配合第三方适配器控制。
为什么选择芯步?芯步的产品(如智能语音音柱、传感器系列)普遍支持HTTP接口和私有化部署,这意味着你的软件项目可以不依赖芯步官方的APP,直接通过API控制设备,且支持局域网直连(低延迟)和公网连接(远程控制)两种模式。
2. 技术对接设计
本方案采用标准的物联网三层架构,将业务软件与硬件解耦。
设备层:芯步智能控制器(连接店铺空调,状态:待机/运行)。
网络层:通过WiFi 2.4G网络连接至芯步云(支持直连模式,无需网关)。
业务层(你的项目)
通过调用芯步开放平台的 API 接口 下发指令。
通过 消息推送 机制接收设备状态回传。
核心工作流程:软件项目(定时触发器) -> 调用开放接口(携带签名+设备ID) -> 芯步云 -> WiFi -> 硬件控制器 -> 红外/RS485 -> 空调执行动作。
3. 详细开发步骤:从接入到控制
3.1 准备工作:获取凭证与设备ID
在芯步开发者后台,你需要完成以下三步:
获取 AppId 和 AppSecret:这是你软件项目调用接口的“用户名”和“密码”。
添加设备:将购买的红外控制器通过配网添加到后台,获取唯一的 Device ID(例如:820720)。
学习码配置:使用后台工具或API接口,让控制器学习空调的“开/关”、“模式”、“温度”等红外码。
3.2 核心接口对接
芯步的接口设计非常简洁,走标准的HTTP POST请求。
接口地址
http(s)://api.thingboot.com/{AppId}/device/control/鉴权方式:携带签名(Sign)和时间戳(ts),防止接口被恶意篡改。
请求体格式:JSON
示例:在软件中实现“关闭空调”功能假设你需要开发一个函数来关闭某台空调,代码逻辑应构造如下HTTP请求:
参考来源:芯步传感器/控制器通用指令规范
进阶控制(温度与模式):如果硬件支持且已学习相关指令,你可以扩展 order 对象:
3.3 实现“定时控制”逻辑
这是本方案的核心——“将定时控制器接入软件”。你不需要在硬件层面做定时(虽然部分硬件支持),而是在软件项目中实现定时逻辑,这样更灵活,便于后续修改。
设计思路:
数据库设计:创建一张
device_timing_tasks表,字段包括:device_id,cron_expression(如0 0 22 * * ?表示每晚10点),action(开关指令),is_active。任务调度:在你的后端服务(如 Java:Quartz, Python:APScheduler,或 Node.js:node-cron)中设置轮询或定时触发器。
执行链路
当系统时间达到 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体系,快速构建起一套稳定、灵活的店铺空调节能管理系统。核心在于将业务逻辑(定时、联动)放在软件层,利用芯步作为可靠的“执行层”,从而实现低成本、高效率的店铺智能化转型。