AT32 IAP using the USART

AN0001 应用笔记

AT32 IAP using the USART

前言

对于AT32 MCU，除了出厂固化的bootloader，用户也可以在应用程序中编写自己的bootloader程序，用于最终产品的固件更新。此功能称为应用程序内编程（IAP）。

本应用笔记的目的是提供在AT32微控制器上创建IAP应用程序的一般准则。

AT32微控制器可以运行用户特定的固件来对微控制器中嵌入的闪存执行IAP。此功能可以使用产品可用和支持的任何通信接口。使用自定义协议协议的USART是本应用笔记中的示例。

IAP_Programmer.exe上位机软件和嵌入式IAP USART示例的源代码位于BSP固件库的utilities文件夹内。

支持型号列表：

支持型号

AT32全系列

目录

1                   概述... 5

1.1        AT32 USART IAP快速使用方法... 7

1.1.1     硬件资源... 7

1.1.2     软件资源... 7

1.2        IAP demo使用... 7

2                   AT32 USART IAP程序设置.. 8

2.1        地址分布... 8

2.2        执行流程... 8

2.3        bootloader project设置... 8

2.4        app project设置... 9

3                   bootloader/app与上位机串口通信协议.. 11

4                   版本历史.. 14

表目录

表1. 地址分布... 8

表2. 文档版本历史... 14

图目录

图1. IAP 代码执行流程... 5

图2. IAP demo上位机... 7

图3. 程序执行流程... 8

图4. bootloader project中address 1在Keil设置... 9

图5. bootloader project中address 2在程序中设置... 9

图6. app project中address 2在Keil设置... 9

图7. app project向量表偏移在程序中设置... 10

图8. 上位机通信协议... 11

图9. IAP 端下位机通信协议... 12

1. 概述

IAP（In Application Programming）即在应用编程，IAP是用户自己的程序在运行过程中对User Flash的部分区域进行烧写，目的是为了在产品发布后可以方便地通过预留的通信口对产品中的固件程序进行更新升级。通常实现IAP功能时，即用户程序运行中作自身的更新操作，需要在设计固件程序时编写两个项目代码，第一个项目程序不执行正常的功能操作，而只是通过某种通信方式(如USB、USART)接收程序或数据，执行对第二部分代码的更新；第二个项目代码才是真正的功能代码。这两部分项目代码都同时烧录在User Flash中，当芯片上电后，首先是第一个项目代码开始运行，它作如下操作：

1. 检查是否需要对第二部分代码进行更新
2. 如果不需要更新则转到4)
3. 执行更新操作
4. 跳转到第二部分代码执行

图1. IAP 代码执行流程

在上图所示流程中，MCU复位后，还是从0x08000004地址取出复位中断向量的地址，并跳转到复位中断服务程序，在运行完复位中断服务程序之后跳转到IAP的main函数，如图标号①所示；在执行完IAP以后（即将新的APP代码写入AT32的FLASH，灰底部分。新程序的复位中断向量起始地址为0x08000004+N+M），跳转至新写入程序的复位向量表，取出新程序的复位中断向量的地址，并跳转执行新程序的复位中断服务程序，随后跳转至新程序的main函数，如图标号②和③所示，同样main函数为一个死循环，并且注意到此时AT32的FLASH，在不同位置上，共有两个中断向量表。

在main函数执行过程中，如果CPU得到一个中断请求，PC指针仍强制跳转到地址0x08000004中断向量表处，而不是新程序的中断向量表，如图标号④所示；程序再根据我们设置的中断向量表偏移量，跳转到对应中断源新的中断服务程序中，如图标号⑤所示；在执行完中断服务程序后，程序返回main函数继续运行，如图标号⑥所示。

通过以上两个过程的分析，我们知道IAP程序必须满足两个要求：

1. 新程序必须在IAP程序之后的某个偏移量为x的地址开始
2. 必须将新程序的中断向量表相应的移动，移动的偏移量为x

