Utilities

msp430.memory.convert

This is a command line tool that can load multiple hex files, combine them and output a hex file of the same or different file type. (run as python -m msp430.memory.convert):

Usage: convert.py [options] [INPUT...]

Simple hex file conversion tool.

It is also possible to specify multiple input files and create a single,
merged output.

Options:
  -h, --help            show this help message and exit
  -o DESTINATION, --output=DESTINATION
                        write result to given file
  -i TYPE, --input-format=TYPE
                        input format name (titext, ihex, bin, hex, elf)
  -f TYPE, --output-format=TYPE
                        output format name (titext, ihex, bin, hex)
  -d, --debug           print debug messages

msp430.memory.compare

Compare two hex files. The files are loaded and a hex dump is compared. The diff between the hex dumps is output (unless the --html option is used). The tool also sets the shell exit code so that it could be used in shell/bat scripts.

(run as python -m msp430.memory.compare):

Usage: compare.py [options] FILE1 FILE2

Compare tool.

This tool reads binary, ELF or hex input files, creates a hex dump and shows
the differences between the files.


Options:
  -h, --help            show this help message and exit
  -o DESTINATION, --output=DESTINATION
                        write result to given file
  -d, --debug           print debug messages
  -v, --verbose         print more details
  -i TYPE, --input-format=TYPE
                        input format name (titext, ihex, bin, hex, elf)
  --html                create HTML output

msp430.memory.generate

Generate hex files filled with some pattern. The pattern can be a counter or a useful MSP430 instruction such as JMP $ (0x3fff).

(run as python -m msp430.memory.generate):

Usage:     generate.py [options]

    Test File generator.

    This tool generates a hex file, of given size, ending on address
    0xffff if no start address is given.

Options:
  -h, --help            show this help message and exit
  -o DESTINATION, --output=DESTINATION
                        write result to given file
  -f TYPE, --output-format=TYPE
                        output format name (titext, ihex, bin, hex)
  -l SIZE, --length=SIZE
                        number of bytes to generate
  -s START_ADDRESS, --start-address=START_ADDRESS
                        start address of data generated
  -c, --count           use address as data
  --const=CONST         use given 16 bit number as data (default=0x3fff)
  --random              fill with random numbers

msp430.memory.hexdump

Show hex dump of files. Note that the same can be achieved with msp430.memory.convert -f hex.

(run as python -m msp430.memory.hexdump):

Usage: hexdump.py [options] [SOURCE...]

Hexdump tool.

This tool generates hex dumps from binary, ELF or hex input files.

What is dumped?
- Intel hex and TI-Text: only data
- ELF: only segments that are programmed
- binary: complete file, address column is byte offset in file

Options:
  -h, --help            show this help message and exit
  -o DESTINATION, --output=DESTINATION
                        write result to given file
  --debug               print debug messages
  -v, --verbose         print more details
  -i TYPE, --input-format=TYPE
                        input format name (titext, ihex, bin, hex, elf)