# binconvert

This package is in the late stages of development testing, and is available for general use.  As of version 0.2.1, Intel Hex, SREC, & TI Text formats are all tested and appear to be working.  Rawbin has not yet been verified.  Once this format is verified, I'll assemble the package into a teacup archive for full release.

Your feedback and bug reports are appreciated.

### About

Binconvert is a Tcl package that reads & writes EEPROM memory files in multiple formats (Motorola S-REC, Intel Hex, TI Txt, raw binary).  Within Tcl, the information in the files is available for use as a Segment List, i.e. a list of segments in startAddress/dataList pairs.  The binconvert structure and interface have hooks for adding new formats transparently, without having to modify the package or release information about private formats.

### Documentation

Binconvert is written for use with the documentation generator in a literate programming style.  Generated documentation can be found [here for the main and [here for all

### Installation

Download the teacup file to your local system.  From a command line in that directory:

    teacup install binconvert.tm

NOTE: I have not released this package in teacup format yet.  To use, download all files into a directory in your TCLLIBPATH.  I plan to generate an initial teacup file once I've tested the final format, probably in December 2017.

### Example usage

    package require binconvert

    # ...later in the code...

    set segmentlist [binconvert readfile srec inputFile.S28]
    set newsegmentlist [process_bin_data $segmentlist]
    binconvert writefile i16hex $newsegmentlist outputFile.hex

### Extending to New Formats

Binconvert is written in a modular way that allows easy extension to new formats.  If you create a format driver for a publicly-documented format, I encourage you to submit it to be added to the base package.  But even if your format is proprietary, you can easily extend binconvert to read and write that format in exactly the same way as any supported format, using [the provided