Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview

Artifact ID: 15a365c60cc44024d1d380c04ce9df10cb13c0b1
Page Name:binconvert
Date: 2017-11-30 02:13:30
Original User: erikj
Mimetype:text/x-markdown
Parent: d4c1abfeea9fe1b833536c6ad57e8237b357229e
Content

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 pycco documentation generator in a literate programming style. Generated documentation can be found here for the main engine and here for all files.

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 interface.