metadata Command Examples

Example #1: Creating a Stream with SDI Metadata

[Source ID=1]

1. Start the SDI metadata encoder instance using the following command:

   # metadata 1 start

2. Create a stream with video, audio and metadata using the following syntax:

   # stream create addr=<IPaddr> port=<UDPport> vid=0 aud=0 data=1

3. Verify the metadata encoder stats:

   # metadata 1 get all

   The system will return the metadata information:

   Metadata ID : 1 Name : (None) Configuration: Type : HD-SDI Input : HDMI Format : KLV Status : STOPPED Decimation : (None) Reclassification : Off Classification : UNCLASSIFIED Classifying Country : (None) Object Country : (None) UAS Tag Filtering : Off Security Filtering : Off Statistics: State : DISABLED Rx Bytes : 0 Rx OK Messages : 0 Rx Corrupt Messages : 0 KLV Bitrate : 0 kbps

Example #2: Streaming with UDP Metadata

[Source ID=2]

1. Create a UDP metadata encoder instance using the following syntax:

   metadata create [addr=<IP source>] port=<dest port>

   Example: 

   # metadata create port=8500

   The system will return the following message, including the UDP metadata ID:

   Metadata source created successfully - ID: 2

2. Start the UDP metadata encoder (if stopped) using the following syntax:

   # metadata <ID> start

   Example: 

   # metadata 2 start

3. Create a stream with video, audio and metadata using the following syntax:

   stream create [addr=<dest IP>] port=<dest port> vid=<id> aud=<id> data=<id>

   Example (showing multiple metadata streams):

   # stream create addr=10.64.1.124 port=1234 encap=ts-udp videosrc=1 audiosrc=1 datasrc=1,3

4. Verify the metadata encoder stats using the following syntax:

   # metadata <ID> get all

   Example:

   # metadata 2 get all

   The system will return the metadata information:

   Metadata ID : 2 Name : (None) Configuration: Type : Network Format : KLV Address : 0.0.0.0 (Any)| UDP Port : 8500  Reclassification : Off Classification : UNCLASSIFIED Classifying Country : (None) Object Country : (None) UAS Tag Filtering : Off Security Filtering : Off Statistics: State : WORKING Rx Bytes : 0 Rx OK Messages : 0 Rx Corrupt Messages : 0 KLV Bitrate : 0 Source Address : ANY

Example #4: Configuration Information for Multiple Metadata Sources

1. Get the metadata configuration information for the encoder using the following command:

   # metadata get all

   Returns configuration information for three metadata sources: (1) serial port source configured for CoT (Makito X4 Rugged only), (2) HD-SDI source configured for KLV, and (3) network source configured for KLV:

   Metadata ID : 0 Name : (None) Configuration: Type : Serial Format : CoT Status : STOPPED Device : "/dev/ttyO0" Standard : RS-232 Baud Rate : 115200 SPI Sensor Discovery : Off SPI UID : (Any) Max AirCraft-SPI Delta : 0 ms CoT Relaying : Off Number Of Relays : 0 Reclassification : Off Classification : UNCLASSIFIED Classifying Country : (None) Object Country : (None) Metadata ID : 1 Name : "HD-SDI-BNC-1" Configuration: Type : HD-SDI Format : KLV Status : STARTED Reclassification : Off Classification : UNCLASSIFIED Classifying Country : (None) Object Country : (None) Metadata ID : 2 Name : "KLV/UDP" Configuration: Type : Network Format : KLV Status : STARTED Address : 10.65.11.169 UDP Port : 20000 Reclassification : Off Classification : UNCLASSIFIED Classifying Country : (None) Object Country : (None)

Example #5: Creating Additional HD-SDI Metadata Sources

To create an additional HD-SDI metadata source and use it in a stream:

# metadata create name="Half the KLV of first input" type=hdsdi
    input=bnc1 decimation=2 
Metadata source created successfully - ID: 3 

# stream create addr=10.65.11.166 port=5678 vid=1 data=3 
Stream created successfully - ID: 3 

# stream 1 get 
Stream ID : 1 
Name : (None) 
Configuration: 
  Address : 10.65.11.166 
  UDP Port : 5678 
  Encapsulation: TS-UDP 
  Contents : Video ("H.264 Video Encoder 1":1), 
               MetaData ("Half the KLV of first input":3) 
…