Msp430 Uart Bootloader

This repository contains everything necessary to loading a program in a MSP430F5529 flash memory through uart using the BSL (Bootstrap Loader). My intention with BSL was that I could get a command through an UCA0 from MSP, and turn on the 'firmware upgrade' function. Upon entering this mode, the same UCA0 would receive the new firmware, update and restart the controller. So it would be possible to put my project in the field, and with each bug found, be able to correct it effectively.

The biggest incentive to make this repository was the time I spent looking for a clear tutorial to start understanding BSL. I believe that if someone who is researching the subject follow the instructions here, have a starting point to make their own changes.

All content and materials on this site are provided 'as is'. TI and its respective suppliers and providers of content make no representations about the suitability of these materials for any purpose and disclaim all warranties and conditions with regard to these materials, including but not limited to all implied warranties and conditions of merchantability, fitness for a particular purpose. This bootstrap loader provides a method to program the flash memory during MSP430 project development and updates. It can be activated by a utility that sends commands using the UART protocol. The BSL enables the user to control the activity of the MSP430 and to exchange data using a personal computer or other device.

Most of the codes and documentation that texas provides are dated to 2013. When I went to use with the most up-to-date versions of the compiler in CCS v6 many problems appeared. When I was able to compile the codes without errors, I was not able to find which part of my code was not working right.

In the end, I was continue when I found the wiki on the subject. But even so the example that was there used old versions of the standard code. I decided to update that example with the latest versions, and test on MSP430F5529 and post here.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for aplication purposes. All code in this project can be found in these two links:

• http://www.ti.com/tool/mspbsl (In the session custom-bsl430) <Last accessed 9/27/2017>
• http://processors.wiki.ti.com/index.php/Custom_MSP430_BSL <Last accessed 9/27/2017>

All I did was just get several parts of the codes contained in these links and make it work the right way.

Prerequisites

League of legends pathc. Here is all the pertinent information to be able to burn this code in an MSP430f5529 that I also used.

I do not know exactly if a previous or later version of CCS will present problems, but if any appears, download the same version as mine. Unlike the IDE, the compiler version and the script are important that are the ones I'm using, as they are the ones that work, I do not guarantee that later or previous versions will work as expected.

I left links to get my CCS and scripter versions. And a texas tutorial on how to download other versions of the TI compiler inside the CCS.

• CCS versions: http://processors.wiki.ti.com/index.php/Download_CCS <Last accessed 9/27/2017>

• Scripter: http://software-dl.ti.com/msp430/msp430_public_sw/mcu/msp430/MSPBSL_Scripter/latest/index_FDS.html <Last accessed 9/27/2017>

• TI compiler tutorial: http://processors.wiki.ti.com/index.php/Compiler_Releases <Last accessed 9/27/2017>

Using in CSS with MSP-FET

After certifying that everything is as I listed above, we will use the CCS. Doing this is a very basic thing, but I think it needs to be explained right and you need to be aware if everything is correct. First go to File-> Import..

In the Code Composer Studio tab select CCS projects

Click browse, point to the src folder inside the cloned repository on your machine. The project will appear under the name of MSP430F5529_BSL. Click finish.

This project will appear in project explorer. Right-click on this and go to properties.

This part is important. If the 'Compiler Version' field is not TI v4.1.9, back and read the link to download older versions of the compiler. Make sure the rest is the same and now go to Build-> MSP430 Linker.

Go to 'MSP430 Properties' and check if the 'Allow Read/Write/Erase access to BSL memory' box is checked. And if 'Erase main, information and protected information memory in Erase Options' is checked. If all is correct, click Apply and then OK.

Finally, go to Project-> Build Project and wait. When finished, this indicated line displayed in the photo will be with warning. As far as I've used this code, it does not affect how it works. If someone has problems and/or find out how to resolve this warning correctly, please contact me.

Testing

In the examples folder you can find all the information you need to test whether these codes really work. It's quite simple indeed.

