STM32F407/STM32F417 (IAP)

Size: px

Start display at page:

Download "STM32F407/STM32F417 (IAP)"

雕宋
4 years ago
Views:

1 应用笔记 STM32F407/STM32F417 通过以太网实现在应用中编程 (IAP) 1 简介本应用笔记专为使用 STM32F407/STM32F417 微控制器的开发人员编写它提供了如何使用 STM32F407/STM32F417 以太网通信接口实现在应用中编程 (IAP) 的解决方案有两种基于 LwIP TCP/IP 协议栈的解决方案 : 使用 TFTP ( 简单文件传输协议 ) 的 IAP 使用 HTTP ( 超文本传输协议 ) 的 IAP 2011 年 10 月文档 ID 第 1 版 1/19

2 目录目录 1 简介 IAP 概述工作原理使用 MCU 以太网接口实现 IAP 通过以太网在 STM32F407/STM32F417 上实现 IAP 使用 TFTP 实现 IAP 方法使用 HTTP 实现 IAP 方法使用 TFTP 实现 IAP TFTP 概述使用 TFTP 为 STM32F407/STM32F417 实现 IAP 使用软件使用 HTTP 实现 IAP HTTP 文件上传概述使用 HTTP 在 STM32F407/STM32F417 上实现 IAP 使用软件已知限制二进制文件中添加的额外字节环境 MAC 地址和 IP 地址设置 STM324xG-EVAL 电路板上的跳线设置软件文件组成代码长度测量构建 IAP 映像版本历史 /19 文档 ID 第 1 版

3 表格索引表格索引表 1. TFTP 操作码表 2. 跳线配置表 3. 文件组成表 4. 代码长度与配置选项表 5. 文档版本历史文档 ID 第 1 版 3/19 3

4 图片索引图片索引图 1. IAP 操作流程图 2. TFTP 数据包图 3. 使用 TFTP 实现 IAP 的流程图图 4. TFTPD32 对话框图 5. 文件上传 HTML 表单的浏览器画面图 6. IE8 HTTP 头文件格式图 7. Mozilla Firefox HTTP 头文件格式图 8. 登录 web 页面图 9. 文件上传完成 web 页面图 10. 使用 HTTP 实现 IAP 的流程图 /19 文档 ID 第 1 版

5 IAP 概述 2 IAP 概述 2.1 工作原理在应用中编程 (IAP) 是一种在现场通过 MCU 通信接口 ( 例如 UART USB CAN 和以太网 ) 进行固件升级的方式启动微控制器时, 可以选择让其在以下任一模式运行 : IAP 模式, 用于执行 IAP 代码, 正常模式, 用于执行应用程序代码无论是 IAP 代码还是应用程序代码都位于微控制器的内置 Flash 中 IAP 代码通常存储在 MCU Flash 的第一页, 而用户应用程序代码则占据剩余的 Flash 区域图 1 介绍了 IAP 操作流程 : 图 1. IAP 操作流程 2.2 使用 MCU 以太网接口实现 IAP 如果有以太网可用, 则它通常是在嵌入式系统中实现 IAP 功能的首选接口其优势包括 : 高速通信接口 (10/100 Mb/s) 通过网络 (LAN 或 WAN) 进行远程编程可以使用 FTP TFTP HTTP 等基于 TCP/IP 栈的标准应用协议实现 IAP 文档 ID 第 1 版 5/19 18

