STM32 BootLoader 刷新项目 (五) 获取软件版本号-命令0x51

下面我们来讲解第一个指令，获取软件版本号命令-0x51.

在BootLoader中获取软件版本号的操作有多个重要的作用，具体如下：

1. 版本管理：

   • 识别当前版本：通过获取软件版本号，可以识别当前运行的固件版本。这对于调试、维护和升级都是至关重要的。
   • 追踪更新：版本号能够帮助开发团队和用户追踪软件的更新历史，确保每次升级都是有计划和可追溯的。

2. 兼容性检查：

   • 与硬件兼容性：在一些情况下，不同的软件版本可能对硬件有不同的要求。BootLoader可以根据版本号决定是否继续启动或提示用户进行升级。
   • 与其他软件模块兼容性：某些软件模块可能只有在特定版本的固件上才能正常运行。通过检查版本号，BootLoader可以确保所有模块的兼容性。

3. 固件升级管理：

   • 升级条件判断：在执行固件升级时，BootLoader可以根据当前版本号决定是否需要进行升级，或者是否需要强制进行某些重要升级。
   • 回滚机制：如果新的固件版本出现问题，BootLoader可以通过版本号识别和恢复到之前的稳定版本。

4. 日志记录和故障诊断：

   • 问题追踪：在记录系统日志和诊断故障时，版本号是一个关键参考信息。它可以帮助开发者快速定位问题所在版本，进而更有效地进行修复。
   • 客户支持：在提供客户支持时，通过获取软件版本号，可以更准确地了解客户正在使用的版本，从而提供更有针对性的支持和解决方案。

5. 安全性：

   • 固件验证：在某些安全敏感的应用中，BootLoader需要验证固件的完整性和来源。版本号可以作为验证过程的一部分，确保固件未被篡改或替换。
   • 防止回滚攻击：通过检查版本号，可以防止系统被降级到存在已知漏洞的老版本，从而提高系统的整体安全性。

总的来说，BootLoader中获取软件版本号的操作在版本管理、兼容性检查、升级管理、故障诊断和安全性等方面都起着至关重要的作用，是确保嵌入式系统稳定、可靠和安全运行的重要手段。

前面我们讲过了整个BootLoader的方案、架构以及协议，下面我们来具体讲解每一个命令该如何编程。

下面我们来讲解第一个指令，获取软件版本号命令-0x51.

主机发送	命令码	BootLoader回复	备注
BL_GET_VER	0x51	BootLoader版本号(1 byte)	从MCU中读BootLoader的版本号

下面是上位机的命令菜单：

输入1，则通过上位机发送指令：发送的数据为0x05, 0x51, 0xe7, 0xe9, 0xab, 0x7c.

启动第一个字节，为接下来要发送数据的长度，即为5个字节，第二个字节为0x51，即为上面获取软件版本号的指令，后四位为前两位的CRC校验位。

BL_GET_VER指令为获取软件版本号：

下面是用Python写的上位机代码：

def decode_menu_command_code(command):ret_value = 0data_buf = []for i in range(255):data_buf.append(0)if(command  == 0 ):print("\n   Exiting...!")raise SystemExitelif(command == 1):print("\n   Command == > BL_GET_VER")COMMAND_BL_GET_VER_LEN              = 6data_buf[0] = COMMAND_BL_GET_VER_LEN-1 data_buf[1] = COMMAND_BL_GET_VER crc32       = get_crc(data_buf,COMMAND_BL_GET_VER_LEN-4)crc32 = crc32 & 0xffffffffdata_buf[2] = word_to_byte(crc32,1,1) data_buf[3] = word_to_byte(crc32,2,1) data_buf[4] = word_to_byte(crc32,3,1) data_buf[5] = word_to_byte(crc32,4,1) Write_to_serial_port(data_buf[0],1)for i in data_buf[1:COMMAND_BL_GET_VER_LEN]:Write_to_serial_port(i,COMMAND_BL_GET_VER_LEN-1)ret_value = read_bootloader_reply(data_buf[1])

通过读取上位机终端输入的“1”，知道是要获取软件版本号的命令，则按照规定先发送数据长度5，在发送命令指令0x51，在计算前两位的CRC值，总共6byte的数据发送给下位机。下位机收到数据按协议进行相应的解析。

下面通过bootloader_uart_read_data()函数，首先读出上位机发送过来的0x05，表示后续要接收5个字节的数据。后续则按5个字节的数据来接收数据。

