使用 ESP32 和 PlatformIO (arduino框架)实现 Over-the-Air(OTA)固件更新

news2024/11/28 16:26:17

使用 ESP32 和 PlatformIO 实现 Over-the-Air(OTA)固件更新

摘要:

本文将介绍如何在 ESP32 上使用 PlatformIO 环境实现 OTA(Over-the-Air)固件更新。OTA 更新使得在设备部署在远程位置时,无需物理接触设备,就可以通过网络更新固件,大大提高了设备维护和管理的便捷性。

介绍:

随着物联网技术的发展,越来越多的设备需要进行固件更新以修复漏洞、添加新功能或提高性能。传统的固件更新方式需要通过串口连接或者直接物理接触设备,但是当设备分布在远程位置时,这种方式就显得非常不便。而 OTA 固件更新技术则能够解决这个问题,使得固件更新可以通过网络实现。

工程配置:

创建新分区表: 在项目目录下创建.cvs后缀文件,文件名随意,这里我以partition.csv文件名为例
在这里插入图片描述

打开partition.csv将下面的分区配置,直接粘贴上去

# Name	Type	SubType	Offset		Size	Flags
nvs,    data,   nvs,    0x9000,     0x5000
otadata,data,   ota,    0xe000,     0x2000
app0,   app,    ota_0,  0x10000,    0x140000
app1,   app,    ota_1,  0x150000,   0x140000
spiffs, data,   spiffs, 0x290000,   0x170000

配置 PlatformIO 项目: 在项目的 platformio.ini 文件中添加下面这行 ,配置选用自定义分区表partition.csv改为你自己创建的分区表

board_build.partitions = partition.csv

Update库

Update 库是 Arduino 核心库中用于 OTA(Over-The-Air)固件更新的一个关键库。它提供了用于在 ESP8266 和 ESP32 上进行固件更新的一组功能和类。

主要功能:

  1. OTA 固件更新: Update 库允许你通过 WiFi 网络进行固件更新,而无需物理连接到设备。这使得你可以远程更新设备上的固件,而不必重新连接电脑或使用串口进行更新。

  2. 简单易用的接口: Update 库提供了一组简单易用的函数和类,用于初始化 OTA 更新功能、写入固件数据和结束 OTA 更新过程。这些函数和类的接口设计得很简洁,使得在代码中集成 OTA 更新功能变得非常容易。

  3. OTA 更新错误处理: Update 库还提供了一些用于处理 OTA 更新过程中可能出现的错误的函数。例如,你可以使用 hasError() 函数检查更新过程是否出现了错误,并使用 printError() 函数打印出错误信息以进行调试。

主要类和函数:

  1. Update 类: Update 类是 Update 库的核心部分,提供了用于 OTA 固件更新的主要功能。它包含了 begin()write()end() 等函数,用于初始化更新、写入固件数据和结束更新过程。

  2. begin() 函数: 这个函数用于初始化 OTA 更新功能,并可以指定固件的大小,也可以选择不指定大小,然后在上传固件时自动检测大小。

  3. write() 函数: 这个函数用于将接收到的固件数据写入到更新对象中。通常在上传固件的过程中调用,用于将固件的每个数据块写入到更新对象中。

  4. end() 函数: 这个函数用于结束 OTA 更新过程。你可以选择设置固件大小为当前接收到的数据大小,也可以选择不设置大小,以最后接收到的数据大小为准。

  5. hasError() 函数: 这个函数用于检查 OTA 更新过程中是否发生了错误。如果在更新过程中出现了错误,则返回 true;否则返回 false。

  6. printError() 函数: 这个函数用于打印出 OTA 更新过程中发生的错误信息。通常在发生错误时使用,以便调试和排查问题。

使用 Arduino 的 Update 库进行 OTA(Over-The-Air)固件更新非常简单,下面我将逐步说明基本的使用方法。

步骤 1:包含头文件和声明全局变量

首先,在你的 Arduino 项目中包含 Update 库的头文件,并声明 WiFi 相关的全局变量,例如 WiFi SSID 和密码。

#include <WiFi.h>
#include <Update.h>