6 IAP 概述 2.3 通过以太网在 STM32F407/STM32F417 上实现 IAP 本应用笔记将介绍两种使用以太网通信外设在 STM32F407/STM32F417 上实现 IAP 的解决方案 : 使用 TFTP( 简单文件传输协议 ) 的 IAP 使用 HTTP( 超文本传输协议 ) 的 IAP 这两种解决方案均基于 LwIP 栈 (v1.3.2), 它是轻量级的 TCP/IP 协议栈使用 TFTP 实现 IAP 方法使用 TFTP 实现 IAP 的方法广泛应用于需要具有固件升级功能的嵌入式应用中 ( 例如, 嵌入式 Linux bootloader 中 ) TFTP 是一种在 UDP 传输层上执行的简单文件传输协议此协议非常适合在局域网环境中使用它基于客户端 / 服务器架构, 在这种架构中, 客户端会向服务器发出文件传输请求 ( 读取或写入操作 ) 为实现 IAP, 需要在 LwIP 协议栈上实现一个简单的 TFTP 服务器, 服务器只需处理来自 PC 的 TFTP 客户端的写入请求即可使用 HTTP 实现 IAP 方法使用 HTTP 协议进行固件升级没有使用 TFTP 常见, 但是在需要通过 Internet 进行远程编程时, 这种解决方案就显得极为有用这时, 需要使用 TCP 传输协议来实现 http 服务 HTTP 基于 TCP 协议运行, 它提供了一种以 HTML 表单形式从 Web 客户端 (Mozilla Firefox 或 Microsoft Internet Explorer) 发送二进制文件的方式这称为 HTTP 文件上传 (RFC 1867) 本文档中的后续章节将详细介绍这两种 IAP 方法的实现, 并会对如何使用软件进行说明 6/19 文档 ID 第 1 版

7 使用 TFTP 实现 IAP 3 使用 TFTP 实现 IAP 3.1 TFTP 概述 TFTP 是一种基于 UDP 的简单文件传输协议文件传输由 TFTP 客户端发起, 会向 TFTP 服务器发送读取或写入请求服务器确认请求后, 即开始进行文件数据传输数据将以固定大小的块进行发送 ( 例如每块含 512 个字节 ) 必须在每个发出的数据块都得到接收方确认后, 才可以发送下一个数据块这种确认机制通过随各个数据块一同发送的块编号来实现数据块小于固定块大小表示文件传输的结束图 2 描述了各种 TFTP 数据包的格式 : 图 2. TFTP 数据包表 1 列出了 TFTP 操作码表 1. TFTP 操作码操作码 0x1 0x2 0x3 0x4 0x5 操作读请求 (RRQ) 写请求 (WRQ) 数据确认 (ACK) 错误文档 ID 第 1 版 7/19 18

8 使用 TFTP 实现 IAP 3.2 使用 TFTP 为 STM32F407/STM32F417 实现 IAP 注 : 此 IAP 实现由基于 LwIP TCP/IP 栈的 TFTP 服务器组成此服务器会对远程 TFTP 客户端 (PC) 发来的写请求做出响应 TFTP 读请求会被忽略 TFTP 通常会将接收到的文件写入到文件系统, 但是该服务器却并非如此, 它会将接收到的数据块写入到 MCU Flash( 用户 Flash 区域中 ) 在这个实现过程中, 数据块大小固定为 512 个字节图 3 概述了使用 TFTP 实现 IAP 操作的过程图 3. 使用 TFTP 实现 IAP 的流程图 8/19 文档 ID 第 1 版

使用 TFTP 实现 IAP 3.3 使用软件要通过 TFTP 对 IAP 进行测试, 需执行以下步骤 : 1. 确保 STM324xG-EVAL 电路板上的跳线设置正确 ( 参见表 2) 2. 在 main.h 文件中, 取消 USE_IAP_TFTP 选项的注释另外, 还可以根据需要取消注释 / 注释其它选项, 例如 USE_DHCP 或 USE_LCD 3.

9 使用 TFTP 实现 IAP 3.3 使用软件要通过 TFTP 对 IAP 进行测试, 需执行以下步骤 : 1. 确保 STM324xG-EVAL 电路板上的跳线设置正确 ( 参见表 2) 2. 在 main.h 文件中, 取消 USE_IAP_TFTP 选项的注释另外, 还可以根据需要取消注释 / 注释其它选项, 例如 USE_DHCP 或 USE_LCD 3. 重新编译软件使用生成的映射文件, 确保 IAP 代码区域之间没有重叠 ( 从地址 0x0 开始 ), 而且用户 Flash 区域从以下地址开始 :USER_FLASH_FIRST_PAGE_ADDRESS ( 在 main.h 中定义 ) 4. 在 STM32 Flash 中编写并运行软件程序 5. 要进入 IAP 模式, 需要在按住按键按钮的同时按下再释放复位按钮 6. 如果在 main.h 文件中定义了 USE_LCD, 则 LCD 屏幕会显示一条消息, 指出已进入 IAP 模式同样, 如果使用的是 DHCP( 在 main.h 中定义的 USE_DHCP),LCD 屏幕也会显示一条消息, 指出 DHCP IP 地址分配是否成功 7. 分配完 IP 地址后 ( 可以是静态或动态地址 ), 用户即可启动 IAP 流程 8. 在 PC 侧, 打开 TFTP 客户端 ( 例如 TFTPD32), 然后配置 TFTP 服务器地址 (TFTPD32 中的主机地址 ) 9. 浏览到要在 STM32 Flash 中加载的二进制映像 ( 在 /project/binary 文件夹中提供了两个二进制映像作为示例 ) 10. 单击 TFTPD32 实用程序中的 Put( 写入 ) 按钮, 启动文件写请求 11. 如果使能 USE_LCD,IAP 操作的进程会显示在 LCD 上 12. 在 IAP 操作结束时, 可以复位评估电路板并在 STM32 Flash 中运行刚刚编写的应用程序注 : 如果在使能 USE_LCD 时出现连接问题,LCD 屏幕上会显示一条错误消息, 指示连接故障图 4. TFTPD32 对话框文档 ID 第 1 版 9/19 18

