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

Action	Description
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

Parameter	Default	Description/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”.

Related Topics