Skip to main content

metadata

The metadata command is used to manage metadata sources. This command configures the Makito X1 to capture either KLV (Key Length Value) or CoT (Cursor on Target) metadata and then incorporate data information within the metadata elementary stream of the standard MPEG Transport Stream.

The Makito X1 supports three metadata input types: either from the Serial port (DC In & I/O), the HD-SDI interface, or a user-definable UDP network port. 

Multiple metadata sources can be multiplexed into the same Transport Stream. To do so, you must specify the metadata source elementary stream (ES) IDs in the stream command (datasrc), using multiple comma-separated metadata source id/names.

CoT/UDP and CoT/Serial metadata sources can also be retransmitted to other IP destinations for follow-up analysis by third party systems. For more information, see CoT Retransmission.

You can define a small set of static KLV objects for KLV and CoT metadata sources. This can be used to modify erroneous or insert missing mission IDs and security classification within outbound TS steams. For more information, see KLV Metadata Insertion.

KLV/SDI metadata sources can be frame-decimated to reduce the bandwidth used by the metadata service. You can also create additional HD-SDI sources which can be configured to different decimation settings. For more information, see Metadata Decimation.

You can also configure MISB Metadata Filtering on KLV metadata from the HD-SDI interface. For more information, see UAS KLV Metadata Tag Filtering.

Synopsis

metadata ID start
metadata ID stop
metadata create type=network port=udpport [addr=ipaddr] [name=text]
-or-
metadata create type=hdsdi [input=bnc1] [decimation=factor] [name=text]
metadata ID delete
metadata ID set parameter=value [parameter=value ...]
metadata ID get
metadata ID clear
enable_metadata_on_serial_port
enable_console_on_serial_port
enable_passthrough_on_serial_port

Note

enable_metadata_on_serial_port will configure the serial port for metadata input. The serial port will no longer be available for console IO (management) or pass-through.

enable_console_on_serial_port will configure the serial port for console IO (management).

enable_passthrough_on_serial_port will configure the serial port for pass-through.

Actions

ActionDescription

start

Starts the metadata source.

stop

Stops the metadata source.

create

Creates a new network (UDP) or HD-SDI metadata source. A series or one or more parameter=value pairs can be specified at once. See Parameters below.

delete

Deletes a UDP metadata source.

set

Configures metadata source settings. A series of one or more parameter=value pairs can be specified at once. See Parameters below.

get

Displays information on the metadata source. You can specify configuration, statistics, or all metadata information.

Tip

To display a summary of all the encoders in a table format, you can use metadata all get table.

clear

Clears the metadata source's statistics.

enable_metadata_on_serial_port

(Makito X4/Makito X1 Rugged Encoders only) Enables metadata capture from the serial port.

enable_console_on_serial_port

(Makito X4/Makito X1 Rugged Encoders only) Enables console management from the serial port. (default)

Parameters

ParameterDefaultDescription/Values
General parameters

type

network 

Specifies the type of metadata source to create, either network or hdsdi.

Note

Additional HD-SDI sources can be created to stream KLV over SDI at different rates.
name

-

(optional) A name of up to 63 characters.
Network Source-specific parameters

port

-          
Specifies the UDP port for a network metadata source (i.e., the port on which to listen for KLV messages). Range: 1025–65,535

address

-             

(optional) Specifies the IP address for a network metadata source. The address is only required to:

  • receive messages from a source that is multicasting. In this case, you need to provide the multicast IP address to which the data is being sent. OR
  • accept KLV messages coming from a specific sender.
HD-SDI Source-specific parameters

input

bnc1

(optional, HD-SDI source only) Specifies the Input port for the metadata source:

  • bnc1
  • bnc2 (Makito X4 only)
  • bnc3 (Makito X4 only)
  • bnc4 (Makito X4 only)

decimation

1

(Optional) For KLV over SDI metadata input, the ingested KLV messages can be frame-decimated to reduce the bandwidth used by the metadata service. Either specify the decimation factor. Range: 1–60

Note