使用 HTTP 实现 IAP 4 使用 HTTP 实现 IAP 4.1 HTTP 文件上传概述 RFC1867 中定义了使用 HTTP 进行文件上传此文件上传方法是基于 HTML 表单发送原始二进制数据时, 要使用 HTML POST 方法而不是 GET 方法以下是一个 HTML 代码示例, 用于实现基于表单的文件上传 : <form action ="/upload.

10 使用 HTTP 实现 IAP 4 使用 HTTP 实现 IAP 4.1 HTTP 文件上传概述 RFC1867 中定义了使用 HTTP 进行文件上传此文件上传方法是基于 HTML 表单发送原始二进制数据时, 要使用 HTML POST 方法而不是 GET 方法以下是一个 HTML 代码示例, 用于实现基于表单的文件上传 : <form action ="/upload.cgi" enctype="multipart/form-data" method="post"> <p> 指定要上传到 STM32F4x7 Flash 的二进制文件 : <br> <input type="file" name="datafile" size="40"> </p> <div> <input type="submit" value="upload"> </div></form> 图 5. 文件上传 HTML 表单的浏览器画面注 : 单击 Browse( 浏览 ), 选择要上传的二进制文件, 然后按下 Upload( 上传 ) 按钮进行发送根据文件大小, 数据会以连续 TCP 分段的形式发送到 web 服务器在发送文件数据前,web 客户端会首先发送 HTTP 头文件数据, 其中包含诸如文件名称和内容长度等信息,web 服务器必须对其中的一些信息进行解析 Web 客户端使用的 HTTP 头文件格式并不总是相同图 6 显示的是 Internet Explorer 在 POST 请求中的 HTTP 头文件格式图 7 显示的是 Mozilla Firefox 的 HTTP 头文件格式 http web 服务器必须能够处理这些不同的格式 10/19 文档 ID 第 1 版

11 使用 HTTP 实现 IAP 图 6. IE8 HTTP 头文件格式图 7. Mozilla Firefox HTTP 头文件格式文档 ID 第 1 版 11/19 18

使用 HTTP 实现 IAP 4.2 使用 HTTP 在 STM32F407/STM32F417 上实现 IAP 此 IAP 实现由基于 LwIP 栈的 HTTP Web 服务器组成在浏览器中输入 STM32 的 IP 地址后, 将显示登录 web 页面 ( 图 8) 此登录 web 页面只有已获授权的用户才能使用 IAP 文件上传功能图 8.

h 文件中已预先定义 ), 然后单击 Login( 登录 ) 按钮这将加载文件上传 web 页面 ( 参见图 5) 注 : 1 默认的 User ID( 用户 ID) 为 :use,password( 密码 ) 为 stm32 注 : 2 如果 User ID( 用户 ID) 或 Password( 密码 ) 不正确, 登录 web 页面会重新加载登录成功后,

