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

NAME

6       srec_ti_tagged_16 - Texas Instruments Tagged (SDSMAC 320) file format
7

DESCRIPTION

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

EXAMPLE

101       Here  is  an  example  TI‐Tagged  file.   It  contains the data “Hello,
102       World[rq] to be loaded at address 0x0100.
103              K000590080B4865B6C6CB6F2CB2057B6F72B6C64*0A7F641F
104              :
105       Here is another example from the reference below
106              00028        7FDCFF
107              90000BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F400F
108              90008BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3F8F
109              90010BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FFF
110              90018BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3F7F
111              90020BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FEF
112              :
113

SEE ALSO

115       http://www.dataio.com/pdf/Manuals/Unifamily/981‐0014‐016.pdf (page 6‐7)
116
118       srec_cat version 1.55
119       Copyright (C) 1998, 1999, 2000, 2001, 2002,  2003,  2004,  2005,  2006,
120       2007, 2008, 2009, 2010 Peter Miller
121
122       The srec_cat program comes with ABSOLUTELY NO WARRANTY; for details use
123       the 'srec_cat -VERSion License' command.  This is free software and you
124       are  welcome  to  redistribute it under certain conditions; for details
125       use the 'srec_cat -VERSion License' command.
126

AUTHOR

128       Peter Miller   E‐Mail:   pmiller@opensource.org.au
129       /\/\*             WWW:   http://miller.emu.id.au/pmiller/
130
131
132
133Reference Manual                    SRecord               srec_ti_tagged_16(5)
Impressum