SAS and SATA Trigger and Decoder Software

Instruction Manual
SAS and SATA
Decoder Software
SAS and SATA Decoder Software Instruction Manual
© 2017 Teledyne LeCroy, Inc. All rights reserved.
Unauthorized duplication of Teledyne LeCroy, Inc. documentation materials other than for internal sales and
distribution purposes is strictly prohibited. However, clients are encouraged to duplicate and distribute
Teledyne LeCroy, Inc. documentation for their own internal educational purposes.
Teledyne LeCroy is a trademark of Teledyne LeCroy, Inc., Inc. Other product or brand names are trademarks
or requested trademarks of their respective holders. Information in this publication supersedes all earlier
versions. Specifications are subject to change without notice.
926374 Rev C
January 2017
Contents
About the Options
1
SASbus Option
1
SATAbus Option
1
Serial Decode
2
Bit-level Decoding
2
Logical Decoding
2
Message Decoding
2
User Interaction
2
Decoding Workflow
3
Decoder Set Up
3
Failure to Decode
6
Serial Decode Dialog
6
Reading Waveform Annotations
7
Serial Decode Result Table
10
Searching Decoded Waveforms
16
Decoding in Sequence Mode
17
Improving Decoder Performance
18
Automating the Decoder
19
ProtoSync
20
ProtoSync Dialog
20
ProtoSync Protocol View
20
Technical Support
21
Live Support
21
Resources
21
Service Centers
21
i
SAS and SATA Decoder Software Instruction Manual
About This Manual
Teledyne LeCroy offers a wide array of toolsets for decoding and debugging serial data streams.
These toolsets may be purchased as optional software packages, or are provided standard with some
oscilloscopes.
This manual explains the basic procedures for using serial data decoder software options.
It is assumed that:
l
l
l
You have purchased and activated one of the serial data products described in this manual.
You have a basic understanding of the serial data standard physical and protocol layer
specifications, and know how these standards are used in controllers.
You have a basic understanding of how to use an oscilloscope, and specifically the Teledyne
LeCroy oscilloscope on which the option is installed. Only features directly related to serial
data decoding are explained in this manual.
Teledyne LeCroy is constantly expanding coverage of serial data standards and updating software.
Some capabilities described in this documentation may only be available with the latest version of
our firmware. You can download the free firmware update from:
teledynelecroy.com/support/softwaredownload
While some of the images in this manual may not exactly match what is on your oscilloscope
display—or may show an example taken from another standard—be assured that the functionality is
identical, as much functionality is shared. Product-specific exceptions will be noted in the text.
ii
About the Options
About the Options
Teledyne LeCroy decoders apply software algorithms to extract serial data information from physical
layer waveforms measured on your oscilloscope. The extracted information is displayed over the
actual physical layer waveforms, color-coded to provide fast, intuitive understanding of the
relationship between message frames and other, time synchronous events.
SASbus Option
Serial Attached SCSI (SAS) is a communication protocol designed to transfer data between computer
storage devices such as hard drives and tape drives. SAS provides backward compatibility from
second-generation SATA drives; meaning SATA 3 Gb/s drives may be connected to SAS backplanes,
but not vice versa.
The SASbus D option is available for most Teledyne LeCroy oscilloscopes. It permits link and data
layer decoding of 1.5, 3, 6, or 12Gb/s SAS physical layer signals.
SASbus D is compatible with the ProtoSync™ option.
SATAbus Option
Serial Advanced Technology Attachment (SATA) is a computer bus interface used to connect host
adapters to mass storage devices like hard disk and optical drives. SATA's evolution brought reduced
cable-bulk and cost (reduced from 80 wires to seven), increased speed, more efficient data transfer,
and hot swapping.
The SATAbus D decoder option permits link layer decoding of 1.5, 3 and 6 Gb/s SATA physical layer
signals. It is compatible with the ProtoSync™ option.
1
SAS and SATA Decoder Software Instruction Manual
Serial Decode
The algorithms described here at a high level are used by all Teledyne LeCroy serial decoders sold for
oscilloscopes. They differ slightly between serial data signals that have a clock embedded in data
and those with separate clock and data signals.
Bit-level Decoding
The first software algorithm examines the embedded clock for each message based on a default or
user- specified vertical threshold level. Once the clock signal is extracted or known, the algorithm
examines the corresponding data signal at the predetermined vertical level to determine whether a
data bit is high or low. The default vertical level is set to 50% and is determined from a measurement
of peak amplitude of the signals acquired by the oscilloscope. For most decoders, it can also be set
to an absolute voltage level, if desired. The algorithm intelligently applies a hysteresis to the rising
and falling edge of the serial data signal to minimize the chance of perturbations or ringing on the
edge affecting the data bit decoding.
Note: Although the decoding algorithm is based on a clock extraction software algorithm
using a vertical level, the results returned are the same as those from a traditional protocol
analyzer using sampling point-based decode.
Logical Decoding
After determining individual data bit values, another algorithm performs a decoding of the serial data
message after separation of the underlying data bits into logical groups specific to the protocol
(Header/ID, Address Labels, Data Length Codes, Data, CRC, Parity Bits, Start Bits, Stop Bits,
Delimiters, Idle Segments, etc.).
Message Decoding
Finally, another algorithm applies a color overlay with annotations to the decoded waveform to mark
the transitions in the signal. Decoded message data is displayed in tabular form below the grid.
Various compaction schemes are utilized to show the data during a long acquisition (many hundreds
or thousands of serial data messages) or a short acquisition (one serial data message acquisition).
In the case of the longest acquisition, only the most important information is highlighted, whereas in
the case of the shortest acquisition, all information is displayed with additional highlighting of the
complete message frame.
User Interaction
Your interaction with the software in many ways mirrors the order of the algorithms. You will:
l
2
Assign a protocol/encoding scheme, an input source, and a clock source (if necessary) to one
of the four decoder panels using the Serial Data and Decode Setup dialogs.
l
Complete the remaining dialogs required by the protocol/encoding scheme.
l
Work with the decoded waveform, result table, and measurements to analyze the decoding.
Serial Decode
Decoding Workflow
We recommend the following workflow for effective decoding:
1. Connect your data and strobe/clock lines (if used) to the oscilloscope.
2. Set up the decoder using the lowest level decoding mode available (e.g., Bits).
3. Acquire a sufficient burst of relevant data. The data burst should be reasonably well centered
on screen, in both directions, with generous idle segments on both sides.
Note: See Failure to Decode for more information about the required acquisition
settings. A burst might contain at most 100000 transitions, or 32000 bits/1000 words,
whichever occurs first. This is more a safety limit for software engineering reasons
than a limit based on any protocol. We recommend starting with much smaller bursts.
4. Stop the acquisition, then run the decoder.
5. Use the various decoder tools to verify that transitions are being correctly decoded. Tune the
decoder settings as needed.
6. Once you know you are correctly decoding transitions in one mode, continue making small
acquisitions of five to eight bursts and running the decoder in higher level modes (e.g., Words).
The decoder settings you verify on a few bursts will be reused when handling many packets.
7. Run the decoder on acquisitions of the desired length.
When you are satisfied the decoder is working properly, you can disable/enable the decoder as
desired without having to repeat this set up and tuning process, provided the basic signal
characteristics do not change.
Decoder Set Up
Use the Decode Setup dialog and its protocol-related subdialogs to preset decoders for future use.
Each decoder can use different protocols and data sources, or have other variations, giving you
maximum flexibility to compare different signals or view the same signal from multiple perspectives.
1. Touch the Front Panel Serial Decode button (if available on your oscilloscope), or choose
Analysis > Serial Decode from the oscilloscope menu bar. Open the Decode Setup dialog.
2. From the buttons at the left, select the Decode # to set up.
3. Select the data source (Src 1) to be decoded and the Protocol to decode.
4. If required by the protocol, also select the Strobe or Clock source. (These controls will simply
not appear if not relevant.)
5. Define the bit- and protocol-level decoding on the subdialogs next to the Decode Setup dialog.
Tip: After completing setup for one decoder, you can quickly start setup for the other decoders
by using the buttons at the left of the Decode Setup dialog to change the Decode # .
3
SAS and SATA Decoder Software Instruction Manual
SAS Decoder Settings
SASDecoder Subdialog
Select the signal Speed from one of the standards.
In Probe Selection, indicate whether you are using One Differential Probe or Two Single Ended
Probes.
Note: The number of Source fields on the Decode Setup dialog changes to accommodate your
probe selection. Be sure to select an input channel for each probe.
Optionally, select Show Subfields to annotate the subfields on the waveform overlay.
Optionally, select Detect OOB to mark Out of Band Signaling on the waveform overlay.
ProtoSync Subdialog
This dialog appears if you have installed the ProtoSync option key and the SAS ProtoSync Software on
the instrument. Use it to display the decoded data in the format of a protocol analyzer. See
ProtoSync.
4
Serial Decode
SATA Decoder Settings
SATADecoder Subdialog
Select the signal Speed from one of the standards.
In Probe Selection, indicate whether you are using One Differential Probe or Two Single Ended
Probes.
Note: The number of Source fields on the Decode Setup dialog changes to accommodate your
probe selection. Be sure to select an input channel for each source.
Optionally, select Detect OOB to mark Out of Band Signaling on the decoder overlay.
ProtoSync Subdialog
This dialog appears if you have installed the ProtoSync option key and the SATA ProtoSync Software
on the instrument. Use it to display the decoded data in the format of a protocol analyzer. See
ProtoSync.
5
SAS and SATA Decoder Software Instruction Manual
Failure to Decode
Three conditions in particular may cause a decoder to fail, in which case a failure message will
appear in the first row of the summary result table, instead of in the message bar as usual.
All decoders will test for the condition Too small amplitude. If the signal’s amplitude is too small with
respect to the full ADC range, the message “Decrease V/Div” will appear. The required amplitude to
allow decoding is usually one vertical division.
If the decoder incorporates a user-defined bit rate (usually these are protocols that do not utilize a
dedicated clock/strobe line), the following two conditions are also tested:
l
l
Under sampled. If the sampling rate (SR) is insufficient to resolve the signal adequately based
on the bit rate (BR) setup or clock frequency, the message "Under Sampled" will appear. The
minimum SR:BR ratio required is 4:1. It is suggested that you use a slightly higher SR:BR ratio
if possible, and use significantly higher SR:BR ratios if you want to also view perturbations or
other anomalies on your serial data analog signal.
Too short acquisition. If the acquisition window is too short to allow any meaningful decoding,
the message “Too Short Acquisition” will appear. The minimum number of bits required varies
from one protocol to another, but is usually between 5 and 50.
In all the above cases, the decoding is turned off to protect you from incorrect data. Adjust your
acquisition settings accordingly, then re-enable the decoder.
Note: It is possible that several conditions are present, but you will only see the first relevant
message in the table. If you continue to experience failures, try adjusting the other settings.
Serial Decode Dialog
To first set up a decoder, go to the Decode Setup dialog. Once decoders have been configured, use
the Serial Decode dialog to quickly turn on/off a decoder or make minor modifications to the settings.
To turn on decoders:
1. On the same row as the Decode #, check On to enable the decoder.
As long as On is checked (and there is a valid acquisition), a result table and decoded
waveform appear. The number of rows of data displayed will depend on the Table #Rows
setting (on the Decode Setup dialog).
2. Optionally, modify the:
l
Protocol associated with the decoder.
l
Data (Source) to be decoded.
To turn off decoders: deselect the On boxes individually, or touch Turn All Off.
6
Serial Decode
Reading Waveform Annotations
When a decoder is enabled, an annotated waveform appears on the oscilloscope display, allowing you
to quickly see the relationship between the protocol decoding and the physical layer. A colored
overlay marks significant bit-sequences in the source signal: Header/ID, Address, Labels, Data Length
Codes, Data, CRC, Parity Bits, Start Bits, Stop Bits, Delimiters, Idle segments, etc. Annotations are
customized to the protocol or encoding scheme.
The amount of information shown on an annotation is affected by the width of the rectangles in the
overlay, which is determined by the magnification (scale) of the trace and the length of the
acquisition. Zooming a portion of the decoder trace will reveal the detailed annotations.
SAS Waveform Annotations
Annotation
Overlay Color (1)
Text (2)
Grouped Primitives
Burgundy
(behind primitives)
<primitive> frame
(e.g., IDLE frame)
Primitive Data
Blue
<type> Data
(e.g., IDLE Data)
Frame
Dark Purple
(behind data)
<TYPE> <SUBTYPE> frame
(e.g., SSP COMMAND frame, Data
frame)
Start/End of Frame
Brick Red
<SOF | EOF>
Data
Blue
(behind frame fields)
Data:<word>
Frame Fields:
Frame Type
Changing Data Point
ReTransmit
Retry Data Frames
Number of Fill Bytes
Initiator & Target Port Transfer Tags
Data Offset
Logical Unit Number
Task Attribute & Priority
Enable First Burst
Additional CBD Length
Operation Code
Service Action
Logical Block Address(es)
Transfer Length
Control
Ignored Data
Data
Green
(blue-green over Data annotation)
<field>:<bytes>
Cyclic Redundancy Check
Royal Blue
CRC
Out of Band Signaling
Protocol Error/Unknown
OOB
Red
<Protocol Error | Unknown>
1. Combined overlays affect the appearance of colors.
2. Text in brackets < > is variable. The amount of text shown depends on your zoom factors.
7
SAS and SATA Decoder Software Instruction Manual
Initial decoding of SAS waveform. At this resolution, little information appears on the overlay.
Zoom of decoding showing annotation details.
8
Serial Decode
SATA Waveform Annotations
Annotation
Overlay Color (1)
Text (2)
Idle Data
Dark Green
(behind Idle data)
Idle Data
Grouped Primitives
Burgundy
(behind primitives)
<primitive>
(e.g., ALIGN, SYNC, X-RDY, WTRM )
Data
Blue
XXXX<word>
Frame
Dark Purple
(behind data)
<TYPE> frame
(e.g., DMA_SETUP frame, DATA
frame)
Start/End of Frame
Brick Red
<SOF | EOF>
Frame fields:
FISType
PMPort
Gray
<field>
Frame fields:
Data
Reserved Bits
DMA Buffer Identifier & Offset
DMA Transfer Count
Status High/Low
Error
Protocol Specific
LBA
Sector Count
Green
(blue-green over Data annotation)
<field>:<bytes>
Cyclic Redundancy Check
Royal Blue
CRC
Out of Band Signaling
Protocol Error/Unknown
(frame error determined using CRC)
OOB
Red
<Protocol Error | Unknown>
1. Combined overlays affect the appearance of colors.
2. Text in brackets < > is variable. The amount of text shown depends on your zoom factors.
Initial decoding of SATA waveform.
Zoom of decoding showing annotation details.
9
SAS and SATA Decoder Software Instruction Manual
Serial Decode Result Table
When View Decode is checked on the Decode Setup Dialog and a source signal has been decoded
using that protocol, a table summarizing the decoder results appears below the grids. This result
table provides a view of data as decoded during the most recent acquisition, even when there are too
many bursts for the waveform annotation to be legible.
You can export result table data to a .CSV file. See also Automating the Decoder.
Tip: If any downstream processes such as measurements reference a decoder, the result
table does not have to be visible in order for the decoder to function. Hiding the table can
improve performance when your aim is to export data rather than view the decoding.
Table Rows
Each row of the table represents one index of data found within the acquisition, numbered
sequentially. Exactly what this represents depends on the protocol and how you have chosen to
"packetize" the data stream when configuring the decoder (frame, message, packet, etc.).
Note: For some decoders, it is even possible to turn off packetization, in which
case all the decoded data appears on one row of the table.
When multiple decoders are run at once, the index rows are combined in a summary table, ordered
according to their acquisition time. The Protocol column is colorized to match the input source that
resulted in that index.
You can change the number of rows displayed on the table at one time. The default is five rows.
Swipe the table up/down or use the scrollbar at the far right to navigate the table. See Using the
Result Table for more information about how to interact with the table rows to view the decoding.
Table Columns
When a single decoder is enabled, the result table shows the protocol-specific details of the
decoding. This detailed result table may be customized to show only selected columns.
A summary result table combining results from two decoders always shows these columns.
10
Column
Extracted or Computed Data
Index
Number of the line in the table
Time
Time elapsed from start of acquisition to start of message
Protocol
Protocol being decoded
Message
Message identifier bits
Data
Data payload
CRC
Cyclic Redundancy Check sequence bits
Status
Any decoder messages; content may vary by protocol
Serial Decode
Example summary result table, with results from two decoders combined on one table.
When you select the Index number from the summary result table, the detailed results for that index
drop-in below it.
Example summary result table showing drop-in detailed result table.
SAS Detailed Result Table
Column
Extracted or Computed Data
Index
(always shown)
Number of the line in the table
Time
Time from start of acquisition to start of symbol sequence
Type
Primitive or frame type
Details
For primitives: counts, errors
For frames: header info, decoded payload data, errors
Section of typical SAS detailed result table.
SATA Detailed Result Table
Column
Extracted or Computed Data
Index
(always shown)
Number of the line in the table
Time
Time from start of acquisition to start of symbol sequence
Type
Primitive or frame type
Details
For primitives: counts, errors
For frames: header info, decoded payload data, errors
Section of typical SATA detailed result table.
11
SAS and SATA Decoder Software Instruction Manual
Using the Result Table
Besides displaying the decoded serial data, the result table helps you to inspect the acquisition.
Zoom & Search
Touching any cell of the table opens a zoom centered around the part of the waveform corresponding
to the index. The Zx dialog opens to allow you to rescale the zoom, or to Search the acquisition. This
is a quick way to navigate to events of interest in the acquisition.
Tip: When in a summary table, touch any data cell other than Index and Protocol to zoom.
The table rows corresponding to the zoomed area are highlighted, as is the zoomed area of the
source waveform. The highlight color reflects the zoom that it relates to (Z1 yellow, Z2 pink, etc.). As
you adjust the zoom scale, the highlighted area may expand to several rows of the table, or fade to
indicate that only a part of that Index is shown in the zoom.
When there are multiple decoders running, each can have its own zoom of the decoding highlighted
on the summary table at the same time.
Note: The zoom number is no longer tied to the decoder number. The software tries to match
the numbers, but if it cannot it uses the next zoom that is not yet turned on.
Example multi-decoder summary table, both zoomed indexes highlighted.
Filter Results
Those columns of data that have a drop-down arrow in the header cell can be filtered:
Touch the header cell to open the Decode Table Filter dialog.
12
Serial Decode
Select a filter Operator and enter a Value that satisfies the filter condition.
Operators
Data Types
Returns
=, ≠
Numeric or Text
Exact matches only
>, ≥, <, ≤
Numeric
All data that satisfies the operator
In Range, Out Range
Numeric
All data within/without range limits
Equals Any (on List),
Does Not Equal Any (on List)
Text
All data that is/is not an exact match to any full value on
the list. Enter a comma-delimited list of values, no spaces
before or after the comma, although there may be spaces
within the strings.
Contains, Does Not Contain
Text
All data that contains or does not contain the string
Note: Once the Operator is selected, the dialog shows the format that may be entered in Value
for that column of data. Numeric values must be within .01% tolerance of a result to be
considered a match. Text values are case-sensitive, including spaces within the string.
Select Enable to turn on the column filter; deselect it to turn off the filter. Use the Disable All button
to quickly turn off multiple filters. The filter settings remain in place until changed and can be reenabled on subsequent decodings.
Those columns of data that have been filtered will have a funnel icon (similar to Excel) in the header
cell, and the index numbers will be colorized.
Example filtered decoder table.
On summary tables, only the Time, Protocol, and Status columns can be filtered.
If you apply filters to a single decoder table, the annotation is applied to only that portion of the
waveform corresponding to the filtered results, so you can quickly see where those results occurred.
Annotations are not affected when a summary table is filtered.
View Details
When viewing a summary table, touch the Index number in the first column to drop-in the detailed
decoding of that record. Touch the Index cell again to hide the details.
If there is more data than can be displayed in a cell, the cell is marked with a white triangle in the
lower-right corner. Touch this to open a pop-up showing the full decoding.
13
SAS and SATA Decoder Software Instruction Manual
Navigate
In a single decoder table, touch the Index column header (top, left-most cell of the table) to open the
Decode Setup dialog. This is especially helpful for adjusting the decoder during initial tuning.
When in a summary table, the Index column header cell opens the Serial Decode dialog, where you
can enable/disable all the decoders. Touch the Protocol cell to open the Decode Setup dialog for the
decoder that produced that index of data.
14
Serial Decode
Customizing the Result Table
Performance may be enhanced if you reduce the number of columns in the result table to only those
you need to see. It is also especially helpful if you plan to export the data.
1. Press the Front Panel Serial Decode button or choose Analysis > Serial Decode, then open the
Decode Setup tab.
2. Touch the Configure Table button.
3. On the View Columns pop-up dialog, mark the columns you want to appear and clear those you
wish to remove. Only those columns selected will appear on the oscilloscope display.
Note: If a column is not relevant to the decoder as configured, it will not appear.
To return to the preset display, touch Default.
4. Touch the Close button when finished.
On some decoders, you may also use the View Columns pop-up to set a Bit Rate Tolerance
percentage. When implemented, the tolerance is used to flag out-of-tolerance messages (messages
outside the user-defined bitrate +- tolerance) by colorizing in red the Bitrate shown in the table.
You may customize the size of the result table by changing the Table # Rows setting on the Decode
Setup dialog. Keep in mind that the deeper the table, the more compressed the waveform display on
the grid, especially if there are also measurements turned on.
Exporting Result Table Data
You can manually export the detailed result table data to a .CSV file:
1. Press the Front Panel Serial Decode button, or choose Analysis > Serial Decode, then open the
Decode Setup tab.
2. Optionally, touch Browse and enter a new File Name and output folder.
3. Touch the Export Table button.
Export files are by default created in the D:\Applications\<protocol> folder, although you can choose
any other folder on the oscilloscope or any external drive connected to a host USB port. The data will
overwrite the last export file saved, unless you enter a new filename.
Note: Only rows and columns displayed are exported. When a summary table is exported, a
combined file is saved in D:\Applications\Serial Decode. Separate files for each decoder are
saved in D:\Applications\<protocol>.
The Save Table feature will automatically create tabular data files with each acquisition trigger. The
file names are automatically incremented so that data is not lost. Choose File > Save Table from the
oscilloscope menu bar and select Decodex as the source.
15
SAS and SATA Decoder Software Instruction Manual
Searching Decoded Waveforms
Touching the Action toolbar Search button button on the Decode Setup dialog creates a 10:1 zoom of
the center of the decoder source trace and opens the Search subdialog.
Touching the any cell of the result table similarly creates a zoom and opens Search, but of only that
part of the waveform corresponding to the index (plus any padding).
Tip: In summary table mode, touch any cell other than Index and Protocol to create the zoom.
Basic Search
On the Search subdialog, select what type of data element to Search for. These basic criteria vary by
protocol, but generally correspond to the columns of data displayed on the detailed decoder result
table.
Optionally:
l
l
l
Check Use Value and enter the Value to find in that column. If you do not enter a Value, Search
goes to the beginning of the next data element of that type found in the acquisition.
Enter a Left/Right Pad, the percentage of horizontal division around matching data to display
on the zoom.
Check Show Frame to mark on the overlay the frame in which the event was found.
After entering the Search criteria, use the Prev and Next buttons to navigate to the matching data in
the table, simultaneously shifting the zoom to the portion of the waveform that corresponds to the
match.
The touch screen message bar shows details about the table row and column where the matching
data was found.
Advanced Search
Advanced Search allows you to create complex criteria by using Boolean AND/OR logic to combine
up-to-three different searches. On the Advanced dialog, choose the Col(umns) to Search 1 - 3 and the
Value to find just as you would a basic search, then choose the Operator(s) that represent the
relationship between them.
16
Serial Decode
Decoding in Sequence Mode
Decoders can be applied to Sequence Mode acquisitions. In this case, the index numbers on the
result table are followed by the segment in which the index was found and the number of the sample
within that segment: index (segment-sample).
Example filtered result table for a sequence mode acquisition.
In the example above, each segment was triggered on the occurrence of ID 0x400, which occurred
only once per segment, so there is only one sample per segment. The Time shown for each index in a
Sequence acquisition is absolute time from the first segment trigger to the beginning of the sample
segment.
Otherwise, the results are the same as for other types of acquisitions and can be zoomed, filtered,
searched, or used to navigate. When a Sequence Mode table is filtered, the waveform annotation
appears on only those segments and samples corresponding to the filtered results.
Note: Waveform annotations can only be shown when the Sequence Display Mode is
Adjacent. Annotations are not adjusted when a Sequence Mode summary table is filtered, only
the table data.
Multiple decoders can be run on Sequence Mode acquisitions, but in a summary table, each decoder
will have a first segment, second segment, etc., and there may be any number of samples in each. As
in any summary table, the samples will be interleaved and indexed according to their actual
acquisition time. So, you may find (3-2) of one decoder before (1-1) of another. Filter on the Protocol
column to see the sequential results for only one decoder.
17
SAS and SATA Decoder Software Instruction Manual
Improving Decoder Performance
Digital oscilloscopes repeatedly capture "windows in time". Between captures, the oscilloscope is
processing the previous acquisition.
The following suggestions can improve decoder performance and enable you to better exploit the long
memories of Teledyne LeCroy oscilloscopes.
Decode Sequence Mode acquisitions. By using Sequence mode, you can take many shorter
acquisitions over a longer period of time, so that memory is targeted on events of interest.
Parallel test using multiple oscilloscope channels. Up-to-four decoders can run simultaneously, each
using different data or clock input sources. This approach is statistically interesting because multichannel acquisitions occur in parallel. The processing is serialized, but the decoding of each input
only requires 20% additional time, which can lessen overall time for production validation testing, etc.
Avoid oversampling. Too many samples slow the processing chain.
Optimize for analysis, not display. The oscilloscope has a preference setting (Utilities > Preference
Setup > Preferences) to control how CPU time is allocated. If you are primarily concerned with quickly
processing data for export to other systems (such as Automated Test Equipment) rather than viewing
it personally, it can help to switch the Optimize For: setting to Analysis.
Turn off tables, annotations, and waveform traces. As long as downstream processes such as
measurements or Pass/Fail tests reference a decoder, the decoder can function without actually
displaying results. If you do not need to see the results but only need the exported data, you can
deselect View Decode, or minimize the number of lines in a table. Closing input traces also helps.
Decrease the number of columns in tables. Only the result table rows and columns shown are
exported. It is best to reduce tables to only the essential columns if the data is to be exported, as
export time is proportional to the amount of data exchanged.
18
Serial Decode
Automating the Decoder
As with all other oscilloscope settings, decoder features such as result table configuration and export
can be configured remotely.
Configuring the Decoder
The object path to the decoder Control Variables (CVARs) is:
app.SerialDecode.Decoden
Where n is the decoder number, 1 to 4. All relevant decoder objects will be nested under this. Use the
XStreamBrowser utility (installed on the oscilloscope desktop) to view the entire object hierarchy.
The CVAR app.SerialDecode.Decoden.Decode.ColumnState contains a pipe-delimited list of all the
table columns that are selected for display. For example:
app.SerialDecode.Decode1.Decode.ColumnState = "Idx=On|Time=On|Data=On|..."
If you wish to hide or display columns, send the full string with the state changed from "on" to "off", or
vice versa, rather than remove any column from the list.
Timebase, Trigger, and input Channel objects are found under app.Acquisition.
Accessing the Result Table
The data in the decoder Result Table can be accessed using the Automation object:
app.SerialDecode.Decoden.Out.Result.CellValue(line index, column index)(item index, depth index)
n:= 1 to 4
line index:= 1 to K
column index:= 1 to L
item index:= {0, 1, 2} where 0=Value, 1=StartTime, 2=StopTime
depth index:= 1 to M
19
SAS and SATA Decoder Software Instruction Manual
ProtoSync
ProtoSync™ adds many of the same algorithms used by the Teledyne LeCroy hardware protocol
analyzers to your decoder, enabling you to view the logic layer display of a protocol analyzer in sync
with the physical layer display of an oscilloscope. There is no need to export the decoded data to
another device, and the integrated graphical user interface makes it easy to switch between the
views, or to arrange them side by side on the screen. Changing the decoder on the oscilloscope
updates ProtoSync in real time for comprehensive physical and protocol layer debug and analysis.
Note: ProtoSync requires the installation of both the option key and the SAS or SATA
ProtoSync software. The ProtoSync software is available as a free download from
teledynelecroy.com. After installing the software, go to the
Start/Programs/LeCroy/<SAS|SATA> Protocol Suite folder to find more extensive
documentation for understanding the Protocol Analyzer.
ProtoSync Dialog
When the ProtoSync option is installed, the ProtoSync subdialog appears behind the protocol-specific
decoder subdialogs.
ProtoSync Protocol View
The Protocol View displays data packets in a format consistent with hardware protocol analyzers.
Each row represents the decoded bits from one transaction/packet, with each cell color-coded to
indicate different data types. Transactions are shown as either upstream or downstream.
Selecting any row in the Protocol View table will simultaneously zoom to that portion of the waveform
in the decoder window.
To display the decoding in Protocol View, open the ProtoSync dialog and either:
l
l
Touch Show Protocol Analysis to manually launch ProtoSync
Select Show Protocol Analysis on every trigger. This option repeatedly sends data to
ProtoSync.
Decoding shown in Protocol View display.
20
Technical Support
Technical Support
Live Support
Registered users can contact their local Teledyne LeCroy service center at the number listed on our
website.
You can also submit Technical Support requests via the website at:
teledynelecroy.com/support/techhelp
Resources
Teledyne LeCroy publishes a free Technical Library on its website. Manuals, tutorials, application
notes, white papers, and videos are available to help you get the most out of your Teledyne LeCroy
products. Visit:
teledynelecroy.com/support/techlib
The Datasheet published on the product page contains the detailed product specifications.
Service Centers
For a complete list of offices by country, including our sales & distribution partners, visit:
teledynelecroy.com/support/contact
Teledyne LeCroy
700 Chestnut Ridge Road
Chestnut Ridge, NY, 10977, USA
teledynelecroy.com
Sales and Service:
Ph: 800-553-2769 / 845-425-2000
FAX: 845-578-5985
contact.corp@teledynelecroy.com
Support:
Ph: 800-553-2769
customersupport@teledynelecroy.com
21
Download PDF