srec_ti_tagged(5)

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

NAME

6       srec_ti_tagged - Texas Instruments Tagged (SDSMAC) file format
7

DESCRIPTION

9       This format is also known as the TI-Tagged or TI-SDSMAC format.
10
11       This  format  allows binary files to be uploaded and downloaded between
12       two computer systems, typically between a computer system  (such  as  a
13       PC,  Macintosh, or workstation) and an emulator or evaluation board for
14       microcontrollers and microprocessors.
15
16   The Lines
17       Unlike many other object formats, the lines themselves  are  not  espe‐
18       cially  significant.   The format consits of a number of tagged fields,
19       and lines are composed of a series of these fields.
20
21                          Tag   Description
22                          ─────────────────────────────────
23                          *     Data byte.
24                          :     End of file.
25                          0     File header (optional).
26                          7     Checksum.
27                          8     Dummy checksum (ignored).
28                          9     Address.
29                          B     Data word.
30                          F     End of data record.
31                          K     Program         identifier
32                                (optional).
33
34   Data Byte
35                                     ┌──┬───┬───┐
36                                     │B │ n │ n │
37       One byte of data.  The nn is 8└-─b─i┴t──b─i┴g─-─e─n┘dian hexadecimal.
38
39   End of File
40                                     ┌──┬──────┐
41                                     │: │ CRLF │
42       The end of data is indicated b└y──t┴h─i─s──t─a─g┘.  The end of line sequence (LF
43       on Unix systems, CRLF on PCs) follows this tag.
44
45   File Header
46                               ┌──┬────────┬──────────┐
47                               │0 │ length │ filename │
48       The optional start-of-fi└l─e─┴r─e─c─o─r─d──b─e┴g─i─n─s──w─i─t─h──a┘tag character ('0') and
49       a  12-character  file  header.  The  first four characters are the byte
50       count of the file data.  The remaining 8 characters are the name of the
51       file and may be any ASCII characters, blank padded.
52
53   Checksum
54                                 ┌──┬───┬───┬───┬───┐
55                                 │7 │ n │ n │ n │ n │
56       The  checksum  is  the  2s└──c┴o─m─p─l┴e─m─e─n┴t──s─u┴m──o─f┘the 8-bit ASCII values of
57       characters, beginning with the first tag character and ending with  the
58       checksum tag character (7).  The nnnn is 16-bit big-endian hexadecimal.
59
60   Dummy Checksum
61                                 ┌──┬───┬───┬───┬───┐
62                                 │8 │ n │ n │ n │ n │
63       The  checksum  is  the  2s└──c┴o─m─p─l┴e─m─e─n┴t──s─u┴m──o─f┘the 8-bit ASCII values of
64       characters, beginning with the first tag character and ending with  the
65       checksum tag character (8).  The nnnn is 16-bit big-endian hexadecimal.
66
67   Address
68                                 ┌──┬───┬───┬───┬───┐
69                                 │9 │ n │ n │ n │ n │
70       Addresses  may  be given f└o─r─┴a─n─y─┴d─a─t─a┴─b─y─t┴e─,──b┘ut none is mandatory.  The
71       file begins at 0000 if no address is given before the first data field.
72       The nnnn is 16-bit big-endian hexadecimal.
73
74   Data Word
75                                 ┌──┬───┬───┬───┬───┐
76                                 │B │ a │ a │ b │ b │
77       Two  bytes  of data.  The └a─a─┴a─n─d─┴b─b──a┴r─e──e┴a─c─h─┘8-bit big-endian hexadeci‐
78       mal.
79
80   End of Record
81                                     ┌──┬──────┐
82                                     │F │ CRLF │
83       The end of line sequence (LF o└n──U┴n─i─x──s─y─s┘tems, CRLF on PCs)  is  escaped
84       using this tag.  The checksum is reset to zero at this point.
85
86   Program Identifier
87                             ┌──┬───┬───┬───┬───┬──────┐
88                             │K │ n │ n │ n │ n │ text │
89       The  program identifie└r──c┴a─n──c┴o─n─t─a┴i─n──a┴─b─r─i┴e─f──d─e─s─c┘ription of the program,
90       or can be empty (i.e. the text portion is optional).  The  nnnn  length
91       (hex)  of the field includes the `K', the length and the text; it is at
92       least 5.
93
94   Size Multiplier
95       In general, binary data will expand in sized by approximately 2.9 times
96       when represented with this format.
97

EXAMPLE

99       Here  is  an  example  TI-Tagged  file.   It contains the data ``Hello,
100       World'' to be loaded at address 0x0100.
101              K000590080B4865B6C6CB6F2CB2057B6F72B6C64*0A7F648F
102              :
103       and here is another example from the reference below
104              00050        7FDD4F
105              90000BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F400F
106              90010BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FFF
107              90020BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FEF
108              90030BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FDF
109              90040BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FCF
110              :
111

COPYRIGHT

117       srec_cat version 1.35
118       Copyright  (C)  1998,  1999,  2000, 2001, 2002, 2003, 2004, 2005, 2006,
119       2007 Peter Miller
120
121       The srec_cat program comes with ABSOLUTELY NO WARRANTY; for details use
122       the 'srec_cat -VERSion License' command.  This is free software and you
123       are welcome to redistribute it under certain  conditions;  for  details
124       use the 'srec_cat -VERSion License' command.
125

AUTHOR

127       Peter Miller   E-Mail:   millerp@canb.auug.org.au
128       /\/\*             WWW:   http://www.canb.auug.org.au/~millerp/
129
130
131
132Reference Manual                    SRecord                  srec_ti_tagged(5)

NAME

DESCRIPTION

EXAMPLE

SEE ALSO

COPYRIGHT

AUTHOR