---
name: "srec_ti_tagged"
section: "5"
platform: "linux"
package: "srecord"
version: "1.64-4.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/srec_ti_tagged"
---

# srec\_ti\_tagged(5)

Texas Instruments Tagged (SDSMAC) file format

## 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‐bit big‐endian hexadecimal.\

### End of File

| | |
| --- | --- |
| `:` | CRLF |

The end of data is indicated by this tag. The end of line sequence (LF on Unix systems, CRLF on PCs) follows this tag.\

### File Header

| | | |
| --- | --- | --- |
| `0` | length | filename |

The optional start‐of‐file record begins with 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 complement sum of 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 complement sum of 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 for any data byte, but 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. The *aa* and *bb* are each 8‐bit big‐endian hexadecimal.\

### End of Record

| | |
| --- | --- |
| `F` | CRLF |

The end of line sequence (LF on Unix systems, 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 identifier can contain a brief description 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.64\
 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 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.\

## MAINTAINER

| | | |
| --- | --- | --- |
| Scott Finneran | E‐Mail: | scottfinneran@yahoo.com.au |
| Peter Miller | E‐Mail: | pmiller@opensource.org.au |