MSP432 BSL流程（UART）

升级流程

PC程序会解析脚本中的命令，根据命令码做相应的操作。数据来自于命令后的文件（当前目录下的数据文件）

# cat script_P4xx_uart.txtLOG     //记录日志MODE P4xx UART 9600 COM25 PARITY    //初始化串口RX_PASSWORD_32 .\pass256_wrong.txt  //解锁BSLRX_PASSWORD_32 .\pass256_default.txtMASS_ERASE      //擦除整块flashRX_DATA_BLOCK_32 Blink_LED.txt  //写flash//RX_DATA_BLOCK_32 Blink_LED.hexTX_BSL_VERSION_32   //获取bsl versionTX_DATA_BLOCK_32 0x0000 0x4000 ReadBlock_MSP432P401R.txt    //读flash//TX_DATA_BLOCK_32 0x0000 0x4000 ReadBlock_MSP432P401R.hexREBOOT_RESET    //复位

数据结构

PC侧

COMMANDS
需要处理的命令列表，所有的操作都是以命令形式触发

#define COMMANDS(DO) \    DO(LOG) \    DO(MODE) \    DO(RX_DATA_BLOCK) \    DO(RX_PASSWORD) \    DO(ERASE_SEGMENT) \    DO(TOGGLE_INFO) \    DO(ERASE_BLOCK) \    DO(MASS_ERASE) \    DO(CRC_CHECK) \    DO(SET_PC) \    DO(TX_DATA_BLOCK) \    DO(TX_BSL_VERSION) \    DO(TX_BUFFER_SIZE) \    DO(RX_DATA_BLOCK_FAST) \    DO(RX_DATA_BLOCK_32) \    DO(RX_PASSWORD_32) \    DO(ERASE_SEGMENT_32) \    DO(REBOOT_RESET) \    DO(CRC_CHECK_32) \    DO(SET_PC_32) \    DO(TX_DATA_BLOCK_32) \    DO(TX_BSL_VERSION_32) \    DO(RX_SECURE_DATA_BLOCK) \    DO(CHANGE_BAUD_RATE) \    DO(FACTORY_RESET) \    DO(JTAG_LOCK) \    DO(JTAG_PASSWORD) \    DO(VERBOSE) \    DO(DELAY) \    DO(CUSTOM_COMMAND)

主要函数
命令处理中，主要命令处理函数是：接收命令处理函数和发送命令处理函数

void Interpreter::executeCommand(CommandParams cmd);    //命令处理void Interpreter::executeRxCommand();       //接收命令void Interpreter::executeTxCommand();       //发送命令void UartComm::transmitBuffer(std::vector<uint8_t>* txBuffer);  //发送数据std::vector<uint8_t>* UartComm::receiveBuffer(int32_t size);    //接收数据

init
初始化的时候，PC发送一个字节“0xFF”,MSP432去计算波特率，然后回应PC一个字节“0x00”,初始化成功。连续发送10次，直到初始化成功，否则初始化失败

void UartComm::init(ModeParams* modeParams);void UartComm::transmitP4xxInitialization();const uint8_t loopInitialization = 10;

transmitBuffer
每当发送数据完成，PC端都会验证MSP432回应的ACK是否正确，如果不正确，很可能MSP432没有接收到数据

Header = 0x80txBuffer->size() & 0xFF(txBuffer->size() >> 8) & 0xFFtxBuffer        //数据getCheckSumLow()getCheckSumHigh()

receiveBuffer
接收数据格式和发送数据格式一致。接收延时1000ms，接收端会首先接收并检查ack是否正确，接收buf是256个字节

uint32_t msDelay = 1000;this->setTimer(msDelay);this->startReadAck(&ack, expSize);Header = 0x80rxUartBuffer = 256

MSP432侧

中断注册

#define BSL432_MAX_BUFFER_SIZE 262  //buf大小262个字节volatile uint8_t BSL432_RAM_TX_Buf[BSL432_MAX_BUFFER_SIZE + 6]; //6：Header + Buffersize + CheckSum

MAP_GPIO_registerInterrupt(BSL432_UART_PORT, BSL432_PI_UARTdetect);BSL432_PI_initUART(BSL432_UARTBaudRates9600);BSL432_PI_sendByteUART(BSL432_ACK);

BSL432_PI_UARTdetect：中断处理函数。响应PC端初始化流程，计算波特率并初始化UART，最后回应PC ACK

MAP_UART_registerInterrupt(BSL432_UART_MODULE, BSL432_PI_IRQ_UART);void BSL432_PI_IRQ_UART(void);uint8_t receivedData = MAP_UART_receiveData(BSL432_UART_MODULE);BSL432_ReceiveBuffer[BSL432_PI_IRQ_RxDataCnt++] = receivedData;