const char* ssid = "YourSSID";
const char* password = "YourPassword";

步骤 2:连接到 WiFi 网络

setup() 函数中,连接到你的 WiFi 网络。

void setup() {
    Serial.begin(115200);
    WiFi.begin(ssid, password);

    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }

    Serial.println("Connected to WiFi!");
}

步骤 3:初始化 OTA 更新

setup() 函数中,初始化 OTA 更新功能。

void setup() {
    // 连接到 WiFi 网络(省略)
    
    // 初始化 OTA 更新
    if (Update.begin()) {
        Serial.println("OTA update begin...");
        // 在这里写入固件数据
        // 结束 OTA 更新过程
        Update.end();
        Serial.println("OTA update complete!");
    } else {
        Serial.println("OTA update failed!");
    }
}

步骤 4:写入固件数据

在初始化 OTA 更新后,你可以通过 Update.write() 函数将固件数据写入更新对象。你可以在这里接收固件数据的回调函数中调用此函数。

void setup() {
    // 连接到 WiFi 网络(省略)
    
    // 初始化 OTA 更新(省略)
    
    // 接收固件数据的回调函数
    server.on("/update", HTTP_POST, []() {
        // 结束 OTA 更新过程
        Update.end(true);
    }, []() {
        HTTPUpload& upload = server.upload();
        if (upload.status == UPLOAD_FILE_START) {
            if (!Update.begin(UPDATE_SIZE_UNKNOWN)) {
                Update.printError(Serial);
            }
        } else if (upload.status == UPLOAD_FILE_WRITE) {
            if (Update.write(upload.buf, upload.currentSize) != upload.currentSize) {
                Update.printError(Serial);
            }
        } else if (upload.status == UPLOAD_FILE_END) {
            if (Update.end(true)) {
                Serial.println("OTA update complete!");
            } else {
                Update.printError(Serial);
            }
        }
    });

    // 开启 Web 服务器(省略)
}

步骤 5:结束 OTA 更新

最后,在你写入完所有固件数据后,调用 Update.end() 函数结束 OTA 更新过程。

void setup() {
    // 连接到 WiFi 网络(省略)
    
    // 初始化 OTA 更新(省略)
    
    // 写入固件数据(省略)
    
    // 结束 OTA 更新
    Update.end(true);
}

项目案例

这里我为大家提供了一个项目案例,这个项目实现了一个简单的ESP32固件OTA(Over-The-Air)更新方法,大家稍作修改就可以直接移植到你自己的项目中,它利用ESP32的WiFi功能搭建了个小AP热点,让我们通过一个简单的Web界面上传新的固件文件,然后用Arduino的Update库自动更新固件。通过这个项目,我们可以方便地在没有外部网络连接的情况下,通过无线方式更新ESP32设备的固件。

案例代码

#include <Arduino.h>
#include <TFT_eSPI.h>
#include <math.h>
#include <WiFi.h>
#include <WebServer.h>
#include <Update.h>
// #include <ArduinoMDNS.h> // 引入mDNS库

const char* ssid = "ESP32-c3_OTAdemo"; // AP的名称
const char* password = "123456789"; // AP的密码

IPAddress local_IP(192, 168, 4, 1); // 静态IP地址
IPAddress gateway(192, 168, 4, 1); // 网关IP地址


WebServer server(80);

TFT_eSPI tft;

const char* updateIndex =
  "<html>"
  "<head>"
  "<meta charset=\"UTF-8\">"
  "<title>ESP32 OTA 更新</title>"
  "<style>"
  "body { font-family: Arial, sans-serif; text-align: center; }"
  "h1 { color: #333; }"
  "form { margin-top: 20px; }"
  "input[type=file] { display: block; margin: 20px auto; }"
  "input[type=submit] { margin-top: 20px; padding: 10px 20px; font-size: 18px; }"
  "</style>"
  "</head>"
  "<body>"
  "<h1>欢迎使用 ESP32 OTA 更新</h1>"
  "<form method='POST' action='/update' enctype='multipart/form-data'>"
  "<input type='file' name='update' accept='.bin'>"
  "<input type='submit' value='上传固件'>"
  "</form>"
  "</body>"
  "</html>";