之后收到的数据是： 0x51, 0xe7, 0xe9, 0xab, 0x7c.

通过switch语句，判断0x51，则进入bootloader_handle_getver_cmd(bl_rx_buffer)，来回去软件版本号的函数。

void  bootloader_uart_read_data(void)
{uint8_t rcv_len=0;printmsg_Host("BL_DEBUG_MSG: Receive CMD\n\r");while (1){memset(bl_rx_buffer, 0, 200);//here we will read and decode the commands coming from host//first read only one byte from the host , which is the "length" field of the command packetHAL_UART_Receive(C_UART,bl_rx_buffer,1,HAL_MAX_DELAY);rcv_len= bl_rx_buffer[0];HAL_UART_Receive(C_UART,&bl_rx_buffer[1],rcv_len,HAL_MAX_DELAY);switch(bl_rx_buffer[1]){case BL_GET_VER:bootloader_handle_getver_cmd(bl_rx_buffer);break;default:printmsg("BL_DEBUG_MSG:Invalid command code received from host \n");break;}}}

进入到bootloader_handle_getver_cmd()函数来获取软件版本号，首先计算排除后四位CRC数据前面收到数据的CRC值。如果计算出CRC的值，在和之前上位机发送的CRC，如果正确则进行软件版本号。

/*Helper function to handle BL_GET_VER command */
void bootloader_handle_getver_cmd(uint8_t *bl_rx_buffer)
{uint8_t bl_version;// 1) verify the checksumprintmsg("BL_DEBUG_MSG:bootloader_handle_getver_cmd\n");//Total length of the command packetuint32_t command_packet_len = bl_rx_buffer[0]+1 ;//extract the CRC32 sent by the Hostuint32_t host_crc = *((uint32_t * ) (bl_rx_buffer+command_packet_len - 4) ) ;if (! bootloader_verify_crc(&bl_rx_buffer[0],command_packet_len-4,host_crc)){printmsg("BL_DEBUG_MSG:checksum success !!\n");// checksum is correct..bootloader_send_ack(bl_rx_buffer[0], 1);bl_version = get_bootloader_version();printmsg("BL_DEBUG_MSG:BL_VER : %d %#x\n",bl_version,bl_version);bootloader_uart_write_data(&bl_version,1);}else{printmsg("BL_DEBUG_MSG:checksum fail !!\n");//checksum is wrong send nackbootloader_send_nack();}
}

下面则通过HAL库中计算CRC的值。

/* This verifies the CRC of the given buffer in pData. */
uint8_t bootloader_verify_crc (uint8_t *pData, uint32_t len, uint32_t crc_host)
{uint32_t uwCRCValue = 0xff;for (uint32_t i=0 ; i < len ; i++){uint32_t i_data = pData[i];uwCRCValue = HAL_CRC_Accumulate(&hcrc, &i_data, 1);}/* Reset CRC Calculation Unit */__HAL_CRC_DR_RESET(&hcrc);if( uwCRCValue == crc_host){return VERIFY_CRC_SUCCESS;}return VERIFY_CRC_FAIL;
}

通过下面的函数返回软件版本号。

/* Just returns the macro value. */
uint8_t get_bootloader_version(void)
{return (uint8_t)BL_VERSION;
}

如果正确的传输，则发送ACK让上位机接收。

/* This function sends ACK if CRC matches along with "len to follow" */
void bootloader_send_ack(uint8_t command_code, uint8_t follow_len)
{//here we send 2 byte.. first byte is ack and the second byte is len valueuint8_t ack_buf[2];ack_buf[0] = BL_ACK;ack_buf[1] = follow_len;HAL_UART_Transmit(C_UART, ack_buf,2, HAL_MAX_DELAY);}

如果错误的话，则传输NACK给上位机传输。

/* This function sends NACK */
void bootloader_send_nack(void)
{uint8_t nack = BL_NACK;HAL_UART_Transmit(C_UART, &nack, 1, HAL_MAX_DELAY);
}

下面则为执行命令1，0x51命令，则正确返回软件版本号。

至此，获取软件版本号命令0x51的整个流程已经梳理完成。

往期文章请参考：

STM32 BootLoader 刷新项目 (一) STM32CubeMX UART串口通信工程搭建

STM32 BootLoader 刷新项目 (二) 方案介绍

STM32 BootLoader 刷新项目 (三) 程序框架搭建及刷新演示

STM32 BootLoader 刷新项目 (四) 通信协议