1. 1. AT32 USART IAP快速使用方法
      1. 硬件资源

文档中是用AT-START-AT32F403A实验板的硬件条件为例，IAP demo源代码还包括AT32其他型号，用户只需编译对应型号工程烧录于AT-START实验板运行即可。

1. 指示灯LED2/LED3/LED4
2. USART1(PA9/PA10)
3. AT-START实验板
   1. 1. 软件资源

1. tool_release

1. IAP_Programmer.exe，PC机tool，用于演示IAP升级流程

1. source_code

1. bootloader，bootloader源程序，运行LED2闪烁

1. app_led3_toggle，app1源程序，运行LED3闪烁
2. app_led4_toggle，app2源程序，运行LED4闪烁

注：源码位于AT32F403A_407_Firmware_Library_V2.x.x\utilities\at32f403a_407_usart_iap_demo\source_code，示例工程基于keil v5和IAR8.2建立，若用户需要在其他编译环境上使用，请参考AT32F403A_407_Firmware_Library_V2.x.x\project\at_start_f403a\templates中各种编译环境（例如IAR6/7/8,keil 4/5, eclipse_gcc）进行对应修改即可。

1. 1. IAP demo使用
2. 打开bootloader工程源程序，选择对应MCU型号的target编译后下载到实验板
3. 打开IAP_Programmer.exe
4. 选择正确的串口、APP下载地址和bin文档，点击Download下载，如下图
5. 观察LED2/3/4闪烁，LED2闪烁-bootloader工作，LED3闪烁-app1工作，LED4闪烁-app2工作

图2. IAP demo上位机

1. AT3 USART IAP程序设置
   1. 地址分布

表1. 地址分布

ITEM	Address and Size
app code	address 2: 0x800 4000   size: 0x40000(256K Byte)
bootloader code	address 1: 0x800 0000   size: 0x4000(16K Byte)

注：bootloader区域最后一个扇区，用于存放防止升级过程掉电的flag，用户编译修改bootloader时，要保证不覆盖flag的地址。

1. 1. 执行流程

IAP分为Bootloader和App两部分，应用在App中执行，升级过程在bootloader中执行。程序执行整体流程框图如下：

图3. 程序执行流程

1. 1. bootloader project设置
2. Keil设置

图4. bootloader project中address 1在Keil设置

1. bootloader源程序修改Iap.h文件中

图5. bootloader project中address 2在程序中设置

1. 1. app project设置

IAP demo提供了2个app程序供测试用，皆以address 2（0x800 4000）为起始地址。app1 LED3闪烁，app2 LED4闪烁。以app1为例，设计步骤如下：

1. Keil工程设置

图6. app project中address 2在Keil设置

1. app1 源程序设置

图7. app project向量表偏移在程序中设置

1. 编译生成bin文件

通过User选项卡，设置编译后调用fromelf.exe，根据.axf文件生成.bin文件，用于IAP更新。

通过以上3个步骤，我们就可以得到一个.bin的APP程序，通过bootloader程序即可实现更新。

1. 开启debug app code功能

如果在设计app code过程中需要对app project进行单独调试，请按照以下操作。

1. 先下载bootloader工程
2. 再调试app工程

1. bootloader/app与上位机串口通信协议

1. 上位机通信协议

图8. 上位机通信协议

1. IAP 端下位机通信协议

图9. IAP 端下位机通信协议

MSB first

注:             ACK:   0xCCDD

                 NACK:  0xEEFF

                 Data:  0x31+ Addr + 数据 +  chenksum（1byte）

                 Addr：4bytes，高位在前

                 Kbytes，下载数据，不足2K内容填充0xFF

                 Checksum：1byte，4bytes的Addr + 2KBytes数据的校验和的低八位

1. 版本历史

表2. 文档版本历史

日期	版本	变更
2021.05.21	2.0.0	初始版本
2022.01.19	2.0.1	增加程序执行流程图
2023.02.08	2.0.2	增加sourcecode在BSP中的路径描述