.


   

Traces

Traces refer to the actual signal data plot(s) generated on a display pane. The Traces menu item may be selected either by clicking on Pane / Traces in the pull-down menu, or by clicking on the Traces button on the main display.

The following "Select Traces Set" panel will appear:

The following table provides the trace descriptions for the Select Traces From This List field:

Traces
Description
Axis 0 Command Position Commanded Axis Position
Axis 0 Actual Position Actual FeedbackPosition
Axis 0 Position Error Axis Position Error (Commanded – Actual)
Axis 0 Command Velocity Axis Velocity Trajectory Command
Axis 0 Actual Velocity Axis Actual Velocity
Axis 0 Command Acceleration AxisAcceleration Trajectory Command
Axis 0 Status: At Target State of the At Target Flag for the Axis
Axis 0 Status: At Velocity State of the At Velocity Flag for the Axis
Axis 0 Status: Done State of the Done flag for the Motion Command
Axis 0 Status: Near Target State of the Near Target Position Flag
Axis 0 Status: Settled State of the Settled Position Flag
Filter 0 Output Demand signal output from Filter 0

On the left side of the panel are listed some of the possible signal data which can be traced. They are selected by clicking with the mouse, then clicking on the Add==> button below.

Click on the signal data to be traced , then on the Add==> button. The signal data will be added to the Trace Set for Pane list.

  • To select all signal data between two listings, hold down the Shift key while selecting with the mouse.
  • To select two or more signal data, hold down the Ctrl key while selecting each with the mouse.

NOTE: Motion Scope is defaulted to autoscale all of the traces selected unless otherwise specified. To turn off autoscale, go to the Manual Scaling section.

Trace Ordering Once a list is defined in the "Trace Set for Pane" window, you may order the arrangement by using the Trace Ordering switch. There are three menu items:

UserName Orders the list by user name.

MapName Orders the list by map name.