void handleRoot() {
  server.sendHeader("Location", "/update");
  server.send(302, "text/plain", "");
}

void setup() {
  Serial.begin(115200); // 初始化串口,波特率为115200
  Serial.println("Booting...");

  // 将 ESP32 设置为 AP 模式并指定静态 IP 地址
  WiFi.softAP(ssid, password);
  WiFi.softAPConfig(local_IP, gateway, IPAddress(255, 255, 255, 0));
  
  Serial.print("Access Point IP address: ");
  Serial.println(WiFi.softAPIP()); // 打印 ESP32 的 AP IP 地址

  // 设置服务器处理函数
  server.on("/", HTTP_GET, handleRoot); // 根路由重定向到 OTA 页面

  server.on("/update", HTTP_GET, []() {
    server.sendHeader("Connection", "close");
    server.send(200, "text/html", updateIndex);
  });

  server.on("/update", HTTP_POST, []() {
    server.sendHeader("Connection", "close");

    //动态显示结果
  String message = Update.hasError() ? "更新失败" : "更新成功。重新启动…";
  server.sendHeader("Content-Type", "text/html; charset=utf-8");
  server.send(200, "text/html", "<span style='font-size: 24px;'>" + message + "</span>");


    delay(1000);
    ESP.restart();
  }, []() {
    HTTPUpload& upload = server.upload(); //用于处理上传的文件数据
    if (upload.status == UPLOAD_FILE_START) {
      Serial.printf("Update: %s\n", upload.filename.c_str());
      if (!Update.begin(UPDATE_SIZE_UNKNOWN)) { // 以最大可用大小开始
        Update.printError(Serial);
      }
    } else if (upload.status == UPLOAD_FILE_WRITE) {
      // 将接收到的数据写入Update对象
      if (Update.write(upload.buf, upload.currentSize) != upload.currentSize) {
        Update.printError(Serial);
      }
    } else if (upload.status == UPLOAD_FILE_END) {
      if (Update.end(true)) { // 设置大小为当前大小
        Serial.printf("Update Success: %u bytes\n", upload.totalSize);
      } else {
        Update.printError(Serial);
      }
    }
  });

  server.begin();
  Serial.println("HTTP server started");


  //程序逻辑 版本1.1
  Serial.println();
  Serial.println("NEW ESP32C3!!");
  tft.begin();
  tft.setRotation(3);
  tft.setTextFont(2);
  tft.fillScreen(TFT_BLACK);
  tft.drawString("NEW ESP32C3!!", 0, 0);
  tft.drawRect(2, 20, 100, 20, TFT_BROWN);
}

void loop() {
  server.handleClient();

}

获取固件文件

PlatformIO 本身并不提供直接导出固件文件的功能,但你可以在 PlatformIO 中构建项目,并手动在构建目录中找到生成的固件文件。

一般情况下,PlatformIO 会将编译生成的固件文件放置在项目的 .pio 目录中。具体来说,对于 ESP32 来说,固件文件通常位于 .pio/build/<board_name>/firmware.bin,其中 <board_name> 是你的开发板名称,例如 esp32dev
在这里插入图片描述

OTA操作

程序烧录到开发板之后,在电脑端连接wifi ESP32-c3_OTAdemo,密码为123456789
请添加图片描述

连接上WIFI之后,打开浏览器输入URL

http://192.168.4.1/update

请添加图片描述

下图即是我们的OTA上传页面
请添加图片描述

点击选择文件
请添加图片描述

选择需要下载的固件文件.bin文件
请添加图片描述

点击上传固件
在这里插入图片描述

如果上传成功,显示更新成功,并且重新启动,如果失败,显示更新失败。
请添加图片描述

总结:

通过使用 PlatformIO 环境和 ESP32 开发板,我们可以轻松实现 OTA 固件更新功能。这使得固件更新变得更加灵活和便捷,大大提高了设备管理的效率。在物联网应用中,OTA 技术将会发挥越来越重要的作用,帮助我们更好地维护和管理设备。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/1802496.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

融合创新:Web3如何重新定义网络生态

