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:

   CODE

   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:

   CODE

   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:

   CODE

   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)