IAP-应用编程

本篇总结

使用 IAP，通过板载按键实现固件在线升级与跳转运行。

硬件平台：本例程基于 W55MH32L-EVB 开发板运行。

采购推荐：点击前往 WIZnet 官方淘宝店铺 选购 W55MH32L-EVB

IAP 程序的两条硬性要求

• 新程序必须在 Bootloader 之后的某个偏移量为 x 的地址开始；
• 必须将新程序的中断向量表相应移动，移动的偏移量为 x。

#ifndef __KEY_H
#define __KEY_H

#include <stdlib.h>
#include <string.h>
#include <stdio.h>
#include "delay.h"
#include "w55mh32.h"

/* 板载 USER 按键：PG6（一端接 GND，内部上拉，按下拉低） */
#define KEY_PIN    GPIO_Pin_6
#define KEY_GROUP  GPIOG
#define KEY_PERIPH RCC_APB2Periph_GPIOG

#define KEY GPIO_ReadInputDataBit(KEY_GROUP, KEY_PIN)

#define KEY1_PRES 1   /* 长按 PG6 (>2s)：更新固件（Copy To FLASH） */
#define KEY2_PRES 2   /* 短按 PG6：运行 APP（Run FLASH APP） */

void    KEY_Init(void);
uint8_t KEY_Scan(void);

#endif

#include "key.h"

void KEY_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStructure;

    RCC_APB2PeriphClockCmd(KEY_PERIPH, ENABLE);

    GPIO_InitStructure.GPIO_Pin  = KEY_PIN;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU;
    GPIO_Init(KEY_GROUP, &GPIO_InitStructure);
}

/*
 * 单按键（PG6）长短按识别：
 *   长按 (>2s) -> KEY1_PRES：更新固件（Copy To FLASH）
 *   短按       -> KEY2_PRES：运行 APP（Run FLASH APP）
 * 板载仅一个 USER 按键，故用长短按区分两种操作。
 */
uint8_t KEY_Scan(void)
{
    uint16_t t = 0;

    if (KEY == 0)
    {
        delay_ms(10);   /* de-dithering */
        if (KEY == 0)
        {
            /* 统计按键持续按下的时长，达到 2s 即可判定为长按 */
            while (KEY == 0)
            {
                delay_ms(10);
                t++;
                if (t >= 200)   /* 200 * 10ms = 2s */
                {
                    break;
                }
            }
            /* 等待按键释放 */
            while (KEY == 0);

            if (t >= 200)
            {
                return KEY1_PRES;   /* 长按：更新固件 */
            }
            else
            {
                return KEY2_PRES;   /* 短按：运行 APP */
            }
        }
    }
    return 0;
}

如果你想自定义

• 调整长按阈值 → 修改 if (t >= 200) 中的数值，如改为 100 即为 1s 长按
• 换用其他按键引脚 → 同步修改 key.h 中的 KEY_PIN / KEY_GROUP / KEY_PERIPH 三个宏

void NVIC_Configuration(void)
{
    NVIC_InitTypeDef NVIC_InitStructure;

    NVIC_InitStructure.NVIC_IRQChannel                   = USART1_IRQn;
    NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 0;
    NVIC_InitStructure.NVIC_IRQChannelSubPriority        = 0;
    NVIC_InitStructure.NVIC_IRQChannelCmd                = ENABLE;
    NVIC_Init(&NVIC_InitStructure);
}

void UART_Configuration(uint32_t bound)
{
    GPIO_InitTypeDef  GPIO_InitStructure;
    USART_InitTypeDef USART_InitStructure;

    RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE);
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);

    /* PA9: USART1_TX → 复用推挽输出 */
    GPIO_InitStructure.GPIO_Pin   = GPIO_Pin_9;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_InitStructure.GPIO_Mode  = GPIO_Mode_AF_PP;
    GPIO_Init(GPIOA, &GPIO_InitStructure);

    /* PA10: USART1_RX → 浮空输入 */
    GPIO_InitStructure.GPIO_Pin  = GPIO_Pin_10;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING;
    GPIO_Init(GPIOA, &GPIO_InitStructure);

    /* USART 参数：115200 / 8N1 / 全双工 */
    USART_InitStructure.USART_BaudRate            = bound;
    USART_InitStructure.USART_WordLength          = USART_WordLength_8b;
    USART_InitStructure.USART_StopBits            = USART_StopBits_1;
    USART_InitStructure.USART_Parity              = USART_Parity_No;
    USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;
    USART_InitStructure.USART_Mode                = USART_Mode_Rx | USART_Mode_Tx;

    USART_Init(USART_TEST, &USART_InitStructure);
    USART_ITConfig(USART_TEST, USART_IT_RXNE, ENABLE);
    USART_Cmd(USART_TEST, ENABLE);
}

