Oscilloscope Control Panel

This lists the eight available channels and the variables assigned to each.

Figure 2: Scope Control Panel - Channels

Each channel shows:

• The name of the associated variable .
• The color of the associated trace in the graph with a color icon .
• The visibility of the associated curve with a check box.
  • This is to quickly show/hide each captured trace.

• 
  

• Change the color of a curve by double-clicking on its color icon and its visibility by clicking on its check box.

• 
  

• Right-click on a channel to map, unmap, or edit the color of a variable's trace.

When selecting a channel in the channels list, it is superimposed on the existing traces, and some related information are displayed on the left and lower sides of the graph.

This section details the properties of the currently selected channel.

Properties	Description
Enabled	A channel has to be enabled  to acquire the samples sent by its associated probe.
Visible	A channel has to be visible to be drawn on the graph. Even if not visible, it continues to acquire the samples sent by its associated probe.
Auto	A channel in auto mode automatically adapts its amplitude (unit/division The term refers to the time-base value for the X-axis and to the amplitude value for the Y-axis. For example, if the user sets a time-base of 10ms and an amplitude of 1, each division in the soft oscilloscope grid corresponds to a time of 10ms for the X-axis and an amplitude of 1 for the Y-axis.) and zero offset to display all its samples. Setting the auto mode disables the possibility of changing the Amplitude and the Zero offset. See (➜ # 1, Setting Scale) for more information about scaling.
Amplitude	Controls the amplitude (unit/division The term refers to the time-base value for the X-axis and to the amplitude value for the Y-axis. For example, if the user sets a time-base of 10ms and an amplitude of 1, each division in the soft oscilloscope grid corresponds to a time of 10ms for the X-axis and an amplitude of 1 for the Y-axis) of the channel. The buttons and slider change the amplitude according to a logarithmic scale. The dialog box allows a more precise definition of the value.
Zero offset	The curve is vertically shifted so that this value is located halfway through the graph height.

• 
  

• On some special devices, some more tabs that are specific to extra configurations appear in this widget.
  Example: S300 device provides trigger functionality, so an additional tab apprears for the trigger configuration.

This enables you to set the speed at which all the lines for each channel are drawn, and is calibrated in milliseconds per division.

• Its usage is similar to the Amplitude property described in the above section.
• The time-base can always be changed, even during sampling (see Time Scale).

Figure 3: Scope Control Panel - Time-base

To setup the time-base properly, the total measurement duration and the required time resolution have to be taken in account.

This enables you to change the time-frame of the acquired samples shown on the graph. It is composed of:

• A single horizontal line represents all the acquired samples with start and stop timings.
• A rectangle represents only the time slot of the acquired samples shown in the graphical area (the time-frame) with timings:

Figure 4: Scope Control Panel - Time Position

• 
  

• The acquisition of samples is limited to 100'000 cycles (ie. 100 s when cycle time is set to 1000 µs, and 25 s when cycle time is set to 250 µs). When you reach this limit:

  • The first data that are added to the queue are the first data to be removed (FIFO queue)
  • The start timing increases

You can change the time slot with the mouse by:

• moving the rectangle
  
• changing the size
  

The Time Scale Offset is the time value of the first sample the graph when plotting is started. Using this as an offset, the time axis is always started at 0 seconds. To get the actual time value of any sample, add the time scale offset to the Time axis value.

Actual Sample Time Value = Time Scale Offset + Time axis value

• 
  

• During acquisition the time position item is disabled and displays the progression of acquisition.

At the bottom of the controls are five buttons:

1. The Start/Stop button is used to start or stop the acquisition of samples.
   When starting acquisition, all previous samples are lost.
2. The Export... button is used to save the acquisition data in a CSV file.
   See click here... for more information.
3. The Plug Trace Times Channels button () is used to quickly load and display these channels:
• Channel 1: Cycle Jitter (in µs)
  See note about Current cycle time

  When the motion is started, the current cycle time remains constant on an average of several cycles, and equal to the EtherCAT cycle time which is a constant value (1000, 500 or 250 µs).

  The CycleJitter is due to EtherCAT transmissions that can vary in a particular cycle (i.e., call out ).

  The channel 1 of the scope monitors the time difference between the expected Cycle Time and the actual Cycle Time:

  

  Figure 5: Cycle Time Calculation

• Channel 2: Motion execution time (microseconds)
• Channel 3: PLC execution time (microseconds)
• Channel 4: AKD PDMM or PCMM - Real Time Margin (microseconds)
  • This channel monitors the available execution time:
    (Cycle Time Period x Controller Core Count - EtherCAT network execution time - MotionExecTime - PLCProgExecTime).
  • The measurement is based on CPU usage, which provides the most accurate measurement.
  • The measurement is updated each cycle period.

  

  Figure 6: AKD PDMM or PCMM - O-Scope Trace Times Channels

  

  Figure 7: AKD PDMMor PCMM - Single Core Controller, Motion, PLC and Real Time Margin Time Calculations

  

  ‡ Channel 4 is the total amount of time across all CPU cores.

  Figure 8: PCMM M2-120 model - Dual Core Controller, PLC and Real Time Margin Time Calculations

• Channel 4: PCMM2G - PLC Margin (microseconds)
  • This channel monitors the available execution time for the PLC within a cycle:
    (Cycle Time Period - EtherCAT network execution time - PLCProgExecTime).
  • The range is 0 to cycle period in microseconds.
  • The measurement is calculated and updated each cycle period.
  • If the PLC execution time spans multiple cycles, then the PLC Margin Time is zero.

  

  Figure 9: PCMM2G - O-Scope Trace Times Channels

  

  Figure 10: PCMM2G - Multiple Core Controller, PLC and PLC Margin Time Calculations

• Simulator
  • Channel 1: Not supported.
  • Channel 2: Motion execution time (microseconds)
  • Channel 3: PLC execution time (microseconds)
  • Channel 4: Not supported.
    • Channel 1 (CycleJitter) and Channel 4 (RealTimeMargin) are always zero with the simulator.
    • The MotionExecTime and PLCProgExecTime traces are visible with simulated values.

  

  Figure 11: Simulator - O-Scope Trace Times Channels

  See Tasking Model / Scheduling for more information

4. The graduations button () displays or removes the axis graduations of the graphical area.
   By graduations are visible by default.
5. The autofit button () changes the time-frame of the graph and amplitudes.
   It zero offsets of channels so they all fit entirely into the graphical area.