Provided by: srecord_1.56-1build1_i386 bug

NAME

       srec_ti_tagged - Texas Instruments Tagged (SDSMAC) file format

DESCRIPTION

       This format is also known as the TI‐Tagged or TI‐SDSMAC 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
       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     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 byte
       count of the file data.  The remaining 8 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*0A7F648F
              :
       and here is another example from the reference below
              00050        7FDD4F
              90000BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F400F
              90010BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FFF
              90020BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FEF
              90030BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FDF
              90040BFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFFBFFFF7F3FCF
              :

SEE ALSO

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

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/