ESP8266 WiFi物联网智能插座—上位机和下位机通信协议_wifi模块上位机(1)

1、配置节点协议

2、控制节点继电器开关协议

3、节点周期上报数据协议

4、升级节点协议

5、重启节点

---

本项目自定义了一套上位机和下位机通信协议，协议并不复杂，包含：配置节点、控制节点继电器开关、节点周期上报数据、升级节点和重启节点功能。

在讲解通信协议前，需要先了解下位机的4种运行模式，在不同的运行模式下，上位机可以对下位机有不同的功能权限，如下图所示：

• 只有在运行模式下，上位机才可以切换到其他几种模式，其他模式无法执行切换模式操作。
• 只有在运行模式下，上位机才可以控制继电器开关，其他模式无法控制继电器。

1、配置节点协议

配置节点是配置节点的ID、硬件版本、软件版本、出厂时间等信息，只有节点处于运行模式下发配置节点指令才有效。上位机界面如下所示：

配置节点前需要先下发指令将节点从运行模式到配置模式，默认上电后，节点处于运行模式，协议如下所示：

下位机软件定义数据结构如下所示：

// WiFi接收数据帧，控制切换模式
#pragma pack(1)
typedef struct receive_data_mode_t
{
    uint8_t device_head;        // 数据帧头：0XA0+功能码（FUNCTION_ID3），A款产品智能插座
    uint16_t device_len;        // 数据包总长度
    uint16_t device_id;         // 节点ID 0X0001~0XFFFE
    char software_version[15];  // 软件版本 SMART_SW_A1_1.0 A款产品软件1.0版本
    char hardware_version[15];  // 硬件版本 SMART_HW_A1_1.0 A款产品硬件1.0版本
    uint8_t switch_mode;        // 切换模式 0：运行模式，1：配置模式，2：节点升级，3：节点重启
    uint16_t crc;               // 校验位
}ReceiveData_Mode_t;
#pragma pack()

节点接收到切换模式指令，处理完成后，回复ACK响应，协议如下所示：

下位机软件定义数据结构如下所示：

// WiFi发送数据帧，节点响应状态
#pragma pack(1)
typedef struct send_state_t 
{
    uint8_t device_head;        // 数据帧头：0XA0+功能码（FUNCTION_ID2），A款产品智能插座
    uint16_t device_len;        // 数据包总长度
    uint16_t device_id;         // 节点ID 0X0001~0XFFFE
    char software_version[15];  // 软件版本 SMART_SW_A1_1.0 A款产品软件1.0版本
    char hardware_version[15];  // 硬件版本 SMART_HW_A1_1.0 A款产品硬件1.0版本
    uint8_t state_id;           // 功能码+响应码（0：响应成功，1：响应失败）
    uint16_t crc;               // 校验位
}SendState_t;
#pragma pack()

此时，节点处于配置模式下，可以接收上位机下发的配置指令，协议如下所示：

下位机软件定义数据结构如下所示：

// WiFi接收数据帧，更新节点配置参数
#pragma pack(1)
typedef struct receive_config_t  
{
    uint8_t device_old_head;    // 数据帧头：0XA0+功能码（FUNCTION_ID4），A款产品智能插座
    uint16_t device_len;        // 数据包总长度
    uint16_t device_old_id;     // 节点ID 0X0001~0XFFFE
	uint8_t device_config_type; // 0：默认配置，配置信息为后面的参数，1：恢复出厂设置，后面的参数均无效，可以为空
    uint8_t device_new_head;    // 需要更新的数据帧头
    uint16_t device_new_id;     // 需要更新的节点ID 0X0001~0XFFFE
    char software_version[15];  // 软件版本 SMART_SW_A1_1.0 A款产品软件1.0版本
    char hardware_version[15];  // 硬件版本 SMART_HW_A1_1.0 A款产品硬件1.0版本
    char release_time[10];      // 出厂时间 2023-01-01
    uint16_t upload_cycle;      // 节点数据上传服务器周期时间，单位秒
    uint16_t sample_cycle;      // 节点采样周期时间（电参采样），单位毫秒
    char wifi_ssid[64];         // WiFi SSID
    char wifi_password[64];     // WiFi密码
    char server_ip[64];         // 服务器IP/网址
    uint16_t server_port;       // 服务器端口
    uint16_t crc;               // 校验位
}ReceiveConfig_t;
#pragma pack()

节点接收到配置指令，处理完成后，回复ACK响应，协议如下所示：

