CoT2Klv Converter: COT to KLV Converter Library Documentation

Introduction

Cursor on Target (CoT) developed by The Mitre Corporation defines location based data. CoT uses XML (eXtendable Markup Language) to represent "what, where and when" information. CoT serves as a communication method for Department of Defense (DoD) systems to pass time sensitive position data. The CoT messages provide a description of an object (what), the time an event occurs (when), and the position of an event (where). Unmanned Air Systems (UAS) usually use Datalink Local Data Set(LDS) or Universal Data Set (UDS) for their platforms. In order to facilitate interoperability between different systems, MISB EG 0805 defines a recommended conversionsfrom EG 0104 and EG 0601 KLV metadata tags to two basic CoT schema messages (PlatformPosition and Sensor Point-of-Interest (SPOI). CoT2KlvConvLib library provides a conversion between CoT, the XML based information and UAS LDS/UDS MISB EG0601.4 (released 4 March 2010) specification. The resulted metadata is converted according to the MISB 0601 standard and encoded into KLV format.

Main features:

CoT to KLV transcoding
MISB 0601.4 compliant conversion
Local Data Set(LDS) and Universal Data Set (UDS) encoding
Security Metadata Set insertion
Simple C/C++ interface
Windows and Linux support

MISB EG 0805 Engineering Guideline defines the Motion Imagery Standards Board (MISB) metadata items used for fields in Cursor on Target (CoT) Situational Awareness (SI) messages. This library converts Platform Position and Sensor Point of Interest (SPI) metadata into equivalent MISB-standard Key Length Value (KLV) data packets.

Getting started with CoT2Klv converter.

CoT2Klv SDK provides examples with source code to help you get started using the converter. Here is a brief example of using the CoT2Klv for some basic tasks.
Let's say that you have to trancode CoT message like this (Sample CoT Message) into KLV data packet.

Add CoT2Klv.lib and make sure you have CoT2Klv.dll (libcot2klv.so for Linux) accessible by your code.
Include ICoT2KlvConv.h file.
```
        #include <ICoT2KlvConv.h>
```

Create converter instance. Set ICoT2KlvConv::LDS if you want to encode a Local Data Set or ICoT2KlvConv::UDS for Universal Data Set
```
        ICoT2KlvConv* pCoT2KlvConv = CreateCoT2KlvConv(ICoT2KlvConv::LDS);   
```

Set optional Security Metadata Set data
```
        pCoT2KlvConv->SetSecurityMetadata((const unsigned char*)secSampleData, sizeof( secSampleData));
```
Note:
The Security Metadata Set is defined in MISB RP 0102, Security Metadata Sets for Digital Motion Imagery. Presence of a Security Metadata Set is mandatory in the Motion Imagery Stream or file.

Call Process method, passing a buffer with CoT data as input. The converter will fill supplied klv buffer with the encoded KLV packet and set a length

        if(pCoT2KlvConv->Process(CoTBuf.c_str(), klv_buf, len))
        {
                // Do something with the encoded KLV buffer...
                writeFile(KlvFile, klv_buf, len);
        }
        else
                cout << "Error parsing CoT buffer" << endl;

Delete converter instance.

           if(pCoT2KlvConv)
                delete pCoT2KlvConv;

For more information please see some Sample Code

ICoT2KlvConv class

Please see ICoT2KlvConv for more details.

Preferences

Cursor on Target for the UAV Domain v. 4, 2006.
DoD Information Technology Standards and Profile Registry (https://disronline.disa.mil)
MISP 4.5 - Motion Imagery Standards Profile version 4.5, dated 15 May 2008
MISB EG 0104.5 Predator UAV Universal Metadata Set, dated 14 December 2006
MISB EG 0601.4 UAS Datalink Local Metadata Set
The Developer�s Guide to Cursor on Target, August 2005.
ImpleoTV KLVlib SDK.
ImpleoTV EG0601Convlib SDK.

Glossary of Acronyms

CoT - Cursor-on-Target
EG - Engineering Guideline
EG - Engineering Guideline
FPS - Frames per Second
KLV - Key-Length-Value
MI - Motion Imagery
SI - Situational Awareness
MISP - Motion Imagery Standards Profile
RP - Recommended Practice
SMPTE - Society of Motion Picture and Television Engineers
UTC - Coordinated Universal Time
UUID - Universally Unique Identifier
XML - Extensible Markup Language