1. 概述

本智能插座是一款支持二次开发的 Wi-Fi 智能插座转换器，内置 ESP8285 通讯模块，支持 MQTT 与 TCP 两种网络通讯方式。 设备可接入公有云平台（如阿里云、天翼云）或用户自建服务器，实现远程控制、状态上报、电量数据采集及系统集成。

本文档主要描述设备在网络层与应用层的通讯方式、协议能力及典型交互模型，供二次开发与系统对接使用。

2. 网络与基础通信能力

2.1 Wi-Fi 网络

• 频段：2.4GHz Wi-Fi
• 工作模式：STA（连接路由器）
• 设备需完成配网后才能建立上层通讯连接
• 网络连接状态会影响协议连接状态（MQTT/TCP）

3. 支持的通讯协议

3.1 MQTT 协议

3.1.1 协议特性

• 基于 TCP 的发布 / 订阅模型
• 低延迟、低带宽占用
• 适合设备规模化部署
• 支持断线重连、心跳机制

3.1.2 服务器支持

设备支持以下 MQTT 服务器类型：

• 官方提供的 MQTT 服务器（开箱即用）
• 用户自建 MQTT 服务器
• 第三方云平台（如阿里云、天翼云等）

3.1.3 通讯模型

设备作为 MQTT Client：

• 启动后连接 MQTT Broker
• 订阅控制类 Topic
• 定期或按需发布状态与电量数据

典型数据方向：

• 下行（服务器 → 设备）
  • 插座开 / 关控制
  • 参数配置
  • 按键锁定状态设置
• 上行（设备 → 服务器）
  • 开关状态上报
  • 电压 / 电流 / 功率数据
  • 设备在线状态（心跳）

Topic 结构、Payload 格式由 API 文档定义，可根据业务场景进行扩展。

3.2 TCP 协议

3.2.1 协议特性

• 基于 TCP 长连接或短连接
• 点对点通信
• 数据格式可完全自定义
• 适合私有协议或局域网场景

3.2.2 通讯模式

• 设备作为 TCP Client，主动连接服务器
• 建立连接后进行命令交互与数据上传
• 支持：
  • 指令控制
  • 状态查询
  • 实时数据上报

3.2.3 典型使用场景

• 私有服务器直连
• 局域网控制
• 对实时性和协议可控性要求较高的系统

4. 设备数据能力（通讯层视角）

设备通过 MQTT 或 TCP 协议可传输以下核心数据：

4.1 控制类数据

• 插座开 / 关控制
• 物理按键锁定 / 解锁
• 配网按键锁定 / 解锁

4.2 状态类数据

• 当前开关状态
• 网络连接状态
• 设备在线 / 离线状态

4.3 电量与功率数据

设备内置电流检测模块，可实时采集并上报：

• 电压（V）
• 电流（A）
• 功率（W）
• 用电统计数据（周期统计 / 累计）

数据可按时间间隔或事件触发方式上传。

5. 设备通讯相关规格

• 通讯方式：2.4G Wi-Fi
• 支持协议：MQTT / TCP
• 输入电压：85Vac ~ 265Vac
• 最大负载：10A / 16A
• 待机功耗：＜3W