BSL432_PI_IRQ_UART：接收中断处理函数。当有中断触发，MSP432开始接收数据，把数据保存到BSL432_ReceiveBuffer中，直到接收完成

数据解析

BSL432_eventFlags BSL432_PI_receivePacketUART();

数据解析由BSL432_PI_receivePacketUART函数完成。主要功能是校验头，记录数据大小，校验checksum
BSL循环去接收串口数据，直到收完指定Buffersize大小，做一次处理

数据处理

void BSL432_CI_interpretCommand();

当一个正确的包接收并解析完成，由BSL432_CI_interpretCommand做数据处理并回应PC ACK

BSL432 Commands
BSL侧命令列表，和PC侧是一一对应的

#define BSL432_RX_DATA_BLOCK     0x10#define BSL432_RX_DATA_BLOCK_32  0x20#define BSL432_RX_PASSWORD       0x21#define BSL432_ERASE_SECTOR      0x12#define BSL432_ERASE_SECTOR_32   0x22#define BSL432_RX_MASS_ERASE     0x15#define BSL432_REBOOT_RESET      0x25#define BSL432_RX_CRC_CHECK      0x16#define BSL432_RX_CRC_CHECK_32   0x26#define BSL432_RX_LOAD_PC        0x17#define BSL432_RX_LOAD_PC_32     0x27#define BSL432_TX_DATA_BLOCK     0x18#define BSL432_TX_DATA_BLOCK_32  0x28#define BSL432_TX_BSL_VERSION    0x19#define BSL432_FACTORY_RESET     0x30#define BSL432_CHANGE_BAUD_RATE  0x52

BSL432_RX_DATA_BLOCK

void BSL432_CI_receiveDataBlock(uint32_t addr, uint8_t *data){    uint8_t returnValue = BSL432_API_openMemory(); //flash写使能    // Check if there is data in buffer (cmd + addr take 4 bytes, 24 bit addr)    if((returnValue == BSL432_SUCCESSFUL_OPERATION) & (BSL432_ReceiveBufferSize > 4))    {        returnValue = BSL432_API_writeMemory(addr, BSL432_ReceiveBufferSize - 4, data); //写flash    }    BSL432_CI_sendMessage(returnValue); //回应PC    BSL432_API_closeMemory(); //flash写锁定}

BSL432_CI_receivePassword
解锁BSL。对flash操作首先需要flash为非锁定状态，否则操作失败

void BSL432_CI_receivePassword(){    if (BSL432_API_unlockBSL(&BSL432_ReceiveBuffer[4]) == BSL432_SUCCESSFUL_OPERATION)    {        BSL432_CI_sendMessage(BSL432_ACK); //回应PC    }    else    {        BSL432_CI_sendMessage(BSL432_PASSWORD_ERROR);    }}

BSL432_ERASE_SECTOR

uint8_t BSL432_API_eraseSector(uint32_t addr){    uint8_t exceptions = BSL432_LOCKED;    if(BSL432_LockedStatus == BSL432_STATUS_UNLOCKED)    {        exceptions = BSL432_SUCCESSFUL_OPERATION;        exceptions = BSL432_API_openMemory();#ifdef __MSP432P401R__        MAP_FlashCtl_eraseSector(addr); //擦除指定扇区#elif defined __MSP432P4111__        MAP_FlashCtl_A_eraseSector(addr);#else#error Device not defined.#endif        exceptions = BSL432_API_closeMemory();    }    else    {        exceptions = BSL432_LOCKED;    }    return exceptions;}

BSL432_RX_MASS_ERASE

uint8_t BSL432_API_massErase(uint32_t locked); //擦除整块扇区

BSL432_RX_CRC_CHECK

void BSL432_CI_CRCCheck(uint32_t addr, uint32_t length); //CRC校验

BSL432_RX_LOAD_PC

uint8_t BSL432_API_callAddress(uint32_t addr); //加载指定地址程序

BSL432_TX_DATA_BLOCK

void BSL432_CI_sendDataBlock(uint32_t addr, uint32_t length); //获取指定地址数据，发送给PC

BSL432_TX_BSL_VERSION

BSL432_CI_sendDataBlock((uint32_t)(&BSL432_VersionVendor), 10); //获取版本，发送给PC

BSL432_REBOOT_RESET

void BSL432_API_rebootReset(); //重启

BSL432_FACTORY_RESET

uint8_t BSL432_API_factoryReset(uint8_t *data); //恢复出厂设置