1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
---
layout: page
title: Specification > Header
---
{% include JB/setup %}
Back to [Specification](../spec.html)
## Header Structure
Bytes
0 2 14 34 42 50 58
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+.....
| V | TYPE | DEVICE_NAME | TIME_STAMP | BODY_SIZE | CRC64 | BODY
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+.....
## Byte Order
Big endian should be used for all [numerical values](http://www.opengroup.org/onlinepubs/007908799/xns/htonl.html) (version, body size, crc). Unused spaces are padded with 0 (binary).
## Header Fields
<table border="1" cellpadding="5" cellspacing="0" align="center">
<tr>
<td style="background:#e0e0e0;"> Data
</td><td style="background:#e0e0e0;"> Type
</td><td style="background:#e0e0e0;"> Description
</td></tr>
<tr>
<td align="left"> V
</td><td align="left"> Unsigned short (16bit)
</td><td align="left"> Version number (1)
</td></tr>
<tr>
<td align="left"> TYPE
</td><td align="left"> char[12]
</td><td align="left"> Type name of data
</td></tr>
<tr>
<td align="left"> DEVICE_NAME
</td><td align="left"> char[20]
</td><td align="left"> Unique device name
</td></tr>
<tr>
<td align="left"> TIME_STAMP
</td><td align="left"> 64 bit unsigned int
</td><td align="left"> Timestamp or 0 if unused
</td></tr>
<tr>
<td align="left"> BODY_SIZE
</td><td align="left"> 64 bit unsigned int
</td><td align="left"> Size of body in bytes
</td></tr>
<tr>
<td align="left"> CRC
</td><td align="left"> 64 bit unsigned int
</td><td align="left"> 64 bit CRC for body data
</td></tr>
</table>
## Description of Fields
### Version number
The version number field specifies the header format version. Currently the version number is *1*.
Please note that this is different from the protocol version.
### Type name
The type name field is an ASCII character string specifying the type of the data contained in the message body e.g. "TRANSFORM".
The length of the type name must be within 12 characters.
### Device name
The device name field contains an ASCII character string specifying the name of the the message.
### Timestamp
The timestamp field contains a 64-bit timestamp indicating when the data is generated.
Please refer [Timestamp](v2_timestamp.html) for the format of the 64-bit timestamp.
### Body size
### CRC
The 64-bit CRC used in OpenIGTLink protocol is based on
[ECMA-182 standard](http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-182.pdf).
An example code is available in [igtl_util.c](https://github.com/openigtlink/OpenIGTLink/blob/master/Source/igtlutil/igtl_unit.h) in the OpenIGTLink library.
|
