Metadata-Version: 2.1
Name: tiflash
Version: 0.11.23
Summary: Unofficial python module for flashing TI devices.
Home-page: https://tiflash.readthedocs.io
Author: Cameron Webb
Author-email: webbjcam@gmail.com
License: MIT
Download-URL: https://github.com/webbcam/tiflash/tarball/0.11.23
Project-URL: Documentation, https://tiflash.readthedocs.io
Project-URL: Source, https://github.com/webbcam/tiflash
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development :: Embedded Systems
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Testing
Classifier: Intended Audience :: Developers
Requires-Python: >=2.7.13, <=3.7
Requires-Dist: pyserial (>=3.4); platform_system != "Windows"

TI-Flash |Status| |Version|
===========================

| |PyVersions| |CCSVersions| |License|

An *unofficial* Python flash programmer for `Texas Instruments
Launchpads <http://www.ti.com/tools-software/launchpads/overview.html>`__.

Read The Docs
-------------

Please see the `readthedocs page <https://tiflash.readthedocs.io>`__ for the
most up to date documentation.


Getting Started
---------------

TIFlash uses Texas Instruments’s Code Composer Studio scripting interface (`Debug Server
Scripting <http://software-dl.ti.com/ccs/esd/documents/users_guide/sdto_dss_handbook.html>`__)
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 <http://www.ti.com/tool/CCSTUDIO>`__ 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 <https://www.python.org/>`__
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 <https://tiflash.readthedocs.io/en/latest/cli.html>`__

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 <https://tiflash.readthedocs.io/en/latest/api.html>`__

Contributing
------------

Please read `CONTRIBUTING.rst <CONTRIBUTING.rst>`__ for details on the
process for submitting pull requests to us.

Versioning
----------

For the versions available, see the `tags on this
repository <https://github.com/webbcam/tiflash/tags>`__.

Authors
-------

-  **Cameron Webb** - *Initial work* -
   `webbcam <https://github.com/webbcam>`__

See also the list of
`contributors <https://github.com/webbcam/tiflash/contributors>`__ who
participated in this project.

License
-------

This project is licensed under the MIT License - see the
`LICENSE <LICENSE>`__ file for details

Disclaimer
----------

Please see the `Disclaimer <DISCLAIMER>`__.

Acknowledgments
---------------

-  `Debug Server
   Scripting <http://software-dl.ti.com/ccs/esd/documents/users_guide/sdto_dss_handbook.html>`__


.. Badges:

.. |Version| image::    https://img.shields.io/pypi/v/tiflash.svg?label=latest
    :target:            https://pypi.org/project/tiflash/#history
    :alt:               Version

.. |Status| image::     https://img.shields.io/pypi/status/tiflash.svg
    :target:            https://pypi.org/project/tiflash/
    :alt:               Status

.. |PyVersions| image:: https://img.shields.io/pypi/pyversions/tiflash.svg?
    :target:            https://pypi.org/project/tiflash/#files
    :alt:               Python Versions

.. |CCSVersions| image:: https://img.shields.io/badge/CCStudio-7.3%20|%207.4%20|%208.0%20|%208.1%20|%208.2-blue.svg?style=flat
    :target:            http://processors.wiki.ti.com/index.php/Download_CCS
    :alt:               CCS Versions

.. |Docs| image::       https://readthedocs.org/projects/tiflash/badge/?version=latest
    :target:            https://tiflash.readthedocs.io
    :alt:               Documentation

.. |License| image::    https://img.shields.io/pypi/l/tiflash.svg?style=flat
    :target:            https://github.com/webbcam/tiflash/blob/master/LICENSE
    :alt:               License: MIT



