TwinCAT Scope

The TwinCAT Scope extension enables connection to a TwinCAT Scope Server. For this purpose, an existing Scope project (.tcscopex file) can be integrated into the TwinCAT HMI. The visualization in the client takes place in Scope Control. The configuration of the charts (e.g. linking with the PLC variables, configuration of the axes, etc.) is done in the Scope project itself.

Create a link to a Scope project

Install the TwinCAT HMI Scope extension (Beckhoff.TwinCAT.HMI.Scope) and the TwinCAT HMI Scope Control (Beckhoff.TwinCAT.HMI.ScopeControl) via the NuGet Package Manager.
TwinCAT Scope 1:

1. Open the TwinCAT HMI Configuration window. Click in the tree structure on the left side on the entry Scope Configurations.
TwinCAT Scope 2:

2. Right-click on the entry Scope Configurations and then on Import Scope Configuration... or double-click on the entry <Import Scope Configuration> in the TwinCAT HMI Configuration window.

3. Assign a unique name for the scope configuration in the Add Scope Config dialog. The Scope project is then listed under this name in the TwinCAT HMI Configuration window.
TwinCAT Scope 3:

4. In the next step, choose whether you want to add the scope project file (.tcscopex file) from the hard disk or from the Solution.

If the project file is located within the Solution, you can select it by clicking on Browse Solution. After selecting the project file, confirm the dialog by clicking on OK.
TwinCAT Scope 4:

If the project file is located outside the Solution on your hard disk, you can select it from your hard disk by clicking on "Browse Files".
You can add multiple Scope configurations to a project

5. After adding the Scope configuration, the charts contained there are displayed.
TwinCAT Scope 5:

If not all charts from your project are displayed, the corresponding chart type is not yet supported in the TwinCAT HMI Scope extension. A list of the supported chart types can be found at the end of this page.

6. Open an HMI page and drop an instance of the TwinCAT HMI Scope Control. This can be found in the Toolbox under the category Charts.
TwinCAT Scope 6:

7. Go to the Properties window to configure the control.

8. You can create a link between the Scope chart and the Scope control by linking the attribute "Scope Config". Here you have two options:

Select the chart below your Scope configuration by clicking on the "..." button next to the "Scope-Config" attribute:
TwinCAT Scope 7:

Alternatively, you can drag and drop the chart from the TwinCAT HMI Configuration window onto the "Scope-Config" attribute:
TwinCAT Scope 8:

You can now use the chart in the LiveView or in the Client.

Configure Scope Charts

The general configuration of the Scope charts (e.g. axes, colors, channels, data sources, etc.) is done in the Scope project. Instructions for this can be found in the Documentation of the TwinCAT Scope.

	After you have made a change in the Scope project, you must update an already existing Scope configuration in the TwinCAT HMI project.

1. To do this, right-click on the Scope configuration entry in the TwinCAT HMI Configuration window and select Refresh.
TwinCAT Scope 10:

The configuration has now been updated.
TwinCAT Scope 11:

Configure Scope Control

Further setting options are available in the TwinCAT HMI Scope Control. This can be found in the properties of the control under the category Common.

Scope Config: Selection of the chart that is displayed in the current control instance. For example, you can create multiple instances of the control to display different charts simultaneously. Alternatively, you can switch the configuration at runtime within the control instance.
EnableRecordControls: Specifies whether the start and stop record buttons are displayed in the Scope control.
Server Interval: Interval at which the data between the control and the extension is updated.
ChartColorSource: Specifies whether the colors of the chart are taken from the Scope project, or whether they are set via the ThemedResources in a TwinCAT HMI Theme.
Server Domain: Name of the Scope extension that provides the Scope configuration. This attribute usually does not have to be changed.

Using the Scope Control in the Client

After you have completed the configuration, you can use the Scope in the client. The familiar TwinCAT Scope functionalities are available for analysis.

Sample

An example of the use of the Scope in TwinCAT HMI can be found here.

	For using the TwinCAT HMI Scope extension a TC3 Scope View Professional (TE1300) license or a TC3 HMI Scope (TF2300) license is required on the system where the TwinCAT HMI Server is running. This also applies to the engineering system (trial licenses are sufficient).

	Available from version 1.12.748.0.

	With version 1.12.748.0 the following chart types are supported: YT-Chart, XY-Chart, Single Bar Chart and Array Bar Chart.