1srec_ascii_hex(5)             File Formats Manual            srec_ascii_hex(5)
2
3
4

NAME

6       srec_ascii_hex - Ascii‐Hex file format
7

DESCRIPTION

9       This  format  is  also  known as the Ascii‐Space‐Hex or Ascii‐Hex‐Space
10       format.  If you know who invented this format, please let me know.   If
11       you  have a better or more complete description, I'd like to know that,
12       too.
13
14       The file starts with  a  start‐of‐text  (STX  or  Control‐B)  character
15       (0x02).  Everything before the STX is ignored.
16
17       Each  data byte is represented as 2 hexadecimal characters, followed by
18       an "execution character".  The default execution character is a  space,
19       although many programs which write this format omit the space character
20       immediately preceding end‐of‐line.
21
22       The address for data bytes is set by using a sequence of $Annnn,  char‐
23       acters,  where  nnnn  is  the  4‐character  ascii representation of the
24       address.  The comma is required.  There  is  no  need  for  an  address
25       record  unless there are gaps.  Implicitly, the file starts a address 0
26       if no address is set before the first data byte.
27
28       The file ends with an end‐of‐text (ETX or Control‐C) character  (0x03).
29       Everything following the ETX is ignored.
30
31       It  is  also  possible  to  specify  a  running 16‐bit checksum using a
32       sequence of $Snnnn, characters, although this usually appears after the
33       ETX character and is thus often ignored.
34
35   Variant Forms
36       In  addition  to a space character, the execution character can also be
37       percent (%) called "ascii‐hex‐percent" format, apostrophe (') or  comma
38       (,) called "ascii‐hex‐comma" format.  The file must use the same execu‐
39       tion character throughout.
40
41       If the execution character is a comma, the address  and  checksum  com‐
42       mands are terminated by a dot (.) rather than a comma (,).
43
44   Size Multiplier
45       In general, binary data will expand in sized by approximately 3.0 times
46       when represented with this format.
47

EXAMPLE

49       Here is an example  ascii‐hex  file.   It  contains  the  data  “Hello,
50       World[rq] to be loaded at address 0x1000.
51              ^B $A1000,
52              48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 0A ^C
53
55       srec_cat version 1.64
56       Copyright  (C)  1998,  1999,  2000, 2001, 2002, 2003, 2004, 2005, 2006,
57       2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller
58
59       The srec_cat program comes with ABSOLUTELY NO WARRANTY; for details use
60       the 'srec_cat -VERSion License' command.  This is free software and you
61       are welcome to redistribute it under certain  conditions;  for  details
62       use the 'srec_cat -VERSion License' command.
63

MAINTAINER

65       Scott Finneran   E‐Mail:   scottfinneran@yahoo.com.au
66       Peter Miller     E‐Mail:   pmiller@opensource.org.au
67
68
69
70Reference Manual                    SRecord                  srec_ascii_hex(5)
Impressum