STM32 BootLoader 刷新项目 (五) 获取软件版本号-命令0x51
下面我们来讲解第一个指令,获取软件版本号命令-0x51.
在BootLoader中获取软件版本号的操作有多个重要的作用,具体如下:
-
版本管理:
- 识别当前版本:通过获取软件版本号,可以识别当前运行的固件版本。这对于调试、维护和升级都是至关重要的。
- 追踪更新:版本号能够帮助开发团队和用户追踪软件的更新历史,确保每次升级都是有计划和可追溯的。
-
兼容性检查:
- 与硬件兼容性:在一些情况下,不同的软件版本可能对硬件有不同的要求。BootLoader可以根据版本号决定是否继续启动或提示用户进行升级。
- 与其他软件模块兼容性:某些软件模块可能只有在特定版本的固件上才能正常运行。通过检查版本号,BootLoader可以确保所有模块的兼容性。
-
固件升级管理:
- 升级条件判断:在执行固件升级时,BootLoader可以根据当前版本号决定是否需要进行升级,或者是否需要强制进行某些重要升级。
- 回滚机制:如果新的固件版本出现问题,BootLoader可以通过版本号识别和恢复到之前的稳定版本。
-
日志记录和故障诊断:
- 问题追踪:在记录系统日志和诊断故障时,版本号是一个关键参考信息。它可以帮助开发者快速定位问题所在版本,进而更有效地进行修复。
- 客户支持:在提供客户支持时,通过获取软件版本号,可以更准确地了解客户正在使用的版本,从而提供更有针对性的支持和解决方案。
-
安全性:
- 固件验证:在某些安全敏感的应用中,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 刷新项目 (四) 通信协议