1 means no decimation, 2 means divide by half, etc.

Or you can specify another video encoder that uses the same input and the metadata AU rate will match the other video encoder's framerate. To do so, enter videncX where X is the actual encoder ID. See Metadata Decimation.

UAS KLV Tag Filtering parameters (See UAS KLV Metadata Tag Filtering)

uastags

off

A list of comma-separated tag numbers from the UAS Datalink Local Set that are allowed to be streamed. Tags not included in this list will be discarded.

  • minimum: Includes the list of uastags as specified in MISB 0902.
  • all: Includes the list of uastags as specified in MISB 0601.
  • none: filters out everything for the given set.

sectags

off

A list of comma-separated tag numbers from the Security Local Data set inside the UAS that are allowed to be streamed. Tags not included.

  • minimum: Includes the list of sectags as specified in MISB 0102.
  • all: Includes the list of sectags as specified in MISB 0102.
  • none: filters out everything for the given set.

Note

sectags filtering requires uastags tag #48 to be included as part of the list.
Static KLV Insertion parameters (See KLV Metadata Insertion)

missionid

-

A string of up to 127 characters.

reclassify

off

(KLV input only) When set to on, enables reclassification of received UAS KLV messages.

classification

unclassified

Specifies the classification of the security data set:

  • unclassified, restricted, confidential, secret, topsecret

classcountry

-

The ISO 3166-1 3-letter code for the classifying country.

objcountry

-

The ISO 3166-1 3-letter code(s) for up to six object countries separated by semicolons.

CoT Retransmission parameters (See CoT Retransmission)

retransmit

off

When set to on, the system will retransmit received CoT/UDP or CoT/Serial metadata to up to 8 other hosts over UDP.

relays


(Mandatory) Specifies the IP address and UDP port of the relayed packets. You can optionally specify the TTL and ToS.

ipaddr1:port1[:ttl1[:tos1]],ipaddr2:port2[:ttl2[:tos2]]..

ttl

64

(Time-to Live for stream packets) Specifies the number of router hops that IP packets from this stream are allowed to traverse before being discarded.
Range = 1..255

tos

0xB8

(Type of Service) Specifies the desired quality of service (QoS). This value will be assigned to the Type of Service field of the IP Header for the outgoing streams.
Range = 0..255 (decimal) or 0x00..0xFF (hex)

Important

A DiffServ or DSCP (Differentiated Services Code Point) value must be converted to a ToS precedence value. For example, AF41 or DSCP 34 becomes ToS 136. For more information, see RFC2474.

Note

The ToS setting must be chosen so as to not interfere with Voice over IP systems and other equipment that may reside on your network. For example, when the ToS value for a stream is set to 0xB8, it can interfere with some third party Voice / IP Telephony systems.

Serial (Makito X4/Makito X1 Rugged Encoders only) and UDP Source-specific parameters

format

KLV

Selects the data format for the metadata.

  • KLV
  • CoT

spiuid


(CoT input only) Specifies the UID of SPI (Sensor Point of Interest) messages to ingest.

discovery

Off

(CoT input only) When set to On, enables the discovery of SPI UIDs (User Identifiers) that will be shown in the stats output and can then be potentially used as the spiuid for SPI message filtering.

delta

0

(CoT input only) Specifies the maximum delta between SPI and Air Craft message timestamps for them to be considered a valid pair that can be converted to KLV.

Serial Source-specific parameters (Makito X4/Makito X1 Rugged Encoders only)

standard

RS232

Specifies the transceiver mode for the metadata capture:

  • RS232
  • RS422

Note

Only valid for the serial port.

baudrate

115200

Specifies the baud rate for the serial port:

  • 115200, 57600, 38400, 19200, 9600, 4800, 2400, 1200

Note

When a KLV over SDI metadata source is started but the input signal is not in a format supported for KLV extraction, its state in the statistics display will show up as “DISABLED”. The moment a supported signal (1080p or 720p) is present, KLV extraction will resume and the status will be updated to “WORKING”.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.