Address Orders the list by memory address (as ordered within the controller's firmware memory). TIP: click this menu item again to reverse the order.

Trace Ordering menu items arrange signal data on the Trace Set for Pane window by user name, map name, or memory address.

Modify Trace

Modify Trace menu items create, edit and close individual traces. These menu items are accessed on the right side of the Select Traces Set panel:

New and Edit Clicking on either the New or Edit button displays the Edit Trace Properties panel. If no trace is currently listed or selected within the "Trace Set for Pane" window, only the New button may be used.

Name Name assigned to the new or edited trace. Trace names can be assigned to correlate to specific axes, such as "X," "Y," etc.

Address Hexadecimal memory address to be assigned to the selected trace.
NOTE
: An Address must be specified for each Name. To determine the memory address of signal data, use the VM3 utility.

In the example below, SystemData.SampleCounter is shown on the VM3 screen with its hexadecimal address. When this address (0x00028010) is entered into the Address field of the Edit Traces Properties window, it may be plotted on the Motion Scope grid. The data's name (SystemData.SampleCounter) is manually entered into the Name field. Configure the Trigger window, then plot the data. Notice that the plot of SystemData.SampleCounter, which records time, is a constantly increasing line.


Plot of SystemData.SampleCounter data.

Bitmasking Allows bitmasking of current trace address. The following fields are used:

Masking Enabled When enabled, the data is masked. Mask-- Bit pattern to be masked (bitwise ANDed with mask).

Normalize Right If a Mask has zeros in its lower-order bit(s), the data value is shifted to the right. This is especially convenient for viewing binary, two-state values.

Data type Specifies the data type of the value stored at the Address. The following data types are selectable:

long Data is a long integer (32 bits).

float Data is a floating decimal point value (32 bits).

unsigned long Data is an unsigned, long integer (32 bits).

Display as hex When selected, data stored at the Address is displayed in hexadecimal form. If not selected, data stored at the Address is displayed in its default format.

Units Units applied to the vertical (Y) axis of the display pane. The following units are selectable:

Counts Encoder counts.

Counts/sec Encoder counts per second.

MilliSecs Milliseconds.

MilliVolts Millivolts.

None No units are applied to the vertical axis.

OK Enters settings and closes the Edit Trace Properties panel.

Cancel Closes the Edit Trace Properties panel without changing settings. Note Demo traces (available from the Pane / Mode menu item) cannot be edited.

Status Banding

The Status Banding menu item within the "Select Traces Set" panel turns on-off separate trace bands at the top of the pane for monitoring NEAR_TARGET and SETTLED status on a single axis. Two color schemes are used: green = FALSE; red = TRUE.


Trace showing use of Status Banding menu items.

In above, the Status Banding menu item has been enabled for the axis indicated by the Axis field. Command velocity (trapezoidal profile) reveals motor movement. As the command position (curved profile) crosses the NEAR_TARGET position value at , the NEAR_TARGET band (topmost band) changes color from green-FALSE, to red-TRUE. (Meaning, the position of the axis is now within the NEAR_TARGET envelope of the target position.) As the axis reaches the target position, it enters the IN_FINE envelope at , and the lower (SETTLED) status band changes color from green-FALSE, to red-TRUE.

NOTE:
The NEAR_TARGET status band remains green-FALSE for all conditions if the servo-stepper system is not commanded (e.g., dead or disconnected). Green can be interpreted as "not in position," which usually, but not always, means "moving."

Manual Scaling

Motion Scope is defaulted to autoscale all of the traces selected unless otherwise specified. To turn off the autoscale feature, you will need to individually modify each trace you do not want Motion Scope to autoscale. Click the Traces button. In the "Select Traces Set" window. Select a trace and click the Edit button.

Make sure you clear both auto scaling check boxes.

Repeat for any traces you want to scale manually. When scaling manually, use the YScale and YOffset for adjusting scaling.

 

Displaying Drive Monitor Fields in Motion Scope

 
  1. Open VM3.

  2. Navigate to the SynqNet buffer to retrieve memory locations of the monitor fields. <Press S>


  3. Monitor fields (if supported) are located in the status packets.
    Monitor Field A is located in the lower 16 bits and Monitor B is located in the upper 16 bits of memory location labeled Status.Motor[0].Monitor[0].
    Monitor C is located in the lower 16 bits of Monitor 1, Status.Motor[0].Monitor[1].

    In this example, we will display Monitor[0], whose address is 0x2324d.

    NOTE: The Monitor field addresses are dynamic addresses that are not constant.


 

Group Highlighted Traces

When displaying multiple signal data plot(s) on a display pane, it may be helpful to group certain signal data plots together so that they are displayed on the same scale.

Here are two graphs where the traces are NOT grouped together. Notice that the scale on each plot is different. The scale changes depending on which trace is chosen (highlighted in white).

Ax0 Cmd Pos selected
White - Command Position
Green - Actual Position     
Ax0 Act Pos selected
White - Actual Position    
Red - Command Position  

It would be easier to interpret the relationship between Actual and Command Positions if the traces were plotted on the same scale. This option can be set in MotionScope by using the Edit Trace Group feature. The graph below shows both traces using the same scale, because they were grouped together in MotionScope.

One scale for both Cmd Pos and Act Pos
White - Command Position
Green - Actual Position     
Follow the steps below to group two or more traces together.

1. Click on the Traces button.


The Select Traces Set window will appear. (see below)

2. Add the desired traces to the Traces Set for Pane listbox.

One scale for both Command Position and Actual Position
White - Command Position
Green - Actual Position     

3. Select the traces that you would like to group together and click the Add button under Group Highlighted Traces. The Edit Trace Group window will appear. Enter a name for the group (ex: positions) and click OK.

4. You will notice that the group called "positions" is listed in the Group highlighted Traces listbox. If you click on the group, the traces associated with the group will be highlighted in the Trace Set for Pane listbox. In the example below, the Axis 0 Command Position and Axis 0 Actual Position traces are grouped together in the "positions" group.

NOTE: The Modify button sets the association of a set of Traces with a Group. If no Traces have been added or removed from the Group after selecting a Group, then pressing the Modify button will do nothing. You can only Modify a group of Traces if changes have been made in the membership set of the Traces.

5. Click OK.

6. When the plot is graphed, you will notice that Axis 0 Command Position and Axis 0 Actual Position are graphed on the same scale.

 

Follow the steps to modify a set of traces belonging to a particular group:

1.  From the Select Traces Set window, select the Group to modify in the Group highlighted Traces listbox.  Notice that the current Group member traces will be highlighted in the Trace Set for Pane listbox. In this example, the Axis 0 Command Position and Axis 0 Actual Position traces are associated with the positions group.


2.  Using the mouse and the Control and/or Shift keys, select or deselect traces in the Trace Set for Pane listbox to create the new set to be associated with the group selected in the Group highlighted Traces listbox. In this example, we want the positions group to include Axis 0 Command Position and Axis Command Velocity traces and disassociate the Axis 0 Actual Position trace.

3.  Press the Modify button to override the old grouping and associate the currently selected traces with the highlighted group:


Previous | Next
       Legal Notice  |  Tech Email  |  Feedback
      
Copyright ©
2001-2009 Motion Engineering