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

2024-06-09 05:52
文章标签 实现 使用 更新 框架 arduino esp32 固件 ota air platformio

本文主要是介绍使用 ESP32 和 PlatformIO （arduino框架）实现 Over-the-Air（OTA）固件更新，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

使用 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); // 初始化串口，波特率为115200Serial.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.1Serial.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 技术将会发挥越来越重要的作用，帮助我们更好地维护和管理设备。

这篇关于使用 ESP32 和 PlatformIO （arduino框架）实现 Over-the-Air（OTA）固件更新的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1044371。

相关文章

Python使用getopt处理命令行参数示例解析(最佳实践)

Python使用getopt处理命令行参数示例解析(最佳实践)

《Python使用getopt处理命令行参数示例解析(最佳实践)》getopt模块是Python标准库中一个简单但强大的命令行参数处理工具,它特别适合那些需要快速实现基本命令行参数解析的场景,或者需要... 目录为什么需要处理命令行参数？getopt模块基础实际应用示例与其他参数处理方式的比较常见问http
阅读更多...
python实现svg图片转换为png和gif

python实现svg图片转换为png和gif

《python实现svg图片转换为png和gif》这篇文章主要为大家详细介绍了python如何实现将svg图片格式转换为png和gif,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录python实现svg图片转换为png和gifpython实现图片格式之间的相互转换延展：基于Py
阅读更多...
Python利用ElementTree实现快速解析XML文件

Python利用ElementTree实现快速解析XML文件

《Python利用ElementTree实现快速解析XML文件》ElementTree是Python标准库的一部分,而且是Python标准库中用于解析和操作XML数据的模块,下面小编就来和大家详细讲讲... 目录一、XML文件解析到底有多重要二、ElementTree快速入门1. 加载XML的两种方式2.
阅读更多...
C 语言中enum枚举的定义和使用小结

C 语言中enum枚举的定义和使用小结

《C语言中enum枚举的定义和使用小结》在C语言里,enum（枚举）是一种用户自定义的数据类型,它能够让你创建一组具名的整数常量,下面我会从定义、使用、特性等方面详细介绍enum,感兴趣的朋友一起看... 目录1、引言2、基本定义3、定义枚举变量4、自定义枚举常量的值5、枚举与switch语句结合使用6、枚
阅读更多...
Java的栈与队列实现代码解析

Java的栈与队列实现代码解析

《Java的栈与队列实现代码解析》栈是常见的线性数据结构,栈的特点是以先进后出的形式,后进先出,先进后出,分为栈底和栈顶,栈应用于内存的分配,表达式求值,存储临时的数据和方法的调用等,本文给大家介绍J... 目录栈的概念（Stack）栈的实现代码队列（Queue）模拟实现队列(双链表实现)循环队列（循环数组
阅读更多...
使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

《使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)》PPT是一种高效的信息展示工具,广泛应用于教育、商务和设计等多个领域,PPT文档中常常包含丰富的图片内容,这些图片不仅提升了... 目录一、引言二、环境与工具三、python 提取PPT背景图片3.1 提取幻灯片背景图片3.2 提取
阅读更多...
C++如何通过Qt反射机制实现数据类序列化

C++如何通过Qt反射机制实现数据类序列化

《C++如何通过Qt反射机制实现数据类序列化》在C++工程中经常需要使用数据类,并对数据类进行存储、打印、调试等操作,所以本文就来聊聊C++如何通过Qt反射机制实现数据类序列化吧... 目录设计预期设计思路代码实现使用方法在 C++ 工程中经常需要使用数据类，并对数据类进行存储、打印、调试等操作。由于数据类
阅读更多...
Python实现图片分割的多种方法总结

Python实现图片分割的多种方法总结

《Python实现图片分割的多种方法总结》图片分割是图像处理中的一个重要任务,它的目标是将图像划分为多个区域或者对象,本文为大家整理了一些常用的分割方法,大家可以根据需求自行选择... 目录1. 基于传统图像处理的分割方法(1) 使用固定阈值分割图片(2) 自适应阈值分割(3) 使用图像边缘检测分割(4)
阅读更多...
Android实现在线预览office文档的示例详解

Android实现在线预览office文档的示例详解

《Android实现在线预览office文档的示例详解》在移动端展示在线Office文档（如Word、Excel、PPT）是一项常见需求,这篇文章为大家重点介绍了两种方案的实现方法,希望对大家有一定的... 目录一、项目概述二、相关技术知识三、实现思路3.1 方案一：WebView + Office Onl
阅读更多...
C# foreach 循环中获取索引的实现方式

C# foreach 循环中获取索引的实现方式

《C#foreach循环中获取索引的实现方式》：本文主要介绍C#foreach循环中获取索引的实现方式,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录一、手动维护索引变量二、LINQ Select + 元组解构三、扩展方法封装索引四、使用 for 循环替代
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2