随着区块链技术的不断发展和Web3时代的到来&#xff0c;我们正在见证着互联网生态的巨大变革。Web3将传统的互联网架构转变为去中心化、开放、透明的新网络生态&#xff0c;为创新和合作提供了全新的可能性。本文将深入探讨Web3如何重新定义网络生态&#xff0c;探索融合创新的…

比亚迪正式签约国际皮划艇联合会和中国皮划艇协会,助推龙舟入奥新阶段

6月5日&#xff0c;比亚迪与国际皮划艇联合会、中国皮划艇协会在深圳共同签署合作协议&#xff0c;国际皮划艇联合会主席托马斯科涅茨科&#xff0c;国际皮划艇联合会秘书长理查德派蒂特&#xff0c;中国皮划艇协会秘书长张茵&#xff0c;比亚迪品牌及公关处总经理李云飞&#…

【C语言】04.循环结构

C语言中提供了3种循环结构&#xff1a;while循环 、do-while循环、 for循环。 一、while循环 while(表达式)语句;//如果循环体想包含更多的语句&#xff0c;可以加上⼤括号 while循环的执行流程&#xff1a; 例题&#xff1a; 输⼊⼀个正的整数&#xff0c;逆序打印这个整数…

详解FedAvg:联邦学习的开山之作

FedAvg&#xff1a;2017年 开山之作 论文地址&#xff1a;https://proceedings.mlr.press/v54/mcmahan17a/mcmahan17a.pdf 源码地址&#xff1a;https://github.com/shaoxiongji/federated-learning 针对的问题&#xff1a;移动设备中有大量的数据&#xff0c;但显然我们不能收…

电调, GPS与飞塔

电调油门行程校准&#xff1a; 断电-----油门推到最高-------电调上电-------滴滴------油门推到最低---滴滴滴---校准完成。 http://【【教程】油门行程校准&#xff08;航模&#xff0c;电机&#xff0c;电调&#xff09;】https://www.bilibili.com/video/BV1yJ411J7aX?v…

区间预测 | Matlab实现QRCNN-BiGRU-Attention分位数回归卷积双向门控循环单元注意力机制时序区间预测

区间预测 | Matlab实现QRCNN-BiGRU-Attention分位数回归卷积双向门控循环单元注意力机制时序区间预测 目录 区间预测 | Matlab实现QRCNN-BiGRU-Attention分位数回归卷积双向门控循环单元注意力机制时序区间预测效果一览基本介绍程序设计参考资料 效果一览 基本介绍 1.Matlab实…

企业办公网安全管控挑战与解决方案

在数字化浪潮的推动下&#xff0c;企业正经历前所未有的变革。然而&#xff0c;随之而来的是一系列复杂的网络安全风险和挑战。我们的网络边界不再清晰&#xff0c;各种设备轻松接入企业网络&#xff0c;这不仅带来了便利&#xff0c;也极大地增加了安全风险。想象一下&#xf…

[AI Google] 双子座模型家族迎来新突破:更快的模型、更长的上下文、AI代理等更多功能

Google发布了Gemini模型家族的更新&#xff0c;包括新的1.5 Flash模型&#xff0c;该模型旨在提高速度和效率&#xff0c;以及Project Astra&#xff0c;这是对未来AI助手愿景的展示。1.5 Flash是专为大规模高频任务优化的轻量级模型&#xff0c;具有突破性的长上下文窗口。同时…

opencv 在飞行堡垒8中调用camera导致设备消失

简介 使用 OpenCV 库时, 在最后调用cv::destroyAllWindows()之后设备管理器中的摄像头设备消失了&#xff0c; 看看是怎么触发的&#xff0c; 后面再慢慢研究RootCause是什么。 步骤 设备管理器原来摄像头显示 1. 代码 main.cpp Note: 1. haarcascade_frontalface_default…

什么是助听器呢?

助听器是一种用于改善听力障碍患者听觉能力的装置。它通过放大声音&#xff0c;使原本听不到或听不清的声音能够被听力受损者感知&#xff0c;从而提高其交流能力和生活质量。 助听器的基本工作原理是&#xff0c;将声音转化为电信号&#xff0c;经过内部电路处理后&#xff0c…

