MSP432 BSL流程（UART）

升级流程

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

# cat script_P4xx_uart.txt

LOG     //记录日志
MODE P4xx UART 9600 COM25 PARITY    //初始化串口
RX_PASSWORD_32 .pass256_wrong.txt  //解锁BSL
RX_PASSWORD_32 .pass256_default.txt
MASS_ERASE      //擦除整块flash
RX_DATA_BLOCK_32 Blink_LED.txt  //写flash
//RX_DATA_BLOCK_32 Blink_LED.hex
TX_BSL_VERSION_32   //获取bsl version
TX_DATA_BLOCK_32 0x0000 0x4000 ReadBlock_MSP432P401R.txt    //读flash
//TX_DATA_BLOCK_32 0x0000 0x4000 ReadBlock_MSP432P401R.hex
REBOOT_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 = 0x80
txBuffer->size() & 0xFF
(txBuffer->size() >> 8) & 0xFF
txBuffer        //数据
getCheckSumLow()
getCheckSumHigh()

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

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

Header = 0x80
rxUartBuffer = 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); //恢复出厂设置