Readme

Example Summary

UART interface Flash plugin handles the data transaction between the BSL host and the ROM BSL through the following 4 API Hooks.

• Init
• Receive
• Send
• Deinit

UART Flash plugin is primarily used to override the ROM BSL UART interface with custom implementation when there is a need.

Once this plugin image is loaded, ROM UART interface will become inactive. To revert the device to use ROM UART use SWD_Factory_Reset.

For more details on the Flash plugin refer to BSL User Guide.

This example can be used to customize the UART interface implementation.

NOTE:

• While creating Custom Flash plugin make sure that, Flash region in which the Flash plugin resides and Non-main Flash memory are Static write protected in the BCR configuration.
• Otherwise there are chances for device to get locked during the Bootloading process.
• This BSL example uses a provided ti_msp_dl_config.h file that is not generated by SysConfig, and it’s recommended to use this provided file.

• If it’s necessary to generate Driverlib configuration files (ti_msp_dl_config.h/c), copy the content of the generated ti_msp_dl_config.h file into the provided version.

• The following SRAM memory are marked as reserved for the ROM BSL execution
  • 0x20000000 to 0x20000160
  • 0x20007EE0 to 0x20007FFF

• The Plugin used for SRAM is allotted from 0x20000160

TIPS:

• If SRAM size for plugin(0xFF) configured in Non main is not sufficient, users can consume required space at the end of first Buffer in SRAM, but this will impact the maximum BSL packet size. The plugin SRAM size in BSL user config can be updated to 0 and free that space for buffers.

Peripherals & Pin Assignments

Peripheral	Pin	Function
SYSCTL
UART0	PA11	RX Pin
UART0	PA10	TX Pin
DEBUGSS	PA20	Debug Clock
DEBUGSS	PA19	Debug Data In Out

BoosterPacks, Board Resources & Jumper Settings

Visit LP_MSPM0G3507 for LaunchPad information, including user guide and hardware files.

Pin	Peripheral	Function	LaunchPad Pin	LaunchPad Settings
PA11	UART0	RX	J4_33/J26_6	PA11 can be used as UART RX connected to XDS-110 backchannel, to boosterpack connector or to CAN/LIN connector: To use backchannel UART on J101: J22 1:2: Connects XDS-110 backchannel UART RX to J101 J101 7:8 Connects XDS-110 backchannel to UART RX To use UART on boosterpack connector: J22 2:3: Connects UART RX to J4_33 To use on J26 CAN/LIN connector: R63 is populated by default and connects pin to J26_6
PA10	UART0	TX	J4_34/J26_5	PA10 can be used as UART TX connected to XDS-110 backchannel, to boosterpack connector or to CAN/LIN connector: To use backchannel UART on J101: J21 1:2: Connects XDS-110 backchannel UART TX to J101 J101 9:10 Connects XDS-110 backchannel to UART TX To use UART on boosterpack connector: J21 2:3: Connects UART TX to J4_34 To use on J26 CAN/LIN connector: R62 is populated by default and connects pin to J26_5
PA20	DEBUGSS	SWCLK	N/A	PA20 is used by SWD during debugging J101 15:16 ON Connect to XDS-110 SWCLK while debugging J101 15:16 OFF Disconnect from XDS-110 SWCLK if using pin in application
PA19	DEBUGSS	SWDIO	N/A	PA19 is used by SWD during debugging J101 13:14 ON Connect to XDS-110 SWDIO while debugging J101 13:14 OFF Disconnect from XDS-110 SWDIO if using pin in application

Device Migration Recommendations

This project was developed for a superset device included in the LP_MSPM0G3507 LaunchPad. Please visit the CCS User’s Guide for information about migrating to other MSPM0 devices.

Low-Power Recommendations

TI recommends to terminate unused pins by setting the corresponding functions to GPIO and configure the pins to output low or input with internal pullup/pulldown resistor.

SysConfig allows developers to easily configure unused pins by selecting Board→Configure Unused Pins.

For more information about jumper configuration to achieve low-power using the MSPM0 LaunchPad, please visit the LP-MSPM0G3507 User’s Guide.

Example Usage

Connect UART_RX and UART_TX with the BSL Host (any microcontroller with UART).

Compile, load the example.

Create BSL invocation condition using BSL Invoke pin or any other invocation methods. Send Connection command from the host. BSL Acknowledgement should be received. Send GetDeviceInfo command from the host. BSL should respond back with the UART interface Flash plugin version information.

Similarly Send erase, program, verification commands to program data in the memory.