metadata Command Examples

Example #1: Creating a Stream with Serial Metadata

[Source ID=0]

Set the baud rate for the serial port to 115,200 using the following command:

# metadata 0 set baudrate=115200

Start the serial metadata encoder instance:

# metadata 0 start

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

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

Verify the metadata encoder stats:

# metadata 0 get all

The system will return the metadata information:

Metadata ID : 0 
Name : (None) 
Configuration: 
  Type : serial 
    Format : KLV 
    Device : "/dev/tts/0" 
    Standard : RS-232 
    Baud Rate : 115200 
Statistics: 
  State : STOPPED 
    Rx Bytes : 0 
    Rx OK Messages : 0 
    Rx Corrupt Messages : 0

Example #2: Creating a Stream with SDI Metadata

[Source ID=1]

Start the SDI metadata encoder instance using the following command:

# metadata 1 start

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

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

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
    Format              : KLV
Statistics:
  State                 : STOPPED
    Rx Bytes            : 0
    Rx OK Messages      : 0
    Rx Corrupt Messages : 0

Example #3: Streaming with UDP Metadata

[Source ID=2]

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

Start the metadata UDP metadata encoder using the following syntax:

# metadata <ID> start

Ex:

# metadata 2 start

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

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 
Statistics: 
  State                 : WORKING 
    Rx Bytes            : 0 
    Rx OK Messages      : 0 
    Rx Corrupt Messages : 0 
    Source Address      : 0.0.0.0

Example #4: Configuration Information for Multiple Metadata Sources

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)
…