12 使用 HTTP 实现 IAP 4.2 使用 HTTP 在 STM32F407/STM32F417 上实现 IAP 此 IAP 实现由基于 LwIP 栈的 HTTP Web 服务器组成在浏览器中输入 STM32 的 IP 地址后, 将显示登录 web 页面 ( 图 8) 此登录 web 页面只有已获授权的用户才能使用 IAP 文件上传功能图 8. 登录 web 页面输入正确的 User ID( 用户 ID) 和 Password( 密码 )(main.h 文件中已预先定义 ), 然后单击 Login( 登录 ) 按钮这将加载文件上传 web 页面 ( 参见图 5) 注 : 1 默认的 User ID( 用户 ID) 为 :use,password( 密码 ) 为 stm32 注 : 2 如果 User ID( 用户 ID) 或 Password( 密码 ) 不正确, 登录 web 页面会重新加载登录成功后, 浏览并选择要上传到 STM32 Flash 的二进制文件确保二进制文件大小不超过 STM32 用户 Flash 区域的总容量单击 Upload( 上传 ) 按钮后 ( 参见图 5), 将向服务器发出 POST 请求这时, 服务器开始擦除用户 Flash 区域的全部内容, 等待接收二进制文件原始数据然后将接收到的数据写入用户 Flash 区域注意, 要接收的数据的总长度信息将从传输开始时发出的 HTTP 头文件数据中提取在 IAP 操作结束后,web 页面将指示 IAP 操作成功, 同时显示一个可用于复位 MCU 的按钮图 9. 文件上传完成 web 页面图 10 对使用 HTTP 实现 IAP 方法进行了总结 12/19 文档 ID 第 1 版

13 使用 HTTP 实现 IAP 图 10. 使用 HTTP 实现 IAP 的流程图文档 ID 第 1 版 13/19 18

14 使用 HTTP 实现 IAP 4.3 使用软件要使用 HTTP 对 IAP 进行测试, 需执行以下步骤 : 1. 确保 STM324xG-EVAL 电路板上的跳线设置正确 ( 参见表 2) 2. 在 main.h 文件中, 取消选项 USE_IAP_HTTP 的注释, 另外还可以根据需要取消注释 / 注释其它选项, 例如 USE_DHCP 或 USE_LCD 3. 重新编译软件使用生成的映射文件, 确保 IAP 代码区域之间没有重叠 ( 从地址 0x0 开始 ), 而且用户 Flash 区域从以下地址开始 :USER_FLASH_FIRST_PAGE_ADDRESS ( 在 main.h 中定义 ) 4. 在 STM32 Flash 中编写并运行软件程序 5. 要进入 IAP 模式, 需要在按住按键按钮的同时按下再释放复位按钮 6. 如果在 main.h 文件中定义了 USE_LCD, 则 LCD 屏幕会显示一条消息, 指出已进入 IAP 模式同样, 如果使用的是 DHCP( 在 main.h 中定义的 USE_DHCP),LCD 屏幕也会显示一条消息, 指出 DHCP IP 地址分配是否成功 7. 分配完 IP 地址后 ( 可以是静态或动态地址 ), 用户即可启动 IAP 流程 8. 打开 web 客户端 (Mozilla Firefox 或 Microsoft Internet Explorer), 输入 STM32 IP 地址 9. 会显示登录 web 页面在 User ID( 用户 ID) 字段中输入 user, 在 Password( 密码 ) 字段中输入 stm32, 然后按下 Login( 登录 ) 按钮 10. 这将加载 fileupload.html web 页面浏览到要在 STM32 Flash 中加载的二进制映像, 然后按下 Upload( 上传 ) 按钮, 启动 IAP 进程 11. 如果使能 USE_LCD,IAP 操作的进程会显示在 LCD 上 12. IAP 操作结束后, 将加载新的 web 页面, 指示文件上传操作已成功完成 13. 可以按下 RESET MCU( 复位 MCU) 按钮复位 MCU, 然后在 STM32 Flash 中运行刚刚编写的应用程序注 : 1 如果在使能 USE_LCD 时出现连接问题,LCD 屏幕上会显示一条错误消息, 指示连接故障 2 使用以下 Web 客户端对软件进行测试 :Microsoft Internet Explorer 8 和 Mozilla Firefox 已知限制二进制文件中添加的额外字节 Internet 浏览器 (Microsoft Internet Explorer 或 Mozilla Firefox) 会在上传的二进制文件的末尾添加一个随机边界标记 ( 根据 RFC 1521 的规定, 此标记不得超过 72 个字节 ) 在最新的 IAP 软件版本中, 并没有删除此边界标记, 而是在空间足够的情况下将其存储在 Flash 中如果没有足够空间, 则不会在 Flash 中写入额外字节, 也不会返回错误 14/19 文档 ID 第 1 版

