Score
0
Watch 3 Star 14 Fork 4

PaulJiang / ota_downloaderCApache-2.0

Join us
Explore and code with more than 2 million developers,Free private repositories !:)
Sign up
用于 OTA 升级的固件下载器,使用 RT-Thread 的 OTA 组件 spread retract

https://github.com/RT-Thread-packages/ota_downloader

Clone or download
Loading...
README.md

OTA Downloader

1、介绍

本软件包是用于 OTA 升级的固件下载器,该下载器提供多种固件下载方式。开发者可以根据自己的需求灵活选择升级方式,每种升级方式都只需调用一次函数或者命令就可实现,目前支持的下载方式如下所示:

  • HTTP/HTTPS 协议下载固件
  • Ymodem 协议下载固件

1.1 许可证

OTA Downloader package 遵循 Apache2.0 许可,详见 LICENSE 文件。

1.2 依赖

  • RT-Thread 3.0+
  • FAL 软件包支持
  • Ymodem 下载方式依赖于 Ymodem 组件
  • HTTP/HTTPS 下载方式依赖于 webclient 软件包

2、如何打开 OTA Downloader

使用 OTA downloader package 需要在 RT-Thread 的包管理器中选择它,具体路径如下:

RT-Thread online packages
    IoT - internet of things  --->
        [*]  The firmware downloader which using on RT-Thread OTA component  --->
            [*]  Enable OTA downloader debug
            [*]  Enable HTTP/HTTPS OTA
                (http://xxx/xxx/rtthread.rbl) HTTP OTA URL
            [*]  Enable Ymodem OTA

软件包选项的详细说明如下图:

选项 说明
Enable OTA downloader debug 使能固件下载器 debug 模式
Enable HTTP/HTTPS OTA 使能 HTTP/HTTPS 协议下载固件功能
Enable Ymodem OTA 使能 Ymodem 协议下载固件功能

选择完自己需要的选项后使用 RT-Thread 的包管理器自动更新,或者使用 pkgs --update 命令更新包到 BSP 中。

3、使用 OTA Downloader

在打开 OTA downloader package ,选中相应的功能选项后,当进行 BSP 编译时,它会被加入到 BSP 工程中进行编译。 烧录程序到目标开发板,用户可在 FinSH 终端找到对应的命令。目前软件包支持的升级方式如下表:

功能 函数调用 执行命令
使用 HTTP/HTTPS 协议固件升级 void http_ota(uint8_t argc, char **argv) http_ota
使用 Ymodem 协议固件升级 void ymodem_ota(uint8_t argc, char **argv) ymodem_ota

3.1 Ymodem 协议固件升级命令行演示

推荐使用支持 Ymodem 协议的 Xshell 。在终端输入 ymodem_ota 命令后,鼠标右键然后在菜单栏找到用 YMODEM 发送选项发送文件。具体步骤如下图:

ymodem_ota

3.2 HTTP/HTTPS 协议固件升级命令行演示

在终端输入 http_ota http://xxx/xxx/rtthreadf.rbl 命令,执行该命令后将会从链接 http://xxx/xxx/rtthreadf.rbl 处下载固件。具体步骤如下图所示:

http_ota

4、注意事项

  1. 确保 FAL 中有 downloader 分区。
  2. Ymodem 协议升级固件时,请使用支持 Ymodem 协议的工具。
  3. HTTP/HTTPS 协议升级固件时,需确保远端链接地址可用。

5、参考资料

《RT-Thread OTA 用户手册》: docs/RT-Thread-OTA 用户手册.pdf

6、联系方式 & 感谢

Comments ( 0 )

Sign in for post a comment

C
1
https://gitee.com/jzhiyu/ota_downloader.git
git@gitee.com:jzhiyu/ota_downloader.git
jzhiyu
ota_downloader
ota_downloader
master

Help Search