Provided by: srecord_1.56-1build1_i386 bug

NAME

       srec_ti_tagged_16 - Texas Instruments Tagged (SDSMAC 320) file format

DESCRIPTION

       This  format is also known as the TI‐Tagged or Texas Instruments SDSMAC
       (320) format.

       This format allows binary files to be uploaded and  downloaded  between
       two  computer  systems,  typically between a computer system (such as a
       PC, Macintosh, or workstation) and an emulator or evaluation board  for
       16‐bit microcontrollers and microprocessors.

   The Lines
       Unlike  many  other  object  formats,  the  lines  themselves  are  not
       especially significant.  The format  consits  of  a  number  of  tagged
       fields, and lines are composed of a series of these fields.

                          Tag   Description
                          ─────────────────────────────────
                          *     Data byte.
                          :     End of file.
                          0     File header (optional).
                          7     Checksum.
                          8     Dummy checksum (ignored).
                          9     Word Address.
                          B     Data word.
                          F     End of data record.
                          K     Program         identifier
                                (optional).

   Data Byte
                                     β”Œβ”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”
                                     β”‚B β”‚ n β”‚ n β”‚
       One byte of data.  The nn is 8β”‐β”bβ”iβ”t─β”bβ”iβ”gβ”‐β”eβ”nβ”dian hexadecimal.

   End of File
                                     β”Œβ”€β”€β”¬β”€β”€β”€β”€β”€β”€β”
                                     β”‚: β”‚ CRLF β”‚
       The end of data is indicated bβ”y─β”tβ”hβ”iβ”s─β”tβ”aβ”gβ”.  The end of line sequence (LF
       on Unix systems, CRLF on PCs) follows this tag.

   File Header
                               β”Œβ”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                               β”‚0 β”‚ length β”‚ filename β”‚
       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
       a 12‐character file header. The first four characters are the count (in
       hex)  of  the  16‐bit  data word values (B) which follow, not including
       data byte values (*). The remaining file header characters are the name
       of the file and may be any ASCII characters, blank padded.

   Checksum
                                 β”Œβ”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”
                                 β”‚7 β”‚ n β”‚ n β”‚ n β”‚ n β”‚
       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
       characters, beginning with the first tag character and ending with  the
       checksum tag character (7).  The nnnn is 16‐bit big‐endian hexadecimal.

   Dummy Checksum
                                 β”Œβ”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”
                                 β”‚8 β”‚ n β”‚ n β”‚ n β”‚ n β”‚
       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
       characters, beginning with the first tag character and ending with  the
       checksum tag character (8).  The nnnn is 16‐bit big‐endian hexadecimal.

   Address
                                 β”Œβ”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”
                                 β”‚9 β”‚ n β”‚ n β”‚ n β”‚ n β”‚
       Addresses  may  be given fβ”oβ”r─β”aβ”nβ”y─β”dβ”aβ”tβ”aβ”΄β”bβ”yβ”tβ”eβ”,─β”bβ”ut none is mandatory.  The
       file begins at 0000 if no address is given before the first data field.
       The nnnn is 16‐bit big‐endian hexadecimal.

   Data Word
                                 β”Œβ”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”
                                 β”‚B β”‚ a β”‚ a β”‚ b β”‚ b β”‚
       Two   bytes  of  data.   Tβ”hβ”e─┴β”aβ”a─┴β”aβ”nβ”d┴─β”bβ”b┴─β”aβ”rβ”e  each  8‐bit  big‐endian
       hexadecimal.

   End of Record
                                     β”Œβ”€β”€β”¬β”€β”€β”€β”€β”€β”€β”
                                     β”‚F β”‚ CRLF β”‚
       The end of line sequence (LF oβ”n─β”Uβ”nβ”iβ”x─β”sβ”yβ”sβ”tems, CRLF on PCs)  is  escaped
       using this tag.  The checksum is reset to zero at this point.

   Program Identifier
                             β”Œβ”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”
                             β”‚K β”‚ n β”‚ n β”‚ n β”‚ n β”‚ text β”‚
       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,
       or can be empty (i.e. the text portion is optional).  The  nnnn  length
       (hex)  of the field includes the `K', the length and the text; it is at
       least 5.

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

EXAMPLE

       Here  is  an  example  TI‐Tagged  file.   It  contains the data β€œHello,
       World[rq] to be loaded at address 0x0100.
              K000590080B4865B6C6CB6F2CB2057B6F72B6C64*0A7F641F
              :
       Here is another example from the reference below
              00028        7FDCFF
              90000BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F400F
              90008BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3F8F
              90010BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FFF
              90018BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3F7F
              90020BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FEF
              :

SEE ALSO

       http://www.dataio.com/pdf/Manuals/Unifamily/981‐0014‐016.pdf (page 6‐7)

COPYRIGHT

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