1. Manuals
  2. Brands
  3. Catalyst Manuals
  4. Measuring Instruments
  5. AirCom UWB Analyzer
  6. User manual

Catalyst AirCom UWB Analyzer User Manual

Ultra-wideband protocol analyzer and frame generator
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
User's Manual
Version 1.22
March 2007
P/N 400-0103-001

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the AirCom UWB Analyzer and is the answer not in the manual?

Questions and answers

Summary of Contents for Catalyst AirCom UWB Analyzer

  • Page 1 User’s Manual Version 1.22 March 2007 P/N 400-0103-001...
  • Page 2 Man y countries prohibit the disposal of waste electronic equipment in standard waste receptacles. For more information about proper disposal and recycling of your Catalyst product, please visit www.getcatalyst.com/recycle.
  • Page 3 Copyright Catalyst Enterprises, Inc. FCC Conformance Statement Compliance with 47 CFR 15.519 (a)(1) This device complied with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including inter- ference that may cause undesired operation.
  • Page 4 Catalyst Enterprises Inc. Copyright...

  • Page 5: Table Of Contents

    Catalyst Enterprises, Inc. Table of Contents Introduction - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 What’s In this Manual - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1...
  • Page 6 Catalyst Enterprises Triggering Setup - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 23 Snapshot Mode - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 23...
  • Page 7 Catalyst Enterprises, Inc. Statistical Report- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 47...
  • Page 8 Catalyst Enterprises Appendix B - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 83...

  • Page 9: Introduction

    This manual describes the installation and operation of your Catalyst AirCom UWB Analyzer. Examples of some typical applications are included. Analyzer Overview The Catalyst AirCom UWB Analyzer is capable of capturing and analyzing UWB traffic. The analyzer supports the following: •...

  • Page 10: Interface

    Catalyst Enterprises Inc. Introduction Interface • Power In • USB Port • Ethernet Port • External trigger Input • External trigger Output LEDs Each link is supported by 4 LEDs with the following functionality: Green This LED is illuminated indicating an active link.

  • Page 11: Receiving Your Analyzer

    Inspect the received shipping container for any damage. Unpack the container and account for each of the system components listed on the accompanying packing list. Visually inspect each component for absence of damage. In the event of damage notify the shipper and Catalyst Enterprises. Retain all shipping materials for shipper’s inspection.

  • Page 12: Installing Your Analyzer

    Catalyst Enterprises Inc. Installing Your Analyzer Installing Your Analyzer Hardware Setup WINDOWS BASED HOST WITH ANALYZER SOFTWARE WUSB DUT WUSB HOST Figure 1 Typical WUSB Test Setup of Analyzer Software Installation On systems operating under Windows® 2000 and Windows® XP.

  • Page 13: Connecting Via Ethernet

    Installing Your Analyzer Catalyst Enterprises, Inc. Connecting via Ethernet You may use the ethernet connection using any one of the following 3 supported configurations: 1. The Analyzer connected to a network via a hub, switch, or similar device. 2. The Analyzer connected to the host computer (machine running the application software), via a hub, switch or similar device.

  • Page 14: Connecting Via Hub, Switch Or Similar Device

    If the assigned IP address is not available, the OS will notify the user of an IP address conflict. After the user clicks ‘OK’ the software will search for all Catalyst boards connected to the network, and will display a list of available Catalyst boards, after the user selects the desired Catalyst board, the software will assign the IP address to the selected board, completing the connection and will launch the software.

  • Page 15: Launching Your Analyzer

    To launch the Analyzer software, double-click the AirCom icon on your Windows desktop. You can also launch the Analyzer software from the start menu by choosing Programs, Catalyst, AirCom and then Aircom. When you run your software it will display the Device selection Dialog. You must make a Local device selection or Hardware Not Installed to run the Analyzer software in Simulation mode and click OK.

  • Page 16: Software Launched

    Catalyst Enterprises Inc. Launching Your Analyzer Software Launched New Protocol Analyzer or Frame Generator Project Open Open Sample File Save Print Open Last Saved Analyzer Project Scan UWB Channels Run Project Stop Project Cancel Project Figure 2 Analyzer Main Toolbar...

  • Page 17: Protocol Analyzer Projects

    Protocol Analyzer Projects Catalyst Enterprises, Inc. Protocol Analyzer Projects Protocol Analysis is performed by defining and running a Protocol Analysis Project, which defines what will be captured, what the analyzer will trigger on and capture memory settings. Defined projects may be saved as project *.wac files for later use.
  • Page 18 Catalyst Enterprises Inc. Protocol Analyzer Projects Project Overview A comprehensive tree structured overview of the project is displayed in the Project Tree display. The project tree shows what is to be captured, what the analyzer will trigger on and capture memory settings.
  • Page 19 Protocol Analyzer Projects Catalyst Enterprises, Inc. Link Status Link status displays general link activity. To display Link Status click the Link Status bus indicator in the Status bar. You may hide any layer by clicking the corresponding Show/Hide button on the menu bar.

  • Page 20: Example Projects

    Catalyst Enterprises Inc. Protocol Analyzer Projects Example Projects Your Analyzer includes a number of pre-defined example projects that you may use to perform an immediate analysis without any setup. The Analyzer system software comes with a pre-defined folder (Directory) structure for storing all files.

  • Page 21: Run An Example Protocol Analyzer Project

    Protocol Analyzer Projects Catalyst Enterprises, Inc. Run an Example Protocol Analyzer Project 1. Click File on the main menu bar and then choose Open. 2. Locate available example Protocol Analyzer Projects by looking in: c:\Program Files\Catalyst\AirCom\Examples. 3. Choose an example *.wac file and click Open to display the example project dialog.

  • Page 22: Saving A Trace Capture

    Catalyst Enterprises Inc. Protocol Analyzer Projects Figure 6. Analyzer Trace Capture Display See "Data Display Manipulation" on page 32 and "Display Configuration" on page 66 for details about the results display. Saving a Trace Capture You may save a Trace Capture...

  • Page 23: Protocol Analyzer Project Setup

    Protocol Analyzer Projects Catalyst Enterprises, Inc. Protocol Analyzer Project Setup You may define a new project starting with the default project definition, or modify the settings for the last project run. Default Project Clicking File, New opens a new project with default settings that you can modify as required.

  • Page 24: Data Capture Setup

    Catalyst Enterprises Inc. Protocol Analyzer Projects Data Capture Setup Capture Everything The default Capture Tab opens with capture Everything selected and the corresponding default Trigger On tab with Don’t care (Snapshot) selected. Clicking run with these default settings will immediately start a data capture to give the user a quick view of bus activity.
  • Page 25 Protocol Analyzer Projects Catalyst Enterprises, Inc. Capture Pattern To define specific patterns for capture, click the Pattern button. Figure 9. Choosing Capture Patterns The Parameters window displays the following pattern capture choice categories: • Frame • Information Element • WUSB Packet •...

  • Page 26: Pre And Post Trigger Data Capture

    Catalyst Enterprises Inc. Protocol Analyzer Projects Figure 10. Exclude Patterns Checked To remove an item from capture, highlight it in the Project tree and click the <<Remove button. Pre and Post Trigger Data Capture You may define one set of patterns for capture prior to the occurrence of a trigger and another set of patterns for capture after the occurrence of a trigger.

  • Page 27: Defining Patterns

    Protocol Analyzer Projects Catalyst Enterprises, Inc. Defining Patterns To select an item for capture, either highlight the category and click the Add>> button or double-click the category to open a corresponding definition dialog. Frame Double-click Frame to display the Frame specification dialog.
  • Page 28 Catalyst Enterprises Inc. Protocol Analyzer Projects Figure 13. Choosing a Specific Field Note: Beacon, Control, Command and Data specific fields offer additional options. WUSB Packet Double-click WUSB packet to display the WUSB packet specification dialog. 1. Enter values in the Common Fields area for Source ID, Destination ID, Sequence Control and Stream Index.
  • Page 29 Protocol Analyzer Projects Catalyst Enterprises, Inc. Information Element Double-click Information Element to display the Information Element specification dialog 1. Enter values in the Common Fields area for Source ID, Destination ID, Sequence Control and Stream Index. 2. Click the down arrow next to the Information Element drop-down combo box and choose an Information Element Type for capture.
  • Page 30 Catalyst Enterprises Inc. Protocol Analyzer Projects Protocol Errors Double-click Protocol Errors to display the Protocol Errors selection dialog. Check the desired Protocol Error(s) for capture and click OK.

  • Page 31: Triggering Setup

    Protocol Analyzer Projects Catalyst Enterprises, Inc. Triggering Setup The Trigger-on tab, allows the user to specify when the analyzer will complete a data capture. Three trigger modes are available: The default Don’t care (Snapshot), Manual Trigger and Pattern. When a data capture is started with Don’t care (Snapshot) selected, the analyzer will trigger on the first data pattern detected.

  • Page 32: Pattern Mode

    Catalyst Enterprises Inc. Protocol Analyzer Projects Pattern Mode In Pattern mode the Analyzer will trigger whenever any one of the patterns selected for triggering occurs. The procedure for selecting trigger parameters is identical to that for selecting capture parameters. All items selected for triggering will appear in the Project Tree.

  • Page 33: External Trigger

    Protocol Analyzer Projects Catalyst Enterprises, Inc. Triggering on a Timer A timer may be set independently of any other trigger selection to cause an unconditional trigger after a set time. To set the timer value, double-click Timer in the Patterns window of the Capture Project dialog to open the Timer dialog.

  • Page 34: Sequential Trigger Mode

    Catalyst Enterprises Inc. Protocol Analyzer Projects Sequential Trigger Mode In the Sequential Trigger mode, triggering occurs whenever a specific sequence of patterns are detected. The sequence is established by the order in which the triggering patterns are defined. To define a triggering sequence, check the Define Sequential Trigger Mode check box.
  • Page 35 Protocol Analyzer Projects Catalyst Enterprises, Inc. Figure 17. Number of Occurrences Triggering order As triggering patterns are defined and added they are displayed in the Project Tree sequentially in the order that they were entered under the Trigger On category. When the project is run, the analyzer will detect the occurrence of each pattern in order and trigger on the last one.

  • Page 36: Project Settings

    Catalyst Enterprises Inc. Protocol Analyzer Projects Project Settings To set project options click the Settings tab. Figure 18. Setting Project Options Trace Memory Status Memory Size To reduce the capture memory size, check Partial Memory and enter the desired buffer size or, check entire memory to allow capture for the entire memory (1 GB) if you want to capture the maximum amount of trace data.

  • Page 37: Analyzer Settings

    Protocol Analyzer Projects Catalyst Enterprises, Inc. Analyzer Settings Scan Channels Click the Scan Channels button to scan for active channels. Start Channel Set the Start Channel number to the active channel to be analyzed. Protocol Error Mask Click the Protocol Error Mask button to open the Protocol Error Mask dialog.

  • Page 38: Pre-Trigger

    Catalyst Enterprises Inc. Protocol Analyzer Projects Pre-Trigger The amount of data to be captured before and after the trigger may be set as a percentage of pre-trigger, between 1% and 99%. This may be done by positioning the pre-trigger slider to the desired percentage. This feature allows the evaluation of bus activity leading up to and after the triggering event.

  • Page 39: Frame Generator Projects

    Frame Generator Projects Catalyst Enterprises, Inc. Frame Generator Projects Defining and running a Frame Generator Project will enable you to transmit user defined frames over the air. To run a Frame Generator Project you must first create Frame Generator files, which define the frames that you want to transmit.

  • Page 40: Data Display Manipulation

    Catalyst Enterprises Inc. Data Display Manipulation Data Display Manipulation View Packets Display The data viewer display may be configured to meet your individual test and viewing preference needs. Toolbars are available for quick access to data viewer display features. Figure 22. View Packets Display...

  • Page 41: Spec View

    Data Display Manipulation Catalyst Enterprises, Inc. Spec View To get a comprehensive specification of frame content, position a Frame to be the first item in the sample viewer and click View on the main toolbar and choose Show Spec View. You may also get a Frame specification by right-clicking on any frame in the sample viewer.

  • Page 42: Spec View Options

    Catalyst Enterprises Inc. Data Display Manipulation Spec View Options To change the Spec View options, right click in the Spec View window and choose the data radix (Hexadecimal or Binary), choose to show data only or copy Field Contents or all Contents to save in a different format.

  • Page 43: Data View

    Data Display Manipulation Catalyst Enterprises, Inc. Data View Whenever the payload data exceeds what can conveniently be displayed in a Frame data field only the initial data values are displayed and an Expand/Collapse Data Payload toggle is enabled. Click this toggle to display all of the Payload Data.
  • Page 44 Catalyst Enterprises Inc. Data Display Manipulation To save the data in a special file, click the Export button to open a Save As dialog. Choose a folder where to save the file, a file name and Save As type (Either Text or Binary) and click OK.

  • Page 45: Viewer Toolbar

    Data Display Manipulation Catalyst Enterprises, Inc. Viewer Toolbar Search button opens the search dialog. Statistical Report button displays the statistical report setup dialog. Click the Full Screen button to increase the data display area to full on the screen. Click the Zoom In button to magnify the data display area of interest on the screen.
  • Page 46 Catalyst Enterprises Inc. Data Display Manipulation Click the Normal Zoom button to reset the zoom to default normal on the screen and in column and frame text view. Click the Wrap Packets button to wrap the packet data in the display to eliminate the need for horizontal scrolling.

  • Page 47: Layers Toolbar

    Data Display Manipulation Catalyst Enterprises, Inc. Layers Toolbar Click the Show/Hide Transfer button on the Layers Toolbar to toggle between show and hide of the Transfer layer. Click the Show/Hide Transaction button on the Layers Toolbar to toggle between show and hide of the Transaction layer.

  • Page 48: Interpretation Aids

    Catalyst Enterprises Inc. Data Display Manipulation Interpretation Aids There are several user selectable options available to assist in interpreting the results displayed in the Sample View. To select any of the available options, right click in a data field in the Sample Viewer and choose the desired option.

  • Page 49: Set Direction Alias

    Data Display Manipulation Catalyst Enterprises, Inc. Set Time Stamp Origin Right click on any field and choose Time Stamp Origin and select the desired time stamp origin. Set Direction Alias Direction Alias allows you to assign a meaningful name to each traffic direction to assist in interpreting the Sample View.

  • Page 50: User Defined Decoding (Udd)

    Catalyst Enterprises Inc. Data Display Manipulation User Defined Decoding (UDD) User Defined Decoding allows you to assign custom decoding for the data stream. The AirCom software includes some pre-defined scripts. Custom decoding is created by using scripts that are described in “Appendix B” on page 83.
  • Page 51 Data Display Manipulation Catalyst Enterprises, Inc. Assign Protocol Button Figure 29. Assign Script Choose an endpoint stage assignment from the Command dropdown list and click Figure 30. Script Assigned Click OK to complete assignment. A Show Decoding icon will appear in the Sample View for the endpoints with the...
  • Page 52 Catalyst Enterprises Inc. Data Display Manipulation Show Decoding Icon Click the Show Decoding Icon to display the decoding table for that endpoint. Figure 31. Decoding Table...

  • Page 53: Faded Packets

    Faded Packets Catalyst Enterprises, Inc. Faded Packets Faded Packets are used to display certain packets that are unrelated to a WUSB Transfer and also to show packets that are related to two or more different WUSB Transfers. Faded Packets are only used when the WUSB Transfer Layer is shown in View Packets.
  • Page 54 Catalyst Enterprises Inc. Faded Packets Figure 32. Illustration of Faded Packets...

  • Page 55: Statistical Report

    Statistical Report Catalyst Enterprises, Inc. Statistical Report Whenever a captured sample is displayed in the sample viewer, the Statistical Report selection in the Report menu and a Statistical Report Button on the viewer toolbar are enabled. You may create a Statistical Report for the entire capture or a select portion of it as desired.

  • Page 56: Statistical Report Content

    Catalyst Enterprises Inc. Statistical Report Statistical Report Content A complete statistical report consists of the following reports a that are accessed by clicking on the corresponding report tab in the dialog: • Frame • • WUSB Packet • HW Protocol Error •...

  • Page 57: Wusb Packet Report

    Statistical Report Catalyst Enterprises, Inc. WUSB Packet Report To display the WUSB Packet report view, click the WUSB Packet tab. The WUSB Packet report displays the report data in columns with the following information: • Type • Channel • Host Address •...

  • Page 58: Transfer Report

    Catalyst Enterprises Inc. Statistical Report Transfer Report To display the Transfer Report, click the Transfer tab.The Transfer report displays the report data in columns with the following information: • Type • Count • Host address • Occurrence Percent • Device Address IE Report To display the IE Report, click the IE tab.

  • Page 59: Hw Protocol Error Report

    Statistical Report Catalyst Enterprises, Inc. HW Protocol Error Report To display the HW Protocol Error Report, click the HW Protocol error tab. The HW Protocol Error report displays the report data in columns with the following information: • Packet •...

  • Page 60: Other Report

    Catalyst Enterprises Inc. Statistical Report Other Report To display the Other Report, click the Other tab. The Other report displays the report data in columns with the following information: • Sample Time • Total Traffic Time • Total Idle Time •...

  • Page 61: Statistical Report Toolbar

    Statistical Report Catalyst Enterprises, Inc. Statistical Report Toolbar The Statistical report toolbar provides the following functions accessible by buttons on the toolbar: • Export to Excel • Save as Text • Print Report • Print Preview • Report Display Settings Export as Microsoft®...

  • Page 62: Print Preview

    Catalyst Enterprises Inc. Statistical Report Print Preview Click the Print Preview Button on the Statistical Report Toolbar to display a preview of the report to be printed. Figure 34. Sample Print Preview of Report...

  • Page 63: Report Display Settings

    Statistical Report Catalyst Enterprises, Inc. Report Display Settings You may set up the report columns for display to suit a particular analysis need. You may globally choose the columns for display thereby eliminating the need to show hide columns individually. Use the Setting dialog to configure the display for each page.

  • Page 64: Link With Sample View

    Catalyst Enterprises Inc. Statistical Report Link With Sample View Whenever a Type is selected on any page of the statistical report, a set of navigation buttons is enabled allowing you to examine each instance of that type in the sample viewer.

  • Page 65: Formatting The Statistical Report View

    Statistical Report Catalyst Enterprises, Inc. Formatting the Statistical Report View Initially the Statistical Report View contains all of the information in columns, but you may customize the display for your needs by: • Sorting items by column • Filtering Columns by item •...

  • Page 66: Hiding Columns

    Catalyst Enterprises Inc. Statistical Report Hiding Columns To hide a column, right click in the column and choose Hide. To unhide a column, right click on any column and choose Unhide. Sorting Column Content To sort column content, click the heading for that column. Repeated clicking of the column heading will sort the column in ascending or descending order.

  • Page 67: Filtering Toolbar

    Statistical Report Catalyst Enterprises, Inc. Filtering Toolbar Filter Enable button enables the Advanced Filter selection button. Advanced Filter button opens the Advanced Filter specification dialog. Hide Device button hides packets associated with specific hardware. Click the down arrow on the button to select hardware.

  • Page 68: Advanced Filter

    Catalyst Enterprises Inc. Statistical Report Advanced Filter The Filtering patterns option allows you to modify the Sample Viewer display to show or hide Packets with a set of user defined patterns. In order to set up filtering, you must have a viewer display open and enable the filter.

  • Page 69: Using Pointers And Bookmarks

    Statistical Report Catalyst Enterprises, Inc. Using Pointers and Bookmarks Pointers The data viewer display incorporates three cursors labeled X, Y and T. The X,Y pointers are initially overlaid and positioned at location 0. The Trigger, or T, pointer shows the trigger point in the captured sample and is the measurement reference.

  • Page 70: Bookmarks

    Catalyst Enterprises Inc. Statistical Report Bookmarks Bookmarks is a convenient way to mark a point in the data viewer display by name, such that you can rapidly return to that point. To create a bookmark: 1. Right click in the sample viewer on a packet where you wish to place the bookmark.
  • Page 71 Statistical Report Catalyst Enterprises, Inc. Finding a Bookmark To find a bookmark, right click the mouse in the sample viewer and click bookmark. Figure 39. Go To Bookmark Dialog Box Highlight the bookmark that you wish to go to and click the Go button.

  • Page 72: Search

    Catalyst Enterprises Inc. Statistical Report Search The search option permits you to examine any data capture file to quickly locate packets of interest. Whenever an initial sample file is displayed, the Search, button is enabled on the Viewer toolbar. To perform a search, click the Search button to open the search setup dialog as shown in Figure 40.
  • Page 73 Statistical Report Catalyst Enterprises, Inc. You may continue to search the output file for the same pattern by clicking the Find Next button until you redefine the data capture search parameters. Data Pattern Search for Data Pattern allows you to search for: •...

  • Page 74: Display Configuration

    Catalyst Enterprises Inc. Display Configuration Display Configuration The Analyzer ships with a default display configuration of field and viewer settings. You may, however, define your own field and viewer settings for a particular testing scenario. The View Packets Display Configuration dialog allows the user to change the following display settings: •...
  • Page 75 Display Configuration Catalyst Enterprises, Inc. Viewer Settings Check the Wrap Packet box to enable the wrapping of packets in the display. Check the Enable Tooltip box to enable tool tips for packet fields. To change the length of long byte fields displayed, enter a number of bytes to display in the Long Field Byte Count text box.
  • Page 76 Catalyst Enterprises Inc. Display Configuration...

  • Page 77: Creating A Frame Generator Pattern File

    Appendix A Catalyst Enterprises, Inc. Appendix A Creating a Frame Generator Pattern File A Frame Generator pattern file (*.wpg) is a user defined text file that is used by the Analyzer hardware to generate specific frames. To create a Pattern file you may use...
  • Page 78 Catalyst Enterprises Inc. Appendix A Byte Definitions Each line in a Pattern file consists of four bytes, Bytes 3, 2, 1 and 0. Byte 3 is the Flag Byte and is the left-most byte on each line. This byte must be defined for all lines in the Pattern file.
  • Page 79 Appendix A Catalyst Enterprises, Inc. Figure 44. Frame Fields Definition. As seen in the figure above, a frame is a stream of structured, formatted bytes, defined in a specific order. The user must insert the desired bytes/values of the frame in the...
  • Page 80 Catalyst Enterprises Inc. Appendix A Frame Example The following is a Pattern (*.wpg) example of an application-specific control frame. Figure 45.shows the information defined for the frame. 01 00 00 00 // Start of PHY Header - Octets 0 through 4...
  • Page 81 Appendix A Catalyst Enterprises, Inc. 00 00 00 00 00 00 00 30 00 00 00 05 00 00 00 00 00 00 00 A7 00 00 00 25 00 00 00 0A 00 00 00 00 00 00 00 00...
  • Page 82 Catalyst Enterprises Inc. Appendix A Figure 45. Information in Frame Example Delay Block In addition to a frame block, a Pattern file allows the insertion of delay blocks. A delay block format is a 4-line instruction, used by the Analyzer hardware to create delays between frames.
  • Page 83 Appendix A Catalyst Enterprises, Inc. To add an additional delay between frames, the user must add a delay block between the desired frames. The format of delay block is described in Figure 46. Figure 46. Delay Block Definition Format Location of Delay Blocks Delay block bytes must be inserted in the data byte fields (i.e., Byte 0).
  • Page 84 Catalyst Enterprises Inc. Appendix A 00 00 00 C0 // Security 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 24 00 00 00 00 00 00 00 00 00 00 00 00...
  • Page 85 Appendix A Catalyst Enterprises, Inc. // Start time 00 00 00 1A 00 00 00 00 // Device ID 00 00 00 30 // TXAttribute 00 00 00 05 00 00 00 00 // High bit is control status 00 00 00 A7...
  • Page 86 Catalyst Enterprises Inc. Appendix A 00 00 00 11 00 00 00 11 00 00 00 11 00 00 00 11 00 00 00 11 ////////////// // FCS 00 00 00 56 00 00 00 51 00 00 00 90...
  • Page 87 Appendix A Catalyst Enterprises, Inc. 00 00 00 00 00 00 00 00 // WUSB header 00 00 00 00 00 00 00 00 // Low 4 bit is sequence number // Data payload 00 00 00 12 00 00 00 01...
  • Page 88 Catalyst Enterprises Inc. Appendix A 00 00 00 BE 00 00 00 30 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 C0 // Security 00 00 00 00 00 00 00 00...
  • Page 89 Appendix A Catalyst Enterprises, Inc. 00 00 00 E3 00 00 00 35 02 00 00 93 //------------------- IN DATA 3 //PHY header 01 00 00 00 00 00 00 18 00 00 00 00 04 00 00 90 00 00 00 00...
  • Page 90 Catalyst Enterprises Inc. Appendix A 00 00 00 11 00 00 00 11 00 00 00 11 00 00 00 11 00 00 00 11 00 00 00 11 00 00 00 11 00 00 00 11 // FCS 00 00 00 B2...

  • Page 91: Advanced Script Language (Asl)

    This appendix is the essential reference for ASL users including definitions, code snippets, and complete examples. The decode script files can be written in any text editor or using the Catalyst script editor and must be saved with an *.asl file extension. Document conventions This appendix uses the following convention to describe the script syntax.

  • Page 92: Language Elements

    Catalyst Enterprises Inc. Appendix B Language Elements Integers ASL accepts integer values in decimal, binary, or hexadecimal formats. Floating point and negative numbers are not accepted. Examples: Hexadecimal: 0x21, 0x0001, 0xA5A5 Binary: 0b00100001, 0b1, 0b101001011010010110100101 Decimal: 33, 1, 42405 Strings Strings in ASL are permitted to be static character strings, or can contain variable values that are calculated at runtime.

  • Page 93: Comments

    Appendix B Catalyst Enterprises, Inc. Expressions The expressions consist of one or more Integers, Functions, or Operators. For more detail about functions see page 96. Examples: Expression 1: 0x2A and LengthOf(F1) Expression 2:(ValueOf(F1)<2) or not (LengthOf(F2)<>10) Expression 3:(4 + LengthOf(F1))* ValueOf(F2)

  • Page 94: Asl Structure

    Catalyst Enterprises Inc. Appendix B ASL Structure An ASL Script file includes two types of sections: • Protocol Extraction Section • Protocol Decoding Section Each ASL script may include only one of each section type. Each script file must contain a Protocol Extraction section, and a Protocol Decoding section.

  • Page 95: Protocol Extraction Section

    Appendix B Catalyst Enterprises, Inc. Protocol Extraction Section The decoding section is written as follows starts with [Decoding] and ends with the End keyword. [Decoding] Define Field Option Block Value Ranges Block Main Block The Main block contains statements. See “ASL Statements” on page 89 Product Section The product section identifies the product by name, such as SBAE for UWB.

  • Page 96: Valid Range Block

    Catalyst Enterprises Inc. Appendix B Description: This string is the description for specified range (Value1 to Value2) or specified value. Example /* F3, F4, F1 and BlockStatus are fields. */ DefineOptions F3 = (“First Option”, 0x0000-0x1000; “Second Option”, 0x1001-4352); F4 = (“Option 1 for F4”, 0x0-14, “Option 2 for F4”, 0x0f);...

  • Page 97: Asl Statements

    Appendix B Catalyst Enterprises, Inc. ASL Statements Addfield fieldId AddField (StartBit, Length, Name, Description, Abbreviation, BitOrder ) Remark This statement adds a field to a packet with given specification. This function increases CURPOS one Length. CURPOS is a pointer that when a field added moves on input data, it points to the current index of the data for the next field.

  • Page 98: Getdata

    Catalyst Enterprises Inc. Appendix B BitStuff BitStuff ( FieldId , n ) Remark If in a protocol one field transfer after bitstuffing algorithm the user can see the value of that field by using the BitStuff statement. This statement runs an unstuff algorithm on the specified field.
  • Page 99 Appendix B Catalyst Enterprises, Inc. If Expresssion Then Block1 Else If Expresssion Then Block2 Else If Expresssion Then Block3 … Else Block4 Remark The if statement evaluates expressions.(For information about expressions see “Expressions” on page 85 The if executes block1 if the expression is true (nonzero); if else is present and expression is false (zero), it executes block2 ;…...

  • Page 100: Repeat Count

    Catalyst Enterprises Inc. Appendix B Repeat Repeat Expresssion Block Remark This statement repeats all commands in block until the Expression is TRUE. Example F1 = AddField(0, 20, "Field1", "It starts form bit# 2", "F1"); F2 = AddField(20, 40, "Field2", "This field is used for..", "F2");...
  • Page 101 Appendix B Catalyst Enterprises, Inc. SubFieldOf SubFieldOf (FiledId [, Separeted]) Block Remark This statement specifies the sub fields of a specific field. Note that all AddField statements that exist in the body of the SubField statement are relative to the specified filed.

  • Page 102: Setfieldtableheader

    Catalyst Enterprises Inc. Appendix B SetTableHeader SetTableHeader(string); SetTableHeader(OptionalFieldId); Remark This statement sets the table header of interpreted data. The viewer will show the string in the header of the table that shows the interpretation of data. If user uses the SetTableHeader(OptionalFieldId) form of this statement, then the option string of the specified OptionalFieldId will be set as table header.
  • Page 103 Appendix B Catalyst Enterprises, Inc. Example OpCode = AddField (0, 8, “Op Code”, “Op Code”, “Op Code”); Type = AddField (CURPOS, 8, “Type”, “Type”, “Type”); SubFieldOf(Type, Separated) SetFieldTableHeader(Type, “Sub fields of type”); T1= AddField (0, 4, “T1”, “T1”, “T1”); T2= AddField (4, 8, “T2”, “T2”, “T2”);...

  • Page 104: Functions

    Catalyst Enterprises Inc. Appendix B Functions LengthOf ( Data ) Remark This function returns the length of Data. Parameters Data This parameter can be INPUTDATA or DataId of a data seg- ment that was specified in the GetData statement or can be a field specified by AddField.

  • Page 105: Curpos

    Appendix B Catalyst Enterprises, Inc. Find (StartBit, Value) Remark This function searches the input data from the given start bit for a specified value.It returns the first position of the first found value. If the value is not found it will return LengthOf(INPUTDATA) + 1.

  • Page 106: China Restriction Of Hazardous Substances Table

    Catalyst Enterprises Inc. Appendix B China Restriction of Hazardous Substances Table The following tables are supplied in compliance with China’s Restriction of Hazardous Substances (China RoHS) requirements:...

  • Page 107: Index

    Index Catalyst Enterprises Index example files Advanced Script Language (ASL) folder analyzer overview exclude from capture patterns language elements protocol extraction script structure faded packets ASL functions file type CURPOS definition filter LengthOf ( Data ) filtering StartOf ( FIELDIdentifier )
  • Page 108 Catalyst Enterprises Index project trigger file type definition external project note manually protocol on pattern error mask on timer protocol errors position in memory setup snapshot quick start triggering analyzer on timer sequential order relative time display UDD assignment save...
  • Page 110 LeCroy Corporation 3385 Scott Blvd. Santa Clara, CA 95054 Tel: 1-800-909-7112 Fax: 408-727-6622 www.lecroy.com...

Table of Contents