metadata
The metadata command is used to manage metadata sources. This command configures the Makito FX 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 FX supports two metadata input types: either from the 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 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 infometadarmation, see UAS KLV Metadata Tag Filtering.
Synopsis
metadata ID start |
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 |
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 |
clear | Clears the metadata source's statistics. |
Parameters
| Parameter | Default | Description/Values |
|---|---|---|
| General parameters | ||
| network | Specifies the type of metadata source to create, either 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. Info Use 'none' to revert to the default name. |
| Network Source-specific parameters | ||
| - | Specifies the UDP port for a network metadata source (i.e., the port on which to listen for KLV messages). Range: 1025–65,535 |
| - | (optional) Specifies the IP address for a network metadata source. The address is only required to:
|
| HD-SDI Source-specific parameters | ||
| bnc1 | (optional, HD-SDI source only) Specifies the Input port for the metadata source:
|
| 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 |
| UAS KLV Tag Filtering parameters (See UAS KLV Metadata Tag Filtering) | ||
| 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.
|
| 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.
Note
|
| Static KLV Insertion parameters (See KLV Metadata Insertion) | ||
| - | A string of up to 127 characters. |
| off | (KLV input only) When set to on, enables reclassification of received UAS KLV messages. |
| unclassified | Specifies the classification of the security data set:
|
| - | The ISO 3166-1 3-letter code for the classifying country. |
| - | The ISO 3166-1 3-letter code(s) for up to six object countries separated by semicolons. |
| CoT Retransmission parameters (See CoT Retransmission) | ||
| off | When set to on, the system will retransmit received CoT/UDP or CoT/Serial metadata to up to 8 other hosts over UDP. |
| - | (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]].. |
| 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. |
| 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. 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. |
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”.