算法006:查找总价格为目标值的两个商品

. - 力扣&#xff08;LeetCode&#xff09;. - 备战技术面试&#xff1f;力扣提供海量技术面试资源&#xff0c;帮助你高效提升编程技能,轻松拿下世界 IT 名企 Dream Offer。https://leetcode.cn/problems/he-wei-sde-liang-ge-shu-zi-lcof/ 题干说的很复杂&#xff0c;简化一…

嵌入式Linux系统编程 — 3.2 stat、fstat 和 lstat 函数查看文件属性

目录 1 文件有哪些属性 2 stat函数 2.1 stat函数简介 2.2 struct stat 结构体 2.3 struct timespec 结构体 2.4 示例程序 3 fstat 和 lstat 函数 3.1 fstat 函数 3.2 lstat 函数 1 文件有哪些属性 Linux文件属性是对文件和目录的元数据描述&#xff0c;包括文件类型…

浅谈安全用电管理系统对重要用户的安全管理

1用电安全管理的重要性   随着社会经济的不断发展&#xff0c;电网建设力度的不断加大&#xff0c;供电的可靠性和供电质量日益提高&#xff0c;电网结构也在不断完善。但在电网具备供电的条件下&#xff0c;部分高危和重要电力用户未按规定实现双回路电源线路供电&#xff1…

问题:设备管理指标为完好率不低于( ),待修率不高于5%,事故率不高于1%。 #知识分享#经验分享#经验分享

问题&#xff1a;设备管理指标为完好率不低于( )&#xff0c;待修率不高于5%&#xff0c;事故率不高于1%。 A、100% B、95% C、90% D、80% 参考答案如图所示

自动驾驶---Control之LQR控制

1 前言 在前面的系列博客文章中为读者阐述了很多规划相关的知识&#xff08;可参考下面专栏&#xff09;&#xff0c;本篇博客带领读者朋友们了解控制相关的知识&#xff0c;后续仍会撰写规控相关文档。 在控制理论的发展过程中&#xff0c;人们逐渐认识到对于线性动态系统的控…

vue数组在浏览器里可以看到值, 但是length为空

arr数组 length为0, 检查了代码在created 里调用了 this.getEnergyList(); 和 this.initChart(); 问题就在这里, this.initChart用到了getEnergyList里的数据, 造成了数据异步, 把this.initChart(); 放入 this.getEnergyList(); 方法里即可解决问题

Elasticsearch 认证模拟题 - 13

一、题目 集群中有索引 task3&#xff0c;用 oa、OA、Oa、oA 查询结构是 4 条&#xff0c;使用 dingding 的查询结果是 1 条。通过 reindex 索引 task3 为 task3_new&#xff0c;能够使 task3_new 满足以下查询条件。 使用 oa、OA、Oa、oA、0A、dingding 查询都能够返回 6 条…

【计算机视觉】数字图像处理基础:以像素为单位的图像基本运算(点运算、代数运算、逻辑运算、几何运算、插值)

0、前言 在上篇文章中&#xff0c;我们对什么是数字图像、以及数字图像的组成&#xff08;离散的像素点&#xff09;进行了讲解&#x1f517;【计算机视觉】数字图像处理基础知识&#xff1a;模拟和数字图像、采样量化、像素的基本关系、灰度直方图、图像的分类。 我们知道&a…

Ruoyi-Vue-Plus 下载启动后菜单无法点击展开,

1.Ruoyi-Vue-Plus框架下载后运行 2.使用mock数据 3.进入页面后无法点击菜单 本以为是动态路由或者菜单逻辑出了问题&#xff0c;最后发现是websocket的问题 解决办法 把这两行代码注释 页面菜单即可点击。 以上。

蓝屏绿屏黑屏?别急,有它们仨【送源码】

使用Windows系统的电脑时&#xff0c;可能会碰到各种问题&#xff0c;导致系统无法正常使用。 这些问题都有一个统一的专业叫法就是bug&#xff01; 系统一旦出现bug&#xff0c;最明显的特点就是&#xff0c; ①电脑蓝屏 电脑蓝屏是最经典的&#xff0c;从XP时代一直延续到…