ESP8266实现在线升级OTA

article/2025/8/29 22:27:24

今天总结一下我实现ESP8266实现在线升级（OTA）的经验

关于理论介绍我这里不多讲，大家可以参考以下文章：
1.一个网友总结的经验（我这篇文章主要也是对该文章做进一步补充）：https://www.cnblogs.com/demodashi/p/9437734.html
2.乐鑫官方OTA文档：https://www.espressif.com/sites/default/files/documentation/99c-esp8266_fota_upgrade_cn.pdf

一，在你的代码工程里增加以下代码：（别忘了添加头文件：#include “upgrade.h”）

/**函数功能：OAT在线升级固件* 输入参数1：server_ip: 服务器地址* 输入参数2：port:服务器端口* 输入参数3：path:文件路径*/
void ICACHE_FLASH_ATTR ota_start_Upgrade(const char *server_ip, uint16_t port,const char *path)
{const char* file;//获取系统的目前加载的是哪个bin文件uint8_t userBin = system_upgrade_userbin_check();os_printf("当前使用的userBin文件，0表示user1，1表示user2: %d\n\n",userBin);switch (userBin) {//如果检查当前的是处于user1的加载文件，那么拉取的就是user2.bincase UPGRADE_FW_BIN1:file = "user2.4096.new.4.bin";break;//如果检查当前的是处于user2的加载文件，那么拉取的就是user1.bincase UPGRADE_FW_BIN2:file = "user1.4096.new.4.bin";break;//如果检查都不是，可能此刻不是OTA的bin固件default:os_printf("Fail read system_upgrade_userbin_check! \n\n");os_printf("读取系统升级失败，请检查userbin \n\n");return;}struct upgrade_server_info* update =(struct upgrade_server_info *) os_zalloc(sizeof(struct upgrade_server_info));//upgrade_server_infoupdate->pespconn = (struct espconn *) os_zalloc(sizeof(struct espconn));//设置服务器地址os_memcpy(update->ip, server_ip, 4);//设置服务器端口update->port = port;//设置OTA回调函数update->check_cb = ota_finished_callback;//设置定时回调时间update->check_times = 10000;//从 4M *1024 =4096申请内存update->url = (uint8 *)os_zalloc(4096);//打印下請求地址os_printf("Http Server Address:%d.%d.%d.%d ,port: %d,filePath: %s,fileName: %s \n",IP2STR(update->ip), update->port, path, file);//拼接完整的 URL去请求服务器os_sprintf((char*) update->url, "GET /%s%s HTTP/1.1\r\n""Host: "IPSTR":%d\r\n""Connection: keep-alive\r\n""\r\n", path, file, IP2STR(update->ip), update->port);//IP地址请求//os_sprintf((char*) update->url, "GET /%s%s HTTP/1.1\r\n""Host: "OTA_DN"\r\n""Connection: keep-alive\r\n""\r\n", path, file, update->port);//域名请求，测试可用//os_sprintf((char*) update->url, "GET /%s%s HTTP/1.1\r\n""Host: "OTA_DN"\r\n""Connection: keep-alive\r\n""\r\n", path, file);//域名请求，测试可用，去掉端口号，默认就是80
//     GET /v1/user1.4096.new.4.bin HTTP/1.1
//     Host: 193.112.122.156:80
//     Connection: keep-aliveif (system_upgrade_start(update) == false){os_printf(" Could not start upgrade\n");//释放资源os_free(update->pespconn);os_free(update->url);os_free(update);}else{os_printf(" Upgrading...\n");}
}//函数功能：OAT回调函数
//成功就重启
//失败不重启
void ICACHE_FLASH_ATTR ota_finished_callback(void *arg)
{struct upgrade_server_info *update = arg;if (update->upgrade_flag == true){espconn_send(&PhoneConn,"OTA Success",11);	//告诉服务器OTA成功os_printf("OTA  Success ! rebooting!\n");os_printf("OTA  成功 ! 重启中!\n");system_upgrade_reboot();}else{espconn_send(&PhoneConn,"OTA failed",10);	//告诉服务器OTA失败os_printf("OTA failed!\n");os_printf("OTA 失败!\n");}os_free(update->pespconn);os_free(update->url);os_free(update);
}

编写代码调用：
ota_start_Upgrade(serverip, port,fileBinPath);//调用在线升级函数
就可以实现升级啦（前提是你设置的服务器路径中要有固件）

二，编译
在工程目录下的makefile中大约20多行有这样一段代码：

BOOT?=new
APP?=2
SPI_SPEED?=40
SPI_MODE?=QIO
SPI_SIZE_MAP?=4

按以下表格要求，修改以上代码的参数，修改APP=1编译一次，修改APP=2编译再一次，这样才会有user1和user2
在这里插入图片描述
修改完后就清除，编译。
建议在user_init(void)函数里添加一个标识，以区分是user1还是user2，比如：
os_printf(“我是user1\r\n”);
os_printf(“我是user2\r\n”);

三，下载首个bin
编译两次后，user1和user2存放在这个upgrade文件夹
在这里插入图片描述
下图的第一和第二个bin文件必须要下载，第三个不清楚是否必要，但下载进去也能正常运行，第四个其实是个空白bin文件，最好写进去

四，服务器部署
这是一个复杂的事情，我试验OTA的时候是搭建一个TOMCAT本地服务器进行试验的，怎么搭建？还是参考这个网友的文章吧：https://www.cnblogs.com/demodashi/p/9437734.html