1srec_ascii_hex(5) File Formats Manual srec_ascii_hex(5)
2
3
4
6 srec_ascii_hex - Ascii-Hex file format
7
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, followd 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 preceeding 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
49 Here is an example ascii-hex file. It contains the data ``Hello,
50 World'' 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.35
56 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
57 2007 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
65 Peter Miller E-Mail: millerp@canb.auug.org.au
66 /\/\* WWW: http://www.canb.auug.org.au/~millerp/
67
68
69
70Reference Manual SRecord srec_ascii_hex(5)