Read Me(SRecord) Read Me(SRecord) NAME RSecord - manipulate EPROM load files DESCRIPTION The SRecord package is a collection of powerful tools for manipulating EPROM load files. I wrote 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 few of the 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: Motorola S-Record The Motorola hexadecimal S-Record format is understood for both reading and writing. Intel The Intel hexadecimal format is understood for both reading and writing. Binary Binary files can both 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 another program. This format cannot be read. 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. 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. Reference Manual SRecord 1 Read Me(SRecord) Read Me(SRecord) The Filters The SRecord package is made more powerful by the concept of nput filters. Wherever an input file may be specified, filters may also be applied to that input file. The following filters are available: checksum The checksum filter may be used to insert the one's complement checksum of the data into the data. 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 any holes 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. 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://www.canb.auug.org.au/~millerp/ File: srecord.html # the SRecord page File: srecord-1.1.README # Description, from the tar file File: srecord-1.1.lsm # Description, LSM format File: srecord-1.1.spec # RedHat package specification File: srecord-1.1.tar.gz # the complete source This Web page also contains a few other pieces of software written by me. Please have a look if you are interested. SRecord is also carried by sunsite.unc.edu in its Linux archives. You will be able to find SRecord on any of its mirrors. Reference Manual SRecord 2 Read Me(SRecord) Read Me(SRecord) URL: ftp://sunsite.unc.edu/pub/Linux/utils/file/ File: srecord-1.1.README # Description, from the tar file File: srecord-1.1.lsm # Description, LSM format File: srecord-1.1.spec # RedHat package specification File: srecord-1.1.tar.gz # the complete source This site is extensively mirrored around the world, so look for a copy near you (you will get much better response). FTP by EMail For those of you without Web or FTP access, I recommend the use of an ftp-by-email server. Here is a list of a few (there may be more): ftpmail@cs.uow.edu.au Australia ftpmail@ftp.uni-stuttgart.de Germany ftpmail@grasp.insa-lyon.fr France ftpmail@doc.ic.ac.uk Great Britain ftpmail@ieunet.ie Ireland ftpmail@sunsite.unc.edu USA ftpmail@ftp.uu.net USA In general, you can get a help message about how to use each system by sending email with a subject of "help" and a message body containing just the word "help". BUILDING SRECORD Full instructions for building SRecord may be found in the BUILDING file included in this distribution. COPYRIGHT srecord version 1.1 Copyright (C) 1998 Peter Miller; All rights reserved. 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 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA. It should be in the LICENSE file included with this distribution. Reference Manual SRecord 3 Read Me(SRecord) Read Me(SRecord) AUTHOR Peter Miller E-Mail: millerp@canb.auug.org.au /\/\* WWW: http://www.canb.auug.org.au/~millerp/ Reference Manual SRecord 4