metadata
The metadata command is used to manage metadata sources. This command configures the Makito X 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 X supports three metadata input types: either from the COM1 serial port, the HD-SDI interface, or a user-definable UDP network port. The serial port and HD-SDI interface are available on the Makito X-SDI only. UDP is always available.
Multiple metadata sources can be multiplexed into the same Transport Stream. To do so, you must specify the metadata source 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 |
enable_metadata_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 |
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, stats, 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. |
enable_metadata_on_serial_port | Enables metadata capture from the serial port. |
enable_console_on_serial_port | Enables console management from the serial port. (default) |
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. |
| 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. |
| Serial and UDP Source-specific parameters | ||
| KLV | Selects the data format for the metadata.
Note CoT is only available from the serial port. For details on setting up CoT, refer to Cursor-on-Target Capture from the Makito X . |
| (CoT input only) Specifies the UID of SPI (Sensor Point of Interest) messages to ingest. | |
| 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. |
| 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 | ||
| RS232 | Specifies the transceiver mode for the metadata capture:
Note Only valid for the serial port. |
| 115200 | Specifies the baud rate for the serial port:
|
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”.