B.3 BSL Message Functions
BSL Message Functions
The following functions implement the messages defined in the BSL protocol:
• bslMsgRxDataBlk(BslMsg* pMsg, int addr, int len, unsigned int* pData) – creates message for the
BSL command, RX Data Block (CMD ID 0x12). Writes block of data to target. Parameters:
– pMsg – pointer to BslMsg data structure
– addr – 16-bit block start address
– len – number of bytes to write. Must be an even number. Maximum value is 250.
– pData – pointer to host data to write to target device
• bslMsgRxPassword(BslMsg* pMsg) – creates message for the BSL command, RX Password (CMD
ID 0x10). Sends password to target BSL. Password is 32 bytes long and is stored in the global array,
BslPassword[]. Password MUST match the 32 bytes starting at address 0xFFE0 in the target’s flash
memory. Default password is all 0xFF’s which matches the contents of the target’s memory after
erasing flash. Parameter:
– pMsg – pointer to BslMsg data structure
• bslMsgEraseSeg(BslMsg* pMsg, int addr, int len) – creates message for the BSL command, Erase
Segment (CMD ID 0x16). Erases specified flash segment. Parameters:
– pMsg – pointer to BslMsg data structure
– addr – any even-numbered address within the flash segment to be erased
– len – value of 0xA504 performs erasure of main flash memory ?????
• bslMsgErase(BslMsg* pMsg) – creates message for the BSL command, Mass Erase (CMD ID 0x18).
Erases entire flash area, both Main and Information flash. Parameter:
– pMsg – pointer to BslMsg data structure
• bslMsgEraseChk(BslMsg* pMsg, int addr, int len) – creates message for the BSL command, Erase
Check (CMD ID 0x1C). Verifies flash erasure within specified address range. Parameters:
– pMsg – pointer to BslMsg data structure
– addr – any 16-bit block start address (odd or even)
– len – length of block (odd or even)
• bslMsgBaudRate(BslMsg* pMsg, int dco, int bcs, int baudRate)– creates message for the BSL
command, Changes Baud Rate (CMD ID 0x20). Parameters:
– pMsg – pointer to BslMsg data structure
– dco – DCO Control Register (DCOCTL) setting for a 1xx device or System Clock Frequency
Integrator Register 0 (SCFI0) setting for a 4xx device.
– bcs – Basic Clock System Control Register 1 (BCSCTL1) setting for a 1xx device or System Clock
Frequency Integrator Register 1 (SCFI1) setting for a 4xx device.
– baudRate – 0 is 9600 baud, 1 is 19200 baud, and 2 is 38400 baud
• bslMsgLoadPC(BslMsg* pMsg, int addr) – creates message for the BSL command, Load PC (CMD
ID 0x1A). Sets target’s program counter register to specified value. Parameters:
– pMsg – pointer to BslMsg data structure
– addr – value for target’s program counter register (R0)
• bslMsgTxDataBlk(BslMsg* pMsg, int addr, int bytes) – creates message for the BSL command, TX
Data Block (CMD ID 0x14). Reads block of data from target. Parameters:
– pMsg – pointer to BslMsg data structure
– addr – 16-bit block start address
– bytes – length of block. Maximum value is 250
• bslMsgVer(BslMsg* pMsg) – creates message for the BSL command, BSL Version (CMD ID 0x1E).
Reads BSL version number and MSP430 device information from target. Parameter:
– pMsg – pointer to BslMsg data structure
SLAA089D – December 1999 – Revised August 2006 Features of the MSP430 Bootstrap Loader 27
Submit Documentation Feedback
To Next Page
Need help?
General