下位机软件定义数据结构如下所示：

// WiFi发送数据帧，节点响应状态
#pragma pack(1)
typedef struct send_state_t 
{
    uint8_t device_head;        // 数据帧头：0XA0+功能码（FUNCTION_ID2），A款产品智能插座
    uint16_t device_len;        // 数据包总长度
    uint16_t device_id;         // 节点ID 0X0001~0XFFFE
    char software_version[15];  // 软件版本 SMART_SW_A1_1.0 A款产品软件1.0版本
    char hardware_version[15];  // 硬件版本 SMART_HW_A1_1.0 A款产品硬件1.0版本
    uint8_t state_id;           // 功能码+响应码（0：响应成功，1：响应失败）
    uint16_t crc;               // 校验位
}SendState_t;
#pragma pack()

2、控制节点继电器开关协议

上位机下发指令控制节点继电器开关，上位机界面如下所示：

只有节点处于运行模式下发控制节点继电器开关指令才有效，协议如下所示：

下位机软件定义数据结构如下所示：

// WiFi接收数据帧，控制继电器
#pragma pack(1)
typedef struct receive_data_control_t 
{
    uint8_t device_head;        // 数据帧头：0XA0+功能码（FUNCTION_ID5），A款产品智能插座
    uint16_t device_len;        // 数据包总长度
    uint16_t device_id;         // 节点ID 0X0001~0XFFFE
    char software_version[15];  // 软件版本 SMART_SW_A1_1.0 A款产品软件1.0版本
    char hardware_version[15];  // 硬件版本 SMART_HW_A1_1.0 A款产品硬件1.0版本
    uint8_t relay_state;        // 继电器开/关状态 0：继电器关闭，1：继电器开启
    uint16_t crc;               // 校验位
}ReceiveData_Control_t;
#pragma pack()

节点接收到控制继电器指令，处理完成后，回复ACK响应，协议如下所示：

下位机软件定义数据结构如下所示：

// WiFi发送数据帧，节点响应状态
#pragma pack(1)
typedef struct send_state_t 
{
    uint8_t device_head;        // 数据帧头：0XA0+功能码（FUNCTION_ID2），A款产品智能插座
    uint16_t device_len;        // 数据包总长度
    uint16_t device_id;         // 节点ID 0X0001~0XFFFE
    char software_version[15];  // 软件版本 SMART_SW_A1_1.0 A款产品软件1.0版本
    char hardware_version[15];  // 硬件版本 SMART_HW_A1_1.0 A款产品硬件1.0版本
    uint8_t state_id;           // 功能码+响应码（0：响应成功，1：响应失败）
    uint16_t crc;               // 校验位
}SendState_t;
#pragma pack()

3、节点周期上报数据协议

节点处于运行模式会周期上报数据，上位机界面如下所示：

协议如下所示：

下位机软件定义数据结构如下所示：

// WiFi发送数据帧，节点数据
#pragma pack(1)
typedef struct send_data_t 
{
    uint8_t device_head;        // 数据帧头：0XA0+功能码（FUNCTION_ID1），A款产品智能插座
    uint16_t device_len;        // 数据包总长度
    uint16_t device_id;         // 节点ID 0X0001~0XFFFE
    char software_version[15];  // 软件版本 SMART_SW_A1_1.0 A款产品软件1.0版本
    char hardware_version[15];  // 硬件版本 SMART_HW_A1_1.0 A款产品硬件1.0版本
    char release_time[10];      // 出厂时间 2023-01-01
    char run_time[12];          // 负载有效运行时间 时-分-秒：123456-01-01
    uint16_t upload_cycle;      // 节点数据上传服务器周期时间，单位秒
    uint16_t sample_cycle;      // 节点采样周期时间（电参采样），单位毫秒
    uint8_t relay_state;        // 继电器开/关状态 0：继电器关闭，1：继电器开启
    float voltage;              // 电压
    float current;              // 电流
    float power;                // 功率
    float electricity;          // 电量
    uint16_t crc;               // 校验位
}SendData_t;
#pragma pack()

上位机接收到周期上报数据协议不做响应。

4、升级节点协议

配置节点前需要先下发指令将节点从运行模式到升级模式，上位机界面如下所示：

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此收集整理了一份《2024年嵌入式&物联网开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上嵌入式&物联网开发知识点，真正体系化！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新！！

15557096095)]

[外链图片转存中…(img-uskiS400-1715557096096)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上嵌入式&物联网开发知识点，真正体系化！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新！！