Waveform Analyzer Manual
Contents
1. 1 800 570 7004 E sales emea celoxica com sales japan gceloxica com sales america celoxica com www celoxica com Waveform Analyzer Manual Celoxica Contents 1 OVERVIEW RARARA X GR KRARG GR RRRARRRERR 4 1 1 STARTING THE WAVEFORM 1 2 4 1 2 WAVEFORM ANALYZER FILE FORMATS 4 CELSUS ERE Eege 5 1 4 CONNECTING A SIMULATION TO A 5 1 5 CONNECTING A PATTERN TO A 7 1 6 CONNECTING IN PARALLEL 22242znERRaERRRRRRERRERAERRZENSARRRAEREENERRRRRRRE 9 1 7 MEASURING TI ME AND VALUE DIFFERENCES IN WINDOWS 10 1 8 FINDING A SEQUENCE IN A TRACE OR PATTERN 10 1 9 GROUPING TRACE AND PATTERN 5 11 1 10 GENERATING PATTERNS 11 1 1 1 USING TRIGGERS iesasaxuRaRSRRERRARANRERERESRERRRSRERRERRSERRAERESERRRERRARARAEEE 12 2 PATTERN GENERATION LANGUAGE 14 2 1 USING THE PATTERN GENERATION LANGUAGE 142. those open when you last saved the project and any scripts you have written in the project 3 1 Waveform Analyzer toolbar icons New 1 Edit trace Delete trace New pattern 1 Edit pattern Paste Delete pattern Edit script Zoom max Zoom Zoom out Zoom Stop min www celoxica com Page 20 Waveform Analyzer Manual L Zoom on cursor Jump to cursor New cursor Delete cursor Celoxica 1 3 2 Trace Pattern window The Trace and Pattern windows use the same layout The top half of the window shows the trace or pattern details The bottom half of the window shows the values and positions of marks you have set on the trace or pattern The marks are referred to as cursors and are represented by coloured triangles 2 www celoxica com Page 21 Waveform Analyzer Manual Celoxica TRACE WINDOW The six panes visible in the above diagram contain reading from left to right Trace pattern name s and port s Current value at selected cursor Waveform over time Cursor list with values relative to current cursor Cursors with absolute time values Time and cursors The current trace is out lined with a green dashed line The current cursor has a red underline Right clicking the trace waveform or t
3. 2 2 STATEMENTS iiss5s255sssRuRRERRERRRENREERRERERERKEFRERRRETERRAREEREARRRARREARRRE 15 2 3 FUNCTIONS IN 16 2 4 WILD CARD MATCHING IN PGL NK KKK KKK KEE uuu 17 2 5 PGL SYNTAX Ra akkunan 18 WAVEFORM ANALYZER INTERFACE ssss222222222523334RRRRRRRRERERRRRRERRRRRRRAAAN 20 3 1 WAVEFORM ANALYZER TOOLBAR 5 20 3 2 TRACE PATTERN WINDOW amp sczxsxsxsxexaxtzsEREAFRERNAXEEAEEEAERRAReEREREREREANRERE 21 3 3 MENUS REIR ARA ARAS REG RARARRARARARRRARRGA 23 MENU RETE 23 3 3 2 Edit un LEE 25 3 3 3 MIeW EE 25 3 3 4 ET AE 26 3 3 5 IPabter erit ad MCI e 29 3 3 6 5 tera atin selon Mas devia RD TA TRIER 32 3 3 7 Capture MON Sead x e RO ts 32 3 3 8 Window MENU zi eoe oer Ep XR E dont Ue ae cw d ga rp nde 33 S 3 9 EE 34 EP 2 EE 35 www celoxica com Page 1 Waveform Analyzer Manual Celoxica Conventions A number of conventions are used in this document These conventions are detailed below Warning Message These messages warn you that actions may damage your hardware Handy Note These messages dr
4. 5 View menu 25 W Waveform Analyzer 4 controlling 32 33 file format 4 overview 4 starting 4 waveforms 10 25 copying 25 finding 10 25 wildcards eoe 17 PGL 17 Window 33 2 ED 20 25 Celoxica e www celoxica com Page 36
5. Celoxica DK4 Waveform Analyzer Manual For DK version 4 Waveform Analyzer Manual Celoxica Celoxica the Celoxica logo and Handel C are trademarks of Celoxica Limited All other products or services mentioned herein may be trademarks of their respective owners Neither the whole nor any part of the information contained in or the product described in this document may be adapted or reproduced in any material form except with the prior written permission of the copyright holder The product described in this document is subject to continuous development and improvement particulars of the product and its use contained in this document are given by Celoxica Limited in good faith However all warranties implied or express including but not limited to implied warranties of merchantability or fitness for purpose are excluded This document is intended only to assist the reader in the use of the product Celoxica Limited shall not be liable for any loss or damage arising from the use of any information in this document or any incorrect use of the product The information contained herein is subject to change without notice and is for general guidance only Copyright 2004 Celoxica Limited All rights reserved Authors SB Document number UM 2012 1 2 Customer Support at http www celoxica com support Celoxica in Europe Celoxica in Japan Celoxica in the Americas T 44 0 1235 863 656 T 81 0 45 331 0218 T
6. a Trace Properties dialog Fields the Trace Properties dialog box gt New Trace are e www celoxica com Page 27 Waveform Analyzer Manual Field Name Width Type Points Clock Period Expression Dump File Variable Trigger Celoxica Description Name for the trace This name will be displayed in a box on the left of the Trace window The name can also be used as part of a trigger specification for this or any other trace The name must be a C style identifier Width of the data in the trace in bits Whether the trace represents signed or unsigned data Number of points in the trace This is the value you entered when you created the Trace window It cannot be edited Rate at which data is read into the trace This is the value you entered when you created the Trace window It cannot be edited Port s the trace is connected to The expression may be of the form Terminal Name width as for the DKConnect plugin or a Handel C expression with expressions of the form Terminal Name width in place of variables Enter a filename to capture the trace to a file Two file formats are supported ASCII files and Verilog Value Change Dump files If the filename ends in vcd dmp or dump a Value Change Dump file will be produced otherwise an ASCII file will be produced The Browse button can be used to select a filename If no filename is entered no dump file will be pro
7. a double quote For example tracel would cause the trace or pattern whose details are being entered to use the same trigger as the trace named tracel 3 Select the appropriate radio button No trigger No triggering amp www celoxica com Page 12 Waveform Analyzer Manual Celoxica Single Transmit or capture the first time the trigger is received Auto Transmit or capture each time the trigger is received To specify the delay between the trigger and the action 1 Open the Pattern or Trace Properties dialog 2 Specify a trigger 3 Enter the number of time units in the Delay box on the Properties dialog The delay is in the time units for that window Delays can be positive or negative for a trace negative delays capture before the trigger positive after and positive or zero for a pattern To pause on trigger 1 Open the Pattern or Trace Properties dialog 2 Specify a trigger 3 Check the Pause box e www celoxica com Page 13 Waveform Analyzer Manual Celoxica 2 Pattern Generation Language The Waveform Analyzer uses Pattern Generation Language PGL as a scripting language to generate patterns PGL has a similar expressive power to regular expressions but uses a C like syntax You can use it to trigger on a sequence of data and search for a sequence of data in a trace or pattern When executed a PGL program generates a sequence of values You can use a PGL program to trigger or sear
8. aw your attention to crucial pieces of information Hexadecimal numbers will appear throughout this document convention used is that of prefixing the number with in common with standard C syntax Sections of code or commands that you must type are given in typewriter font like this void main Information about a type of object you must specify is given in italics like this copy SourceFileName DestinationFileName Optional elements are enclosed in square brackets like this struct type Name Curly brackets around an element show that it is optional but it may be repeated any number of times string character www celoxica com Waveform Analyzer Manual Celoxica Assumptions amp Omissions This manual assumes that you e have used Handel C or have the Handel C Language Reference Manual e are familiar with common programming terms e g functions e are familiar with MS Windows This manual does not include e instruction in VHDL or Verilog e instruction in the use of place and route tools e tutorial example programs These are provided in the Handel C User Manual www celoxica com Waveform Analyzer Manual Celoxica 1 Overview The Waveform Analyzer connects to ports in Handel C simulations It displays outputs from Handel C simulations as waveforms traces You can generate inputs to Handel C simulations and display them as waveforms patterns You can manipu
9. ch for any pattern that could be generated by passing parameters to the program 2 1 Using the Pattern Generation Language You can use the Pattern Generation Language PGL to e Generate patterns that are fed into a port e Identify a sequence of data a trace that you wish use as a trigger You can use the trigger to start recording the trace or to start generating a pattern If you have defined a trigger associated with a trace or pattern you may re use it as a trigger for other traces or patterns Find a sequence of data in a trace or a pattern Entering PGL statements When you need to enter a PGL statement in a dialog box you can enter any statement including compound statements and function calls For example the following are all valid PGL statements e 2 e 0 1 e rising edge valid if the rising edge function has been defined But these are not e 2 missing semi colon e 0 1 curly brackets must surround compound statements You can write PGL functions in the script pgl file associated with a project Complex pattern matching and pattern generation If you need to generate more complex patterns than those that can be generated with PGL or if you need to trigger efficiently on a complex sequence of words consider writing a separate Handel C program to perform your pattern generation or pattern www celoxica com Page 14 Waveform Analyzer Manual Celoxica matching For trigger
10. cted portion of the pattern Saves the selected portion of a trace or pattern to a file You will be prompted for a file name and if the file is a VCD file a reference name to use for the signal in the VCD file 3 3 3 View menu e www celoxica com Page 25 Waveform Analyzer Manual Command Toolbar Status Bar Zoom Max Zoom In Zoom Out Zoom Min Zoom on Cursor Jump to Cursor New Cursor Delete Cursor Description Toggles the toolbar on off Toggles the Status Bar on off Zooms in to the maximum extent at the centre of the active trace or pattern window Zooms in at the centre of the active trace or pattern window Zooms out from the centre of the active trace or pattern window Zooms out to the maximum extent from the centre of the active trace or pattern window Zooms in on the selected cursor in the active trace or pattern window Scrolls to the selected cursor in the active trace or pattern window Creates a new cursor in the centre of the active trace or pattern window Deletes the selected cursor from the active trace or pattern window 3 3 4 Trace menu Command New Trace Edit Trace Delete Trace Description Creates a new trace in the active Trace window Edits the selected trace in the active Trace window Removes the selected trace from the active Trace window www celoxica com Page 26 Celoxica Waveform Analyzer Manual Celoxic
11. cursor icon on the toolbar or select New Cursor from the View menu The cursor will be added to the centre of the time pane of the active trace or pattern window Moving cursors e Drag the cursor across the time pane Selecting cursors e Double click a cursor A red bar will appear beneath it to show that it is selected By default the first cursor created is the selected cursor Only one cursor can be selected at a time Deleting cursors e Select the cursor you wish to delete e Click the Delete Cursor icon on the toolbar or select Delete Cursor from the View menu 1 8 Finding a sequence in a trace or pattern To find a sequence of data in a trace or pattern 1 Activate the window containing the trace or pattern you wish to search 2 Click on the trace or pattern you want to search 3 Select Edit gt Find 4 Enter a PGL statement or function in the Find what box in the Find dialog www celoxica com Page 10 Waveform Analyzer Manual Celoxica 1 9 Grouping trace and pattern windows You can group Trace Windows and Pattern Windows together into Waveform Analyzer projects Only one project may be open at a time You must create a project if you want to use a Pattern Generation Language script file Creating a project Open the Waveform Analyzer and select New Project from the File menu A dialog box will appear asking you to select a file name for the new project Project file names have an apj ex
12. d separated by white space www celoxica com Page 4 Waveform Analyzer Manual Celoxica e Value Change Dump VCD files This file format is specified in the IEEE 1364 1995 standard When you create a new trace the extension you type in the Dump file box in the Trace Properties dialog gt New determines whether a VCD an ASCII file is produced If the extension is vcd dmp or dump the file is a Value Change Dump file otherwise it is an ASCII file Similarly Pattern source files with the extensions vcd dmp or dump are recognised as VCD files else the file is assumed to be an ASCII file Saving traces in a VCD file A VCD file can contain any number of variables If you need to dump several traces to the same VCD file enter the same VCD filename in the Dump File box on the Trace Properties dialog for every trace that should be written to the file The Variable box in the Trace dialog is used to enter a reference name which will be used in the VCD file for the signal variables are output to a single top level scope called top Reading patterns from VCD files When reading a pattern from a VCD file you need enter the reference name of the variable in the VCD file which needs to be read in the Variable box in the Pattern dialog This name must specify the scope in which the variable occurs and the reference name of the variable within that scope Scopes are terminated using the character For
13. dio button Click OK Start capturing Start capturing by clicking the Run icon on the toolbar or by selecting Run from the Capture menu A red dashed line should appear jumping around all over the place This line marks the current position in the trace Run the Handel C simulation To stop capturing click on the stop button on the toolbar or select Stop from the Capture menu You must also stop the Handel C simulation 1 5 Connecting a pattern to a port To connect a pattern to a port you must 1 Write and compile Handel C code to connect a Handel C port to a terminal using the DKConnect and the DKSync plugins Set up a pattern window in the analyzer generating a signal to the named terminal Simulate the Handel C code and start transmitting the pattern Writing the Handel C program Open Handel C create a new project and enter the following program www celoxica com Page 7 Waveform Analyzer Manual Celoxica set clock external with extlib DKSync dll extinst 50 extfunc DKSyncGetSet interface bus in unsigned 1 in ib1 with extlib DKConnect dll extinst t 1 extfunc DKConnectGetSet unsigned 5 count 0 void main void d while count 4 count 2 if ibl in 0 delay if ibl in 1 count else delay Now compile the program but do not run it This program uses the DKConnect plugin to conn
14. duced If the dump file is a Verilog Value Change Dump file enter the name which will be used as the reference name of the signal in the VCD file Specifies which sequences of words triggering should occur on If this box is empty no trigger is used and all further trigger options are greyed out www celoxica com Page 28 Waveform Analyzer Manual Delay No trigger S ingle Auto Pause on Trigger Interpolated Waveform Stepped Waveform Numeric Symbolic Define Symbols Celoxica Specifies the trigger delay This may be positive or negative If a positive delay x is used capturing begins x time units after a trigger sequence occurs If a negative delay is used capturing begins x time units before a trigger sequence occurs Select trigger mode No trigger triggering is disabled Single a trace is captured once after a trigger sequence occurs Auto a trace is captured after every occurrence of a trigger sequence If this checkbox is ticked capturing will be automatically paused after a trigger sequence has occurred and a trace has been captured Selects the display format for the trace Opens the Define Symbols dialog where you can select how values are represented 3 3 5 Pattern menu Command Description New Pattern Creates a new pattern in the active pattern window Edit Pattern Allows you to edit the selected pattern in the active pattern window Delete Pattern Remove
15. ect the port ib1 in to the terminal t 1 The program will only terminate when it has detected 20 rising edges from the port ibl in Setting up a Pattern Window 1 Open the Waveform Analyzer 2 Select New from the File menu and create a new pattern with a filename of your choosing with 40 as the number of points and 50 as the clock period An empty Pattern window should appear 3 Select New Pattern from the Pattern menu or from the toolbar and enter the following properties in the dialog box Name testpattern Width 1 www celoxica com Page 8 Waveform Analyzer Manual Celoxica Type unsigned Source Select Script radio button Enter 20 0 1 in the box Variable Greyed out Destination t 1 Trigger Leave box blank Other settings should be greyed out Delay Greyed out with 0 as default Display Check Stepped Waveform radio button 4 Click OK Starting transmission 1 Run the Handel C simulation 2 Start transmission by clicking the Run icon the toolbar or by selecting Run from the Capture menu The Handel C program should terminate shortly after transmission is started 3 To stop capturing click on the stop icon on the toolbar or select Stop from the Capture menu 1 6 Connecting in parallel If you wish to connect the Waveform Analyzer to ports that are connected to other plugins you may do so using the DKShare d11 Example interface bus out seg output unsigned 7 output
16. erval by which to advance simulations when Advance is selected Set Advance Step dialog Celoxica The Set Advance Step dialog Capture Set Advance Step specifies the time in nanoseconds to advance all simulations by 3 3 8 Window menu Command Description Cascade Cascades all open windows Tile Tiles all open windows Arrange Icons Automatically arranges all minimized trace and pattern windows www celoxica com Page 33 Waveform Analyzer Manual Celoxica 3 3 9 Help menu Command Description Help Topics Invokes the online help About Displays details about Waveform Analyzer e www celoxica com Page 34 Waveform Analyzer Manual 4 Index A files 2 eect ee eee eee eee 11 Capture 32 capturing waveforms 32 connecting a pattern to a port 7 connecting a simulation to a trace 5 o in eg Ee PA 10 21 D Define symbols dialog 31 11 5 7 DKShare dll 5 7 9 24 5 7 4 dump FIGS 4 Edit men 25 examples eaten 5 7 connecting simulation to a trace 5 pattern generation 7 F 23 Help menu 2 34 M measuring differenc
17. es 10 time 10 value 10 MEDUS nmt Hx RA D nina 20 N New window dialog 24 P Pattern Generation Language 14 Celoxica functions 16 limitations 17 scripts 16 32 statements 15 sub programs 16 syntax 11 18 wildcards 17 Pattern 29 Pattern Properties dialog 29 Pattern 21 29 patterns ick 7 11 29 creating 11 23 grouping 11 properties 7 29 31 PG mE 14 functions 16 limitations 17 scripts 16 32 statements 15 sub programs 16 syntax 11 18 wildcards 17 POTUS TTE 5 7 9 Waveform Analyzer 5 7 9 lte e CN 11 Waveform Analyzer 11 S Script menu 32 C 14 16 PGL 14 set advance step 20 32 33 starting the Waveform Analyzer 4 statements cere ex xen 15 PGL 15 T time 10 ele e 20 e www celoxica com Waveform Analyzer Manual waveform analyzer 20 Trace menu ott eret rne 26 Trace Properties dialog 27 Trace window 21 27 ThACES P 5 11 21 23 26 27 creating 23 grouping 11 properties 5 27 triggers E 12 U user interface 20 waveform analyzer 20 V value change dump files 4 value difference 10 e 4
18. example main scopel x refers to the variable x in the scope scopel which is a subscope of main 1 3 Time units Time units are not explicitly defined in the Waveform Analyzer Any Handel C simulation to which you connect the Waveform Analyzer should use the DKSync plugin with the clock period for the simulation specified in an extinst string When you enter the clock period for a trace or pattern window you determine the sample rate for the trace or patterns in the window relative to the clock period specified for the Handel C simulation If the clock period for the trace or pattern is the same as the clock period specified in the extinst string in the Handel C program the trace or pattern will be sampled on every cycle of the Handel C program If the clock period for the trace or pattern is twice the clock period specified in the extinst string in the Handel C program the trace or pattern will be sampled on every other cycle of the Handel C program and so on It is a matter of convenience to make the clock periods that you use correspond to the clock periods that will be used in the target hardware The VCD file reader writer used by the Waveform Analyzer assumes that the time units used are nanoseconds 1 4 Connecting a simulation to a trace To connect a simulation to a trace you must _ www celoxica com Page 5 Waveform Analyzer Manual Celoxica Write and compile Handel C code to connect a Handel C port to a termi
19. he current value pane gives you a menu of possible display formats for that pane You can have multiple traces or patterns in a single window but they all use the same cursors the same number of points and the same clock period Zooming You can zoom in and out of the active Trace or Pattern window using the zoom icons or the Zoom options from the View menu _ www celoxica com Page 22 Waveform Analyzer Manual Celoxica 3 3 Menus 3 3 1 File menu Command Description New Ctrl N Creates a new trace or pattern window You will be prompted for the type of window Trace or Patern a filename for the window and the clock period and number of points for the window The clock period and the number of points that you specify will be used for all traces or patterns in the window Open Opens an existing trace or Ctri O pattern file Close Closes the active trace or pattern window Save Ctri S Saves the active trace or pattern window Save As Saves the active trace or pattern window with a different name Save All Saves all open trace and pattern windows New Project Creates a new project Open Project Opens an existing project Close Project Closes the current project Save Project Saves the current project Print Prints the active trace or pattern window Print Setup Sets up the printer details Print Preview Previews the active trace or pattern window Recent Files List of recentl
20. his box is used to specify which sequences of words and which trace triggering should occur on If this box is empty no trigger is used and all further trigger options are greyed out e www celoxica com Page 30 Waveform Analyzer Manual Delay No trigger Single Auto Pause on Trigger Interpolated Waveform Stepped Waveform Numeric Symbolic Define Symbols Celoxica Specifies the trigger delay For patterns this must be positive A delay of x means that transmission begins x time units after a trigger sequence occurs Choose the trigger mode No trigger triggering is disabled Single a pattern is transmitted once after a trigger sequence occurs Auto a pattern is transmitted after every occurrence of a trigger sequence If this checkbox is ticked capturing will be automatically paused after a trigger sequence has occurred and a pattern has been transmitted Selects the display format for the pattern Opens the Define Symbols dialog where you can select how values are represented Define symbols dialog The Define symbols dialog consists of a set of radio buttons which allow you to choose how values are represented Binary Octal Decimal Hexadecimal numbers ASCII characters User defined strings You must supply the file name of a file which associates symbols with values for the trace being defined Each line of this file should contain a number in binary octal decimal o
21. ing you could output a trigger signal from this Handel C program to Waveform Analyzer and then use a simple PGL statement to trigger on this signal 2 2 PGL statements You can use any of the following statements as a PGL statement Expression statement For example 1 When an expression statement is executed it generates the value of the expression An expression statement used for matching may also be of the form 1 This statement will match any value except 1 Compound statement For example 0 1 The statements enclosed in the braces get executed sequentially Loop statement For example 100p 3 0 1 The body of this 100p will get executed 3 times Conditional statement For example if 1 0 1 else 1 0 Here the statements that get executed depend upon the value of the variable a You can build Boolean tests using the following operators amp amp Switch statement For example switch a d 1 0 1 default 1 0 break P 2 www celoxica com Page 15 Waveform Analyzer Manual Celoxica This switch statement achieves the same thing as the conditional statement described above Assert statement For example assert a 0 This kind of statement can be used to place constraints on matched variables when matching 2 3 Functions in PGL PGL allows you to define and call functions which can take parameters You can only define functions in an o
22. l encode out with extlib DKShare dl1 extinst Share iextlib 7segment dll extinst lt A gt extfunc lt PlugInSet gt Share extlib lt DKConnect dl1 gt extinst lt SS 7 gt extfunc lt DKConnectGetSet gt extfunc DKShareGetSet This example uses DKShare d11 to share the output port output output1 between the 7 segment display and DKConnect connected to terminal SS 7 You can then trace the output going to the 7 segment display by using SS 7 as the expression in the Trace properties window www celoxica com Page 9 Waveform Analyzer Manual Celoxica 1 7 Measuring time and value differences in windows You can measure the time between two events and the difference in the value of a signal at two different times by placing marks in Trace and Pattern Windows These marks are represented by coloured triangles and will be referred to as cursors One cursor is always selected The cursor triangles are placed in the time pane of the trace or pattern window If there is more than one cursor in the time pane the time pane displays the differences in time between cursors The bottom centre pane displays the absolute position in time of all cursors The differences in values between the cursors are displayed in the bottom left pane If multiple traces or patterns are displayed in a window the values given are those of the selected trace or pattern Creating cursors e Click on the New
23. late the simulated inputs and outputs in the same way that input and output signals from a real piece of hardware can be manipulated with a logic analyzer You can perform the following tasks e Connect traces to output ports Handel C simulations e Connect patterns to input ports Handel C simulations e Connect the Waveform Analyzer to ports connected to another simulation using the DKShare plugin connecting in parallel e Measure the differences between values and times in traces or patterns using cursor marks e Create patterns by writing scripts using Pattern Generation Language PGL by copying existing traces or patterns into a pattern window Patterns can also be read from a file e Specify triggers the Pattern Generation Language e Capture traces or generate patterns when a specified trigger appears in a trace e Find a specified pattern in a trace or pattern window 1 1 Starting the Waveform Analyzer To start the Waveform Analyzer chose one of the following e Select Start gt Programs gt DK Design Suite gt Waveform Analyzer e Double click the icon for the analyzer exe file L in the DK Bin directory e Double click on a Waveform Analyzer project apj e Double click on a trace trc or pattern pat file 1 2 Waveform Analyzer file formats The Waveform Analyzer supports 2 different file formats for storing waveform data These are e ASCII files where data elements are written in ASCII an
24. nal using the DKConnect and the DKSync plugins Set up a trace window in the analyzer which reads the signal from the named terminal Simulate the Handel C code and start capturing Sample Handel C program Open Handel C create a new project and enter the following program set clock external with extlib DKSync dll extinst 50 extfunc DKSyncGetSet unsigned 3 x 0 interface bus_out obl unsigned 3 out x with extlib DKConnect dll extinst t 3 extfunc DKConnectGetSet void main void while 1 Now compile the program but do not run it This program uses the DKConnect plugin to connect the port ob out to the terminal eer Setting up a Trace window 1 2 3 4 Open the Waveform Analyzer Select New from the File menu and create a new trace Select the browse button to specify a filename and location of your choosing Set Default Clock Period to 50 and Default No points to 40 An empty Trace window should appear Select New Trace from the Trace menu or from the toolbar and enter the following properties in the dialog box Name testtrace Width 3 Type unsigned e 2 www celoxica com Page 6 Waveform Analyzer Manual 6 Celoxica Expression t 3 Dump file Leave blank Variable Greyed out Trigger Leave box blank Other settings should be greyed out Delay Greyed out with 0 as default Display Check the Stepped Waveform ra
25. ntered during matching Context sensitive matches can be carried out in this way For example if a function is defined as follows count fives a a loop a 5 and called using the statement count_fives it will match any sequence consisting of a number followed by that number of fives including the sequence 0 This feature should be used carefully since it is possible to use it write functions which take a very long time to match Do not use the expression expression statements starting with or assert statements in PGL programs these are used to generate patterns www celoxica com Page 17 Waveform Analyzer Manual Celoxica 2 5 PGL syntax subprogram def identifier parameter list compound statement parameter list identifier identifier parameter list statements statement statement statements statement subprogram call compound statement Toop statement if statement if else statement switch statement break statement expression statement assert statement subprogram call identifier expression parameter list expression parameter list expression expression expression parameter list compound statement statements loop statement loop expression statement loop forever statement if statement if boolean expression statement if else statement if b
26. oolean expression statement else statement switch statement switch expression case list default statements case list case case case list case case number statements www celoxica com Page 18 Waveform Analyzer Manual Celoxica break statement break expression statement expression expression assert statement assert boolean expression boolean expression expression expression expression expression expression boolean expression amp amp boolean expression boolean expression boolean expression boolean expression boolean expression here amp amp has higher precedence than and both are left associative expression number identifier Numbers must be binary octal decimal or hexadecimal integers and use the same syntax as Handel C i e Ob for binary numbers O for octal numbers Ox for hex numbers all other numbers are treated as decimals Identifiers are C style identifiers i www celoxica com Page 19 Waveform Analyzer Manual Celoxica 3 Waveform Analyzer interface The Waveform Analyzer interface consists of menu bar e A tool bar e workspace area e Any trace or pattern windows you have open e log output window used by the program to report errors to the user You may group trace or pattern windows together in a project Projects contain a number of trace or pattern windows
27. pen project The functions are stored in the script pgl file associated with that project You may edit this file outside the Waveform Analyzer Defining functions 1 Open the project in which you want to use the functions 2 Click on the EditScript icon on the toolbar or select EditScript from the Script menu This opens script pgl in Notepad This file resides in the same directory as the project file Example The following example defines two functions one called rising edge and the other called rectangular wave rising edge 0 1 rectangular wave hival hicount loval locount cycles loop cycles loop hicount hival loop locount You can call the rectangular wave function with a statement like this rectangular wave 1 5 0 5 10 www celoxica com Page 16 Waveform Analyzer Manual Celoxica 2 4 Wild card matching in PGL If you use a PGL program for triggering or searching you can have a 7 character in any place where a number or variable could go This character stands for any value For example the compound statement 1 1 would match against any 3 word sequence starting and ending with a 1 If is used as a parameter in a function call when the function is called the formal parameter which corresponds to the has no value assigned to it If a variable is encountered which has no value assigned to it it gets assigned a value according to the values encou
28. r hexadecimal using the Handel C syntax followed by a symbol The symbol should be separated from the number using white space Any values which may appear in the Trace and which do not have symbols associated with them will be represented using the character For example if the trace is of width 3 is unsigned and the user defined symbol file contains the following 06001 e www celoxica com Page 31 Waveform Analyzer Manual Celoxica 00111 00110 0b101 B the values 1 5 6 and 7 will be represented as A B C and D respectively The values 0 2 3 and 4 will all be represented as question marks 3 3 6 Script menu Command Description Edit Script Allows you to edit the PGL script for the current project 3 3 7 Capture menu e 4 www celoxica com Page 32 Waveform Analyzer Manual Command Run F5 Pause Stop Shift F5 Advance Ctrl F11 Set Advance Step Description Starts reading traces from simulations and sending patterns to simulations Temporarily stops traces being sent to simulations and patterns being read from simulations This also suspends all connected simulations Stops reading traces from simulations and sending patterns to simulations Simulations continue running after Waveform Analyzer has stopped Advances all simulations by the interval specified in the Set Advance Step box Opens Set Advance Step dialog which allows you to specify the int
29. s in PGL programs that are used to generate patterns Complex pattern generation If you need to generate more complex patterns than those which can be generated with PGL you should consider writing a separate Handel C program to perform your pattern generation 1 11 Using triggers You can specify a sequence of data that you want to use as a trigger or re use an existing specification When the trigger sequence occurs you can e Start capturing a trace before at or after the specified trigger e Start generating a pattern at or after the specified trigger Pause simulations once a trace has been captured or a pattern has been generated To specify a trigger 1 Open the Pattern or Trace Properties dialog 2 Enter trace name in the Trigger box followed by PGL statement trace name is the name of a pre defined trace note that it must be followed by a colon The PGL statement will be matched against the named trace For example b s 10512 would cause the pattern to be generated on a rising edge of trace b 3 Select the appropriate radio button No trigger No triggering Single Transmit or capture the first time the trigger is received Auto Transmit or capture each time the trigger is received To re use a specified trigger 1 Open the Pattern or Trace Properties dialog 2 Enter name in the Trigger box where name is the name of the trace or pattern that uses a trigger Note that name must be preceded by
30. s the selected pattern from the active pattern window Pattern Properties dialog Fields in the Pattern Properties dialog box Pattern gt New Pattern are www celoxica com Page 29 Waveform Analyzer Manual Field Name Width Type Points Clock Period Source Variable Destination Trigger Celoxica Description Name for the pattern The name is displayed in a box on the left of the Pattern window The name must be a C style identifier Width of the data in the pattern in bits Whether the pattern represents signed or unsigned data Number of points in the pattern This is the value you entered when you created the Pattern window It cannot be edited Rate at which data is read into the pattern This is the value you entered when you created the Pattern window It cannot be edited The source for the pattern may be either a file or a script Supported file formats are ASCII and VCD The box to the right of the radio buttons is used to enter a script if the Script radio button is checked or a file name if the File radio button is checked If the source is a VCD file this box should be used to enter the reference name of the variable in the VCD file that will be used as the source for this pattern Expression of the form Terminal Name width as for the DKConnect plugin Transmission of a pattern can be triggered by the occurrence of a specified sequence of words in any trace T
31. tension 1 10 Generating patterns Generating a pattern from an existing trace or pattern You can copy data from a trace or pattern into the clipboard and then paste the contents of the clipboard into a pattern 1 Drag the mouse pointer over a region of a trace or pattern to select it 2 Copy the region to the clipboard by selecting Copy from the Edit menu or with the Copy icon on the toolbar 3 Make a pattern window active and either select a region to paste over or select a cursor 4 Select Paste from the Edit menu or click on the Paste icon on the toolbar If you selected a region the clipboard contents are pasted into the selected pattern starting at the beginning of the selected region If you selected a cursor the clipboard contents are pasted into the window starting at the selected cursor location Generating a pattern from a PGL statement 1 Select Script as the pattern source in the Pattern Properties dialog 2 Enter the PGL statement or function call in the box to the right of the button Generating a pattern from a file 1 SelectFile as the pattern source in the Pattern Properties dialog 2 Enter the filename in the box to the right of the button Use the Browse button to browse for a file www celoxica com Page 11 Waveform Analyzer Manual Celoxica Pattern generation limitations It is an error to use the expression expression statements starting with and assert statement
32. y used trace or pattern files Recent Projects List of recently used projects e www celoxica com Page 23 Waveform Analyzer Manual Exit Closes all windows and exits the application New window dialog Field Description Untitled box Select the window type Pattern Window or Trace Window Default clock Enter the default clock period period for the window Default No points Enter the number of points recorded in the window Filename and File where the window details location are stored use the browse button to choose a directory Celoxica DM www celoxica com Page 24 Waveform Analyzer Manual Celoxica 3 3 2 Edit menu Command Find Ctrl F Copy Ctrl C Paste Ctrl V Save Selection As Description Searches for a specified sequence of data words in the selected trace or pattern You will be prompted for a PGL statement describing the sequence of words to search for the search direction and whether to scroll to the sequence if it is found Searching starts at the position of the selected cursor If there is no cursor searching starts at the beginning of the selected trace or pattern the sequence is found the selected cursor is positioned at the start of the sequence If there is no cursor a cursor is created at the start of the sequence Copies the selected portion of a trace or pattern to the clipboard Pastes the contents of the clipboard into the sele
Download Pdf Manuals
Related Search