Skip to content

Latest commit

 

History

History
159 lines (103 loc) · 4.3 KB

README.rst

File metadata and controls

159 lines (103 loc) · 4.3 KB

TI-Flash Status Version

Python Versions CCS Versions License: MIT Downloads

An unofficial Python flash programmer for Texas Instruments Launchpads.

Read The Docs

Please see the readthedocs page for the most up to date documentation.

Getting Started

TIFlash uses Texas Instruments’s Code Composer Studio scripting interface (Debug Server Scripting) to flash devices. It’s essentially a python/command line interface for CCS. This is helpful when just needing to perform simple actions like flashing, erasing or resetting a device without having to spin up an entire CCS GUI session.

Follow the steps below to get TIFlash set up on your computer.

Prerequisites

You will need to have Code Composer Studio installed along with drivers for any devices you plan to use (offered during installation of CCS or available in CCS’s Resource Explorer).

You’ll also need Python installed on your computer, either 2.7 or 3.6+ (preferred) will work.

Installing

Install TIFlash via PyPi (recommended)

pip install tiflash

Install via git repo (used for development)

git install https://github.com/webbcam/tiflash.git
cd tiflash
pip install -r requirements.txt
pip install -e .

Quickstart

TIFlash can be used via Python directly or using the commandline.

Command Line

Installing TIFlash via pip will install the commandline application.

From a command prompt:

tiflash -h      # display help menu
tiflash -s L4000CE flash /path/to/image.hex -o ResetOnRestart True

For more commandline examples see the CLI docs

Python

TIFlash can also be used directly in your Python scripts.

import tiflash
tiflash.flash(serno='L4000CE', image='/path/to/image.hex', options={'ResetOnRestart':True})

For more python examples see the API docs

Contributing

Please read CONTRIBUTING.rst for details on the process for submitting pull requests to us.

Versioning

For the versions available, see the tags on this repository.

Authors

  • Cameron Webb - Initial work - webbcam

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details

Disclaimer

Please see the Disclaimer.

Acknowledgments