如何对接10A86型单路智能插座以实现定时任务启停控制_解决方案

CATALOG

芯步的10A86型智能插座开放标准HTTP API，通过签名认证即可下发控制指令。定时任务的核心思路是：在你的服务器上设置定时器，到点调用API发送“开”或“关”命令。以下是具体实现方案。

1. 解决概述

本方案的目标是指导开发者如何利用芯步提供的开放式HTTP API，对接 10A86型智能插座，实现远程定时任务控制（如定时开关、周期通断等）。

核心逻辑：由于设备固件本身不直接支持复杂的 cron 表达式定时，通常采用 “云端/服务器端调度 + API即时控制” 的架构。即由开发者自己的业务服务器维护定时任务逻辑，在指定时间点通过调用芯步的开放接口发送“开/关”指令。

适用场景：办公设备定时断电、养殖场灯光周期控制、充电桩错峰用电等。

2. 准备工作与环境搭建

在开始开发前，请完成以下三项准备工作：

硬件就位：确保10A86型智能插座已安装并连接Wi-Fi（仅支持2.4GHz），在芯步后台显示为“在线”状态。
获取凭证
- 登录芯步开发者控制台。
- 获取 AppID 和 AppSecret（开发者密码）。这是调用接口的“身份证”。
- 获取 设备ID (Device ID)：在控制台设备列表查看该插座的唯一ID（例如截图中的820720）。
网络环境：服务器需具备访问公网能力（如果使用私有化部署方案则需配置局域网地址）。

3. 接口鉴权与核心请求方法

芯步的接口采用多重MD5签名机制，所有控制请求必须携带动态签名。

3.1 请求地址

Method: POST
URL: http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
Content-Type: application/json

3.2 签名算法 (Sign)

这是对接的关键步骤，签名生成规则如下：

将 AppSecret 进行第一次 MD5 加密，得到 enc_secret。
将 enc_secret 与当前秒级时间戳 ts 拼接。
将拼接后的字符串再次进行 MD5 加密，得到最终的 sign。

公式Sign = md5( md5(AppSecret) + ts )

3.3 请求体结构

4. 定时任务控制实现逻辑

由于10A86型插座本身不带复杂的定时芯片，实现定时任务需在您的业务服务器端进行逻辑编排。

4.1 架构流程图

用户配置：用户在您的Web/App端设置“每周一至周五 08:00 开启，18:00 关闭”。
任务存储：您的服务器将这些规则存入数据库，并启动定时调度器（如 Linux Crontab, Quartz, Node-schedule 等）。
时间触发
- 08:00 触发：服务器生成签名，调用 API 下发 {"power":1}。
- 18:00 触发：服务器生成签名，调用 API 下发 {"power":0}。
设备执行：插座接收指令，继电器吸合/断开。

4.2 代码实现示例 (Python + 调度逻辑)

以下示例展示了如何封装一个定时任务脚本。

import hashlib
import time
import requests
import schedule  # 使用 schedule 库模拟定时

# --- 配置信息 ---
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"
DEVICE_ID = "YOUR_DEVICE_ID"  # 例如 "820720"
API_URL = f"https://api.thingboot.com/{APP_ID}/device/control/"

# --- 签名生成函数 ---
def generate_sign(secret):
    # 1. MD5(AppSecret)
    md5_secret = hashlib.md5(secret.encode()).hexdigest()
    # 2. 拼接时间戳
    ts = str(int(time.time()))
    sign_str = md5_secret + ts
    # 3. MD5(拼接字符串)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    return sign, ts

# --- 控制插座函数 ---
def control_socket(power_state):
    """
    power_state: 1 开启, 0 关闭
    """
    sign, ts = generate_sign(APP_SECRET)
    url = f"{API_URL}?sign={sign}&ts={ts}"
    
    payload = {
        "device": DEVICE_ID,
        "order": {"power": power_state}
    }
    
    try:
        response = requests.post(url, json=payload, timeout=5)
        print(f"[{time.strftime('%Y-%m-%d %H:%M:%S')}] 指令发送: {'开启' if power_state else '关闭'}")
        print(f"响应内容: {response.text}")
    except Exception as e:
        print(f"控制失败: {e}")

# --- 定时任务配置 ---
# 早上 8:00 开启
schedule.every().day.at("08:00").do(control_socket, 1)
# 晚上 18:00 关闭
schedule.every().day.at("18:00").do(control_socket, 0)

if __name__ == "__main__":
    print("定时控制服务已启动...")
    while True:
        schedule.run_pending()
        time.sleep(1)

5. 进阶技巧：利用硬件特性实现“软定时”

如果您不希望服务器长期运行，或者网络不稳定，可以利用插座硬件支持的指令实现 “一键触发二次动作” （例如：通电1小时后自动断电），减少网络往返。

芯步10A86型插座支持 point (先通后断) 和 reset (先断后通) 命令。

案例：鱼缸水泵定时循环需求：打开插座，运行30分钟后自动关闭（即使此时服务器宕机，插座也会执行完动作）。

下发命令
{ "device": "DEVICE_ID", "order": { "point": 1800000 // 单位:毫秒。此处为 30 * 60 * 1000 } }
point 逻辑：继电器立即吸合（通电），保持30分钟后，自动断开。

6. 常见问题与排障指南

签名错误 (401 Unauthorized)
- 现象：接口返回签名无效。
- 解决：严格检查 ts 是否为秒级时间戳（不是毫秒）。核对 MD5 加密顺序，注意拼接时无任何连接符（直接拼接字符串）。
设备离线
- 现象：接口返回成功，但插座无反应。
- 解决：10A86型插座仅支持 2.4GHz Wi-Fi，检查路由器是否开启了5G融合，关闭双频合一。检查插座指示灯状态。
负载注意事项
- 安全：该插座额定电流 10A，最大功率 2200W。如果是感性负载（如电机、LED灯），降额至 300W 以下使用，否则继电器易粘连。
计量版数据读取
- 如果您购买的是带 -P 后缀的计量版，除了控制命令，还可以通过额外的数据接口查询电压、电流和功率，可用于制作“电费统计”或“过载保护”逻辑。

7. 总结

通过对接芯步的开放接口，实现10A86型智能插座的定时任务控制主要分为三步：

网络层：完成签名计算与 HTTP POST 请求封装。
业务层：通过服务器定时任务（Cron/Schedule）按计划下发 power:1/0 指令。
硬件层：可选用 point/reset 命令实现断网环境下的本机延时控制。

这种对接方式简单高效，十分钟内即可跑通原型，且兼容所有支持 HTTP 请求的编程语言和平台（如 NodeJS、PHP、Java 等）。