I used a PL2303 USB to UART to test. Any such chip that converts USB to serial works. (http://www.prolific.com.tw/US/ShowProduct.aspx?p_id=225&pcid=41)

First look at the schematic contained in the sch folder, and after mounting the hardware correctly open the windows prompt and navigate to the bsl-msp430examplesusb_to_serialscript folder. Open the script.txt and change the COM number. There, simply call the command line:

The following must appear:

Now it is necessary to look if the LED previously connected is blinking. After all this, you are able to upload any firmware in txt format. How to generate this kind of file for your firmware in the CCS or IAR Workbench to be able to burn through this method? Read the documentation provided on the texas instruments website or in the folder in that repository called docs.

I hope you get the same result as me :D.

After testing like this, you'll need to test how to call BSL load mode within an actual application. Inside the proj folder you have a project that you can import into CCS and sending the strings through the same upload uart as 'RUN BSLr' will put in the same state, and then the process of running the script is the same.

This code is not complicated I recommend you read it well and understand exactly how it works. You can adapt a function to call BSL in your own application easily.

Contributing

If you think this is worth improving in any way, either with this README.md or anything, send me an email :D.

Author

• Rafael Coelho Silva - rafaellcoellho

My personal e-mail: rafaellcoellho@gmail.com

License

As all the code written here was provided by texas instruments all comments describing the license were kept, if you have any questions just look in src files or email texas instruments.

MSPBSL：Bootloader (BSL) for MSP low-power microcontrollers

The Bootloader (BSL, formerly known as the bootstrap loader) is an application built into MSP low-power microcontrollers. It enables the user to communicate with the device to read from and write to its memory. This feature is primarily used for programming the device, during prototyping, final production, and in service. Both the programmable memory (Flash memory or FRAM) and the data memory (RAM) can be modified as required. Different BSLs offer different peripherals to communicate with, e.g. UART, I2C, SPI, or USB.

MSP430/MSP432 Custom Bootloader (BSL) PackageThe custom bootloader packages contain BSL source code and released BSL firmware images for MSP430 and MSP432 microcontrollers. The source code can be used as reference for developing a custom BSL. The firmware images are provided to update or restore the factory BSL if needed.

MSP430 Main Memory BootloaderMSPBoot is a main memory custom bootloader solution that can be implemented on any MSP430 microcontroller. The base example uses I2C communication, and MSPBoot also supports different communication interfaces like UART or SPI, and it is fully customizable. This highly flexible and modular custom bootloader solution includes options like dual-image support and interrupt and reset vector redirection. MSPBoot is a good option when additional custom features are needed that are not provided in the built-in BSL.

BSL ScripterThe BSL Scripter is a PC application that is available for Windows, Linux and Mac OS X. It is a user interface which allows to easily communicate with the BSL on MSP430 and MSP432 devices to modify the device's memory via UART, I2C, SPI or USB. Supported programming adapters are the MSP-BSL programmer ('BSL Rocket') and the MSP-FET.

MSP430FR5x/FR6x Crypto-Bootloader (CryptoBSL)The Crypto-Bootloader (CryptoBSL) is a custom bootloader that was developed and implemented on the MSP430FR5x and MSP430FR6x FRAM microcontrollers. This bootloader uses cryptographic functions to enable increased security for in-field firmware updates.

MSP-BSL Programmer (‘BSL Rocket’)The MSP-BSL (previously called the MSP430-BSL, or BSL Rocket) is a low-cost programmer. It is designed for easy USB communication between a PC and the BSL of a MSP microcontroller. The MSP-BSL is a collaboration project between Olimex LTD and Texas Instruments. PCB and firmware for the MSP-BSL are open source. The MSP-BSL supports UART, I2C and SPI communication. The is available through Olimex

Order Information

Software (1)

Development Tools (3)

Design Kits & Evaluation Modules (29)

TI Devices (100)