Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
srec_stewie(5)		       File Formats Manual		  srec_stewie(5)

NAME
     srec_stewie - Stewie's binary file format

DESCRIPTION
     If you have a URL for documentation of this format, please let me know.

     Any  resemblance  to the Motorola S-Record is superficial, and extends only
     to the data records.  The header records and termination records  are  com-
     pletely  different.   None  of the other Motorola S-Records record type are
     available.

   The Records
     All records start with an ASCII capital S character, value  0x53,	followed
     by a type specifier byte.	All records consist of binary bytes.

   The Header Record
     Each file starts with a fixed four byte header record.
			   +------+------+------+------+
			   | 0x53 | 0x30 | 0x30 | 0x33 |
			   +------+------+------+------+

   The Data Records
     Each  data  record  consists  of 5 fields. These are the type field, length
     field, address field, data field, and the checksum.  The lines always start
     with a capital S character.
	    +------+------+---------------+---------+------+----------+
	    | 0x53 | Type | Record Length | Address | Data | Checksum |
	    +------+------+---------------+---------+------+----------+

     Type    The type field is a one  byte  field  that  specifies  whether  the
	     record  has  a  two-byte address field (0x31), a three-byte address
	     field (0x32) or a four-byte address field (0x33).	The  address  is
	     big-endian.

     Record Length
	     The record length field is a one byte field that specifies the num-
	     ber of bytes in the record following this byte.

     Address
	     This is a 2-, 3- or 4-byte address that specifies where the data in
	     the record is to be loaded into memory.

     Data    The  data	field contains the executable code, memory-loadable data
	     or descriptive information to be transferred.

     Checksum
	     The checksum is a one byte field that represents the least signifi-
	     cant byte of the one's complement of the sum of the  values  repre-
	     sented  by  the  bytes  making up the record's length, address, and
	     data fields.

   The Termination Record
     Each file ends with a fixed two byte termination record.
				  +------+------+
				  | 0x53 | 0x38 |
				  +------+------+

   Size Multiplier
     In general, binary data will expand in sized  by  approximately  1.2  times
     when represented with this format.

EXAMPLE
     Here  is  an hex-dump example file.  It contains the data "Hello, World[rq]
     to be loaded at address 0.
	    0000: 53 30 30 33 53 31 10 00 00 48 65 6C 6C 6F 2C 20  S003S1...Hello,
	    0010: 57 6F 72 6C 64 0A 9D 53 38			   World..S8

COPYRIGHT
     srec_cat version 1.64
     Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,  2006,  2007,
     2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller

     The srec_cat program comes with ABSOLUTELY NO WARRANTY; for details use the
     'srec_cat	-VERSion  License'  command.   This is free software and you are
     welcome to redistribute it under certain conditions; for  details	use  the
     'srec_cat -VERSion License' command.

MAINTAINER
     Scott Finneran   E-Mail:	scottfinneran@yahoo.com.au
     Peter Miller     E-Mail:	pmiller@opensource.org.au

Reference Manual		     SRecord			  srec_stewie(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=srec_stewie&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help