srec_fairchild(5) [debian man page]

srec_fairchild(5)						File Formats Manual						 srec_fairchild(5)

NAME

       srec_fairchild - Fairchild Fairbug file format

DESCRIPTION

       The Fairchild Fairbug format has 8-byte records.  A file begins with an address record and ends with an end-of-file record.

       There are three record types in this file format.

       Address records are of the form

								       +--+------+
								       |S | nnnn |
       indicating the address for the following data records.	       +--+------+

       Data records are of the form

							       +--+------------------+---+
							       |X | ffffffffffffffff | c |
       Each  data  record  begins with an X and always contains+8-data-bytes.--The-ff+characters are hexadecimal byte values (8 bytes).  Each data
       byte is represented by 2 hexadecimal characters.  The c character is a hex digit being the the nibble-sum of the  data  bytes.	A  1-digit
       hexadecimal checksum follows the data in each data record.  The checksum represents, in hexadecimal notation, the sum of the binary equiva-
       lents of the 16 digits in the record; the half carry from the fourth bit is ignored.  The programmer  ignores  any  character  (except  for
       address	characters  and the asterisk character, which terminates the data transfer) between a checksum and the start character of the next
       data record. This space can be used for comments.

       The end-of-file record has the form

									   +--+
									   |* |
       The last record consists of an asterisk only, which indicates the end-of file.

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

EXAMPLE

       Here is an example Fairchild Fairbug file.  It contains the data "Hello, World[rq] to be loaded at address 0x1000.   Notice  how  the  last
       record is padded with 0xFF bytes.
	      S1000
	      X48656C6C6F2C2057C
	      X6F726C64210AFFFF3
	      *

COPYRIGHT

       srec_cat version 1.58
       Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 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.

AUTHOR

       Peter Miller   E-Mail:	pmiller@opensource.org.au
       //*		 WWW:	http://miller.emu.id.au/pmiller/

Reference Manual						      SRecord							 srec_fairchild(5)

srec_ascii_hex(5)						File Formats Manual						 srec_ascii_hex(5)

NAME

       srec_ascii_hex - Ascii-Hex file format

DESCRIPTION

       This  format is also known as the Ascii-Space-Hex or Ascii-Hex-Space format.  If you know who invented this format, please let me know.	If
       you have a better or more complete description, I'd like to know that, too.

       The file starts with a start-of-text (STX or Control-B) character (0x02).  Everything before the STX is ignored.

       Each data byte is represented as 2 hexadecimal characters, followed by an "execution character".  The  default  execution  character  is  a
       space, although many programs which write this format omit the space character immediately preceding end-of-line.

       The  address  for  data	bytes  is set by using a sequence of $Annnn, characters, where nnnn is the 4-character ascii representation of the
       address.  The comma is required.  There is no need for an address record unless there are gaps.	Implicitly, the file starts a address 0 if
       no address is set before the first data byte.

       The file ends with an end-of-text (ETX or Control-C) character (0x03).  Everything following the ETX is ignored.

       It  is  also  possible to specify a running 16-bit checksum using a sequence of $Snnnn, characters, although this usually appears after the
       ETX character and is thus often ignored.

   Variant Forms
       In addition to a space character, the execution character can also be percent (%) called  "ascii-hex-percent"  format,  apostrophe  (')	or
       comma (,) called "ascii-hex-comma" format.  The file must use the same execution character throughout.

       If the execution character is a comma, the address and checksum commands are terminated by a dot (.) rather than a comma (,).

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

EXAMPLE

       Here is an example ascii-hex file.  It contains the data "Hello, World[rq] to be loaded at address 0x1000.
	      ^B $A1000,
	      48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 0A ^C

COPYRIGHT

       srec_cat version 1.58
       Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 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.

AUTHOR

       Peter Miller   E-Mail:	pmiller@opensource.org.au
       //*		 WWW:	http://miller.emu.id.au/pmiller/

Reference Manual						      SRecord							 srec_ascii_hex(5)