TE13xx TwinCAT 3 ScopeView En

ManualTwinCAT 3 Scope View TwinCAT 3 Version: Date: Order No.: 1.2 2016-03-30 TE13xx Table of Contents Table of Contents 1 Foreword .................................................................................................................................................... 4 1.1 Notes on the documentation.............................................................................................................  4 1.2 Safety instructions ............................................................................................................................  5 2 Overview..................................................................................................................................................... 6 2.1 Product description ...........................................................................................................................  6 3 Installation.................................................................................................................................................. 9 3.1 System requirements........................................................................................................................  9 3.2 Downloading the setup file................................................................................................................  9 3.3 Installation.........................................................................................................................................  9 3.4 After the Installation ........................................................................................................................  12 3.5 Licensing.........................................................................................................................................  13 4 Configuration ........................................................................................................................................... 18 4.1 Scope View.....................................................................................................................................  18 4.1.1 Scope View - Architecture................................................................................................... 18 4.1.2 Scope View - Scope Menu.................................................................................................. 23 4.1.3 Scope View - Toolbar.......................................................................................................... 25 4.1.4 Scope View Scope Properties ............................................................................................ 27 4.1.5 Scope View YT Graph ........................................................................................................ 29 4.1.6 Scope View XY Graph ........................................................................................................ 37 4.1.7 Scope View Bar Graph ....................................................................................................... 47 4.1.8 Recording............................................................................................................................ 54 4.1.9 Cursor ................................................................................................................................. 57 4.1.10 Trigger................................................................................................................................. 61 4.1.11 Saving and exporting data .................................................................................................. 65 4.1.12 Reporting ............................................................................................................................ 69 4.1.13 Scope Options .................................................................................................................... 76 5 .NET API ................................................................................................................................................... 79 5.1 Integration of the ScopeViewControl ..............................................................................................  79 5.1.1 Sample YT Chart ................................................................................................................ 80 5.1.2 Sample XY Chart ................................................................................................................ 84 5.1.3 Sample YT Cursor .............................................................................................................. 90 5.1.4 Sample Scope Export ......................................................................................................... 97 5.2 Integration in a WPF (Windows Presentation Foundation) project .................................................  99 5.3 API Documentation.........................................................................................................................  99 6 Samples.................................................................................................................................................. 101 6.1 TwinCAT 3 Scope View – first steps.............................................................................................  101 7 Appendix ................................................................................................................................................ 110 7.1 FAQ - frequently asked questions and answers ...........................................................................  110 7.2 TwinCAT Scope Glossary.............................................................................................................  112 7.3 How To's .......................................................................................................................................  113 7.3.1 Oversampling recordings with the TwinCAT 3 Scope....................................................... 113 7.3.2 Opening .svd files from a network directory...................................................................... 116 TwinCAT 3 Scope View Version: 1.2 3 Foreword 1 Foreword 1.1 Notes on the documentation This description is only intended for the use of trained specialists in control and automation engineering who are familiar with the applicable national standards. It is essential that the following notes and explanations are followed when installing and commissioning these components. The responsible staff must ensure that the application or use of the products described satisfy all the requirements for safety, including all the relevant laws, regulations, guidelines and standards. Disclaimer The documentation has been prepared with care. The products described are, however, constantly under development. For that reason the documentation is not in every case checked for consistency with performance data, standards or other characteristics. In the event that it contains technical or editorial errors, we retain the right to make alterations at any time and without warning. No claims for the modification of products that have already been supplied may be made on the basis of the data, diagrams and descriptions in this documentation. Trademarks Beckhoff®, TwinCAT®, EtherCAT®, Safety over EtherCAT®, TwinSAFE®, XFC®and XTS® are registered trademarks of and licensed by Beckhoff Automation GmbH. Other designations used in this publication may be trademarks whose use by third parties for their own purposes could violate the rights of the owners. Patent Pending The EtherCAT Technology is covered, including but not limited to the following patent applications and patents: EP1590927, EP1789857, DE102004044764, DE102007017835 with corresponding applications or registrations in various other countries. The TwinCAT Technology is covered, including but not limited to the following patent applications and patents: EP0851348, US6167425 with corresponding applications or registrations in various other countries. EtherCAT® is registered trademark and patented technology, licensed by Beckhoff Automation GmbH, Germany Copyright © Beckhoff Automation GmbH & Co. KG, Germany. The reproduction, distribution and utilization of this document as well as the communication of its contents to others without express authorization are prohibited. Offenders will be held liable for the payment of damages. All rights reserved in the event of the grant of a patent, utility model or design. 4 Version: 1.2 TwinCAT 3 Scope View Foreword 1.2 Safety instructions Safety regulations Please note the following safety instructions and explanations! Product-specific safety instructions can be found on following pages or in the areas mounting, wiring, commissioning etc. Exclusion of liability All the components are supplied in particular hardware and software configurations appropriate for the application. Modifications to hardware or software configurations other than those described in the documentation are not permitted, and nullify the liability of Beckhoff Automation GmbH & Co. KG. Personnel qualification This description is only intended for trained specialists in control, automation and drive engineering who are familiar with the applicable national standards. Description of symbols In this documentation the following symbols are used with an accompanying safety instruction or note. The safety instructions must be read carefully and followed without fail! Serious risk of injury! Failure to follow the safety instructions associated with this symbol directly endangers the life and health of persons. DANGER Risk of injury! Failure to follow the safety instructions associated with this symbol endangers the life and health of persons. WARNING Personal injuries! Failure to follow the safety instructions associated with this symbol can lead to injuries to persons. CAUTION Damage to the environment or devices Failure to follow the instructions associated with this symbol can lead to damage to the environment or equipment. Attention Tip or pointer This symbol indicates information that contributes to better understanding. Note TwinCAT 3 Scope View Version: 1.2 5 Overview 2 Overview 2.1 Product description TwinCAT 3 Scope is the charting and analysis tool for TwinCAT. Variables in TwinCAT can be recorded and displayed graphically. Sampling rates can be adjusted individually for each channel. Recordings in the µs range and long-term recordings over several days are equally possible. Due to division into a Scope View with multi-core support for the display of the signals and a Scope Server for the recording of the values, it is possible it to connect to servers distributed in the field from a central View. A tool is thus available not only for machine commissioning, but also for process monitoring. The TC3 Scope functionality includes a cursor tool and trigger functions. The TC3 Scope also sets new standards in the field of engineering. Like TwinCAT 3 itself, it is integrated in Microsoft Visual Studio. It is thus possible to use TwinCAT 3 projects and Scope projects in parallel in a single solution. Variables can be shifted very simply from the TwinCAT 3 project to a Scope configuration. Of course the Scope can also still be used as a standalone tool in the framework of the Visual Studio shell. Due to the constantly increasing range of functions required of data analysis tools, the TwinCAT 3 Scope is subdivided into product levels with different ranges of features. The TwinCAT 3 Scope Base contains a license-free View and a license-free Server. Both are installed together with TwinCAT 3 XAE. Product note The TwinCAT 3 Scope software consists of two products: • TwinCAT 3 Scope View is a TwinCAT 3 engineering product and supplies the graphic interface for the configuration of recordings and the display of signal curves. The View is available in different product levels and is licensed for the device on which it is displayed. This document contains the technical product description. • TwinCAT 3 Scope Server is a TwinCAT 3 function and provides the software for data logging. The server sends the recorded data to the View. The software is installed on distributed devices or on the local target device. The server license is issued for the device on which the server runs. In most cases the Base version, which is installed together with TwinCAT XAE or the Scope View, is sufficient. The server license is only required if it is used independently, i.e. without View, e.g. for control via a PLC function block. The TwinCAT 3 Scope Server is documented separately as part of the TC3 functions. Both components must be available in the system in order to be able to use the Scope. Principle of operation The TwinCAT Scope View communicates over ADS with the Scope Servers distributed in the system. The local server, which is located with the View on a system, can be used for the recording of local variables. However, it is also used whenever saved Scope data files are opened in the View. The View displays the signal curves and is used for the configuration of recordings. Product level / feature list This table shows which functions are available with which TwinCAT Scope level with the corresponding licensing. 6 Version: 1.2 TwinCAT 3 Scope View 0) Ring Buffer Auto Save Restart Record View Multicore Support Base: Create Configurati on Target Browser Filter Individual Sample Rate Drag and Drop for Configurati on Docking Windows View Scope Server Full License Server Full 7 days trial version - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - TwinCAT 3 Scope View Version: 1.2 Scope View Professional View Full 7 days trial version 7 .Overview Features Scope Base Server General: Free of charge Local record Remote Record using Target Server Remote Record using Local Server Scope Control Integration Long Time Records > 1h Applicatio n Settings (TC 3. 2 Scope View Professional TwinCAT 3 Scope View .Overview Features Scope Base YT Charts - Scope Server Full License - YT Overview Chart Stacked Yaxes Time Based Charts XY Charts - - - - - - - - - - - - Array Bar Charts Logarithmi c Y-axes Channel Marks Channel Offset Channel Scaling Panning - - - - - - - - - - - - - - - - - - Zoom - - - Cursor - - - Print Report Extended data export with Export Tool - - - - - - - - - - - - - - - - - - - - - - - - Trigger: Start Record Stop Record Stop Display Restart Display Start Subsave Stop Subsave 8 Version: 1. Windows Embedded Standard 2009. Please note: Under Windows 32-bit/64-bit.3 Installation Description of the installation procedure of a TwinCAT 3 Function for Windows-based operating Systems. you can download this setup in the internet.beckhoff. 3. Windows 7 TwinCAT Minimum is TwinCAT 3 ADS. The TwinCAT 3 Scope Base is installed together with TwinCAT 3 XAE. in which the TwinCAT Scope View integrates itself. Then click on “Start download” (Optional) Transfer the downloaded file to the TwinCAT runtime system on which you wish to install the product 3. TwinCAT 3 Scope View Version: 1. The Scope View can be licensed as full version and as a 7-day-trial-version.2 Downloading the setup file Like many other TwinCAT 3 engineering tools. If the shell or another full version of Microsoft Visual Studio is already installed on the target system. which can be licensed for each product level. If you select Full. the TwinCAT Scope View is available for download on the Beckhoff website. Please perform the following steps to download the setup file: 1. 1. Supported operating systems Windows XP.de 2.1 System requirements The following system requirements must be fulfilled for proper functioning of the TwinCAT 3 Scope View. If you want to use a new Scope version without a TwinCAT 3 XAE Update or install the Scope standalone on a PC without TwinCAT 3 Engineering. Navigate in the tree to the nodes Automation/TwinCAT3/TE1xxx | TC3 Engineering/TE13xx | TC3 Scope View 3. Double-click the downloaded setup file "TFxxxx". the setup also brings along the Microsoft Visual Studio Shell. Click on the Download link in order to place the software in the shopping cart. There you can choose between Download Full and Download Update. The further product level and features are activated per licensing.Installation 3 Installation 3. Start a web browser of your choice and go to the Beckhoff website at www. 4. . the Update setup is sufficient. please start the installation with "Run as Administrator" by right-clicking the setup file and selecting the corresponding option in the context menu. It is always the most current version of the product.0 is required.NET Framework The .NET Framework 4. Limitations of the 7-day-trialversion you can see on the product overview. Windows XP Embedded.2 9 . Click on "Next" and accept the license Agreement. 10 Version: 1. Enter your user information in the specified area. 3.2 TwinCAT 3 Scope View .Installation 2. Alternatively you can also install each component seperately by choosing "Custom". including all sub-components.2 11 . The TwinCAT system has to be stopped before proceeding with installation TwinCAT 3 Scope View Version: 1. please choose "Complete" as the Setup Type. Click on "Install"after pressing the "Next" to start the Installation. 5. To install the full product.Installation 4. up to the Professional product level. ð The installation is complete now. 3.g.4 After the Installation The next step after a successful installation is the licensing of the products "TE130x Scope View" and/or "TF3300 Scope Server". e.2 TwinCAT 3 Scope View .NET-based visualisation [} 79] 12 Version: 1.Installation 6. Select "Finish" to end the installation process. Confirm the Dialog with "Yes". 7. After a successful installation the TC 3Function needs to be licensed [} 13]. By default the Base product level is active and is available without a licence. The extended range of functions can be enabled by appropriate licensing. Further possible steps are then: • First steps with TwinCAT 3 Scope [} 101] • Detailed documentation of the individual functions [} 18] • The integration of TwinCAT 3 Scope View Control into your own . Both license types can be activated via TwinCAT XAE. In “Solution Explorer”. Optional: If you would like to add a license for a remote device.Installation 3.5 Licensing The TwinCAT 3 functions are available both as a full and as a 7-Day trial version. please navigate to the entry “System\License” 4.2 13 . please consult the TwinCAT 3 Help System.The following document describes both licensing scenarios for a TwinCAT 3 function on TwinCAT 3 and is divided into the following sections: • Licensing a 7-Day trial version [} 13] • Licensing a full version [} 14] Licensing a 7-Day trial version 1. you first need to connect to the remote device via TwinCAT XAE toolbar TwinCAT 3 Scope View Version: 1.For more information about TwinCAT 3 licensing. Start TwinCAT XAE 2. Open an existing TwinCAT 3 project or create a new project 3. Open the tab "Manage Licenses" and add a "Runtime License" for your product (in this screenshot “TE1300: TC3 Scope View Professional”) 5. Installation 6. Switch to the tab "Order Information" and click the button "Activate 7 Days Trial License. please navigate to the entry "SYSTEM\License" 11.. Open an existing TwinCAT 3 project or create a new project 10. Please restart TwinCAT 3 afterwards. Start TwinCAT XAE 9.. 14 Version: 1. Open the tab "Manage Licenses" and add a "Runtime License" for your product (in this screenshot " TE1300: TC3 Scope View Professional”). Licensing a full version 8.2 TwinCAT 3 Scope View . In "Solution Explorer"."to activate a test version 7. Optional:If you would like to add a license for a remote device. The "HW Platform" is an indicator for the performance of the device. Optionally. If you are not aware of your "Beckhoff License ID" please contact your local sales representative. 14. Send this Activation Request to Beckhoff NOTE! The “License Response File“ will be sent to the same E-Mail address used for sending out the ”License Request File” TwinCAT 3 Scope View Version: 1..Installation 12.. 16.com" which contains the "License Request File" 18. you first need to connect to the remote device via TwinCAT XAE toolbar 13. After the license request file has been saved. Navigate to the "Order Information" tab The fields "System-ID" and "HW Platform" cannot be changed and just describe the platform for the licensing process in general a TwinCAT 3 license is always bound to these two identifiers: the "System-ID" uniquely identifies your system.".2 15 . you may also enter an own order number and description for your convenience 15. enter the "Beckhoff License ID" and click on "Generate License Request File. After clicking "Yes". the system asks whether to send this file via E-Mail to the Beckhoff Activation Server 17. the standard E-Mail client opens and creates a new E-Mail message to "tclicense@beckhoff. Installation 19. 20.. After receiving the activation file.2 TwinCAT 3 Scope View . The "License Response File" will be imported and all included licenses will be activated. these will be removed accordingly."in the TwinCAT XAE license Interface.. Select the received "Licnse response file" and click on "Open" 21. If there have been any trial licenses. 16 Version: 1. please click on the button "Activate License Response File. \TwinCAT\3.Installation 22.2 17 . NOTE! The license file will be automatically copied to ".. TwinCAT 3 Scope View Version: 1.1\Target\License" on the local device.. Please restart TwinCAT to activate licenses. 2 TwinCAT 3 Scope View .Configuration 4 Configuration 4. For the creation of these configurations it is important to be familiar with the architecture of the Scope View. The Scope architecture: 18 Version: 1.Architecture Not only are signal curves represented in the TwinCAT Scope View. The architecture is reflected in the tree structure within the Measurement Project in the Solution Explorer.1 Scope View 4.1 Scope View . recording configurations are also created.1. 2 19 . The settings for the chart can be entered in the Property window. Each chart has its own toolbar for changing the display. marks and other parameters can be set. Standard Scope Project: A Scope always stands for a recording configuration. The Scopes within a project can be controlled independently of one another. The trigger action. Each chart has its own toolbar for changing the display. Double-clicking on the channel highlights the respective signal in the chart. The color and axis settings can be made in the Property window. Trigger: Triggers are assigned to the Scopes in the tree structure of the Scope View. They are the actual display area in the view and provide the timebase. Stop Record. The Cursor Tool window shows the current values of the signal/cursor interface and the differences compared with other cursors. If a Scope is selected. the setting options such as recording time and ring buffer are displayed in the Visual Studio Property window. X and Y cursors can be added within a chart.g. They represent the actual display area in the view. Cursor: Cursors are hierarchically assigned to the charts. In the Property window the color. Several array bar charts can exist in parallel in a Scope. Clicking on the signal curve in the chart highlights the respective channel in the Solution Explorer. Amongst others. This means that all elements inserted below it are subject to the same recording settings. See also: Axis properties [} 32] Channel: A channel represents the style characteristics of a selected variable. TwinCAT 3 Scope View Version: 1. See also: Scope properties [} 27] YT Chart: Several YT charts can exist in parallel in a Scope. See also: XY chart properties [} 38] Array Bar Chart: An array bar chart can connect to an array in the controller and display each array element as a bar. The underlying triggers can be logically linked to a trigger condition. The variable selection also takes place here in the Property window. See also: YT chart properties [} 29] Axis: An (YT or XY) chart can feature several axes. Clicking on the signal curve in the chart highlights the respective channel in the Solution Explorer. Acquisition: The acquisition contains information on the actually selected variables. at which several Scopes can be added. can be set in the Property window of the trigger group. See also: Trigger properties [} 61] Window The interfaces for the control of the Scope View are divided into several individual windows (Tool windows) and their position and size are freely configurable. See also: Cursor properties [} 57] XY Chart: Several XY charts can exist in parallel in a Scope. An axis provides the range of values for the connected channels. Any desired number of X and Y cursors can be set. e. the automatic or free scaling can be set in the Property window.Configuration Measurement Scope Project: Main level. The color and scaling settings can be made in the Property window. exactly like all other windows. Each scope project lists the generated messages independently here. With the target browser you can be add Scope configuration channels via their symbol names. List of errors. warnings and messages. The messages for the respectively selected Scope can be deleted via the context menu item "Clear Error List". the settings for the respective element selected in the Solution Explorer can be modified.Configuration Overview of the individual windows: Solution Explorer Cursor [} 57] Error List Target Browser [} 54] Properties Scope View Control 20 Display of the project structure within a solution. Version: 1. Display of the values present at the X/Y-cursor.2 TwinCAT 3 Scope View . Under Properties. Display of the individual charts. The charts can be displayed next to each other or in overlapping tabs within the control. tcscope) or scope data (. Contains a Scope instance and a preconfigured array bar chart with a corresponding axis. List of the available templates: Empty Measurement Project Scope YT Project Scope YT Project with Reporting Scope YT NC Project Scope XY Project Scope XY Project with Reporting Scope Array Bar Project Empty Measurement Project. See "Scope YT Project" for a ready-made printing template for printing charts. TwinCAT 3 Scope View Version: 1. Contains a Scope instance and a preconfigured XY chart with a corresponding axis. Scope configurations (. The template can easily be extended to the number of actually configured drive axes. See “Scope XY Project” for a ready-made printing template for printing charts. Addition of a Scope/report to a Measurement Project: • Context menu of the Measurement Project -> Add -> New Item… -> selection of the desired template. Contains a Scope instance and a preconfigured YT chart with a corresponding axis. To create a Measurement Project: • File -> New -> Project -> TwinCAT Measurement -> Selection of the desired template.2 21 .svd) can subsequently be inserted here.Configuration Configuration The options for creating or editing a Scope configuration are explained below.sv2 can | . Contains a Scope instance. The way in which the properties of the respective elements can be changed is described in the description of the associated window. which was specially preconfigured for working with drive axes. sv2 | . • Context menu of the element -> Delete Moving / copying individual elements: • Every element can be moved in the Solution Explorer with drag & drop.rdlc) on to the Measurement Project in the Solution Explorer.sv2 | .rdlc) • Drag & drop the desired file (. • The described moving operations are available within a Scope even after the start of recording. In doing so it must always be added to an element that is one level higher in the hierarchy. PLC editor -> context menu of variables -> Add to Scope New axis New channel Deletion of elements • Select the element in the Solution Explorer .Configuration List of the available templates: Scope Project Scope instance with a pre-configured chart and an axis. Scope NC Project Standard Report • Context menu of the measurement project -> Add -> Existing Item… -> select the desired file (. Scope instance that has been specially preconfigured for working with axes. Table 1: Addition of individual elements: New Chart Context menu of the Scope instance -> New YT Chart -> New XY Chart Context menu of the Scope / Chart instance -> New Axis Context menu of the Scope / Chart / Axis instance -> New Empty Channel Drag & drop symbol data from the target browser to an existing Scope / Chart / Axis instance. then it is only copied. 22 Version: 1.2 TwinCAT 3 Scope View . Printing template for printing charts. • If the <Ctrl> key is pressed and held during the drag & drop.tcscope | .> <Del> key. the selected element is always copied instead of being moved.svd | . If an element is moved to another Scope.tcscope | .svd | . Thus it is still available in the original Scope. 1. which is called by a double click (a copy of the file is placed in the new project directory).> Send Project By Email… ◦ If the Scope is to contain data (Scope State: Reply).Scope Menu The Scope functions are accessible via the menu. depending on the node selected in the Solution Explorer. since a Measurement Project is lacking as the basis. a selection dialog appears in which a new project is created. Sending projects by email: • Context menu of the Scope instance to be sent . • Select the channel in the Solution Explorer -> Properties -> Disabled -> true 4.sv2 | .svd) can be opened directly by a double click. TwinCAT 3 Scope View Version: 1. Deactivating / activating a channel A channel can be deactivated in the configuration in order to prevent it being recorded.> select the Solution / Measurement Project via the file selection dialog.tcmproj) as well as Solutions (. The menu content may differ. Subsequently the newly created project is added to the Scope.) The Scope menu also shows the corresponding key assignments.sln) can opened directly by a double click. The "Empty Measurement Project" template lends itself to this. • Measurement Project files (. (For this reason the screenshot shown below differs from the description. • All Scope files (.2 23 . it is retained when saving the configuration.2 Scope View .Configuration Saving a Scope configuration: • File -> Save (shortcut assigned by default: Ctrl + S) Loading a Scope configuration: • File -> Open -> Project/Solution . then you can select whether the data should also be sent.tcscope | . However. However. Configuration 24 Version: 1.2 TwinCAT 3 Scope View . Opens the configuration interface of the Scope Server.2 25 . Creates a new XY chart within the Scope. Deletes all entries (Error | Warning | Message) of the currently active Scope from the error list. Downloads the current configuration as a . After stopping the recording. Creates a new array bar chart within the Scope.. The generated Scope data file (.svd file. Creates a new channel within the axis.. The symbol names of all channels located below the selected element are edited. New YT Chart New XY Chart New Array Bar Chart New Axis New Empty Channel Delete Export to CSV Export to Binary Export to DAT Export to TDMS Extract Scope Configuration Upload Configuration To Target Save Data Scope Messages Local Scope Server.3 Opens the target browser. Opens the cursor window. Dialog for incrementing / decrementing the Index Group / Index Offset. 4. Context menu of the Scope instance to be sent . Some frequently occurring message boxes in the scope are equipped with a checkbox – "Remember my answer and don't ask again!" – so that the question is not repeated the next time.tcscope file to a user-selected target system. Deletes the element currently selected in the Solution Explorer. Scope View .Toolbar The Scope recording is started and stopped with the toolbar.. Creates a new axis within the chart. it can be activated again here.> Send Project By Email… If the Scope is to contain data (Scope State: Reply).svd file. TwinCAT 3 Scope View Version: 1. Opens the Visual Studio Options window and selects the Scope entry. If no axis is selected. Options.Configuration Target Browser Cursor Window Send Project By E-Mail. Clear Error List Change Ads Symbol.. If a message box has been deactivated...1. Export to a CSV or TXT file Export to a binary file Export to a DAT file Export to a TDMS file Extracts the Scope Configuration from the selected . then a new chart is additionally created. This makes the handling of the program individually adjustable for each user. Change Index Group.svd) can be added directly to the Measurement Project or saved in a directory of your choice via the directory selection dialog. Dialog for the replacement of character strings... Creates a new YT chart within the Scope. then a new axis is additionally created.. If the selected element is not a chart.. then you can select whether the data should also be sent. the current data including the configuration can be saved in a . The acquisitions of all channels located below the selected element are edited. The following elements are available by default in the toolbar: 26 Version: 1. it can be reactivated under View -> Toolbars -> TwinCAT Measurement.2 TwinCAT 3 Scope View .Configuration If the toolbar is not visible by default or has been closed. After stopping the recording it is possible to change the Scope configuration. if they are not saved. The settings are entered via the Property window (for the Scope element selected in the Solution Explorer). however. TwinCAT 3 Scope View Version: 1. The commands belonging to the Scope can subsequently be found under Add Command -> Categories: Scope 4. Stop Record: The recording is stopped. The current data will then be lost.2 27 .1. then a query appears asking whether the current data should be saved. If data are already present from a preceding session.Configuration Start Record: All required servers are called and the recording settings and connected channels are entered. the recorded data remain on the connected servers and can be viewed. After the start it is no longer possible to change the Scope settings or acquisition or to add or remove channels. The toolbar can be extended as desired via the context menu (can be displayed on the right-hand side of the toolbar) -> Add or Remove Buttons -> Customize .4 Scope View Scope Properties The Scope properties must be determined before a recording is started. However. Afterwards the recording is started in accordance with the above settings. The option is therefore only available for XY plots at present. The options Default and Extended are available for all chart types. For a better overview. A distinction is made between GDI+ and DirectX. • Use Auto Save: turns on the automatic saving of a stopped recording. The recording can be terminated prematurely via the stop button. Record • Restart Record: Here you can restart a stopped recording. • Ring buffer: Here you can specify how the server should respond. • File Path: Directory in which the Scope instance was saved. ◦ If the option is disabled. the recording is stopped when the recording time is reached. • Filename Mask: here you can edit the filename of the recorded data. • File Name: File name of the current Scope instance.Configuration Auto Save • Auto Save Path: here you can choose the path for the recorded data to be saved. • Graphics: Shows the currently used graphic. 28 Version: 1. For instance you can create increasing time stamps. once the recording time has been reached.2 TwinCAT 3 Scope View . • ViewDetailLevel: Here you can set the level of detail for showing or hiding various options. Common • Comment: A free comment can be stored here. the Extended level is particularly recommended for XY plots. The choice depends on the quantity of data to be recorded and the recording equipment. 4. Changes by group To change the settings of several Scopes at once.1. if only the RAM is used.1. can be used to separate Channel Style and Channel Acquisition at channel level through an additional hierarchy level. The access time is faster. It is entered in the format Days:Hours:Minutes:Seconds.Configuration ◦ If the option is enabled the recording is not stopped. The recording can be stopped by pressing the stop button. but the oldest data in the memory is overwritten.2 29 . 4. The View Detail level. • Record Time: Here you can specify the total recording time. This increases the start time of the recording. • Start Record: Here you can set whether the recording should be started via the recording button (UserStart) or when a trigger event occurs (TriggerStart). For larger data quantities it is usually necessary to activate the “File Store” option.5 Scope View YT Graph The properties of the individual hierarchy levels of YT plots are explained below.5. which can be set in the Scope settings. TwinCAT 3 Scope View Version: 1.1 YT chart properties Here you can enter all the settings relating to a YT chart. Record Mode • File Store: Here you can specify whether the server should buffer the data in a local file (True) or only in the RAM (False). Channel Style and Channel Acquisition are described separately below. please observe the section Multiple selection [} 77]. when the rescale button is selected in the chart toolbar. the chart starts the live display when a new recording is started. Color • The background and frame color can be set by means of color dialogs. This value is set.Configuration Behavior • Auto Start: If this option is enabled. a click on a data point results in display of a tooltip with the exact values of the data point on the X. • Data Tool Tip: If this option is enabled. • Default Display Time: This time specifies the standard width of the associated chart. • Tool Bar: Specifies whether the toolbar is displayed in the chart. for example.and Y-axis.2 TwinCAT 3 Scope View . • Time Bar: Specifies whether the time bar is displayed in the chart. • Inverse X-Axis: Switches the signal sequence from the default (left to right) to right to left. plus the timestamp and name of the corresponding channel. 30 Version: 1. multiple CPU cores can be specified for a chart. • X-Grid Color: The color of the grid. • X-SubGrid Divisions: Number of areas into which the main grid is subdivided by auxiliary lines. X-Axis Grid • Use X-Axis Grid: The X-subdivisions in the chart can be switched on or off here. • Stacked Y-axes: This setting can be used to specify whether the axes of a chart should be displayed side by side. If not all units are edited the format is sorted in ascending order.fff". Changes by group To change the settings of several charts at once. It can be edited in the format "hh:mm:ss. each with its own display area. The zoom function works down to the µs range. • X-Axis Color: The colour of the X-axis. You can now navigate in the data already recorded without stopping the recording. The inner scroll keys move the display only by a tenth of the display width and can be kept pressed to view the data set. This may improve the performance. or whether the axes should be above each other. The chart display is operated with the toolbar. If the option is set. The colons are used as separators. The data currently being accumulated are displayed. If required. • Display-Width: The current display width is displayed here. • Scroll buttons: The outer scroll buttons move the current display in steps that correspond to the display width. please observe the section Multiple selection [} 77]. • Pause: The display switches to the pause mode. The changed value is adopted automatically.fff". all associated settings can be made here. • Use X-Axis SubGrid: Auxiliary lines for the finer X-subdivision of the main grid can be shown or hidden here. X-Axis Style Since the X-axis is permanently assigned to a chart. starting with seconds. This includes both zooming and panning (shifting the display with the mouse). • Position: Shows the position. • Ticks: The number of subdivisions. the display width can be changed by turning the mouse wheel in the selected chart window.2 31 . • Show Name: Specifies whether the name of the chart is shown in the graph. • CPU Core: Here you can set (for each chart individually) which CPU core should be used for the current chart display. Alternatively. It can be edited in the format "hh:mm:ss. so that the values of the attached channels are shown within the same area. • X-Grid Line Width: Line width of the grid in pixels. This can be used to expand the selected area.Configuration Common • Comment: A free comment can be saved here. • Y-Zoom: Here you can set the chart behavior during zooming. the chart instructs all axes (X and Y) to perform autoscaling after a zoom or panning action. you can navigate in the data of a chart in the Y-direction as well. The overview shows all buttons and their explanation (from left): • Play: Starts the live display mode. TwinCAT 3 Scope View Version: 1. Y-Settings • Scale on Zoom: If this option is selected. • X-Axis LineWidth: Line width of the axis in pixels. i. 32 Version: 1. • Zoom Horizontal: A new time range for the display can be selected by stretching a rectangle over the x-axis. By turning the mouse wheel you can also zoom in or out on the current display. The current recording times are displayed in the chart toolbar: • Start-Time: The common starting point of the recordings of all connected channels.). The x-axis is/axes are set to the default display time. The right mouse button is likewise assigned this function. The cursor position of the mouse determines the center. 4. • Zoom Out Max: Scales the x-axis in such a way that all current values in the recording appear in the display. scroll.and y-axes by clicking and dragging with the mouse. Once undone. • Panning Horizontal: In the horizontal panning mode the current display can be shifted along the xaxis by clicking and dragging with the mouse. • Overview Chart: The Overview Chart option activates a chart display. • Date: The absolute date at the origin of the chart.Configuration • Undo/Redo Time/Position: This option can be used to undo step changes in the display width or the current position.2 YT axes properties Settings can be made separately for each available YT axis here. irrespective of how they were made (e. values can be repeated with redo. The Overview Chart also offers an absolute time axis for the whole recording time. etc.1.e.5.g. The start time defines the zero point of the recording. the time from the start time to the beginning of the display. • Rescale All: Carries out an autoscale on all axes. • Zoom Free: You can zoom into the current display by stretching a rectangle over the graphic area. The end time thus marks the final value of the recording.2 TwinCAT 3 Scope View . The signal range currently shown in the main chart is highlighted in the Overview Chart. zoom. The difference between the end time and start time is maximally as large as the defined record time (see Scope properties [} 27]). • End-Time: The largest common time of all connected channels. • Time : The absolute time at the origin of the chart. • Panning Free: In the free panning mode the current display can be shifted along the x. • Position: The position time represents the zero point of the current chart. • Grid Line Width: Line width of the grid in pixels. • Show Caption: Defines whether the name of the chart (Caption) is shown in the graph.Configuration Common • Caption: Here you can enter an axis label. Grid • Grid Color: The colour of the grid. • SubGrid Divisions: Number of areas into which the main grid is subdivided by auxiliary lines. • Enabled: Here you can switch the axis on or off completely. • Use Grid: The Y-subdivisions of the axis can be shown or hidden here. In the case of logarithmic scaling the auxiliary lines for subdivision are shown only in the set number if the range of values per tick is precisely one decade. • Comment: A free comment can be saved here.2 33 . TwinCAT 3 Scope View Version: 1. This functionality is also available via the context menu. • Use SubGrid: Auxiliary lines for the finer Y-subdivision of the main grid can be shown or hidden here. Otherwise the displayed auxiliary line shows the decades not displayed in the main grid. Auxiliary lines have no axis labelling. In the case of logarithmic scaling the number of ticks depends on the displayed range of values and can thus deviate from the settings.2 TwinCAT 3 Scope View . This mode always automatically adjusts the maximum of the y-axis to the maximum in the current view (display width). AutoGrowNShrink can be selected. the maximum value can be edited directly.1. 4. • Visible: Specifies whether the axis is shown or hidden in the chart. each axis is scaled such that the last-known minimum and maximum of all connected channels lie within the display range. until a rescale is carried out for the current view.3 YT channel style All style settings belonging to a YT channel can be made here.5. • Precision: Here you can enter the number of significant digits for the axis labels. 34 Version: 1. • Axis Min: If Auto Scale is inactive.Configuration Scale • Auto Scale: If Auto Scale is active. Axis Style • Color: The colour of the axis. The default mode is AutoGrowOnly. If there is not enough space for the selected number of ticks. Alternatively. • Logarithmic: Switches between logarithmic and linear scaling of the axes. these are automatically reduced in the chart. the minimum value can be edited directly. please observe the section Multiple selection [} 77]. • Axis Max: If Auto Scale is inactive. It corresponds to the number of visible digits on the axis. • Line Width: The line width in pixels. • Scale Mode: There is a choice between two auto-scale modes. This means the y-axis always scales to the historic maximum. • Ticks: Maximum number of subdivisions. Changes by group To change the settings of several axes at once. steps and bars. The default setting is “None”. • Line Width: The line width of the graph. If applicable the comment will be adopted from the connected ADS symbol. Other alternatives: Bottom. Here you can select the fill color. Marks • Mark Color: The colour of the base markings. The default value is line. Antialias is "nicer" but requires considerably more computing. above or below a curve.g. • Line Color: The color of the graph. This has an effect in particular if there are many channels with large movements. Line • Antialias: This option decides how the lines will be drawn. above or below a curve. TwinCAT 3 Scope View Version: 1.2 35 . For BOOL variables the default value is “Horizontal Zero”. • Fill Color: Fill mode can be used to color an area. • Fill Mode: Fill mode can be used to color an area. Top. Variables with the data type BOOL are an exception. Center and Source. • Visible: Here you can set whether the channel should be displayed in the chart. • Fill Transparency: Here you can set the transparency value of the fill color. e. The default value is 50.Configuration Common • Comment: A free comment can be saved here. • Type: Changes the value display between line. e.g. The line width 1 requires least computing. Configuration • Marks: Selection of the visibility of markings -> On (permanently visible) | Auto (dependent on the zoom level) | Off (markings switched off).5. This can be useful to compensate a known bus runtime. Changes by group To change the settings of several channels at once. please observe the section Multiple selection [} 77].2 TwinCAT 3 Scope View . degrees would be displayed instead of radians. for example. • Offset: A free offset can be added to the function value of the channel in the offset field. This helps you. Modify • Bit Mask: In the Bit Mask field a value can be entered with which the display value is masked.1. for example. This means that the value of the channel is ANDed with the binary value of the mask. • Time Shift: This option enables the graph to be moved along the time axis. • Scale Factor: The display value of a channel can be changed with the scale factor. for example. to observe individual bits of a status byte.4 YT channel acquisition All acquisition settings belonging to a YT channel can be made here.296. 4. 36 Version: 1. This makes sense if angle signals are to be displayed in degrees. • Mark Size: The size of the base markings. therefore. rather than radians. With a scaling factor of k = 360 / (2*Pi) = 57. provided it is not of the type floating point. TwinCAT 3 Scope View Version: 1. Comparisons: Oversampling recordings [} 113]. Some setting possibilities are visible / editable only for special channels.1. and the input fields for Group and Offset are enabled. 4. It is always greater than the TaskSampleTime. If the option is not set. • Time Offset [s]: This can be used for one-time manipulation of the original timestamp during recording of the data point.Configuration The properties may differ. • Sample Time: If the sample state “FreeSampleTime” was selected.6 Scope View XY Graph The properties of the individual hierarchy levels of XY plots are explained below. Acquisition • Array Length: Shows the number of array elements. • Symbol Size: Shows the size of the variables in bytes. • Target System: Indicates the target system selected for a recording.g. • Symbol Name: Symbol name of the selected variable. the variables are communicated via the symbol name. This corresponds to the behavior of EtherCAT oversampling terminals. • Use Local Server: If this option is set. • Symbol Comment: Here the actual symbol comment is displayed.2 37 . The phase differences have to be determined manually by the user. can be used to separate Channel Style and Channel Acquisition at channel level through an additional hierarchy level. the variables are communicated via the Group and Offset indices. to compensate phase differences of different target systems. if such a comment exists. Note Example: The Array Length setting is only visible in the case of array symbols. If this option is not set. the Scope Server installed on the Scope View system is used for the recording. Changes by group To change the settings of several channels at once. • Symbol Index Group: Group index of the variable. which can be set in the Scope settings. • Disabled: Here you can decide whether the configured channel should be recorded or not. Channel Style and Channel Acquisition are described separately below. e. • Sample State: Here you can specify whether the data for the selected variables is to be sampled with the TaskSampleTime or the FreeSampleTime. If the option is set. • Symbol based: If this option is set. • Force Oversampling: This option is only shown for arrays. By default this is the target system for the selected variable. the array is interpreted as a variable and shows the values of the individual array elements contiguously. • Target Port: Shows the variable port on the respective TwinCAT system. a connection with the remote server of the target system is established. • Symbol Index Offset: Offset index of the variable. you can set the sampling rate here. • Data-Type: Indicates the data type of the selected variable. please observe the section Multiple selection [} 77]. The View Detail level. The properties of the channels can deviate from the illustration shown here. A drop-down box can be used to select the available ports for the selected target system. 6.1. 38 Version: 1.1 XY chart properties All settings assigned to the XY chart can be made here.2 TwinCAT 3 Scope View .Configuration 4. Changes by group To change the settings of several charts at once. TwinCAT 3 Scope View Version: 1. In the side by side display. If they are shown above each other. the display width can be changed by turning the mouse wheel in the selected chart window. multiple CPU cores can be specified for a chart. • Show Name: Specifies whether the name of the chart is shown in the graph. • CPU Core: Here you can set (for each chart individually) which CPU core should be used for the current chart display. please observe the section Multiple selection [} 77]. the chart starts the live display when a new recording is started. • Position: Shows the position. • Zoom Free: You can zoom into the current display by stretching a rectangle over the graphic area. The chart display is operated with the toolbar. the values of the appended channels are shown within the same area. • Data Tool Tip: If this option is enabled. The x-axis is/axes are set to the default display time.Configuration Behavior • Auto Start: If this option is enabled. You can now navigate in the data already recorded without stopping the recording. for example. the chart instructs all axes (X and Y) to perform autoscaling after a zoom or panning action. If required. • Time Bar: Specifies whether the time bar is displayed in the chart. If not all units are edited the format is sorted in ascending order. starting with seconds.fff". The maximum number is 60. • Rescale All: Carries out an autoscale on all axes. This value is set. Color • The background and frame color can be set by means of color dialogs.and y-axes by clicking and dragging with the mouse. The inner scroll keys move the display only by a tenth of the display width and can be kept pressed to view the data set. Up to the maximum number of data points that can be shown. Settings • Scale on Zoom: If this option is selected. • Display-Width: The current display width is displayed here. • Tool Bar: Specifies whether the toolbar is displayed in the chart. The changed value is adopted automatically. the channels are displayed in their own areas. a click on a data point results in display of a tooltip with the exact values of the data point on the X. • Scroll buttons: The outer scroll buttons move the current display in steps that correspond to the display width. It can be edited in the format "hh:mm:ss. This can be used to expand the selected area. • Panning Free: In the free panning mode the current display can be shifted along the x. • Default Display Time: This time indicates the display time for the signal or the signal length in the XY chart. The data currently being accumulated are displayed. • Zoom Out Max: Scales the X and Y-axis in such a way that all current values in the recording appear in the display. It can be edited in the format "hh:mm:ss.and Y-axis. Alternatively. The overview shows all buttons and their explanation (from left): • Play: Starts the live display mode. Common • Comment: A free comment can be saved here. This may improve the performance.2 39 . plus the timestamp and name of the corresponding channel. • Stacked Axes: This setting can be used to specify whether the axes of a chart are shown side by side or above each other. when the rescale button is selected in the chart toolbar. The colons are used as separators.000 data points. • Pause: The display switches to the pause mode.fff". • Date: The absolute date at the origin of the chart. The difference between the end time and start time is maximally as large as the defined record time (see Scope properties [} 27]). 4. The cursor position defines the center.2 TwinCAT 3 Scope View . The start time defines thus the zero point of the recording.6. • Time : The absolute time at the origin of the chart. • End-Time: The largest common time of all connected channels.2 XY axes properties Settings can be made separately for each available xy axis here. i.Configuration By turning the mouse wheel you can also zoom in or out on the current display. The current recording times are displayed in the chart toolbar: • Start-Time: The common starting point of the recordings of all connected channels. 40 Version: 1. The end time marks the final value of the recording.e.1. the time from the start time to the beginning of the display. • Position: The position time represents the zero point of the current chart. • Y Caption: Here you can enter an y-axis label. TwinCAT 3 Scope View Version: 1. This functionality is also available via the context menu. • Show Y Caption: Specifies whether the name of the y-axis is shown in the chart.Configuration Common • Comment: A free comment can be saved here. • X Caption: Here you can enter an x-axis label.2 41 . • Show X Caption: Specifies whether the name of the x-axis is shown in the chart. • Enabled: Here you can switch the axis on or off completely. X Scale • X Auto Scale: If Auto Scale is active. • Y SubGrid Divisions: Number of areas into which the main grid is subdivided by auxiliary lines. • Use X SubGrid: Auxiliary lines for the finer X-subdivision of the main grid can be shown or hidden here. • X Grid Color: The color of the grid. Alternatively. • X Visible: Specifies whether the axis is shown or hidden in the chart. • X Precision: Here you can enter the number of significant digits for the axis labels. • Y Logarithmic: Switches between logarithmic and linear scaling of the axes. AutoGrowNShrink can be selected. each axis is scaled such that the last-known minimum and maximum of all connected channels lie within the display range. Auxiliary lines have no axis labelling. • Y Grid Line Width: Line width of the grid in pixels. The default mode is AutoGrowOnly.Configuration X Grid • Use X Grid: The X-subdivisions of the axis can be shown or hidden here. 42 Version: 1. these are automatically reduced in the chart. This means the x-axis always scales to the historic maximum. • X Logarithmic: Switches between logarithmic and linear scaling of the axes. • Use Y SubGrid: Auxiliary lines for the finer Y-subdivision of the main grid can be shown or hidden here. • X SubGrid Divisions: Number of areas into which the main grid is subdivided by auxiliary lines. the maximum value can be edited directly. X Style • X Color: The colour of the axis. If there is not enough space for the selected number of ticks. Y Scale • Y Auto Scale: If Auto Scale is active. • X Line Width: The line width in pixels. • X Axis Max: If Auto Scale is inactive. • Y Axis Min: If Auto Scale is inactive. • Y Grid Color: The color of the grid. • X Axis Min: If Auto Scale is inactive. • Y Axis Max: If Auto Scale is inactive. Auxiliary lines have no axis labelling. the minimum value can be edited directly. each axis is scaled such that the last-known minimum and maximum of all connected channels lie within the display range. Otherwise the displayed auxiliary line shows the decades not displayed in the main grid. the maximum value can be edited directly. In the case of logarithmic scaling the number of ticks depends on the displayed range of values and can thus deviate from the settings. the minimum value can be edited directly. Y Grid • Use Y Grid: The Y-subdivisions of the axis can be shown or hidden here. In the case of logarithmic scaling the auxiliary lines for subdivision are shown only in the set number if the range of values per tick is precisely one decade. • X Ticks: Maximum number of subdivisions. • X Scale Mode: There is a choice between two auto-scale modes. • Y Precision: Here you can enter the number of significant digits for the axis labels. This mode always automatically adjusts the maximum of the x-axis to the maximum in the current view (display width). It corresponds to the number of visible digits on the axis. until a rescale is carried out for the current view. Otherwise the displayed auxiliary line shows the decades not displayed in the main grid.2 TwinCAT 3 Scope View . It corresponds to the number of visible digits on the axis. In the case of logarithmic scaling the auxiliary lines for subdivision are shown only in the set number if the range of values per tick is precisely one decade. • X Grid Line Width: Line width of the grid in pixels. The default mode is AutoGrowOnly.3 XY channel style All style settings belonging to a XY channel can be made here. This mode always automatically adjusts the maximum of the y-axis to the maximum in the current view (display width). • Y Visible: Specifies whether the axis is shown or hidden in the chart. TwinCAT 3 Scope View Version: 1. Alternatively. AutoGrowNShrink can be selected. • Y Ticks: Maximum number of subdivisions.Configuration • Y Scale Mode: There is a choice between two auto-scale modes. • Y Line Width: The line width in pixels.6. If there is not enough space for the selected number of ticks. until a rescale is carried out for the current view.1. In the case of logarithmic scaling the number of ticks depends on the displayed range of values and can thus deviate from the settings. This means the y-axis always scales to the historic maximum. 4.2 43 . Changes by group To change the settings of several axes at once. these are automatically reduced in the chart. Y Style • Y Color: The colour of the axis. please observe the section Multiple selection [} 77]. 44 Version: 1. If applicable the comment will be adopted from the connected ADS symbol.Configuration Cap • Cap Color: Specifies the colour of the active cap. • End Cap: Activates the end cap for the channel. • Start Cap: Activates the start cap for the channel. • Visible: Here you can set whether the channel should be displayed in the chart. • Cap Size: Specifies the size of the cap.2 TwinCAT 3 Scope View . Common • Comment: A free comment can be saved here. Changes by group To change the settings of several channels at once. to observe individual bits of a status byte. Alternatives are: Horizontal Zero. Top. • Line Color: The color of the graph. 4. This has an effect in particular if there are many channels with large movements. The default setting is “None”. to observe individual bits of a status byte. above or below a curve.6.2 45 . The default value is 50. • Fill Transparency: Here you can set the transparency value of the fill color. This means that the value of the channel is ANDed with the binary value of the mask.g. Antialias is "nicer" but requires considerably more computing. • Y Scale Factor: The display value of a channel can be changed with the scale factor. • Y Offset: A free offset can be added to the function value of the channel in the offset field. Center and Source. e. for example. • Fill Mode: Fill mode can be used to color an area. • Mark Size: The size of the base markings.g. • Y Bit Mask: In the Bit Mask field a value can be entered with which the display value is masked. • Marks: Selection of the visibility of markings -> On (permanently visible) | Auto (dependent on the zoom level) | Off (markings switched off). above or below a curve. This helps you. Bottom.Configuration Line • Antialias: This option decides how the lines will be drawn. TwinCAT 3 Scope View Version: 1. for example. This means that the value of the channel is ANDed with the binary value of the mask. Here you can select the fill color. • X Scale Factor: The display value of a channel can be changed with the scale factor. • X Offset: A free offset can be added to the function value of the channel in the offset field. Modify • X Bit Mask: In the Bit Mask field a value can be entered with which the display value is masked. • Line Width: The line width of the graph. provided it is not of the type floating point. The line width 1 requires least computing. Marks • Mark Color: The colour of the base markings. provided it is not of the type floating point. e.1.4 XY channel acquisition All acquisition settings belonging to a XY channel can be made here. This helps you. • Fill Color: Fill mode can be used to color an area. please observe the section Multiple selection [} 77]. the variables are communicated via the symbol name. if such a comment exists. • Symbol Comment: Here the actual symbol comment is displayed. A drop-down box can be used to select the available ports for the selected target system. If the option is set. This corresponds to the behavior of EtherCAT oversampling terminals. Comparisons: Oversampling recordings [} 113]. Acquisition • Data-Type: Indicates the data type of the selected variable. • Symbol Index Group: Group index of the variable. the array is interpreted as a variable and shows the values of the individual array elements contiguously. the variables are communicated via the Group and Offset indices. Note Example: The Array Length setting is only visible in the case of array symbols. • Disabled: Here you can decide whether the configured channel should be recorded or not. Some setting possibilities are visible / editable only for special channels. • Sample State: Here you can specify whether the data for the selected variables is to be sampled with the TaskSampleTime or the FreeSampleTime. • Target System: Indicates the target system selected for a recording. • Symbol Size: Shows the size of the variables in bytes. • Sample Time: If the sample state “FreeSampleTime” was selected. By default this is the target system for the selected variable. If this option is not set. 46 Version: 1.2 TwinCAT 3 Scope View . • Symbol based: If this option is set. • Symbol Name: Symbol name of the selected variable. and the input fields for Group and Offset are enabled.Configuration The properties may differ. • Force Oversampling: This option is only shown for arrays. • Target Port: Shows the variable port on the respective TwinCAT system. The properties of the channels can deviate from the illustration shown here. you can set the sampling rate here. • Symbol Index Offset: Offset index of the variable. It is always greater than the TaskSampleTime. 4. can be used to separate Channel Style and Channel Acquisition at channel level through an additional hierarchy level. TwinCAT 3 Scope View Version: 1. • Use Local Server: If this option is set. which can be set in the Scope settings.g.7. please observe the section Multiple selection [} 77].1. Changes by group To change the settings of several channels at once. If the option is not set.1. to compensate phase differences of different target systems.1 Bar chart properties Here you can enter all the settings relating to a array bar chart.2 47 .Configuration • Time Offset [s]: This can be used for one-time manipulation of the original timestamp during recording of the data point. a connection with the remote server of the target system is established. The phase differences have to be determined manually by the user. the Scope Server installed on the Scope View system is used for the recording. Channel Style and Channel Acquisition are described separately below. e.7 Scope View Bar Graph The properties of the individual hierarchy levels of array bar charts are explained below. The View Detail level. 4. 48 Version: 1.2 TwinCAT 3 Scope View . • Data Tool Tip: If this option is enabled. The values are recorded as a rule. If they are shown above each other. a click on a data point results in display of a tooltip with the exact values of the data point on the X.and Y-axis. A longer display time enables examination of the history of the extreme values. plus the timestamp and name of the corresponding channel. multiple CPU cores can be specified for a chart. the chart starts the live display when a new recording is started. the channels are displayed in their own areas. • Tool Bar: Specifies whether the toolbar is displayed in the chart. • CPU Core: Here you can set (for each chart individually) which CPU core should be used for the current chart display. the values of the appended channels are shown within the same area. Settings • Stacked Axes: This setting can be used to specify whether the axes of a chart are shown side by side or above each other. • Time Bar: Specifies whether the time bar is displayed in the chart. Color • The background and frame color can be set by means of color dialogs. If required. Common • Comment: A free comment can be saved here. • Show Name: Specifies whether the name of the chart is shown in the graph. • Default Display Time: This time refers to the display times of the minimum and maximum values in the array bar chart. This may improve the performance. In the side by side display.Configuration Behavior • Auto Start: If this option is enabled. 4. • Zoom Horizontal: A new time range for the display can be selected by stretching a rectangle over the x-axis. • Zoom Out Max: Scales the x-axis such that all array elements are displayed. The right mouse button is likewise assigned this function. this option triggers a zoom to the maximum number of array elements. • Panning Horizontal: In the horizontal panning mode the current display can be shifted along the xaxis by clicking and dragging with the mouse.and y-axes by clicking and dragging with the mouse. irrespective of their origin (e.). You can now navigate in the data already recorded without stopping the recording. starting with seconds.2 Bar axes properties All the settings for the axes of array bar charts are described here. • Position: The displayed position can be edited in the Position field in the format "hh:mm:ss. the zoom automatically focuses on the defined limits. A longer display time enables examination of the history of the extreme values.g. values can be repeated with redo. The values are recorded as a rule. If autoscale is disabled. • Pause: The display switches to the pause mode. etc. The colons serve here as separators. • Rescale All: If autoscale is set. The chart display is operated with the toolbar.2 49 . • Panning Free: In the free panning mode the current display can be shifted along the x. • Display-Width: This time refers to the display times of the minimum and maximum values in the array bar chart. Once undone. • Zoom Free: You can zoom into the current display by stretching a rectangle over the graphic area. • Undo/Redo Time/Position: Jumps in the display width or the current position can be undone here. The overview shows all buttons and their explanation (from left): • Play: Starts the live display mode.1. If not all units are edited the format is sorted in ascending order. scroll. The inner scroll keys move the display only by a tenth of the display width and can be kept pressed to view the data set.7. TwinCAT 3 Scope View Version: 1.Configuration Changes by group To change the settings of several charts at once. please observe the section Multiple selection [} 77].fff". • Scroll buttons: The outer scroll buttons move the current display in steps that correspond to the display width.: zoom. The data currently being accumulated are displayed. 50 Version: 1.Configuration Common • Comment: A free comment can be saved here. • Enabled: Here you can switch the axis on or off completely. • Y Caption: Here you can enter an y-axis label. • X Caption: Here you can enter an x-axis label. • Show Y Caption: Specifies whether the name of the y-axis is shown in the chart. • Show X Caption: Specifies whether the name of the x-axis is shown in the chart.2 TwinCAT 3 Scope View . This functionality is also available via the context menu. Configuration X Grid • Use X Grid: The X-subdivisions of the axis can be shown or hidden here. • Use X SubGrid: Auxiliary lines for the finer X-subdivision of the main grid can be shown or hidden here. Auxiliary lines have no axis labelling. • X Grid Color: The color of the grid. • X Grid Line Width: Line width of the grid in pixels. • X SubGrid Divisions: Number of areas into which the main grid is subdivided by auxiliary lines. In the case of logarithmic scaling the auxiliary lines for subdivision are shown only in the set number if the range of values per tick is precisely one decade. Otherwise the displayed auxiliary line shows the decades not displayed in the main grid. X Scale • X Auto Scale: If Auto Scale is active, each axis is scaled such that the last-known minimum and maximum of all connected channels lie within the display range. • X Axis Max: If Auto Scale is inactive, the maximum value can be edited directly. • X Axis Min: If Auto Scale is inactive, the minimum value can be edited directly. • X Logarithmic: Switches between logarithmic and linear scaling of the axes. • X Precision: Here you can enter the number of significant digits for the axis labels. It corresponds to the number of visible digits on the axis. X Style • X Color: The color of the axis. • X Line Width: The line width in pixels. • X Ticks: Maximum number of subdivisions. If there is not enough space for the selected number of ticks, these are automatically reduced in the chart. In the case of logarithmic scaling the number of ticks depends on the displayed range of values and can thus deviate from the settings. • X Visible: Specifies whether the axis is shown or hidden in the chart. Y Grid • Use Y Grid: The Y-subdivisions of the axis can be shown or hidden here. • Use Y SubGrid: Auxiliary lines for the finer Y-subdivision of the main grid can be shown or hidden here. Auxiliary lines have no axis labelling. • Y Grid Color: The color of the grid. • Y Grid Line Width: Line width of the grid in pixels. • Y SubGrid Divisions: Number of areas into which the main grid is subdivided by auxiliary lines. In the case of logarithmic scaling the auxiliary lines for subdivision are shown only in the set number if the range of values per tick is precisely one decade. Otherwise the displayed auxiliary line shows the decades not displayed in the main grid. Y Scale • Y Auto Scale: If Auto Scale is active, each axis is scaled such that the last-known minimum and maximum of all connected channels lie within the display range. • Y Axis Max: If Auto Scale is inactive, the maximum value can be edited directly. • Y Axis Min: If Auto Scale is inactive, the minimum value can be edited directly. • Y Logarithmic: Switches between logarithmic and linear scaling of the axes. • Y Precision: Here you can enter the number of significant digits for the axis labels. It corresponds to the number of visible digits on the axis. Y Style • Y Color: The color of the axis. • Y Line Width: The line width in pixels. TwinCAT 3 Scope View Version: 1.2 51 Configuration • Y Ticks: Maximum number of subdivisions. If there is not enough space for the selected number of ticks, these are automatically reduced in the chart. In the case of logarithmic scaling the number of ticks depends on the displayed range of values and can thus deviate from the settings. • Y Visible: Specifies whether the axis is shown or hidden in the chart. Changes by group To change the settings of several axes at once, please observe the section Multiple selection [} 77]. 4.1.7.3 Bar Channel Style All Style properties of array bar chart channels are explained here. Common • Comment: A free comment can be saved here. If applicable the comment will be adopted from the connected ADS symbol. • Visible: Here you can set whether the channel should be displayed in the chart. Line • Antialias: This option decides how the lines will be drawn. Antialias is "nicer" but requires considerably more computing. This has an effect in particular if there are many channels with large movements. • Line Color: The color of the graph. 52 Version: 1.2 TwinCAT 3 Scope View Configuration • Line Width: The line width of the graph. The line width 1 requires least computing. • Show Max: If the option is set to TRUE, the maximum values for the set display width are shown. • Show Min: If the option is set to TRUE, the minimum values for the set display width are shown. • Type: Here you can switch between different display types. The default value for an array bar chart is Bar. Other options are: Line and Stair. Marks • Mark Color: The color of the base markings. • Marks: Selecting the visibility of markings -> On (permanently visible) | Off (markings switched off). • Mark Size: The size of the base markings. Modify • X Offset: A free offset can be added to the function value of the channel in the offset field. • X Scale Factor: The display value of a channel can be changed with the scale factor. • Y Offset: A free offset can be added to the function value of the channel in the offset field. • Y Scale Factor: The display value of a channel can be changed with the scale factor. Changes by group To change the settings of several channels at once, please observe the section Multiple selection [} 77]. 4.1.7.4 Bar Channel Acquisition This section explains all settings for the channel acquisition of array bar chart channels. TwinCAT 3 Scope View Version: 1.2 53 • Symbol Name: Symbol name of the selected variable.2 TwinCAT 3 Scope View . The phase differences have to be determined manually by the user. and the input fields for Group and Offset are enabled. Below that all devices registered in the System Manager are shown. The first shows a tree with the first entry: ROUTES.Target Browser With the target browser you can be add Scope configuration channels via their symbol names. The colour of the target indicates the system state: red = not reachable (stop mode). 4. • Symbol based: If this option is set. • Symbol Index Offset: Offset index of the variable. • Target Port: Shows the variable port on the respective TwinCAT system. The default setting for array bar charts is 100 ms. the variables are communicated via the symbol name. you can set the sampling rate here. It is always greater than the “TaskSampleTime”. blue = config.Configuration Acquisition • Array Length: Indicates the length of selected arrays. • Symbol Size: Shows the size of the variables in bytes. • Use Local Server: If this option is set. which is also the maximum displayed on the xaxis. • Target System: Indicates the target system selected for a recording.1.1 TwinCAT Scope View . mode. the system tries to connect to the remote server of the target system. This is a sampling rate for bar charts that is comfortable for the human eye. • Disabled: Here you can decide whether the configured channel should be recorded or not. A drop-down box can be used to select the available ports for the selected target system. • Symbol Comment: Here the actual symbol comment is displayed.g. • Sample Time: If the sample state “FreeSampleTime” was selected.8. green = system in run mode. • Sample State: Here you can specify whether the data for the selected variables is to be sampled with the TaskSampleTime or the FreeSampleTime. the Scope Server installed on the Scope View system is used for the recording. • Time Offset [s]: This can be used for one-time manipulation of the original timestamp during recording of the data point. to compensate phase differences of different target systems. Changes by group To change the settings of several channels at once. By default this is the target system for the selected variable. if such a comment exists. If this option is not set. The target browser is divided into two halves. e. • Data-Type: Indicates the data type of the selected variable. 54 Version: 1.1. the variables are communicated via the Group and Offset indices. If the option is not set. since it makes no sense to scan a bar display so quickly that it is not possible for the human eye to observe it. The default value for array bar charts is “FreeSample”. please observe the section Multiple selection [} 77].8 Recording 4. • Symbol Index Group: Group index of the variable. an Ads Bigtype or an array is selected that contains sub-symbols. the "Add Subsymbols" option adds a channel for each subsymbol. In addition. selected elements can be inserted by drag & drop to any place within the configuration.2 55 . If a folder. The "Add symbol" option inserts only one channel with the information of the selected symbol. Add channel In the list structure one or more channels can now be selected and added to the configuration with a double click or by a right mouse click-> "Add symbol" ("Add subsymbols" ) or by one of the buttons in the toolbar. TwinCAT 3 Scope View Version: 1.Configuration The second half shows a detailed list of the subitems of the selected element of the tree structure. With the “Upper Folder” button you can go one level upwards in the tree structure. with a detail level of 1 it becomes "Signals. then a selection menu can be called using the Enable – Server Types option that displays the limitation to certain tasks. irrespective of whether they are server tasks. These are marked in colour: green = PLC task. Each further level then adds the term before the respective next full stop. Subsequently a check is made as to which of the ports exist. allowing simple browsing. in order to update the display.Sinus".Sinus" with a detail level of 0 becomes "Sinus". If the detail level is zero. For example. blue = NC task. then only the part of the symbol name after the final full stop is transferred. If a task is not displayed. View symbol list If a symbol list is available for the selected task.Signals. the connected tasks become visible.').Sinus" and with 2 or more it becomes "Main. this can be called by means of selection. All common Ads ports are displayed here.Signals. All symbols of a task are transferred into a hierarchical view according to separators (e. All selected ports that are servers are adopted after confirming with OK. the symbol "Main.2 TwinCAT 3 Scope View .Configuration Task selection If a target computer is selected in the tree or list structure. Settings The detail level of the channel name formed from the symbol name can be set with the 'Name Detail Level' option in the settings. If a port is not listed here it can be entered in the text field at the bottom left. red = other.g. 56 Version: 1. '. Cursor A chart cursor can be added and changed via the cursor module. 4.1.Configuration Record After you have chosen all channels for the record.1.9. you can start the record with the "Start Record" button in the Scope Toolbar.2 57 . TwinCAT 3 Scope View Version: 1.1 TwinCAT Scope View .9 Cursor 4. Configuration Cursor module The cursor module (listed in each chart element as "cursor") offers the following setting options: 58 Version: 1.2 TwinCAT 3 Scope View . Configuration • Delta Values: If several cursors are used in one direction the differences can be displayed if Delta Types is activated.2 59 . • Comment: A comment can be saved here. Cursor Settings Each X/Y-cursor within the cursor module offers its own setting options • Color: Colour of the cursor. Cursor Window The values are displayed in the cursor window (Scope context menu -> cursor window) TwinCAT 3 Scope View Version: 1. • Hex Valies: Hexadecimal notation of the average values of the individual channels. • Line Width: Line width of the cursor in pixels. The displayed average values are. You can zoom into the recording in order to indicate the intermediate values. compromised to pixel width. Channel The average values of the individual channels are displayed with the respective X-cursor in the Channel field. like the display. Axis The values of the Y-cursors on the respective axes are indicated in the lowest field. • Record Position: Time value of the cursor since the beginning of the recording.2 TwinCAT 3 Scope View . • Chart Position: Time value of the cursor within the recording. 60 Version: 1.Configuration Status Times The times belonging to an added X-cursor are displayed here in three formats. • Absolute Position: Corresponds to the actually registered time. 1 TwinCAT Scope View .1.Trigger Different trigger functions can be added to the Scope configuration. In order to enable the simplest possible and free combination of individual trigger conditions and actions.10 Trigger 4.1. these are combined into trigger groups.10. TwinCAT 3 Scope View Version: 1.2 61 .Configuration 4. Trigger groups and trigger sets can be added via the trigger context menu.2 TwinCAT 3 Scope View . Some setting options are visible / editable only for special trigger actions.Configuration properties of the trigger group can differ The properties of the trigger group can deviate from the illustration shown here. Note Example: The trigger position setting is only visible in the case of the trigger action "Stop Display". Trigger group The trigger group offers the following setting options: 62 Version: 1. With setting this action.2 63 . It is possible to start up to 5 subsaves simultaneously (via one or more trigger events). the Scope connects itself as usual to the servers involved and starts to sift through the connected channels. therefore. a question box appears that carries out this setting if necessary.Configuration • StartRecord: If this option is selected. The maximum memory capacity of the subsave can be specified in the 'Record Time' field. in alphanumeric order. If pre-trigger is selected. This subsave always runs in the ring buffer mode (independent of the settings in the Scope settings). • StartSubsave: On the occurrence of this trigger event a background recording is started with the current configuration. the Scope should be operated in the ring buffer mode. • StopDisplay: The stop display action stops all Scope charts that are in live mode at the point of triggering. the recording runs for the specified time after receipt of the trigger event. TwinCAT 3 Scope View Version: 1. • RestartDisplay: All charts paused due to a StopDispay trigger are resumed on fulfilment of the trigger condition. the oldest subsave is stopped and transferred to the View in the background. Otherwise the Scope would start recording as usual. the start record condition in the Scope settings should be set to trigger start. In the field below you can specify whether a fixed time range should appear in the recording before and/or after the trigger event. The recording begins with the trigger time of the last trigger set condition. Pause can be actuated in the chart in order to prevent this retriggering. If the trigger condition is fulfilled again. From here it is saved in a . With the trigger position you can select how many percent of the display shown (display width) are to be located before or behind the trigger event (in the example: positive 0-crossing of the green signal at 10% of 2. the display jumps to this new event. If you actuate the record button in the menu bar.25 s). • StopRecord: If the stop action is selected. • StopSubsave: Following the StopSubsave trigger event. a question box appears that carries out this setting if necessary.5 s = 0. If post-trigger is active. With setting this action. but without starting the actual recording. This recording duration may also be longer than the recording duration of the basic configuration (in this case ring buffer operation should also be selected). trigger events before the expiry of this time are ignored. The generated file name consists of the name of the Scope in the basic configuration and an ID composed of the date and time. therefore.svd file via the specified path. Configuration Trigger set Each trigger set can be regarded as an independent trigger condition. the icon in the Solution Explorer changes from to .2 TwinCAT 3 Scope View . The action report of the trigger group defines what happens when a trigger group is triggered. As soon as a trigger set is triggered. Note here that AND operations are handled before OR operations. Manual triggering of trigger set Triggers can be manually triggered for test purposes via the trigger set context menu item "Manual Trigger Hit". • Hit: indicates whether the trigger set has been triggered ( ) or not ( ). The trigger set offers the following setting options: • Channel: A channel is assigned to each set whose state is to be checked for the selected trigger condition • Combine: By selecting a logic operation these individual conditions can be placed in relation to one another. 64 Version: 1. • Release: The release condition can be either a rising or falling edge. All trigger sets remain set until the entire trigger group has triggered. • Threshold: The associated limit value. svd file -> Visual Studio opens and offers a “New Project” dialog. The most common choice is an Empty Measurement Project. To use the configuration for other purposes. Loading data • Double-click on the required . This enables exclusively data analysis within the file. A corresponding yellow data icon is displayed in the Solution Explorer.2 65 . TwinCAT 3 Scope View Version: 1. • If a measurement project already exists.svd format. select the option “Extract Scope Configuration” in the Scope menu.1 Save Data that were logged with the TwinCAT 3 Scope can be saved in . for example to record further data with the same configuration.svd file is a special. • If several svd files are added to a measurement project. In this way the data can be reloaded. • Select the measurement project to which the previously created svd file was added File -> Open -> Project/Solution. proprietary Scope View data format. the context menu automatically offers a reload option for the svd file. the svd file can be selected and opened via Add Existing Item.1.Configuration 4. Reloading of svd files • If previously saved data are no longer displayed by the Scope server as a result of a "disconnect" in the internal Scope communication.11. Saving data • Use the option Save Data in the Scope menu This creates a Scope data file (svd) that can be added directly to the measurement project or saved in a directory via the directory selection dialog.11 Saving and exporting data 4.1. A . the name of the svd file is automatically incremented with a number. Extracting Scope configurations from an svd file An svd file is visually identified as such. The rows are separated by lines and the columns by tabulators. Afterwards a definition range with the acquisition data follows for each channel.svd).txt or binary format for use in other programs. Context menu of the Scope -> Export to CSV/Export to Binary Export to CSV: The generated file is held in the table format. once the current recording has stopped.2 TwinCAT 3 Scope View . 66 Version: 1.Configuration 4. data can be exported in . such as Scope name and start and the end time of the recording. The first rows contain information about the recording. .2 Export CSV / Binary Recorded Scope data can be saved in a Scope data file (.11.csv. Alternatively.1. Each time offset from the Start Record time is allocated the corresponding data value.Configuration Finally a list with the recorded data follows for each channel. Instead the byte lengths of all variable data types (such as character strings) are contained in the corresponding headers. All times are specified in the file time format: 1tick = 100ns. Export to Binary: The binary data format is based on the text format. TwinCAT 3 Scope View Version: 1. but contains no separators. All characters are stored in UTF8.2 67 . origin is 1/1/1601 0h. Header #1 ChannelHeaderSize 8 NameSize 4 Name NameSize NetIdSize 4 NetId NetIdSize Port 4 Sample Time 8 SymbolBased 1 SymoblNameSize 4 Symbol name: SymbolNameSize CommentSize 4 Comment CommentSize IndexGroup 8 IndexOffset 8 DataTypeSize 4 DataType DataTypeSize DataTypeId 4 VariableSize 4 Samples in File 8 Data in File 8 File-StartPosition 8 Scalefactor 8 Offset 8 Bitmask 8 Channel ..ChannelCount DataType Variable Size (Bytes) Data Channel #1 DataPoint #1 Timestamp 4 Value ChannelHeader1.DataType TwinCAT 3 Scope View .. DataType 68 Version: 1.Samples In File Data Channel #2 .Header #2 ..Configuration Variable MAIN-HEADER HeaderSize NameSize Name StartTime EndTime ChannelCount Size (Bytes) or Number of character DataType 8 4 NameSize 8 8 4 Int64 Int32 Array of Char Int64 Int64 Int32 Variable Size (Bytes) Channel . DataPoint ChannelHeader #1...VariableSize DataPoint #2 . Channel-Header #MainHeader.2 Int64 Int32 Array of Char Int32 Array of Char Int32 Int64 bool (as byte) Int32 Array of Char Int32 Array of Char Int64 Int64 Int32 Array of Char Int32 Int32 Int64 Int64 Int64 Real64 Real64 Int64 UInt32 ChannelHeader.. Reporting With the help of the Microsoft Visual Studio Report Designer it is possible to generate complex printing templates which are used by the TwinCAT Measurement.1.csv silent'. A small code example with fixed strings and fbStartExport as instance of NT_StartProcess is shown below: fbStartExport( NETID:= ''. The tool comes with integrated documentation and requires a Professional license.1. TwinCAT 3 Scope View Version: 1.12 Reporting 4.svd). for example. Context menu of the Scope -> Export to DAT/Export to TDMS 4.svd files into the supported export formats. The interface shown here can be suppressed by entering the keyword "silent" in the command line. COMNDLINE:= '"svd=c:\Scope Project.     ERR=> .3129 an additional TC3ScopeExport tool is installed in the TE130X Scope View folder. based on specified parameters. To automate the export.     ERRID=> ). Alternatively data can be exported to .4 Automated export From Scope version 3.1.3 Export tdms / dat Recorded data can be saved in a scope data file (. The TC3ScopeExport tool can also be used for export via a command line call.svd" target=c:\TestExport.1 TwinCAT Scope View .11.     TMOUT:= T#20S.2 69 .1.     BUSY=> .     DIRNAME:= 'C:\TwinCAT\Functions\TE130X-Scope-View'.12.tdms or .     PATHSTR:= 'C:\TwinCAT\Functions\TE130X-Scope-View\TC3ScopeExportTool. 4.Configuration Data Channel #MainHeader.ChannelCount 4. Both data formats are widely used in measurement applications and can be used with the TwinCAT 3 Scope View Professional version.exe'.     START:= bStart. In this case the export is executed in the background.dat format. once the current recording is complete. This can be used to convert content from .2. the tool can be called from the PLC via NT_StartProcess. to print Scope charts.11. beckhoff.Configuration The following report is generated from the recording shown here via the Visual Studio "Print" function (File -> Print | <Ctrl> + P): http://infosys.2 TwinCAT 3 Scope View . Editing a report In order to edit a report the Microsoft Visual Studio Report Designer can be opened by double-clicking on the printing template. Integration of a report in a TwinCAT Measurement Project Beckhoff already supplies a ready-made printing template with each installation of TwinCAT 3. This printing template is already contained in the project with the TwinCAT Measurement Template "Measurement Scope Project with Reporting". 70 Version: 1.com/content/1033/TE13xx_TC3_ScopeView/.1 in the TwinCAT Measurement. It can be added to every existing TwinCAT Measurement Project via the context menu -> Add -> New Item > Standard Report. • Built-in Fields ◦ Execution Time: time at which a print job was created. ◦ Comment: the comment saved in the Scope element. ◦ Language: the set system language. ◦ Report Name: name of the report. ◦ User ID: User ID of the user who commissioned the report. Beckhoff offers a ready-made data set containing all relevant data of a Scope chart.Configuration For the editing of report templates. ◦ Page Number: current page number. TwinCAT 3 Scope View Version: 1.Convert. ◦ FilePath: storage location of the associated Scope file. • Parameters ◦ ChartImage: Converted image of the chart.2 71 .FromBase64String (Parameters!ChartImage. please refer to the following article: Report Designer (Visual Studio). ◦ Total Pages: total number of pages of the document. Can be converted back to an image using the expression (System.Value). Data of the data set For the design of your own printing templates. • Cursor_Status_Times ◦ ColorHex: colour of the cursor in hexadecimal notation. ◦ Row: name of the cursor row. ◦ Value: displayed value. ◦ RecordStop: stop time of the recording. • Cursor_Y_Values ◦ ColorHex: colour of the cursor in hexadecimal notation. The raw data of the chart are for the creation of your own displays. Chart_Data usage Note The Chart_Data are the raw data of the chart. ◦ Column: name of the cursor column. • Chart_Data ◦ Channel: channel name. ◦ ChannelName: name of the channel. • Cursor_X_Values ◦ ColorHex: colour of the cursor in hexadecimal notation. 72 Version: 1. • Images ◦ logo: Beckhoff logo used in the standard template. ◦ ChannelColorHex: colour of the channel in hexadecimal notation. ◦ Column: name of the cursor column. • Channel_Properties ◦ AxisName: name of the axis. ◦ Value: displayed value.2 TwinCAT 3 Scope View .Configuration ◦ RecordStart: start time of the recording. ◦ Time : time stamp of the value. ◦ Row: name of the cursor row. ◦ Column: name of the cursor column. ◦ Value: displayed value. ◦ Row: name of the cursor row. ◦ ChannelComment: comment of the channel. ◦ Value: displayed value. They are only exported if the setting "Export Raw Data to Report" has been selected (Menu Options [} 76]) This setting significantly delays the creation of reports. 12.Configuration 4.2 reporting_sample.2 73 .pdf TwinCAT 3 Scope View Version: 1.1. 05.2 TwinCAT 3 Scope View .Configuration Record Start: 12:38:17:450 Record End: 12:38:27:484 Axis Name Channel Name Channel Comment Position absolute ACTPOS Actual Position SETPOS Set Position ACTPOSMODULO Actual Position Modulo SETPOSMODULO Set Position Modulo ACTVELO Actual Velocity SETVELO Set Velocity ACTACC Actual Acceleration SETACC Set Acceleration POSDIFF Position Difference Position modulo Velocity Acceleration Position Lag Status Times C 01 Absolute Position 12:38:18:461.000 16.2013 Record Position 01:011.96s C:\TwinCAT Measurement\Scope\Scope NC Project.tcscope 5/16/2013 12:47:55 PM 74 1/2 Version: 1.961s Chart Position 00:977. 368419 Position Lag -1.Configuration X-Values C 01 ACTACC 0 ACTPOS 258.368419 Velocity -55.50000 SETPOS 258.21053 Position absolute 122.672887 ACTPOSMODULO 258.672887 SETPOSMODULO 258.263161 C:\TwinCAT Measurement\Scope\Scope NC Project.2 75 .672887 ACTVELO 237.672887 SETVELO 231.8421053 Position modulo 122.tcscope 5/16/2013 12:47:55 PM TwinCAT 3 Scope View 2/2 Version: 1.736500 POSDIFF 0 SETACC -553.919499 Y-Values C 02 Acceleration -184. 2 TwinCAT 3 Scope View ...13.1.1. 76 Version: 1.13 Scope Options 4.Configuration 4.1 TwinCAT Scope View . The standard or default settings can be made here.Scope Menu: Options You can go directly to the TwinCAT measurement options in the Visual Studio Options window via the Scope menu item "'Options.". TwinCAT 3 Scope View Version: 1. keep the <Shift> key pressed and then select the last element in order to mark all elements in between.1.2 TwinCAT Scope View – Multiple Selection Changes by group Some parameters are often modified for several or all elements. Further you can select all channels of the scope easily independent of the configuration. Scope • Root: Here you can enter settings relating to tracing of the Scope View product components. ◦ Border Background Color: color for the border of the chart.". (Significantly extends the time it takes to generate a report | Only required for creating custom charts). for a detailed description see Acquisition [} 36]. To make multiple selections. ◦ Show Clear List Command: Shows the context menu item "Clear Error List.. ◦ Y-Axis Color: color for the grid of the Y-axis. ◦ Show Warnings: Shows warnings from the Scope in the error list. • Acquisition: Defines the standard acquisition data (used if empty channels are inserted). for a detailed description see Axis properties [} 32]. • Axis: Defines the standard axis settings (used if new axes are inserted). ◦ Show Messages: Shows messages from the Scope in the error list.Configuration Reporting • General ◦ Show Chart Timebar: specifies whether the time bar of the Scope chart should be visible in the printing template. for a detailed description see Channel properties [} 34]. ◦ X-Axis Color: color for the grid of the X-axis. To do this you can mark several elements via the Solution Explorer and edit the settings of all marked elements at the same time. the following color settings are used before the chart is exported for the report (color combinations can be selected here that reduce ink consumption for printing processes). for a detailed description see Chart properties [} 29]. • Error List ◦ Clear on Record: Deletes the respective error messages for the Scope instance from the error list as soon as a Scope changes to the record mode. In the case of successive elements you can select the first element. • Chart: Defines the standard chart settings (used if new charts are inserted). ◦ Y-Axis Color: color for the labelling of the Y-axis. ◦ X-Axis Color: color for the labelling of the X-axis.. 4. ◦ Export Raw Data to Report: Provides the raw chart data for the report.13. ◦ Show Chart Toolbar: specifies whether the toolbar of the Scope chart should be visible in the printing template. keep the <Ctrl> key pressed during the selection. ◦ Y-Axis Color: color for the grid of the Y-axis. Data that differ between the selected elements are represented as empty fields. Keep the <Alt>-key pressed and double click on the first channel in the Scope configuration. ◦ Chart Background Color: color for the background of the chart. • Channel: Defines the standard channel settings (used if empty channels are inserted). for a detailed description see Scope properties [} 27].2 77 . • Scope: Defines the standard Scope settings (used if new Scope instances are inserted). ◦ Use Custom Color: If "Use Custom Color" is active. Multiple selection is implemented for: • Scopes • Charts • Axes • Channels • Cursor • Trigger Groups • Trigger Sets 78 Version: 1.2 TwinCAT 3 Scope View .Configuration All elements of the same type can be selected. ð The .NET Framework 4. use the Designer in Visual Studio: 1. MS Visual Studio To add the ScopeViewControl to an existing or newly created project.”. select “. In this way simple integration is possible in C#. The ".NET is available with the installation of TwinCAT 3. 2.0 is installed.0 1.NET Framework 4. The main components are Scope View and Scope Server.1 Integration of the ScopeViewControl Integration of the ScopeViewControl in your own applications The TwinCAT Scope consists of different components. which can be used as a separate component for custom visualization. Open the form or the control to which the ScopeViewControl is to be added. Right-click on a blank area in the toolbox and select “Choose Items.Net or WPF applications. VB.NET API 5.NET API 5 .0” as the target framework.. 3. Under “Application”. ð A dialog opens. Right-click on the project and select “Properties”. 2. Note Installation of the ..NET Framework 4 Client Profile" is not supported.NET Framework 4. The ScopeViewControlLib developed in .NET Framework 4.1 from version 4006. The View includes the ScopeViewControl.0. TwinCAT 3 Scope View Version: 1. Required software The ScopeViewControl requires .. Select “Browse”.2 79 . ð You have now added the ScopeViewControl to a project.Tools' libraries.NET API 4.0. 3. Right-click on the current project in the Solution Explorer and select “Add Reference”.dll” and confirm. Add the following libraries to the project: • TwinCAT. 2. 5.. create a new Windows application and add a tool bar and the buttons shown to the form in the designer.1.Ads. ð A gearwheel now appears in toolbox with the entry “ScopeViewControl”.Tools. Required software The ScopeViewControl requires .Scope2. Execute the following steps: 1.Communications. In the “Browse” tab.View.1 Sample YT Chart The application shown in the example below is created to demonstrate the main aspects of ScopeViewControl. Use the mouse to drag one or several ScopeViewControls in the Designer and position it. To do this. Then add a ScopeViewControl to the form as described above and set the 'Dock' property to Full.Scope2. Find the installation path for the TE130X Scope View and open it. By double-clicking on each button you can generate a Click-Event handler. select the installation path of the . The ".Scope2.NET Framework 4 Client Profile" is not supported.NET-GAC (Global Assembly Cache). 6. Select “TwinCAT. which is filled with the example code in the following.Scope2.dll • TwinCAT.dll 5.2 TwinCAT 3 Scope View . If the project is now compiled. ð A dialog opens. Note 80 Version: 1.dll • TwinCAT.NET Framework 4. Visual Studio may report missing references to the 'TcAdsScope2Communications' and 'TwinCAT.Control.           MessageBoxButtons. shows a grey surface at the start.1.sv2". which is now executable.Count > 0)     {      scopeViewControl1.LoadScopeConfig(filename).Exists)  {     MessageBox.1 Loading the configuration Loading the configuration The project.1.2 Adding elements All elements that can be added in the TwinCAT Scope are generated in the ScopeViewControl by a method in the respectively higher element: • Charts: private void buttonChart_Click(object sender.NET Framework 4. refer to the separate API documentation of the ScopeViewControlLib: ScopeViewControlLib 5.OK. EventArgs e) { ScopeViewControlChart chart = scopeViewControl1. select “.NewChart(). "File not found!".ConnectedChannels)     {      channel.     }     // Konfiguration laden     scopeViewControl1. "File not found! Please use the 'New' buttons to create a config.NET API Installation of the . The C# code example shows the call from a 'ButtonClick EventHandler': private string filename = @"ScopeTest.AmsNetId = AmsNetId. since no configuration has been loaded or created.NET Framework 4.Charts[0]). ð The .     }  } } Creating the configuration by programming The ScopeViewControl offers methods for all functions that are also called from the TwinCAT Scope. The example developed here is available as a VS2010 project: scopeviewcontrolintegration. A configuration can either be created programmatically. EventArgs e) {  FileInfo finfo = new FileInfo(filename).\r\n         Once a config is created and saved it can be load using the 'Load' -Button!".0” as the target framework.Exclamation).Charts. } • (Y-)axes: TwinCAT 3 Scope View Version: 1. 2. Right-click on the project and select “Properties”.2 81 . MessageBoxIcon.zip 5.0 1.zip The example accesses variables of the example PLC program: ScopeSignals..0 is installed. or a file created with the TwinCAT Scope can be loaded.Show(this.1.     foreach (ScopeViewControlChannel channel in scopeViewControl1.1.  if (!finfo.DeleteChart(scopeViewControl1.  }  else  {     // alte Konfiguration löschen     while (scopeViewControl1.NET Framework 4.Acquisition. private void button_Load_Click(object sender. Under “Application”. For details.Local.     channel.Local.AmsNetId = AmsNetId. "No channel connected!".1.Style.Exclamation).Charts[0]. "No axis connected!". SetAcquisition(channel).Charts[0].4 Adaptation of the acquisition data In addition to the 'Style'. } else if (scopeViewControl1.LineColor = Color.Charts.Exclamation).Count == 0) { MessageBox. } else { ScopeViewControlChannel channel = scopeViewControl1.OK. } } 5. } } 5. } else {     channel. MessageBoxIcon. MessageBoxButtons. MessageBoxIcon. "Please create an YAxis first!". "Please create a chart first!".Exclamation). The connection to a system variable is set here: private void SetAcquisition(ScopeViewControlChannel channel) { if (scopeViewControl1.OK.Count == 0) {     MessageBox.DisConnect(false).Charts[0].Exclamation).Acquisition.Channels. Beyond that.Charts[0].Count == 0) { MessageBox. colour and line width can be assigned to a channel.OK. "No chart connected!". EventArgs e) { if (scopeViewControl1.TicksPerMillisecond).Acquisition.Channels.Exclamation).MarkColor = Color.OK.         MessageBoxButtons.     channel.Style.Show(this.OK. in which all the properties are saved that are also visible in the corresponding Visual Studio Properties window. } } • Channels: private void buttonChannel_Click(object sender.     channel.         MessageBoxButtons. "No channel connected!".AdsToScope2Datatype(AdsDatatypeId. all the properties can be found that are also visible in the Visual Studio Properties window with the Scope selected.Count > 0) { MessageBox. MessageBoxIcon.1.Channels.     channel. EventArgs e) { if (scopeViewControl1. methods are available for starting and stopping the recording or for saving and export.Axes[0].SymbolName = "SIGNALS.Charts.         MessageBoxButtons.DataType = DataTypeConverter.ADST_INT16). MessageBoxIcon.Charts.Acquisition.State == ScopeViewControlStates.dll     channel. "Channel still connected!".Charts[0].NewAxis(). "Please create an YAxis first!".Acquisition.Axes[0]..OK. MessageBoxIcon.Charts[0]. MessageBoxButtons.         MessageBoxButtons. MessageBoxIcon.Count == 0) {     MessageBox.Show(this.Ads.     channel.Axes.Acquisition. "Please create a Channel first!".     // Start recording     if (scopeViewControl1. EventArgs e) { try {     // Discard old data     if (scopeViewControl1. } else if (scopeViewControl1.Show(this. } else if (scopeViewControl1.1.CONFIG) 82 Version: 1.Axes. For instance.1. } else if (scopeViewControl1.Exclamation). MessageBoxIcon.Operating.     channel.Count == 0) {     MessageBox.         MessageBoxButtons. "Please create a Channel first!".PlcRuntime1.DarkRed. each channel also has the 'Acquisition' property. } else if (scopeViewControl1.LineWidth = 2.State == ScopeViewControlStates.Show(this.3 Adapting the styles Each of the elements created has a 'Style' property.Red. "This sample contains only one channel!". } else {     //AmsNetId and AmsPort require the TwinCAT.Show(this.OK.TargetPort = (int)AmsPort. "Please create a chart first!". private void button_StartRecord_Click(object sender. } else { ScopeViewControlYAxis axis = scopeViewControl1.Show(this. "Please create a chart first!".Show(this.NewChannel().Count == 0) {     MessageBox. "No axis connected!". MessageBoxButtons. private void ChangeChannelSettings(ScopeViewControlChannel channel) { if (scopeViewControl1. Here.OK.Count == 0) { MessageBox. "No chart connected!".5 Controlling the recording All methods and properties for controlling the ScopeViewControl are summarised in the 'Operating' property.OK. "No chart connected!".2 TwinCAT 3 Scope View .1.IsSymbolBased = true.Exclamation).NET API private void buttonAxis_Click(object sender.Exclamation). MessageBoxIcon.Axes.Axes[0]. MessageBoxIcon. "No axis connected!".TREPPE".Style. MessageBoxIcon.         MessageBoxButtons. "Please create a chart first!". MessageBoxButtons. "Please create an YAxis first!".Count == 0) {     MessageBox.Show(this.1.Acquisition.REPLY)      scopeViewControl1.OK. } } 5.Show(this. "No chart connected!". } else if (scopeViewControl1.Exclamation).Axes[0].Charts.Charts[0].Show(this.Count == 0) {     MessageBox. ChangeChannelSettings(channel).Exclamation).SampleTime = (uint) (10 * TimeSpan.Charts[0].     channel. State == ScopeViewControlStates.1. } } private void button_Save_Click(object sender. } TwinCAT 3 Scope View Version: 1.Operating. } catch (Exception err) {     MessageBox.Operating. "Error on save!". The options to hide/ show the toolbar and the time bar are also to be found there.Error).Operating. } } 5.SaveScopeConfig(filename).     } } catch (Exception err) {     MessageBox.         MessageBoxButtons.Create(filename). it is also possible to operate these functions via the 'ChartOperating' property. err.Close(). EventArgs e) { if (scopeViewControl1.Charts[0].State != ScopeViewControlStates.svd").Exclamation). EventArgs e) { try {     // Save if data are there     if (scopeViewControl1. "Error on stop record!".1.Show(this.REPLY)     {      File. MessageBoxIcon.State != ScopeViewControlStates. MessageBoxIcon.Create("ExportData. } catch (Exception err) {     MessageBox.RECORD)     scopeViewControl1.NET API      scopeViewControl1.Show(this. EventArgs e) { try {     if (scopeViewControl1.State == ScopeViewControlStates.Show(this. "Only possible if a record is running!".Error).         MessageBoxButtons.OK.StartDisplay().OK.6 Controlling a chart All charts that have been added to the configuration have their own toolbox in order to make them operable.RECORD)      scopeViewControl1. "Error on start record!".Message. EventArgs e) { if (scopeViewControl1.      scopeViewControl1.RECORD) {     MessageBox. err.Message. "Only possible if a record is running!".Exclamation).         MessageBoxButtons.Operating. MessageBoxIcon.OK.OK. } private void button_Pause_Click(object sender. err.State == ScopeViewControlStates.SaveData("ExportData.RECORD) {     MessageBox.OK.     }     // Otherwise save only the configuration     else     {      File. MessageBoxIcon.         MessageBoxButtons.2 83 .StartRecord(). "Pause not possible!".Close().         MessageBoxButtons.StartAllDisplays().Error).svd").ChartOperating. } }      private void button_StopRecord_Click(object sender.. } if (scopeViewControl1. "Run not possible!".Show(this.      scopeViewControl1.     // Start all charts     if (scopeViewControl1.Message. private void button_Run_Click(object sender.CONNECTED)      scopeViewControl1. MessageBoxIcon.State == ScopeViewControlStates.StopRecord().Show(this. However. so that the graph can utilize the whole window. } else if (scopeViewControl1.DisConnect(false).Exclamation). First.OK. } else if (scopeViewControl1.         MessageBoxButtons. create a Windows Forms application with a toolbar containing the buttons shown in the above form.Count .StopDisplay().. EventArgs e) { if (scopeViewControl1. } } 5.StopRecord().RECORD)     scopeViewControl1.Charts.DisConnect(false).1.State == ScopeViewControlStates.State == ScopeViewControlStates.NET API if (scopeViewControl1. The procedure is explained below.REPLY) {     scopeViewControl1. Then. } private void toolStripButtonDelChart_Click(object sender. add a ScopeViewControl to the form and set the ‘Dock’ property to Full.2 Sample XY Chart The form shown above illustrates a Scope View control integration in C# with an XY chart.Operating.State == ScopeViewControlStates.     scopeViewControl1.ChartOperating.2 TwinCAT 3 Scope View . MessageBoxIcon.1]). 84 Version: 1. "No chart is connected!".Charts[0].Operating.Count == 0) {     MessageBox.Charts. "Nothing to delete!".DeleteChart(scopeViewControl1.Charts[scopeViewControl1.RECORD) {     scopeViewControl1.Operating.Show(this. } else {     scopeViewControl1. First.0.com/ content/1033/TE13xx_TC3_ScopeView/Resources/zip/2282225419.NET Framework 4 Client Profile" is not supported.2.NET Framework 4.zip 5. The ".NET Framework 4.0 is installed. create a Windows Forms application with a toolbar containing the buttons shown in the above form. ð The . so that the graph can utilize the whole window.beckhoff. The program can be found in the following file: http://infosys.beckhoff. add a ScopeViewControl to the form and set the ‘Dock’ property to Full.com/content/1033/ TE13xx_TC3_ScopeView/Resources/zip/2282227083.0 1.1 C# sample project The form shown above illustrates a Scope View control integration in C# with an XY chart. Then.NET API Required software The ScopeViewControl requires .NET Framework 4.zip The variables refer to the TwinCAT program behind the following file: http://infosys. Under “Application”. Required software The ScopeViewControl requires .NET Framework 4.1. Note Installation of the . Note TwinCAT 3 Scope View Version: 1. Right-click on the project and select “Properties”. 2. select “..NET Framework 4.0. The procedure is explained below.NET Framework 4 Client Profile" is not supported. The ".0” as the target framework.2 85 . 0 is installed. if (!finfo.NET API Installation of the . The graph can then be displayed by clicking on the “Start” button. since a configuration consists of three hierarchy levels.beckhoff. scopeViewControl1.. and the configuration from the file is transferred to ScopeViewControl.Charts. EventArgs e) { FileInfo finfo = new FileInfo(filename).Charts.zip 5. Right-click on the project and select “Properties”. Ensure that the property ChartType is set to XY.Charts[0]). the presence of a chart must be verified.0 1. which build on each other. In Scope.LoadScopeConfig(filename).OK. } else { // alte Konfiguration löschen while (scopeViewControl1. scopeViewControl1. the configuration opened in the program is deleted. The program can be found in the following file: http://infosys. } Then use the “Add Axis” button to add the X. which is created with the TwinCAT Scope. MessageBoxButtons.2 TwinCAT 3 Scope View .NewChart().scopeDisplayModes.Count - 1]. "File not found!".AmsNetId = AmsNetId. It is used to open a configuration file (.Show(this.Communications.and Y-axis to create the coordinate system. foreach (ScopeViewControlChannel channel in scopeViewControl1. MessageBoxIcon. select “. This file only contains the information about the axes and the channels.2 Loading the configuration private void button_load_Click(object sender. Without a chart.Count > 0) { scopeViewControl1. "File not found! Please use the 'Add Chart' buttons to create a config.com/content/1033/ TE13xx_TC3_ScopeView/Resources/zip/2282227083.NET Framework 4.2.\r \nOnce a config is created and saved it can be load using the 'Load' -Button!".Local. The chart represents the basic framework and must be created first.ChartType = TwinCAT.Exists) { MessageBox.Scope2. first use the “Add Chart” button to create a new chart. This method first checks the existence of the method. in which the graph with the coordinate system appears. a program configuration with three buttons is created. 86 Version: 1.zip The variables refer to the TwinCAT program behind the following file: http://infosys.1.tcscope). the coordinate system cannot be created.ViewDetailLevel = ScopeViewDetailLevel. but not the graph (measured data) itself.XY. } } } The code specified above is executed by clicking the “Load” button in the interface.0” as the target framework.NET Framework 4.beckhoff. Since this coordinate system is created in the chart. If this is the case. EventArgs e) { ScopeViewControlChart chart = scopeViewControl1. } // Konfiguration laden scopeViewControl1. Under “Application”. Further information about this can be found under “Control recording”.Exclamation).DeleteChart(scopeViewControl1.1.3 Create configuration In this example. ð The . 5.Charts[scopeViewControl1.2.com/ content/1033/TE13xx_TC3_ScopeView/Resources/zip/2282225419.Acquisition. The chart is the environment.Extended.ConnectedChannels) { channel.NET Framework 4. private void button_AddChart_Click(object sender. 2. } else if (scopeViewControl1.Exclamation). MessageBoxButtons. EventArgs e) { if (scopeViewControl1. in which values for the graphs are specified.LineColor = Color. and the acquisition can be set. } else if (scopeViewControl1.Charts. if (axis is ScopeViewControlXYAxis) { ScopeViewControlXYAxis xyAxis = (ScopeViewControlXYAxis)axis. MessageBoxButtons.4 Edit channel Edit style: Each channel has a “Style” property. "No axis connected!".OK.Show(this.Charts[0]. MessageBoxButtons. SetAcquisition(channel).Count > 0) { MessageBox. } Edit acquisition data: TwinCAT 3 Scope View Version: 1.DarkRed. "No chart connected!".OK. This is where colors and line thickness can be assigned. the “Add Channel” button can be used to add an XY-channel. "No chart connected!".NewAxis(). This XYchannel is linked directly to the axes.. check whether charts and axes were created. the graph style can be modified.Show(this. EventArgs e) { if (scopeViewControl1.Exclamation). "Channel still connected!".Exclamation). } else { ScopeViewControlYAxis axis = scopeViewControl1.Charts[0]. When creating the XY-channel. ChangeChannelSettings(channel). channel.Channels.1.Count == 0) { MessageBox. } } } Once the axes have been created.Count == 0) { MessageBox. "Please create a chart first!". This is easily possible. for example.Count == 0) { MessageBox.NET API private void button_AddAxis_Click(object sender. since the XY-objects inherit from the Y-objects. "Please create the Axis first!". First. } } } Once the channel has been created.Axes. private void button_AddChannel_Click(object sender.NewChannelPair().Charts[0].Charts[0].Show(this. channel.2 87 .Style. ScopeViewControlXYChannel channel = xyAxis. "This sample contains only one channel!". if (axis is ScopeViewControlXYAxis) { ScopeViewControlXYAxis xyAxis = (ScopeViewControlXYAxis)axis.Axes[0].LineWidth = 2. private void ChangeChannelSettings(ScopeViewControlXYChannel channel) { channel. These methods are explained in more detail in the following sections. 5.Style. MessageBoxIcon. "Please create a chart first!". } else { ScopeViewControlYAxis axis = scopeViewControl1.2. MessageBoxButtons.Axes[0].Style.OK.Show(this.Charts.OK.MarkColor = Color. MessageBoxIcon.Red.Exclamation). MessageBoxIcon. MessageBoxIcon. ensure that casting takes place from the Y-objects to the XY-objects. The signal determines the data type.AdsToScope2Datatype(AdsDatatypeId.1. "Error on stop record!". channel. channel. } catch (Exception err) { MessageBox. If a recording is currently displayed. } catch (Exception err) { MessageBox. // Aufnahme starten if (scopeViewControl1. MessageBoxIcon. To stop a recording.Show(this. channel. channel. it must be removed before a new recording.IsSymbolBased = true.Acquisition.Operating.RECORD) scopeViewControl1. This is the hierarchical name of the signal to be monitored.Operating.AmsNetId = AmsNetId.Puls1".XAcquisition. channel.DataType = DataTypeConverter.CONFIG) scopeViewControl1. } } private void button_Stop_Click(object sender.State == ScopeViewControlStates.CONNECTED) scopeViewControl1. 88 Version: 1. which is entered in “DataType”.Message.Error). err. // alle Charts starten if (scopeViewControl1. } 5. err.SampleTime = (uint)(10 * TimeSpan.2.Operating. MessageBoxButtons.NET API The acquisition data of a channel describe the connection between the Scope and the respective value of the machine control.AdsToScope2Datatype(AdsDatatypeId.SymbolName = "MAIN.AmsNetId = AmsNetId. EventArgs e) { try { if (scopeViewControl1.XAcquisition. channel. During the acquisition the “SymbolName” is set. channel. channel. MessageBoxIcon.Acquisition.2 TwinCAT 3 Scope View . private void button_Start_Click(object sender. channel. EventArgs e) { try { // alte Daten verwerfen if (scopeViewControl1. The recording is then started.TargetPort = 851.XAcquisition. Press the “Stop” button.Acquisition.Message. channel. MessageBoxButtons.StartRecord().Acquisition.XAcquisition.TicksPerMillisecond).StopRecord().OK.Acquisition.Show(this.Operating.XAcquisition.Acquisition.TargetPort = 851.Puls2".DisConnect(false).XAcquisition.DataType = DataTypeConverter.Local. } } The “Operating” properties are available in Scope View control for starting or stopping the recording and for the settings of the Scope.. For display on the interface the display is then started.ADST_REAL32).SymbolName = "MAIN.StartAllDisplays().TicksPerMillisecond).State == ScopeViewControlStates. The “AmsNetId” and the “TargetPort” are the connection data leading to the TwinCAT project.Error).OK. private void SetAcquisition(ScopeViewControlXYChannel channel) { channel. "Error on start record!".State == ScopeViewControlStates.Local.5 Control recording Use the “Start” and “Stop” buttons to start and stop the recording.State == ScopeViewControlStates. execute the method “StopRecord”.SampleTime = (uint)(10 * TimeSpan.ADST_REAL32).REPLY) scopeViewControl1. channel.IsSymbolBased = true.  MessageBoxButtons. } private void button_Pause_Click(object sender. MessageBoxIcon.SaveScopeConfig(filename).ChartOperating.Count == 0) { MessageBox.1.Show(this.RECORD) scopeViewControl1.Show(this. MessageBoxIcon.Charts[0].ChartOperating. MessageBoxButtons. "Pause not possible!".2.Message. err.REPLY) { scopeViewControl1. } private void btn_DelChart_Click(object sender.OK.RECORD) { MessageBox.Exclamation).RECORD) { scopeViewControl1.StopRecord(). in order to display the data. TwinCAT 3 Scope View Version: 1.SaveData("ExportData.Charts[0]. MessageBoxIcon. on the other hand. } } catch (Exception err) { MessageBox.State != ScopeViewControlStates. scopeViewControl1.Create(filename).Exclamation).DisConnect(false).svd"). } if (scopeViewControl1. EventArgs e) { try { // wenn Daten da sind speichern if (scopeViewControl1. "Nothing to delete!".Operating.State == ScopeViewControlStates.Operating.tcscope file. "Error on save!".7 Control chart The “Run” and “Pause” buttons can be used to pause and resume the graph during recording.State == ScopeViewControlStates. It can be used to start new recordings. The .2.OK. MessageBoxButtons. } } There are two save options.Operating.svd file • Creating a configuration file (. "Run not possible!".DisConnect(false). "Only possible if a record is running!".Create("ExportData.svd"). scopeViewControl1.RECORD) scopeViewControl1.StartDisplay().2 89 .Charts.6 Save configuration/recording private void button_Save_Click(object sender.OK. MessageBoxButtons.Exclamation).svd file can be opened in any TwinCAT 3 Scope View.Close().OK.State == ScopeViewControlStates.Operating.State == ScopeViewControlStates.Error).NET API 5. } if (scopeViewControl1.Close(). } else if (scopeViewControl1.State != ScopeViewControlStates.tcscope) The difference is that the . scopeViewControl1. MessageBoxIcon.StopDisplay(). The “DelChart” button is used to close the chart. as indicated in the code: • Saving the recorded data in a . "No chart is connected!".Show(this.1. "Only possible if a record is running!". } // sonst nur die Konfiguration speichern else { File.Show(this.State == ScopeViewControlStates. EventArgs e) { if (scopeViewControl1.RECORD) { MessageBox. EventArgs e) { if (scopeViewControl1. } else if (scopeViewControl1.. private void button_Run_Click(object sender.REPLY) { File. EventArgs e) { if (scopeViewControl1. 5. only contains the configuration without actual data. The code behind the “Load” and “Create Configuration” buttons can be found in the sample for the ScopeViewControl YT chart.2 TwinCAT 3 Scope View . A toolbar can be used to create the menu with the buttons shown in the image above. This is apparent if the Overview chart is active. The method “DisConnect” under “Operating” can be used to remove the graph from the chart.DeleteChart(scopeViewControl1. The method “DeleteChart” can be used to delete a chart from ScopeViewControl. The recording continues in the background. the current recording is stopped. 90 Version: 1. If this is the case. The “StopDisplay” method can be used to pause the display via the Pause button. 5. the system checks whether signals are currently being recorded. Before the chart is deleted.3 Sample YT Cursor The following section describes the use of cursors in a ScopeViewControl. In this sample the programming language C# is used.1. } } Since this function can only be used in recording mode.Count - 1]). for example. the system checks whether a chart is open. The Run button and the method “StartDisplay” behind it can then be used to resume the chart.Charts. a Windows Forms application is created.NET API } else { scopeViewControl1.. First. based on an YT-chart. It then checks whether recording is active.Charts[scopeViewControl1. Under “Application”. TwinCAT 3 Scope View Version: 1.1 C# sample project The following section describes the use of cursors in a ScopeViewControl.com/content/1033/ TE13xx_TC3_ScopeView/Resources/zip/2282228747.NET Framework 4. Right-click on the project and select “Properties”.beckhoff. based on an YT-chart.2 91 ..0” as the target framework. In this sample the programming language C# is used. First.beckhoff. The program can be found in the following file:http://infosys.NET Framework 4 Client Profile" is not supported. Note Installation of the . ð The . select “.0 is installed. The code behind the “Load” and “Create Configuration” buttons can be found in the sample for the ScopeViewControl YT chart. The ".com/ content/1033/TE13xx_TC3_ScopeView/Resources/zip/2282225419.NET API Required software The ScopeViewControl requires .zip The variables refer to the TwinCAT program behind the following file: http://infosys.NET Framework 4.1.0 1.0. a Windows Forms application is created.zip 5. 2.NET Framework 4.3.NET Framework 4. A toolbar can be used to create the menu with the buttons shown in the image above. The ".NewCursor(false).3. EventArgs e) { try { ScopeViewControlCursor newCursor = scopeViewControl1.Charts[0].resfreshX). For a Y-cursor.Name).com/ content/1033/TE13xx_TC3_ScopeView/Resources/zip/2282225419.Count - 1].NET Framework 4. 2.NewCursor(true). 92 Version: 1. To create an X-cursor.NET Framework 4.EventHandler(this. This method is also explained in more detail later. The new cursor.0” as the target framework.Charts[0]. Note that X-cursors have several values.1. newCursor. To add a further cursor.ChannelValuesChanged += new System. These methods are described in more detail later. Right-click on the project and select “Properties”.zip The variables refer to the TwinCAT program behind the following file: http://infosys. dataGridView1.Selected += new System. all channel values should be double-checked for this cursor.Style. add method events.NET API Required software The ScopeViewControl requires .Color. newCursor.Rows.Insert(scopeViewControl1. Finally. null). newCursor. including its color. the method is called which recreates the view of the delta values.NET Framework 4.Charts[0].EventHandler(this. setXDeltaView().timeRefreshX). all old delta values are deleted first.Charts[0]. To ensure that the display of the delta values matches the new cursor. set the value to “true”. Therefore.ChartPositionTime.XCursor. This is not necessary for Y-cursors. } catch (Exception) { } } private void buttonYCursor_Click(object sender. newCursor.NET Framework 4. call the method NewCursor(Boolean).or Y-cursor. The last event is triggered with a mouse click on the cursor. The Boolean value determines whether the cursor is an X. is then added in the table.0 is installed.Style. All new delta values are then calculated and added to the table. The program can be found in the following file:http://infosys. Under “Application”.CursorModule.Count - 1. dataGridView1. Note Installation of the .Rows[scopeViewControl1.XCursor. newCursor. In addition. newCursor.Selected += new System.0.2 TwinCAT 3 Scope View . EventArgs e) { try { ScopeViewControlCursor newCursor = scopeViewControl1.EventHandler(this. Once the cursors have been created. These methods are explained in more detail later.CursorModule.AxesValuesChanged += new System.zip 5.EventHandler(this.beckhoff.StatusTimes. if there are several channels.CursorModule.resfreshY).Style. the refreshX method is called to enter the current values in the table right away.actCursorRefresh).actCursorRefresh).StatusTimesChanged += new System.CursorModule.2 Add cursors The cursors for a chart are in the CursorModule.com/content/1033/ TE13xx_TC3_ScopeView/Resources/zip/2282228747. ð The .NET Framework 4 Client Profile" is not supported. so that the tables on the interface are updated. when each individual cursor is assigned new values. newCursor. since they only have the position.Cells[1].ToString(). private void buttonXCursor_Click(object sender. select “. set the value to “false”.ForeColor = newCursor. resfreshX(newCursor.0 1. rather than later.beckhoff..EventHandler(this.  h < scopeViewControl1.Count - 1]. The table with the cursor data is then revised.3 Delete cursor The method CurserModule.Value = Convert.ToString()). dataGridView2. setXDeltaView().DefaultCellStyle.Count. newCursor.Style.SelectedCells[0]. k].Rows.SelectedCells[0]. } //set new values for (int i = 0.Rows. dataGridView1.Count + 2.AxesValues[0]). since they only have the position.CursorModule.Count - 1).Rows[scopeViewControl1.Channels. i < scopeViewControl1.Rows. i].Parse(dataGridView1[0.Value)  Convert.CursorModule.1.YCursor.Name.3.Charts[0]. EventArgs e) { try { scopeViewControl1. newCursor. all channel values should be double-checked for this cursor.DeleteCursor(scopeViewControl1. k < scopeViewControl1.YCursor. dataGridView1.ToString()) - TimeSpan.SelectedCells[0]. i].Count - 1.Charts[0]. the cursor is deleted from the table.CursorModule. k].Charts[0].CursorModule. i].Value + " - " + dataGridView1[1.3. all old delta values are deleted first.4 Delta values To ensure that the display of the delta values matches the edited cursor. The cursor data in the table are then updated.DeleteCursor(scopeViewControl1.Rows.. } catch (Exception) { } } private void butteonDeleteYC_Click(object sender. h++) { if (dataGridView1[h.Count.Rows. k].CursorModule.Style.Insert(scopeViewControl1.Add(TimeSpan. Then.CursorModule. k++) { dataGridView1.NET API dataGridView2.XCursor.XCursor.Value).CursorModule.ToDouble(dataGridView1[h. k]. This procedure is created under “Update values”.Parse(dataGridView1[0.Value.RowIndex]).RowIndex).Charts[0]. dataGridView1[1.Count) { dataGridView1.Rows.Axes[0].XCursor. } catch (Exception){} } 5.CursorModule.1.XCursor[dataGridView1. EventArgs e) { try { scopeViewControl1.Count - 1].RemoveAt(dataGridView1. setYDeltaView().ForeColor = newCursor.Charts[0]. dataGridView2. i++) { for (int k = i + 1.DeleteCursor() deletes the cursor that was transferred to it from the list.RemoveAt(dataGridView2.Charts[0]. setYDeltaView(). private void buttonDeleteXC_Click(object sender.Charts[0].Rows.Color.RowIndex). private void setXDeltaView() { //delete old values while (scopeViewControl1.Rows. if there are several channels. the method for updating the delta values is called.Value != null) { dataGridView1[h. } catch (Exception) { } } 5.ToDouble(dataGridView1[h. The values are updated under events. } } } TwinCAT 3 Scope View Version: 1.Charts[0]. for (int h = 2.Charts[0].Value.CursorModule.Value).Charts[0].RemoveAt(dataGridView1.YCursor[dataGridView2.Count != dataGridView1. Note that X-cursors have several values.RowIndex]). All new delta values are then calculated and added to the table.2 93 . This is not necessary for Y-cursors. First. Therefore.SelectedCells[0]. CursorModule. k++) { dataGridView2. Here too. m].YCursor.XCursor[k] == tmpCursor) { for (int j = 0. k++) { if (scopeViewControl1. j++) { dataGridView1[j + 2. This method works like the functions described above. k].XCursor.CursorModule.ToDouble(dataGridView1[h. } } } 5. } } //refresh all delta values int m = scopeViewControl1.CursorModule.Count.Count + 2. i].Charts[0].XCursor.Charts[0].Channels. k++) { for (int h = 2.Rows. i < scopeViewControl1.CursorModule. i < scopeViewControl1.Axes[0].Value. Convert. i].ToDouble(dataGridView2[1.Rows. because the program is unable to update the values fast enough.CursorModule. only the time rows are addressed. i++) { for (int k = i + 1.Charts[0].Value + " - " + dataGridView2[0.Count. } } m++. k]. } } } catch (Exception) { } } 94 Version: 1.NET API } } private void setYDeltaView() { //delete old values while (scopeViewControl1.1. The interface would start to flicker. //set new channel value for (int k = 0. a further method is available for updating the time. This enables the cursor to be found in the table first..Charts[0].ChannelValues[j].CursorModule.Count. } //add new values for (int i = 0.Rows.Value) - Convert.Value = Convert.Count - 1). the cursors are included in the parameters.Count. k]. } break.Value)). Please note that the values in each cell should be edited individually.YCursor.2 TwinCAT 3 Scope View .Value) - Convert.CursorModule.Charts[0].XCursor. Since the time may also change with the X-cursor. i].ChannelValues.Count.Charts[0].RemoveAt(dataGridView2. for (int i = 0.ToDouble(dataGridView2[1.Count.Value != null) { dataGridView1[h.Count) { dataGridView2. private void resfreshX(object sender.Value). h++) { if (dataGridView1[h. EventArgs e) { try { ScopeViewControlCursor tmpCursor = (ScopeViewControlCursor)sender. The delta values are then revised. since this would have a negative impact on the performance. Several rows are edited during this process.3.Value = tmpCursor.Count != dataGridView2.YCursor.ToDouble(dataGridView1[h.CursorModule. k < scopeViewControl1. please note that the X-cursor can have several channels (unlike the Y-cursor). k < scopeViewControl1. j < tmpCursor.5 Update values Since these methods are called through events. i++) { for (int k = i + 1. Each cell is recalculated.Charts[0].Count. k]. k < scopeViewControl1.Charts[0].XCursor. k].Add(dataGridView2[0. h < scopeViewControl1.Charts[0]. rather than deleting and regenerating the row.Rows. so that the values can then be modified. Count. } } //refresh all deltavalues int m = scopeViewControl1.Name) { dataGridView2[1.CursorModule. The value of the pressed key can be found in the parameter of type KeyEventArgs under the property “KeyCode”. The method is called directly on a cursor.CursorModule.1. i++) { dataGridView1[0. i].Value.Count.StatusTimes. Use the method MoveCursor(int) to move the cursor.Count.XCursor[i]. k]. i++) { for (int k = i + 1. for (int i = 0. k].ToDouble(dataGridView2[1.Charts[0].2 95 .Value = Convert.Charts[0]. TwinCAT 3 Scope View Version: 1. No further code is required.XCursor. i].Value = scopeViewControl1.Rows.ToString(). This can be found in the CursorModule. k++) { dataGridView2[1. If a positive number is entered. i < scopeViewControl1.YCursor.Count. } m++. i++) { if (dataGridView2[0.XCursor. break. This event is always triggered when a key is pressed. • by clicking on the cursor in ScopeViewControl The “Select” event of the cursor is called..Value.Value). The position of the cursor in the CursorModule is shown in the selected table cell.CursorModule. } //refresh the deltatime int m = scopeViewControl1. EventArgs e) { //refresh the cursortime for (int i = 0.Charts[0].Charts[0].YCursor. i < scopeViewControl1. i++) { for (int k = i + 1.ChartPositionTime.Value = tmpCursor.Count.YCursor.Count. as described above.NET API private void resfreshY(object sender.6 Control cursor via the keyboard When the cursor is moved via the keyboard. This is always the cursor that is selected in the interface.CursorModule. There are two ways to select a cursor in the table: • by direct clicking on the table row. with a negative number it is moved to the negative part.ToString(). //set new axes value for (int i = 0. } } } 5. The KeyDown event of the form is used for this. k < scopeViewControl1.Count. only the cursor selected last is moved.CursorModule. k++) { dataGridView1[0.Charts[0].CursorModule.Charts[0].XCursor.Style.Value) - Convert. the cursor is moved to the positive part.ToString()) - TimeSpan. m++. This event calls the method specified below. The parameter indicates how far the cursor moves. i].ToString() == tmpCursor.Count.AxesValues[0]. This value can then be compared with the expected values.Value. i]. m]. The cursor is transferred in the first parameter. k < scopeViewControl1. i]. EventArgs e) { try { ScopeViewControlCursor tmpCursor = (ScopeViewControlCursor)sender.CursorModule.3. i < dataGridView2.XCursor.Charts[0].CursorModule.ToDouble(dataGridView2[1.ToString()). for (int i = 0.Parse(dataGridView1[0.Charts[0]. i < scopeViewControl1.Parse(dataGridView1[0.Value = TimeSpan. m]. } } catch (Exception) { } } private void timeRefreshX(object sender. Show("There is no X-Axis to move!"). } } } private void actCursorRefresh(object sender.CursorModule.A) { try { scopeViewControl1.KeyCode == Keys.Show("There is no Y-Axis to move!"). EventArgs e) { ScopeViewControlCursor tmpCursor = (ScopeViewControlCursor)sender.Charts[0].Vertical) { for (int i = 0. } catch (Exception) { MessageBox.Orientation” property of the cursor is checked to ascertain whether the cursor is an X-cursor or Y-cursor.XCursor[dataGridView1.RowIndex].MoveCursor(-5).Charts[0].Charts[0].Charts[0].CursorModule. i++) { if (tmpCursor == scopeViewControl1.SelectedCells[0].CursorDirection. so that the corresponding table row can be selected.SelectedCells[0].KeyCode == Keys.CursorModule.XCursor. } catch (Exception) { MessageBox.S) { try { scopeViewControl1.Charts[0].Style.KeyCode == Keys.2 TwinCAT 3 Scope View .D) { try { scopeViewControl1.Charting. The system counts the cursor position in the cursor module.SelectedCells[0].Orientation == TwinCAT.KeyCode == Keys.Charts[0].CursorModule.NET API First. The cursor is then located in the cursor module.MoveCursor(5).Charts[0].MoveCursor(5). dataGridView1[1.CursorModule.ClearSelection().ClearSelection(). } } } else { for (int i = 0. the “Style. } catch (Exception) { MessageBox.Show("There is no Y-Axis to move!").YCursor[dataGridView2.CursorModule.SelectedCells[0].YCursor.Show("There is no X-Axis to move!").Count. } } else if (e. i < scopeViewControl1. i].XCursor[dataGridView1.W) { try { scopeViewControl1. i++) { if (tmpCursor == scopeViewControl1.RowIndex].YCursor[dataGridView2. 96 Version: 1.YCursor[i]) { dataGridView2.ChartingBase. } } else if (e.CursorModule.Scope2..RowIndex].XCursor[i]) { dataGridView1.RowIndex].Selected = true. KeyEventArgs e) { if (e. } } else if (e.Count. } catch (Exception) { MessageBox. private void Form1_KeyDown(object sender.MoveCursor(-5).Charts[0]. if (tmpCursor.CursorModule. i < scopeViewControl1. select “.com/ content/1033/TE13xx_TC3_ScopeView/Resources/zip/2282225419. The interface for this sample consists of two text boxes for entering the paths and a button for starting the export.g. TwinCAT 3 Scope View Version: 1. The interface for this sample consists of two text boxes for entering the paths and a button for starting the export.0 1. The ScopeViewControl requires . The ". i]. Right-click on the project and select “Properties”.com/content/1033/ TE13xx_TC3_ScopeView/Resources/zip/2282223499.2 97 .0” as the target framework.zip The variables refer to the TwinCAT program behind the following file: http://infosys.txt or . This application is 32-bit-based. Under “Application”.csv).g.NET Framework 4.1 C# Scope Export The following example illustrates the export of a Scope file into another file type (e.csv). Note Installation of the .4 Sample Scope Export The following example illustrates the export of a Scope file into another file type (e. This sample is based on the programming language C# in a Windows Forms project.Selected = true.beckhoff.1.. 2.NET API dataGridView2[0. This sample is based on the programming language C# in a Windows Forms project. } } } } 5.beckhoff. .0.NET Framework 4. . The program can be found in the following file: http://infosys.4.txt or .1.NET Framework 4.zip 5.NET Framework 4 Client Profile" is not supported. this is not used to output the configuration on the interface.0” as the target framework. if (string. so that a string containing the file format is formed.NET Framework 4. try { //Checking the existens of the path if (destination == null) destination = Environment.Text.2 TwinCAT 3 Scope View .socpeExportTdmsExtention)) { control. destination. Once the required format has been found.Write("No destination file defined. and the chart should be deleted with the method “DeleteChart()”.0.zip 5. destination = @textBox_Export.LoadScopeConfig(svdFile).Equals(ScopeViewControl. The file extension is first checked for all possible file formats available for export.Extension. static String svdFile.Exists(svdFile)) { Console.zip The variables refer to the TwinCAT program behind the following file: http://infosys. The target path for the new file is transferred to the method as a parameter. the path under which the new file is to be stored is split. EventArgs e) { svdFile = @textBox_SVD.svd file) is then loaded in a ScopeViewControl.ScopeExportTXTExtension)) 98 Version: 1. the respective export method is called on the ScopeViewControl instance..0 1.ExportDataToTDMS(destination). ScopeViewControl control = new ScopeViewControl().4.Write("SVD File could not be found."). This application is 32-bit-based.com/ content/1033/TE13xx_TC3_ScopeView/Resources/zip/2282225419. } else { control. The configuration should then be separated from the control with the method “DisConnect(true)”.2 Export The system first checks whether both paths were specified correctly. } else if (format. 2. private void export_button_Click(object sender. The ".beckhoff.IsNullOrEmpty(destination)) { Console. select “. Unlike in the other samples. if (format. Note Installation of the . The program can be found in the following file: http://infosys.Equals(ScopeViewControl. but for export.NET Framework 4 Client Profile" is not supported. The configuration file (.NET API The ScopeViewControl requires .IsNullOrEmpty(svdFile) || !File. Under “Application”.beckhoff."). } if (string. Right-click on the project and select “Properties”.NET Framework 4.Operating.ScopeExportCSVExtension) || format. string format = fInfo.Equals(ScopeViewControl.CurrentDirectory. Once the configuration is loaded.Text. } else { //search the Method with the right export FileInfo fInfo = new FileInfo(destination).com/content/1033/ TE13xx_TC3_ScopeView/Resources/zip/2282223499.NET Framework 4.1. SupportWpfRefresh" property needs to be set.DisConnect(true).ExportDataBinary(destination). TwinCAT 3 Scope View Version: 1.Write(ex..      // Initialisierung des ScopeViewControl      windowsFormsHost1.     } } }   5. Console.Operating.ExportData(destination).2 Integration in a WPF (Windows Presentation Foundation) project In order to use the ScopeViewControl within WPF applications as well.Child = scopeViewControl. Initialize the ScopeViewControl as described in the Windows Forms examples.Equals(ScopeViewControl.Operating. } } //Disconnect the . When using the ScopeViewControl within the WPF application. Position a WindowsFormsHost control from the toolbar in the interface of the WPF application you created. Amongst other things.NET API { control.Equals(ScopeViewControl.ReadLine().Operating. An exemplary implementation would then look like the following: namespace WpfApplication { /// /// Interaction logic for MainWindow. and add the created ScopeViewControl to the WindowsFormsHost.ScopeExportBinaryExtention)) { control.      ScopeViewControl scopeViewControl = new ScopeViewControl(). the library contains instructions and reference documents as well as example codes. only the "ScopeViewControl.xaml /// public partial class MainWindow : Window {     public MainWindow()     {      InitializeComponent(). 2.Operating.Charts[0]).      scopeViewControl. control.ToString()).2 99 . 1.DisConnect(true).3 API Documentation The attached class library offers an extensive source of information for developers who work with the technologies and services of TwinCAT Scope.Operating. control.DeleteChart(control. } catch (Exception ex) { Console. you require a WindowsFormsHost as a the basis.Operating.Write("Unknown format. } else { Console. } else if (format. } } 5. since the ScopeViewControl is a Windows Forms UserControl.ScopeExportDatExtention)) { control. } else if (format.").ExportDataToDat(destination).SupportWpfRefresh = true.svd File control.Operating.  1: ScopeViewControl_API In order to find the desired contents. use the search function or switch to one of the sections of the library with the aid of a quick link.2 TwinCAT 3 Scope View . cursor and many more. In the search results you will find example codes for the trigger modules. navigate through the table of contents. For example codes.NET API Fig. switch in the left-hand area of the user interface to the "Search" tab and search for the keyword "examples". Class library documentation 100 Version: 1.. You can choose between various templates.1 TwinCAT 3 Scope View – first steps In order to allow a fast startup and to simplify work with the TwinCAT 3 Scope software oscilloscope. For example. You can find out here [} 6] which functions are enabled with which licence key. 1. the first steps are briefly described on this page.2 101 . New project: The Scope View can be selected under Beckhoff in the Windows Start Menu. 2. Licensing: Regardless of whether the Scope View was installed by its own setup or by the TwinCAT 3 XAE setup. the Scope component installation can also install the Server without View on a target device. Installation: For basic understanding is important to know that a Scope Server is always installed with a Scope View. Conversely. We have consciously avoided dealing with every detail. the initially activated license is "Base" for View and Server. trigger-controlled recordings and the creation of reports are not subjects of this documentation. The Visual Studio opens in its shell or in a full version if installed. TwinCAT 3 Scope View Version: 1.Samples 6 Samples 6. 3. since otherwise no saved data can be displayed locally in the View. 2 TwinCAT 3 Scope View . These can be selected via the target browser. 4. The target browser can be selected in the context menu with a right-click on the Scope node. When using for the first time it is possible that this will not be directly visible as a window in Visual Studio. Selection of channels: Variables or channels now have to be added to the generated configuration. 102 Version: 1.Samples In the Solution Explorer the starting point for the new Scope configuration assembles itself automatically. the window can be docked in any position in the user interface. The variables can be selected by multi-select and added to the configuration by right-clicking on "Add symbol" or by drag & drop. Once the target browser has opened. TwinCAT 3 Scope View Version: 1. It is possible to select the desired variables by browsing into the respective target system.2 103 .Samples Alternatively the target browser can also be selected via the Scope menu in Visual Studio. 5. Axis and Channel – as well as for trigger and cursor can be made in the standard Property window of Visual Studio. provided that the Property window has already been opened first under View in Visual Studio. In this case only one axis is present.Samples The selected channels are assigned to the last-selected axis. Recording: Prior to a recording the basic recording settings must be made in the Scope Properties. Charts. 104 Version: 1. Standard is a tenminute recording which is started manually and automatically stopped after the respective time.2 TwinCAT 3 Scope View . A simple click on the corresponding element in the Solution Explorer is sufficient. The settings for all hierarchical levels – Scope. To this end the Scope toolbar must be opened when using for the first time. The recording is started by clicking on the icon with the red recording symbol.Samples If the standard settings are left as they are. the recording can be started. TwinCAT 3 Scope View Version: 1.2 105 . In Visual Studio > View Toolbars > TwinCAT Measurement. During the recording: In order to improve the display of the channels in the View.2 TwinCAT 3 Scope View . 106 Version: 1.Samples 6. charts and axes can be added even during the recording in TwinCAT 3 Scope View and channels can be shifted within the Scope. TwinCAT 3 Scope View Version: 1.2 107 .Samples X and Y cursors can also be added and deleted at runtime. Samples An important feature is the option to pause the display of the current recording while data logging continues in the background. 108 Version: 1. Alternatively the recording can of course be ended manually at any time via the stop button in the Scope toolbar. If the display is stopped. the user can take time to zoom into the data and analyse the signal curve with the cursor.2 TwinCAT 3 Scope View . 7. Stopping the recording and saving the data: In this case the started recording is stopped automatically on expiry of the recording time of ten minutes. Click on the Scope menu in Visual Studio and select Save Data. The recorded data are only consistent if they are stored as a .svd file. 2 109 .Samples TwinCAT 3 Scope View Version: 1. but a generic term for various products? ! Yes.Appendix 7 Appendix 7. The license model remains identical. The server can thus be controlled. Beyond that there are also different product levels.frequently asked questions and answers In this section frequently asked questions are answered in order to make your work with TwinCAT 3 Scope easier. If you have any further questions. to scope a remote device with the local Base Server. Details and examples can be found here. Is multimedia documentation available for TwinCAT 3 Scope? 8. What do you need a TF3300 Scope Server for. ? What do you need a TF3300 Scope Server for. ? Can the TwinCAT Scope View be integrated into its own visualization? ! Yes.2 TwinCAT 3 Scope View . Professional is very well suited for process monitoring in addition to machine commissioning. Why can't I open them? ? Is it true that "TC3 Scope" in the TwinCAT 3 world is not a product. ? Why are there different product levels for the TC3 Scope? ! The Scope is a constantly growing tool for data recording and analysis. however. Beyond that. are displayed and added to the printout. Can the TwinCAT Scope View be integrated into its own visualization? 6. The currently available product levels are Base and Professional. contact please our Support (. 110 Version: 1. not every Scope user requires the full range of functions for his purposes. Therefore we offer product levels tailored as far as possible to the application. It is also possible. Is it true that "TC3 Scope" in the TwinCAT 3 world is not a product.NET-based visualization application. Is it possible to print out recorded Scope Charts? 7. without a View being connected. fringe data shown by the cursor. ? Is it possible to print out recorded Scope Charts? ! The currently displayed chart can be printed out by inserting a report in a Scope project. Base is free of license costs and is an outstanding tool for machine commissioning. the Scope Control can be integrated into its own . for example. axis name or values. "TC3 Scope" is a generic term. Only the limitations of the Base Server version need to be observed. Can the Scope View Professional be operated with the Scope Server Base? What are the restrictions? 4. This means that a TC3 Scope always consists of the View and Server products. Why are there different product levels for the TC3 Scope? 3. To do this the “Use local server” option must be set in the channel settings. You can find out more here. such as channel name. ? Can the Scope View Professional be operated with the Scope Server Base? What are the restrictions? ! Yes.1 FAQ . My Scope . Professional View can also be operated with the Base Server.157) 1. The TC3 Scope is subdivided into the Scope View and Scope Server products. for example from the PLC. when you can also switch on the “Use local server” option? 5. but a generic term for various products? 2.svd files are on a network drive. when you can also switch on the “Use local server” option? ! The TwinCAT TF3300 Scope Server function is required as soon as a Scope Server has to run autonomously on a remote device. In order to be able to open .svd files are on a network drive.Appendix ? Is multimedia documentation available for TwinCAT 3 Scope? ! Yes. ? My Scope . there is a recording of a TwinCAT 3 Scope Webinar on the Beckhoff Homepage.svd files. Why can't I open them? ! That is probably because the TwinCAT 3 Scope server service has no rights of access to the network directory. TwinCAT 3 Scope View Version: 1. you either need to copy them to the local system or grant the Scope server service the appropriate rights [} 116].2 111 . the elements of which are assigned to a bar line or a bar. All connected channels are scaled to the same time segment. A Scope connects itself to a server in order to record new data or to read an existing file (.Appendix 7. The Scope View is the front end of the TwinCAT Scope. Version: 1.). The chart provides a graphic area with time axis. The chart provides a drawing area for a channel that is calculated from two variables.and Y-axes.2 TwinCAT Scope Glossary Term Scope Scope Server Scope View YT Chart Overview Chart XY Chart Array Bar Chart Axis Channel Data Picker Target Browser Solution Explorer Measurement Project Cursor Marks Trigger Quick View Chart 112 Description The Scope forms the highest hierarchical element in a Scope configuration and manages all recording settings. The chart provides the drawing interface for an array data type. Therefore. the other one on the Y-axis. They can be adjusted via the channel properties. there is one setting window for the acquisition and another one for the general settings (colors. The Quick View chart is available in the Target Browser. marks etc. Marks are the actual data points of recorded variables.2 TwinCAT 3 Scope View . among other things for the measurement projects. Various actions can be triggered with freely configurable trigger groups. It provides an overview of the whole recording period with absolute times. the display adjusted and recordings controlled. The cursor module serves to display graph and axis values and their differences. The measurement project can contain several Scope projects in which the actual recording configurations are created. A (Y-) axis represents the value scaling for connected channels. which are necessary for a Scope recording. An Overview chart can be displayed within a YT chart. This is a mouse pointer tool that is automatically activated in the chart when the cursor runs over a data point. It can be used to provide a quick overview of the current value status before the configuration is complete. One variable is shown on the X-axis. Clicking brings up a tool tip showing the values of the X. The channel forms the connection of system variable and graph. The Scope Server is the logger program of the TwinCAT Scope. The Solution Explorer is a kind of project manager.svd). From here configurations are created or loaded. the channel name and the absolute time for the selected data point. All connected systems and their devices can be simply scanned for system variables with the target browser. The desired oversampling factor should be set in the TwinCAT System Manager for the respective oversampling terminal before the configuration is activated. The assigned ADS port has to be specified later in the Scope in order to find the ADS symbols. the TwinCAT System Manager generates an ADS symbol containing a time stamp for each individual value. EL3702 or EL3632). If you connect to this ADS symbol with the Scope.Appendix 7. then the Scope performs all further settings in order to represent the n values in a chronologically correct order. some settings need to be made in the TwinCAT System Manager configuration: The Create Symbols option must be switched on and the ADS server must be activated on the ADS tab in the EtherCAT process image. So that the ADS symbol is created and can be directly scoped by an EtherCAT terminal (e.3. Since n values (n = oversampling factor) are recorded for each cycle when oversampling. TwinCAT 3 Scope View Version: 1.g.1 Oversampling recordings with the TwinCAT 3 Scope With the TwinCAT 3 Scope it is possible to represent oversampling values in a single variable.3 How To's 7.2 113 . 2 TwinCAT 3 Scope View . The ADS port number assigned by the TwinCAT System Manager must be entered in the appropriate dialog and added with the Add button. assuming that the port has not already been entered beforehand. The server settings must be called in the target browser of the Scope.Appendix If the configuration has been loaded successfully and TwinCAT is in Run mode. 114 Version: 1. you can switch to the TwinCAT 3 Scope. Appendix Now AdsPort of Image X (27905) should appear in the Scope’s target browser.2 115 . this number can vary according to the oversampling factor). Via this new entry you can browse to the EtherCAT terminals and thus to the desired oversampling terminal. the variable marked in red with the suffix [T20] should be selected for the scope recording (20 stands in this case for 20-fold oversampling. In the oversampling terminal. TwinCAT 3 Scope View Version: 1. svd files from a network directory If a . In the following screenshot 20-fold oversampling with a cycle time of 1ms.Appendix The INT16 variable can now be recorded directly in the TwinCAT Scope.3. 7.svd file from the network is to be merged into the solution. the following error message will probably appear if appropriate preparations are not made.2 Opening .2 TwinCAT 3 Scope View . 116 Version: 1. svd file within scope server."2014-04-28T07:26:59.Appendix An unknown Error occured.8442."2014-04-28T07:26:59.. please proceed as follows (using Windows 7 as an example): 1.2 117 .9720667Z"."Access to the path '\\remote-PC\SVDs\test.Error.Error.9720667Z".. In order to grant the TwinCAT Scope server the necessary rights. Both errors indicate that the TwinCAT 3 Scope server service has no rights of access to the network directory."16".368.svd file.  or "ScopeServerTraceSource". Enable and check scope server tracing...svd' is denied. Right-click on the directory to be shared -> Properties -> Sharing tab -> Share 2..".msc” -> TwinCAT3 Scope Server -> Log on -> TwinCAT 3 Scope View Version: 1.8442. The Read permission level is sufficient for the Scope server access and for the display of the . 3.3376.". One of the following entries will then usually be found in the server tracing log: "ScopeServerTraceSource". Enter the users who are to gain access to the directory." Could not find file '\\remote-PC\SVDs\test."16". Error handling ..svd '. Click on the Windows button + R -> “services. svd files from the configured network directory can be opened in the measurement project on this system. . 6.Appendix 4. After confirming. Pay attention if applicable to the correct use of your server domain. 5. Enter the account with which you have rights of access to the network directory. ð Subsequently.2 TwinCAT 3 Scope View . restart the service in order to accept the new user data. 118 Version: 1.