15 环境 5 环境 5.1 MAC 地址和 IP 地址设置在 main.h 文件中对 MAC 地址和 IP 地址进行了定义默认的 MAC 地址固定为 :00:00:00:00:00:02 IP 地址可以设置为静态地址, 也可以设置为由 DHCP 服务器分配的动态地址默认的静态 IP 地址为 : 可以通过在 main.h 文件中使能 USE_DHCP 来选择 DHCP 模式注意, 如果选择由 DHCP 来配置 IP 地址, 但应用程序没有找到它之前在网络中所连接的 DHCP 服务器, 则 IP 地址将自动设置为静态地址 ( ) 5.2 STM324xG-EVAL 电路板上的跳线设置要运行软件, 请按照表 2 中所示来配置 STM324xG-EVAL 电路板在 project\inc 文件夹下的 main.h 文件中选择 MII 和 RMII 配置例如, 要选择 RMII 模式 : //#define MII_MODE #define RMII_MODE 如果在 main.h 文件中对 MII_MODE 和 PHY_CLOCK_MCO 都进行了定义, 则在 MII 模式下, PHY 时钟可以来自外部晶振或者由 STM32 通过 MCO 提供注 : 1 对于 RMII 模式, 必须通过在位于 CN3 下方的 U3 封装中焊接一个 50 MHz 的振荡器 ( 参见 SM7745HEV-50.0M 或相应手册 ) 并断开 JP5 上的跳线来提供 50 MHz 的时钟这个振荡器并未随电路板一同提供有关详细信息, 请参见 STM3240G-EVAL 评估电路板用户手册 UM 在本文档中出现的所有 STM324xG-EVAL 电路板均指 STM3240G-EVAL 和 STM3241G-EVAL 电路板表 2. 跳线配置跳线 MII 模式配置 RMII 模式配置 JP5 1-2: 通过外部晶振提供 25 MHz 时钟 2-3: 通过 PA8 上的 MCO 提供 25 MHz 时钟不适用 JP6 2-3: 使能 MII 接口模式 1-2: 使能 RMII 接口模式 JP8 断开 : 选择 MII 接口模式闭合 : 选择 RMII 接口模式文档 ID 第 1 版 15/19 18

16 环境 5.3 软件文件组成表 3 介绍了项目源文件 : 表 3. 文件组成文件名称说明 main.c main.h httpserver.c /.h tftpserver.c /.h flash_if.c /.h netconf.c /.h stm32f4x7_eth_bsp.c /.h stm32f4x7_it.c /.h fsdata.c lwipopts.h 主应用程序文件主配置文件 HTTP 服务器实现 TFTP 服务器实现高级别 Flash 访问函数高级别以太网接口函数 STM32F4x7 以太网硬件配置中断处理程序作为 ROM 文件系统的 HTML 文件 LwIP 配置选项注 : 表格中没有列出标准固件库和 LwIP 栈中所用的文件 5.4 代码长度测量表 4 中提供了使用 main.h 文件中不同配置选项所得到的代码长度测量结果表 4. 代码长度与配置选项代码长度 ( 字节 ) USE_IAP_TFTP USE_IAP_HTTP USE_LCD USE_DHCP X X X X X X X X X X X X X X X X 注 : 软件使用 IAR EWARM v 进行编译, 并对代码长度进行了高度优化 16/19 文档 ID 第 1 版

17 环境 5.5 构建 IAP 映像为了构建 IAP 映像 ( 将会使用 IAP 软件加载 ), 应确保以下几点 : 1. 编译 / 链接的软件必须从用户 Flash 区域的起始地址开始运行 ( 此地址应与 main.h 的 USER_FLASH_FIRST_PAGE_ADDRESS 中所定义的地址相同 ) 2. 将向量表的起始地址配置为用户 Flash 区域的起始地址可以通过以下两种方法配置向量表的基本偏移量 : a) 在应用程序代码中, 使用 misc.h/.c 驱动程序的 NVIC_SetVectorTable 函数来重新定位应用程序加载地址的向量表例如, 将向量表基本位置设置为 0x : NVIC_SetVectorTable(NVIC_VectTab_FLASH, 0x10000); b) 通过修改 system_stm32f4x7.c 文件中定义的 VECT_TAB_OFFSET 常量的值例如, 将向量表基本位置设置为 0x : #define VECT_TAB_OFFSET 0x 编译后的软件大小不超过用户 Flash 区域的总容量在使用 USART 实现 STM32F40x/STM32F41x 应用编程 (AN3965) 中包括一个软件示例, 介绍如何使用预配置项目来构建要通过 IAP 加载的应用程序文档 ID 第 1 版 17/19 18

