Command Line Examples - Quantum Data Gen 2 980 User Manual

980 HDMI Protocol Analyzer User Guide
List of PCAP Commands
Note: Commands are lower case.
Command Description
pcap trig Defines the trigger
mechanism
pcap start Initiates the capture of
video stream.
pcap decode Decodes an existing
capture in the capture
buffer and creates a
decode file.
pcap stat Obtain a list of the
video format timing
statistics.
Note: The commands are not case sensitive.

17.2 Command Line Examples

The following is an example of how to use the command line. You use the capture control commands at the
pscope prompt. Once you have captured data you can transfer into the Linux shell and run typical Unix commands.
Note: You can run Linux commands on a capture file (decode.log) that either resides in the 980 instrument or that
resides on your PC. However, the method is different. For captures that reside on the 980, you must run the
capture through the command line either through a telnet session or through the 980 Manager Console.
17.2.1 Searching through captured text
This example shows you how to search through captured text. The primary capture utility in Linux is grep. Consult
the man pages for the grep filter to determine how best to use this command.
To search through the captured text:
1. Enter the following commands to capture the data:
p-scope> pcap size 25
p-scope> pcap mode di
p-scope> pcap trig vsync 10 // Initiates the capture when vsync is detected
p-scope> pcap start
Page 310
Syntax
pcap trig <type> <pos>
Where <type> can be:
vsync – when a vsync event occurs

 encr- – encryption enable pulse is disabled
(not detected in window of opportunity)

encr+ - encryption enable pulse occurs
 in – external trigger input
 prat – a change in the pixel rate
 match – matched values in the data islands
Where <pos> can be a percent in the range of:
0 to 100

pcap start
pcap decode
pcap stat
// Sets the capture buffer to 25% of its maximum size
// Only captures data islands (no video is captured)
// Initiates the capture
Rev. A1
Command Example
To set the trigger criteria:
>pcap trig vsync 50
This example would set the
trigger event to the occurrence
of vsync and the position such
that the trigger event would be
midway between the data
accumulated in the capture
buffer.
To initiate a capture:
> pcap start
To a decode of a capture:
> pcap decode
Creates a file using the default
name of pdecode.log on the 980
To obtain a list of the video
format timing information:
> pcap stat
December 19, 2012