AT32讲堂003 | AT32 MCU如何使用USB HID进行IAP升级

IAP在线升级原理概述

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

图1. IAP代码执行流程

在图上图所示流程中，AT32复位后，还是从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

AT32 USB HID IAP快速使用方法

硬件资源

文档中是用AT-START-AT32F403A实验板的硬件条件为例，OTA demo源代码还包括AT32其他型号，用户只需编译对应型号工程烧录于AT-START实验板运行即可。1) 指示灯LED2/LED3/LED42) USART1(PA9/PA10)3) AT-START实验板

软件资源

1. APP_Release

● IAP_Programmer.exe PC机tool

2. SourceCode

● bootloader，IAP源程序，运行LE2闪烁

● app_led3_toggle，app1 LED3闪烁源程序

● app_led4_toggle，app2 LED4闪烁源程序

注：工程基于keil v5和IAR8.2建立，若用户需要在其他编译环境上使用，请参考

AT32F403A_407_Firmware_Library_V2.x.x\project\at_start_f403a\templates中各种编译环境（例如IAR6/7/8,keil 4/5,eclipse_gcc）进行对应修改即可。

IAP Programmer使用

1. 打开bootloader源程序，编译后下载到实验板

2. 打开IAP Programmer.exe3. 如图，选择USB设备,使用的是HID设备，因此不需要驱动4. 选择APP下载地址（下载地址需要与IAP设置的下载地址相同）和bin文档，选择是否需要CRC校验，点击Download下载5. 观察LED2/3/4闪烁，LED2闪烁-bootloader工作，LED3闪烁-app1工作，LED4闪烁-app2工作6. 支持断电保护，当程序没有download成功时，下次启动还在IAP模式

图2. IAP demo上位机

AT32 USB HID IAP程序设置

地址分布

表1. 地址分布

Note：bootloader区域最后一个扇区，用于放置防掉电丢失的flag，用户修改bootloader时请勿操作该段地址。

bootloader project设置

1) Keil设置

图3. bootloader project中add1在Keil设置

2)bootloader源程序修改

hid_iap_user.h文件中

图4. bootloader project中add2在程序中设置

app设置

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

1.Keil工程设置

图5. app project中add2在Keil设置

2.app源程序设置

修改main.c中的中断向量偏移

图6. app源程序设置

3. 编译生成bin文件

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

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

4. 开启debug app code功能

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

● 下载bootloader project

● 第一次使用debug功能需要IAP Programmer.exe成功下载一次app.(成功下载之后会写flag，表示下次从app启动。默认flag会从bootloader启动)

● debug app project

IAP、APP与上位机通信流程

1. 上位机通信流程

图7. 上位机通信流程

2. IAP端下位机通信流程

图8. IAP端下位机通信流程

注意：具体协议请参考AT32_HID_IAP_Protocol.pdf

USB HID IAP Protocol

本节描述USB HID升级协议，使用此协议与上位机进行通信，达到升级固件的目的。

命令列表

注意1：HID MaxPacket=64Byte

注意2：每一个包的前面两个Byte固定为命令

注意3：命令按照MSB,LSB的顺序传输

ACK：0XFF00，NACK：0x00FF

命令详解

1. 0x5AA0进入IAP模式

作为一个特定的命令，当用户APP收到这个命令之后将进入IAP模式。实现方式为收到这个命令之后擦除flag然后reset

上位机：[0x5A,0xA0]

IAP设备响应：[0x5A,0XA0,ACK/NACK]

2. 0x5AA1开始下载

上位机：[0x5A,0xA1]

IAP设备响应：[0x5A,0xA1,ACK/NACK]

3. 0x5AA2设置下载地址

设置下载地址需按照1KB对齐，每下载1Kbyte数据之后，都需要重新设置下载地址。

上位机(命令+地址)：[0x5A,0xA2,0x08,0x00,0x40,0x00]

IAP设备响应：[0x5A,0xA2,ACK/NACK]

4. 0x5AA3下载数据命令(1KB对齐多个包发送)

下载数据命令采用命令+长度+数据的格式进行发送，每包最大数据量为60Byte（64–命令–长度），当发送数据达到1KB时，上位机需要等待设备的ACK响应。此时设备需将1KB的数据写到FLASH。

上位机（命令(2Byte)+长度(2Byte)+数据(nbyte)）:[0x5A,0xA3,LEN1,LEN0,DATA0….DATAn]

收完1KB数据后IAP设备响应：[0x5A,0XA3,ACK/NACK]

5. 0x5AA4下载结束

上位机：[0x5A,0xA4]

IAP设备响应：[0x5A,0xA4,ACK/NACK]

6. 0x5AA5固件CRC校验

上位机传输固件起始地址和固件大小/1KB（固件大小按1KB对齐，不足补0xFF），由IAP计算CRC之后返回给上位机。

上位机：[0x5A,0xA5,0x08,0x00,0x40,0x00,LEN1,LEN0]

IAP设备响应：[0x5A,0xA5,ACK/NACK,CRC3,CRC2,CRC1,CRC0]

7. 0x5AA6跳转命令

跳转命令将跳转到用户代码进行运行

上位机：[0x5A,0xA6,0x08,0x00,0x40,0x00]

IAP设备响应：[0x5A,0xA6,ACK/NACK]

8. 0x5AA7获取IAP设置的app地址

返回IAP设置的app地址

上位机：[0x5A,0xA7]

IAP设备响应：[0x5A,0xA7,ACK/NACK,0x08,0x00,0x40,0x00]

关于雅特力雅特力科技于2016年成立，是一家致力于推动全球市场32位微控制器创新趋势的芯片(MCU)设计公司，专注于ARM Cortex-M4/M0+的32位微控制器研发与创新，全系列采用55nm先进工艺及ARM Cortex-M4高效能或M0+低功耗内核，缔造M4业界最高主频288MHz运算效能，并支持工业级别芯片工作温度范围（-40°~105°）。雅特力目前已累积相当多元的终端产品成功案例：如微型打印机、扫地机、光流无人机、热成像仪、激光雷达、工业缝纫机、伺服驱控、电竞周边市场、断路器、ADAS、T-BOX、数字电源、电动工具等终端设备应用，广泛地覆盖5G、物联网、消费、商务及工控等领域。