18 版本历史 6 版本历史表 5. 文档版本历史日期版本变更 2011 年 10 月 21 日 1 初始版本 18/19 文档 ID 第 1 版

19 请仔细阅读 : 中文翻译仅为方便阅读之目的该翻译也许不是对本文档最新版本的翻译, 如有任何不同, 以最新版本的英文原版文档为准本文档中信息的提供仅与 ST 产品有关意法半导体公司及其子公司 ( ST ) 保留随时对本文档及本文所述产品与服务进行变更更正修改或改进的权利, 恕不另行通知所有 ST 产品均根据 ST 的销售条款出售买方自行负责对本文所述 ST 产品和服务的选择和使用,ST 概不承担与选择或使用本文所述 ST 产品和服务相关的任何责任无论之前是否有过任何形式的表示, 本文档不以任何方式对任何知识产权进行任何明示或默示的授权或许可如果本文档任何部分涉及任何第三方产品或服务, 不应被视为 ST 授权使用此类第三方产品或服务, 或许可其中的任何知识产权, 或者被视为涉及以任何方式使用任何此类第三方产品或服务或其中任何知识产权的保证除非在 ST 的销售条款中另有说明, 否则,ST 对 ST 产品的使用和 / 或销售不做任何明示或默示的保证, 包括但不限于有关适销性适合特定用途 ( 及其依据任何司法管辖区的法律的对应情况 ), 或侵犯任何专利版权或其他知识产权的默示保证意法半导体的产品不得应用于武器此外, 意法半导体产品也不是为下列用途而设计并不得应用于下列用途 :(A) 对安全性有特别要求的应用, 例如, 生命支持主动植入设备或对产品功能安全有要求的系统 ;(B) 航空应用 ;(C) 汽车应用或汽车环境, 且 / 或 (D) 航天应用或航天环境如果意法半导体产品不是为前述应用设计的, 而采购商擅自将其用于前述应用, 即使采购商向意法半导体发出了书面通知, 采购商仍将独自承担因此而导致的任何风险, 意法半导体的产品设计规格明确指定的汽车汽车安全或医疗工业领域专用产品除外根据相关政府主管部门的规定,ESCC QML 或 JAN 正式认证产品适用于航天应用经销的 ST 产品如有不同于本文档中提出的声明和 / 或技术特点的规定, 将立即导致 ST 针对本文所述 ST 产品或服务授予的任何保证失效, 并且不应以任何形式造成或扩大 ST 的任何责任 ST 和 ST 徽标是 ST 在各个国家或地区的商标或注册商标本文档中的信息取代之前提供的所有信息 ST 徽标是意法半导体公司的注册商标其他所有名称是其各自所有者的财产 2013 STMicroelectronics 保留所有权利意法半导体集团公司澳大利亚 - 比利时 - 巴西 - 加拿大 - 中国 - 捷克共和国 - 芬兰 - 法国 - 德国 - 中国香港 - 印度 - 以色列 - 意大利 - 日本 - 马来西亚 - 马耳他 - 摩洛哥菲律宾新加坡 - 西班牙 - 瑞典 - 瑞士 - 英国 - 美国文档 ID 第 1 版 19/19 19

AN3226.fm

AN3226.fm 应用笔记 STM32F107 通过以太网实现在应用中编程 (IAP) 前言本应用笔记的目标读者为使用 STM32F107 微控制器的开发者提供了如何使用 STM32F107 以太网接口实现在应用中编程 (IAP) 的解决方案在 LwIP TCP/IP 协议栈上提供了两种可行的解决方案 : 使用 TFTP ( 简单文件传输协议 ) 的 IAP 使用 HTTP ( 超文本传输协议 ) 的 IAP