.
SRecord
Reference Manual
Scott Finneran <scottfinneran@yahoo.com.au>
Peter Miller <pmiller@opensource.org.au>
.
This document describes SRecord version 1.64
and was prepared 22 June 2014.
This document describing the SRecord program, and the SRecord program itself, are
Copyright 2014 Scott Finneran <scottfinneran@yahoo.com.au>
Copyright Peter Miller <pmiller@opensource.org.au>
This program is free software; you can redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software Foundation; either version 3 of
the License, or (at your option) anylater version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without eventhe implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICU-
LAR PURPOSE. See the GNU General Public License for more details.
Youshould have receivedacopyofthe GNU General Public License along with this program. If
not, see <http://www.gnu.org/licenses/>.
0
Read Me(SRecord) Read Me(SRecord)
NAME
SRecord − manipulate EPROM load files
DESCRIPTION
The SRecord package is a collection of powerful tools for manipulating EPROM load files.
Iwrote SRecord because when I was looking for programs to manipulate EPROM load files, I could not
find very many. The ones that I could find only did a fewofthe things I needed. SRecord is written in C++
and polymorphism is used to provide the file format flexibility and arbitrary filter chaining. Adding more
file formats and filters is relatively simple.
The File Formats
The SRecord package understands a number of file formats:
Ascii-Hex
The ascii-hexformat is understood for both reading and writing. (Also known as the ascii-space-
hexformat.)
ASM It is possible, for output only,toproduce a serices of DB statements containing the data. This can
be useful for embedding data into assembler programs. This format cannot be read.
Atmel Generic
This format is produced by the Atmel AVR assembler.Itisunderstood for both reading and
writing.
BASIC It is possible, for output only,toproduce a serices of DAT A statements containing the data. This
can be useful for embedding data into BASIC programs. This format cannot be read.
Binary Binary files can both be read and written.
B-Record
Files in Freescale Dragonball bootstrap b-record format can be read and written.
C It is also possible to write a C array declaration which contains the data. This can be useful when
you want to embed download data into C programs. This format cannot be read.
COE The Xilinx Coefficient File Format (.coe) is understood for output only.
Cosmac The RCA Cosmac Elf format is understood for both reading and writing.
DEC Binary
The DEC Binary (XXDP) format is understood for both reading and writing.
Elektor Monitor (EMON52)
The EMON52 format is understood for both reading and writing.
Fairchild Fairbug
The Fairchild Fairbug format is understood for both reading and writing.
Formatted Binary
The Formatted Binary format is understood for both reading and writing.
Four Packed Code (FPC)
The FPC format is understood for both reading and writing.
Hexdump
It is possible to get a simple hexdump as output.
IDT/sim The IDT/sim binary file format is understood for both reading and writing.
Intel The Intel hexadecimal format is understood for both reading and writing. (Also known as the
Intel MCS-86 Object format.)
Intel AOMF
The Intel Absolute Object Module Format (AOMF) is understood for both reading and writing.
Intel 16 The Intel hexadecimal 16 format is understood for both reading and writing. (Also known as the
INHX16 file format.)
Reference Manual SRecord 1
Read Me(SRecord) Read Me(SRecord)
LSI Logic Fast Load
The LSI Logic Fast Load format is understood for both reading and writing. Logisim The
Logisim format is understood for both reading and writing. See srec_logisim(5) for more
information.
Memory Initialization Format
The Memory Initialization Format (.mem) by Lattice Semiconductor is understood for writing
only.
MIF The Memory Initialization File format by Altera is supported for both reading and writing.
MOS Technology
The MOS Technology hexadecimal format is understood for both reading and writing.
MIPS-Flash
The MIPS Flash file format is supported for both reading and writing.
Motorola S-Record
The Motorola hexadecimal S-Record format is understood for both reading and writing. (Also
known as the Exorciser,Exormacs or Exormax format.)
MsBin The Windows CE Binary Image Data Format is supported both for reading and writing.
Needham
The Needham Electronics ASCII file format is understood for both reading and writing.
OS65V The Ohio Scientific hexadecimal format is understood for both reading and writing.
PPB The Stag Prom Programmer binary format is understood for both reading and writing.
PPX The Stag Prom Programmer hexadecimal format is understood for both reading and writing.
Signetics
The Signetics format is understood for both reading and writing.
SPASM The SPASM format is used by a variety of PIC programmers; it is understood for both reading
and writing.
Spectrum
The Spectrum format is understood for both reading and writing.
Tektronix (Extended)
The Tektronix hexadecimal format and the Tektronix Extended hexadecimal format are both
understood for both reading and writing.
Te x as Instruments Tagged
The Texas Instruments Tagged format is understood for both reading and writing (both 8 and 16
bit). Also known as the TI-tagged or TI-SDSMACformat.
Te x as Instruments ti-txt
The TI-TXT format is understood for reading and writing. This format is used with the bootstrap
loader of the Texas Instruments MSP430 family of processors.
TRS-80 The Radio Shack TRS-80 object file format is understood for reading and writing.
VHDL It is possible to write VHDL file. This is only supported for output.
Verilog VMEM
It is possible to write a Verilog VMEM file suitable for loading with $readmemh().This
format is supported for reading and writing.
Wilson The Wilson format is understood for both reading and writing. This mystery format was added
for a mysterious type of EPROM writer.
The Tools
The primary tools of the package are srec_cat and srec_cmp.All of the tools understand all of the file
formats, and all of the filters.
Reference Manual SRecord 2
Read Me(SRecord) Read Me(SRecord)
srec_cat The srec_cat program may be used to catenate (join) EPROM load files, or portions of EPROM
load files, together.Because it understands all of the input and output formats, it can also be used
to convert files from one format to another.
srec_cmp
The srec_cmp program may be use to compare EPROM load files, or portions of EPROM load
files, for equality.
srec_info
The srec_info program may be used to print summary information about EPROM load files.
The Filters
The SRecord package is made more powerful by the concept of input filters.Whereveraninput file may be
specified, filters may also be applied to that input file. The following filters are available:
bit reverse
The bit-reverse filter may be used to reverse the order of bits in each data byte.
byte swap
The byte swap filter may be used to swap pairs of add and evenbytes.
CRC The various crc filters may be used to insert a CRC into the data.
checksum
The checksum filters may be used to insert a checksum into the data. Positive,neg a tive
and bit-not checksums are available, as well as big-endian and little-endian byte orders.
crop The crop filter may be used to isolate an input address range, or ranges, and discard the
rest.
exclude The exclude filter may be used to exclude an input address range, or ranges, and keep the
rest.
fill The fill filter may be used to fill anyholes in the data with a nominated value.
length The length filter may be used to insert the data length into the data.
maximum
The maximum filter may be used to insert the maximum data address into the data.
minimum
The minimum filter may be used to insert the minimum data address into the data.
offset The offset filter may be used to offset the address of data records, both forwards and
backwards.
random fill
The random fill filter may be used to fill holes in the data with random byte values.
split The split filter may be used to split EPROM images for wide data buses or other
memory striping schemes.
unfill The unfill filter may be used to makeholes in the data at bytes with a nominated value.
unsplit The unsplit filter may be reverse the effects of the split filter.
More than one filter may be applied to each input file. Different filters may be applied to each
input file. All filters may be applied to all file formats.
ARCHIVE SITE
The latest version of SRecord is available on the Web from:
URL: http://srecord.sourceforge.net/
File: index.html # the SRecord page
File: srecord−1.64.README #Description, from the tar file
File: srecord−1.64.lsm #Description, LSM format
Reference Manual SRecord 3