void USART1_IRQHandler(void)
{
    uint8_t res;
    if (USART_GetFlagStatus(USART_TEST, USART_FLAG_RXNE))
    {
        res = USART_ReceiveData(USART_TEST);
        if (USART_RX_CNT < USART_REC_LEN)
        {
            USART_RX_BUF[USART_RX_CNT] = res;
            USART_RX_CNT++;
        }
    }
}

#include <stdlib.h>
#include <string.h>
#include <stdio.h>
#include "delay.h"
#include "w55mh32.h"
#include "key.h"
#include "iap.h"

USART_TypeDef *USART_TEST = USART1;
#define USART_REC_LEN 32 * 1024 //Define the maximum number of received bytes 32K

void UART_Configuration(uint32_t bound);
void NVIC_Configuration(void);

uint16_t USART_RX_STA = 0; //receive status flag
uint16_t USART_RX_CNT = 0; //Number of bytes received
uint8_t  USART_RX_BUF[USART_REC_LEN] __attribute__((at(0X20001000)));

int main(void)
{
    uint8_t  key;
    uint16_t oldcount = 0; //The old serial port receives the data value.
    uint16_t applenth = 0; //The length of the received app code

    RCC_ClocksTypeDef clocks;

    delay_init();
    UART_Configuration(115200);
    NVIC_Configuration();
    RCC_GetClocksFreq(&clocks);

    printf("\n");
    printf("SYSCLK: %3.1fMhz, HCLK: %3.1fMhz, PCLK1: %3.1fMhz, PCLK2: %3.1fMhz, ADCCLK: %3.1fMhz\n",
           (float)clocks.SYSCLK_Frequency / 1000000, (float)clocks.HCLK_Frequency / 1000000,
           (float)clocks.PCLK1_Frequency / 1000000, (float)clocks.PCLK2_Frequency / 1000000, (float)clocks.ADCCLK_Frequency / 1000000);

    printf("IAP Bootloader Test.\n");
    printf("Long  press PG6: Copy To FLASH (update firmware)\n");
    printf("Short press PG6: Run FLASH APP\n");

    KEY_Init();
    while (1)
    {
        if (USART_RX_CNT)
        {
            if (oldcount == USART_RX_CNT)
            {
                applenth     = USART_RX_CNT;
                oldcount     = 0;
                USART_RX_CNT = 0;
                printf("User program reception complete!\r\n");
                printf("code length:%dBytes\r\n", applenth);
            }
            else
            {
                oldcount = USART_RX_CNT;
            }
        }

        delay_ms(100);

        key = KEY_Scan();
        if (key == KEY1_PRES)
        {
            if (applenth)
            {
                printf("Start updating firmware...\r\n");
                printf("Copying To FLASH...\n");
                if (((*(vu32 *)(0X20001000 + 4)) & 0xFF000000) == 0x08000000)  //Determine whether it is 0X08XXXXXX.
                {
                    IAP_Write_Appbin(FLASH_APP1_ADDR, USART_RX_BUF, applenth); //Update Flash Code
                    printf("Copy APP Successed!!\n");
                    printf("Firmware update complete!\r\n");
                }
                else
                {
                    printf("Illegal FLASH APP!  \n");
                    printf("Non-flash applications!\r\n");
                }
            }
            else
            {
                printf("There is no firmware that can be updated!\r\n");
                printf("No APP!\n");
            }
        }

        if (key == KEY2_PRES)
        {
            printf("Start executing FLASH user code!!\r\n");
            if (((*(vu32 *)(FLASH_APP1_ADDR + 4)) & 0xFF000000) == 0x08000000) //Determine whether it is 0X08XXXXXX.
            {
                IAP_Load_App(FLASH_APP1_ADDR);                                 //Execute FLASH APP code
            }
            else
            {
                printf("Non-FLASH applications cannot be executed!\r\n");
                printf("Illegal FLASH APP!\n");
            }
        }
    }
}

如果你想自定义

• 改 APP 起始地址 → 修改 iap.h 中的 FLASH_APP1_ADDR 宏，同时同步修改 APP 工程的 Keil Target 设置（IROM1 Start）和中断向量表偏移
• 改缓冲区大小 → 修改 USART_REC_LEN 宏定义，注意不得超过 SRAM 容量
• 换用其他通信口 → 同步修改 GPIO 引脚和对应的时钟使能宏，如改用 USART2 需注意其挂在 APB1

int SER_PutChar(int ch)
{
    while (!USART_GetFlagStatus(USART_TEST, USART_FLAG_TC));
    USART_SendData(USART_TEST, (uint8_t)ch);

    return ch;
}

int fputc(int c, FILE *f)
{
    /* Place your implementation of fputc here */
    /* e.g. write a character to the USART */
    if (c == '\n')
    {
        SER_PutChar('\r');
    }
    return (SER_PutChar(c));
}