Unity SFC View
Unity SFC View
Version 2.0
User's manual
June 2004
33003015.00
2
Table of Contents
Chapter 3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Installation sequence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Installation and registration of Unity Pro and OFS . . . . . . . . . . . . . . . . . . . . . . . 28
Installing SCF View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Installation of the SFC View Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Registration with Schneider Electric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Implementation of the SFC View ActiveX Controls . . . . . . . . . . . . . . . . . . . . . . . 32
3
Chapter 6 SFCView appearance and behavior . . . . . . . . . . . . . . . . . . . . . 43
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.1 General controlling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
General description of the control elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Objects for general controlling of SFCView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Properties for general controlling of SFCView . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Methods for general controlling of SFCView . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Events for general controlling of SFCView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Constants for general controlling of SFCView . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
6.2 View: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
General description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Properties for controlling the view: Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Events for controlling the view: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Constants for controlling the view: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
6.3 View: Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
General description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Properties for controlling the view: Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Methods for controlling the view: Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Events for controlling the view: Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Constants for controlling the view: Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
6.4 View: Details Simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
General description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Properties for controlling the view: Details Simple . . . . . . . . . . . . . . . . . . . . . . . . 78
Methods for controlling the view: Details Simple . . . . . . . . . . . . . . . . . . . . . . . . . 81
Events for controlling the view: Details Simple . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Chapter 8 Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
OFSDevice Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
OFSDevices Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
OFSInfo Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
SFC View Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
4
Chapter 9 Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
9.1 ChainXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
ChainName Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
ChainControlVariableName Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
ChainFlagsOffBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
ChainFlagsOffForeColor Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
ChainFlagsOnBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
ChainFlagsOnForeColor Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
9.2 ColumnHdrActionXxx Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
ColumnHdrActionComment Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
ColumnHdrActionName Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
ColumnHdrActionQualifier Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
ColumnHdrActionTime Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
ColumnHdrActionType Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
9.3 ColumnHdrChainXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
ColumnHdrChainComment Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
ColumnHdrChainName Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
ColumnHdrChainStatus Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
9.4 ChainHdrErrorXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
ColumnHdrErrorComment Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
ColumnHdrErrorStep Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
ColumnHdrErrorVariable Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
ColumnHdrErrorPinType Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
ColumnHdrErrorState Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
9.5 ColumnHdrStepXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
ColumnHdrParallelSteps Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
ColumnHdrStepComment Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
ColumnHdrStepName Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
9.6 DetailsXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
DetailsActiveStepBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
DetailsInactiveStepBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
DetailsInitialStepBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
DetailsWaitingStepBackColor Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
DetailsViewLinesColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
5
9.7 DetailsSimpleXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
DetailsSimpleShowChainName Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
DetailsSimpleShowChainStatus Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
DetailsSimpleShowChainComment Property . . . . . . . . . . . . . . . . . . . . . . . . . . 119
DetailsSimpleShowStepErrorLabel Property . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
DetailsSimpleShowStepComment Property . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
DetailsSimpleShowInitStepIndicator Property . . . . . . . . . . . . . . . . . . . . . . . . . . 122
DetailsSimpleShowNavigation Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
DetailsSimpleStepNameFont Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
9.8 DetailsStepXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
DetailsStepNameFont Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
DetailsStepsLeft Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
DetailsStepsWidth Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
9.9 DetailsTextXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
DetailsTextDisableActions Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
DetailsTextDisableTimeCheck Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
DetailsTextDisableTransitions Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
DetailsTextSectionDisabled Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
DetailsTextSetResetFlag Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
9.10 DiagXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
DiagAutoRetrigger Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
DiagAutoRetriggerInterval Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
9.11 OPCXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
OPCNetworkServer Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
OPCAccessPath Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
OPCConnect Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
OPCUpdateRate Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
9.12 OverviewTextXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
OverviewTextDisableActions Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
OverviewTextDisableTimeCheck Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
OverviewTextDisableTransitions Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
OverviewTextRunning Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
OverviewTextSectionDisabled Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
OverviewTextSetResetFlag Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
6
9.13 ShowXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
ShowActiveStep Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
ShowAllDiagErrors Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
ShowAllTransitionsInput Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
ShowChainGroups Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
ShowStatistics Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
ShowStepComments Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
ShowTimeInms Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
ShowBlockNames Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
9.14 StepMaxTimeErrXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
StepMaxTimeErrBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
StepMaxTimeErrForeColor Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
StepMaxTimeErrText Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
9.15 StepMinTimeErrXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
StepMinTimeErrBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
StepMinTimeErrForeColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
StepMinTimeErrText Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
9.16 UseXxx Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
UseOPCProject Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
UsePLCDiagSystem Property (Unity Pro). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
UsePLCDiagSystem Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
UseEasyModeSwitch Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
9.17 ValueXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
ValueOffBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
ValueOffForeColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
ValueOnBackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
ValueOnForeColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
9.18 WidthActionXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
WidthActionQualifierColumn Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
WidthActionTimeColumn Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
WidthActionVariableColumn Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
WidthActionCommentColumn Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
9.19 WidthErrorXxx Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
WidthErrorStepNameColumn Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
WidthErrorVariableColumn Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
WidthErrorPinTypeColumn Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
WidthErrorStateColumn Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
WidthErrorCommentColumn Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
7
9.20 Other Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Alias Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
AutomaticProjectReload Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
BackColor Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Count Property. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
ContentErrorStateColumn Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
EnableOPCUpdates Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Font Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Item Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
MaxChannel Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
NumberErrorGridLines Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
OFSDevices Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
OnChainOpen Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Path Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
ProjectFile Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Refresh Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
StateErrorStateColumn Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Symb Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
UnityNetworkServer Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
ViewMode Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
8
10.3 PLCXxx Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
PLCClearChain Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
PLCDisableActions Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
PLCDisableSection Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
PLCDisableTimeCheck Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
PLCDisableTransitions Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
PLCGotoNextStep Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
PLCResetTimeErrors Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
PLCSetInitializeFlag Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
10.4 Other Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
At a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
About Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
GetOFSInfo Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
ReloadProject Method. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
9
Part III SFCView block library . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Chapter 17 SFCVIEW_CTRL:
Step chain control via SFCView . . . . . . . . . . . . . . . . . . . . . . . 237
Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
10
About the Book
At a Glance
Validity Note This document applies to Unity SFC View 2.0 with Unity Pro 2.0,
OPC Factory Server 3.1, Microsoft Windows 2000 or Microsoft Windows XP
Professional.
Product Related The data and illustrations found in this document are not binding. We reserve the
Warnings right to modify our products in line with our policy of continuous product
development. The information in this document is subject to change without notice
and should not be construed as a warranty by Schneider Electric.
Schneider Electric assumes no responsibility for any errors that may appear in this
document. If you have any suggestions for improvements or amendments or have
found errors in this publication, please notify us.
No part of this document may be reproduced in any form or by any means, electronic
or mechanical, including photocopying, without express written permission of
Schneider Electric.
All pertinent state, regional, and local safety regulations must be observed when
installing and using this product. For reasons of safety and to ensure compliance
with documented system data, only the manufacturer should perform repairs to
components.
When controllers are used for applications with technical safety requirements,
please follow the relevant instructions.
Failure to use Schneider Electric software or approved software with our hardware
products may result in injury, harm, or improper operating results.
Failure to observe this product related warning can result in injury or equipment
damage.
User Comments We welcome your comments about this document. You can reach us by e-mail at
[email protected]
11
About the Book
12
Unity SFC View
I
At a Glance
Overview This section contains information on the Unity SFCView software package,
henceforth referred to as SFCView .
13
Unity SFC View
14
General description
1
General description
Target group for The documentation is targeted towards configuration specialists who want to
documentation integrate SFC View in an HMI application and towards users of such HMI
applications.
Brief description Unity SFCView is made up of an ActiveX control and its SFCView function block
library for Unity Pro.
The ActiveX control is configured on an operating station (HMI) and can then make
real-time information available regarding the state of the sections in the controller.
It can:
l Display sections
l show the state of sections
l show the section diagnosis information
l navigate through sections
l control sections online
l automatically recognize changes in project data
Note: Several instances for a control can also be configured on one operating
station. This makes it possible to access several chains at one time.
15
General description
Programming The programming environment is a HMI application that supports ActiveX container.
environment
SFC View Demo- A sample program written in Visual Basic is installed along with SFC View.
Application This SFC View demo application is a standalone program that can also be
executed without Visual Basic.
Nearly all the properties, methods and events for SFC View were configured in this
program and can be tested in conjunction with Unity Pro, the OPC Factory Server
(OFS), and the Unity Pro PLC Simulator.
The user can experiment with this demo application and learn how SFC View is used
and programmed.
(See Starting and Using the SFC View Demo Application, p. 37).
16
Requirements and restrictions
2
Introduction
Overview This chapter contains information on requirements and restrictions which should be
noted when using Unity SFC View.
17
Requirements and restrictions
System requirements
Unity Pro Unity Pro V2.0 must be installed at least once on the system.
Version
SFC View Library The SFC View library must be installed (update type library).
OPC Factory An OPC Factory Server (OFS) Version 3.1 must be installed on the system.
Server
ActiveX The programming environment is a HMI application that supports ActiveX container.
Container
HMI Application HMI applications tested for Unity SFC View are:
l Monitor Pro 7.2, Schneider Electric
l Vijeo Look 2.5, Schneider Electric
l iFix 3.0, GE Fanuc
l InTouch 7.2, Woderware
Other applications tested are:
l Internet Explorer 6.0, Microsoft
l Visual Basic 6.0, Microsoft
PLCs supported The following PLCs programmed with Unity Pro are supported:
l Quantum
l Premium
l Atrium
System Architecture
General Mode SFC View reads the structure of the sections and other data from the Unity Pro
of Operation project (*.stu). For this Unity Pro must be installed.
Via the OPC Factory Server (OFS), SFC View reads the online data from the SFC
(sections status, variable status, diagnosis buffer etc.).
SFC View recognizes project changes in the PLC and automatically updates the
display.
18
Requirements and restrictions
This guarantees that the sections display in the HMI application and the PLC
program always remain consistent.
Function blocks from the SFC View library must be used for a particular diagnosis
mode and for online controlling when configuring Unity Pro.
Apart from this no other programming needs to be carried out in the PLC.
System SFC View can be used in simple and in distributed system configurations.
configuration
1
3
1 Operating station
2 PLCs
3 Communication
Operating station (1)
The following components must be on the operating station:
l HMI Application
l Unity Pro program
l Unity Pro projects
l OPC Factory Server (OFS) as a server installation
l SFC View
PLCs (2)
The Unity Pro projects run on the PLCs with the sections to be visualized.
Communication (3)
The communication between the operating station and the PLCs can be carried out
via the following buses, as long as these are supported by the relevant PLCs:
l Modbus
l Modbus Plus
l Modbus TCP-IP
l Uni-Telway
19
Requirements and restrictions
1 2
OFS-Server Unity-Server
3 4
7
5
1 Operating stations
2 additional PCs
3 OPC Factory Server
4 Unity Server
5 PLCs
6 Communication via Modbus TCP-IP
7 Communication via various busses e.g. Modbus Plus
Note: The Unity Pro program must be installed once and only once on the entire
system.
20
Requirements and restrictions
PLCs (5)
The Unity Pro projects run on the PLCs with the sections to be visualized.
Communication via Modbus TCP-IP (6)
The communication between the operating station and the PCs is carried out via the
Modbus TCP-IP (DCOM).
Communication via various buses (7)
The communication between the OFS server and the PLCs can be carried out via
the following buses, as long as they are supported by the relevant PLCs:
l Modbus
l Modbus Plus
l Modbus TCP-IP
l Uni-Telway
User requirements
Programming The programming environment is a HMI application that supports ActiveX container.
environment
Configuring In order to be able to configure SFC View in a HMI application the user should have
SFC View a basic understanding of the following areas:
l SFC programming in Unity Pro
l OFS parameterization
l Embedding ActiveX controls in HMI applications
Programming The SFC View software package has a programming interface that makes it
interface possible to set up SFC View in such a way that that the workflow and display is
appropriate for a HMI application.
SFC View Demo- A sample program written in Visual Basic is installed along with SFC View.
Application This SFC View demo application is a standalone program that can also be
executed without Visual Basic.
Nearly all the properties, methods and events for SFC View were configured in this
program and can be tested in conjunction with Unity Pro, the OPC Factory Server
(OFS), and the Unity Pro PLC Simulator.
The user can experiment with this demo application and learn how SFC View is used
and programmed.
(See Starting and Using the SFC View Demo Application, p. 37).
21
Requirements and restrictions
General In order to be able to control sections from SFCView online, certain prerequisites
must be fulfilled in the appropriate Unity Pro project.
Function Block Online control is carried out using a special SFCVIEW_CTRLfunction block in the
SFCVIEW_CTRL appropriate Unity Pro project.
For this reason for every Unity Pro project a function block of this type
SFCVIEW_CTRL must be configured.
Note: Function blocks from the SFCView library may only be used in FBD sections
in the Unity Pro projects.
SFC View Library The SFCVIEW_CTRLfunction block is available for use after the SFCView library
has been installed. See Installation of the SFC View Library, p. 30).
A description of the SFCView function blocks can be found in the SFCView block
library, p. 221 chapter.
SFC View Library For the SFCView function block diagnostics, the SFCView library must be installed.
(See Installation of the SFC View Library, p. 30).
A description of the SFCView function blocks can be found in the SFCView block
library, p. 221 chapter.
22
Requirements and restrictions
Settings in To use the diagnostics in Unity Pro, certain settings must be made. (See Unity Pro
Unity Pro presettings, p. 34).
Control The diagnostic mode is controlled via the control property UsePLCDiagSystem:
diagnostic mode
Property Diagnostics via the SPS Diagnostics via the SFCView
UsePLCDiagSystem diagnostics buffer function blocks
True X -
False - X
Diagnostics If the UsePLCDiagSystem property is set to True the control reads the diagnosis
via the PLC information from the PLC diagnostic buffer.
diagnostics
buffer
Diagnostics If the property UsePLCDiagSystem is set to False , the diagnosis is done via
via the SFCView special SFC View function blocks in the respective Unity Pro project.
function blocks For this reason, for every transition in the Unity Pro project, a SFC View function
block of this type must be configured and its output variable used as a transition
variable.
The following SFC View function blocks are available for use after the SFCView
library has been installed:
l AND_16
l OR_16
l AND_OR_8
Variables or a logic can be used as inputs for these function blocks. All inputs and
the nested logic for these function blocks are analyzed by SFCView.
Every connection for an SFCView function block which is not an AND_BOOL or
OR_BOOLfunction block is displayed in SFCView as an unknown connection (see
EQ_INT function block graphic).
Inputs for SFCView function blocks which are not occupied will be ignored.
23
Requirements and restrictions
Representation in SFCView
SFC_para
Section Disabled Reset Flag Set Time Check Disabled Transitions Disabled Actions Disabled
0 (1)
TV5
Swich ShowBlockNames option to
hide\show EFBís names.
Note: SFCView function blocks may only be used in FBD sections in the Unity Pro
projects, since SFCView only looks for them there.
24
Requirements and restrictions
Differences The user should decide which diagnosis mode he wants to use for each section.
between the Only one diagnosis mode should be used for each section.
diagnostic The following table can be used to make decisions.
modes
Diagnostics via the SPS diagnostics buffer Diagnostics via the SFCView function
blocks
A transition logic must be configured in a The transition logic must be configured using
transition section. SFCView function blocks.
Only erroneous signals will be shown: All its signals will be shown:
Errors will only be shown after the maximum Transition logic and diagnosis results are
supervision time has been exceeded, i.e. a always shown
maximum supervision time must be
configured.
The diagnostics information can also be read The diagnostics information can only be read
by other tools. by SFCView.
No more programming is required The SFCView function blocks must be
configured in an FBD section of their own.
Restrictions
Macro steps Macro sections are symbolically views in SFCView (double line above and below).
The lower steps in macro steps are not shown in SFCView.
Action section For action sections in SFCView (in the details view) only the following is shown:
l Section name
l Type (S = Action Section)
The logic contained in the action section is notshown in the SFCView.
25
Requirements and restrictions
26
Installation
3
Introduction
Overview This chapter contains information on installations that are required to use
Unity SFC View.
27
Installation
Installation sequence
Prescribed Adhere to the following installation sequence to make sure that SFC View is
sequence operating without any errors:
1. Unity Pro 2.0
2. OPC Factory Server (OFS) 3.1
3. SFC View 2.0
4. SFC View Library
5. HMI software
Software Make sure that only software versions are installed which are guaranteed to work
versions together perfectly . For information on this see the readme.txt file.
Installation Install Unity Pro and the OPC (OFS) as described in their respective manuals.
Registration Register Unity Pro and the OPC (OFS) as described in their respective manuals.
28
Installation
Changing and For the installation described here you can change options already selected by
canceling clicking on Back or cancel the installation by clicking on Cancel.
Installation The installation directories for the software are preset as defaults. However they can
directories be changed.
If this is necessary, click Find...to select a different installation directory.
Installing SFC The step-by-step instructions for installing the SFCView software are described
View here.
Step Action
1 Insert the CD-ROM.
2 Execute the Setup.exe file.
3 Select the language for the installation wizard and confirm the SFCView
installation by clicking on OK.
4 Confirm the start screen by clicking onNext.
5 Read the licensing conditions and accept them by clicking on Yes.
6 Check the configuration and then confirm it with Next.
7 Enter your name, the name of your company and the serial number and then
confirm by clicking on Next.
8 Select the directory into which the program should be installed using Find and
confirm usingNext.
9 Select a program folder and confirm it using Next..
10 Check the current settings confirm them finally by clicking on Next.
11 Exit the installation by clicking on Finishto return to Windows.
Note: If you have selected the option Install the SFC View library in Unity the
installation program necessary for this starts automatically.
29
Installation
General To use the SFC View function block diagnosis, the SFC View library must be
installed.
Automatic start The program Types Library Update starts either automatically at the end of the
installation of SFC View or it can be started as described below.
Execute update These instructions describe the steps that must be carried out to install the
SFC View library using the tool Type library update .
Step Action
1 Start the program via: Start → Programs → Schneider Electric → Unity Pro
→ Types Library Update
2 Select the family.dsc file. The file is on the CD in ...\Unity SFCView
Lib\family.dsc
3 Start the installation via Install family.
4 Click on the Exitbutton.
Permanent To be able to use the software on a permanent basis, it must be registered with
usage Schneider Electric.
The software must be registered within 21 days after installation.
30
Installation
Registering SFC These instructions give the individual steps for registering SFC View.
View
Start the SFC View or the registration tool
Yes Select
Do you have the Enter the code you
release code? received and confirm with
Next
No
Fill in the required fields, enter the serial Fill in the required fields, enter the serial
number and purchase reference (*) and number and purchase reference on the CD-
confirm by clicking on Next. ROM case and confirm with Register.
Enter the release code and confirm with Exit using Finish
Next
(*) These numbers are on the label stuck to the inside of the software CD-ROMs
case.
31
Installation
Registration The SFC View ActiveX control is automatically registered on the PC when SFC
on the PC View is installed.
This makes it available for the individual programming environments.
32
Preliminary Settings
4
Introduction
Overview This chapter contains information on the preliminary setting that are required to use
Unity SFC View.
33
Preliminary Settings
General Before the SFC View can be used, Unity Pro must be configured in a certain way.
Note: These settings must be configured separately for every Unity Pro project.
Diagnostics Make sure that under Tools → Project settings... → Build → Diagnostics the
option Application Diagnostics is selected and the application level is set to Local
Diagnostics.
Note: This setting is required if the SFC View diagnostics is carried out via the PLC
diagnostics buffer.
Sequential Make sure that under Tools → Project settings... → Language extension the
Function Chart Allow multiple token option is not selected.
(SFC)
Save project Make sure that under Tools → Options → General → Save project automatically
automatically the option On Download is selected.
General Before the SFC View can be used, certain settings must be made in the OFS
configuration tool.
Starting OFS Execute the command Start → Program → Schneider Electric → OFS → OFS
configuration configuration tool.
tool
Options In the tab Options under Features the following option must be selected:
l Enable OPC Extensions
Note: In case the tab Options is not displayed, via the command button
Advanced... all tabs can be shown.
34
Preliminary Settings
Comm. settings In the Comm. tab in Options for devices without alias the following option must
be selected:
l Check Consistency
Note: If the Comm. tab is not shown, all of the tabs can be shown via the
Advanced... tab.
Create alias An alias is required to ensure that SFC View and OFS can work together. The
following table describes the procedure to create a new alias.
Step Action
1 Click the Alias tab.
2
Click the (Create new alias) button.
Loading the The following table describes the procedure to load a project.
project
Step Action
1 Launch Unity Pro.
2 Open the desired *.STU file via File → Open.
3 Via PLC → Connect... create a connection to the PLC or PLC simulator controller.
4 Via PLC → Transfer Project to PLC load the program into the PLC or PLC
simulator controller.
Note: If you select the option PLC RUN after transfer , the PLC starts automatically
after the program is transferred.
35
Preliminary Settings
Test the The following table describes the procedure for testing the connection between the
connection OFS and the PLC.
between the
Step Action
OFS and the PLC
1 Start the OFS client via Start → Programs → Schneider Electric → OFS → OFS
Test Client.
Note: The OFS Client program is only available if the appropriate option was
selected for the OFS installation.
2 Click on Schneider Aut.OFS as server and confirm using OK. The diagnosis
window for the OPC factory server is opened in the foreground.
3 Put the OFS Client window in the foreground again and create a new group via
Group → New Group... and give it the name: e.g. GRP1.
4 Under Notification activate all the options and select the following settings:
l Update rate: 1000 ms
l Dead banding: 0.000000 [0.0,1.0]
l OPC version: Auto
Confirm with OK.
5 Via Item → New... open the AddItemwindow.
6 In the tree structure in the left window select the desired project. The project
variables are shown in the right hand window.
7 Click on one of the variables and confirm with OK.
8 If a green symbol appears to the left of the variable in the properties window which
now appears, the connection between the OFS and the PLC is intact.
Diagnosis Errors which might appear are shown in red in the OPC Factory Server diagnosis
window for window.
the OFS
Diagnosis The installation of a HMI application (e.g. Vijeo Look) can make it so that the
window not diagnosis window of the OPC Factory Server is not visible in the foreground and is
visible displayed only as an icon in the footer line of the screen.
If this is the case, run the program ChangeOFSSettings.exe . This program is
saved by default during the installation of SFC View under ...Installation
directory of the SFCView...\ .
So that the change is effective, you must restart, via Start → Programs →
Schneider Electric → OFS , the OPC Factory Server .
36
Starting and Using the
SFC View Demo Application
5
Starting and using the SFC View Demo Application
General When installing SFC View, a SFC View Demo Application and the corresponding
source code (in Visual Basic) are installed.
The SFC View Demo Application is an independent program that can also be
executed without HMI, SPS and Visual Basic.
Nearly all the properties, methods and events for SFC View were configured in this
program, are available using menus, and can be tested in conjunction with Unity
Pro, the OPC Factory Server (OFS), and the Unity Pro PLC Simulator.
The user can experiment with this demo application and learn how SFC View is used
and programmed.
Source code If the user's development environment is Visual Basic 6.0, the source code for the
demo application can be viewed in it.
If a different development environment is used, the Visual Basic source code can be
viewed in any editor.
The Visual Basic files can be found in the default directory: ...installation
directory for SFCView...\SFCView\Example.
Preliminary The demo application only works properly when all the Preliminary Settings,
Settings p. 33are correct.
Saving the Unity The Unity Pro test project that belongs to the demo application is saved during the
Pro test project installation of SFC View as an *.XEF-file by default under ...Installation
directory of the SFCView...\TESTSFC.
37
Starting and Using the SFC View Demo Application
Converting The following table describes the procedure for converting the Unity Pro test project.
the Unity Pro
Step Action
test project
1 Launch Unity Pro.
2 Open the TESTSFCV.XEF file via File → Open.
3 Generate the project via Build → Rebuild All Project.
4 Save the project via File → Save using the name TESTSFCV.STU.
Loading the The following table describes the procedure for loading the Unity Pro test project into
Unity Pro test the PLC simulator.
project in the
Step Action
PLC simulator
1 Launch Unity Pro.
2 Open the TESTSFCV.STU file via File → Open.
3 Via PLC → Connect... create a connection to the PLC simulator controller.
4 Via PLC → Transfer Project to PLC load the program into the PLC simulator
controller.
Note: If you select the PLC RUN after sending option, the PLC starts
automatically after the program is sent.
OFS Before the SFC View can be used, certain settings must be made in the OFS
configuration configuration tool.
tool Execute the command Start → Programs → Schneider Electric → OFS → OFS
Configuration Tool .
Comm. settings In the Comm. tab in Options for device without alias the following option must be
selected:
l Check Consistency
Note: If the Comm. tab is not shown, all of the tabs can be shown via the
Advanced... tab.
38
Starting and Using the SFC View Demo Application
Create Alias for An alias is required to ensure that SFC View and OFS can work together. The
demo application following table describes the procedure to create an alias for the demo application.
Step Action
1 Click the Alias tab.
2
Click the (Create new alias) button.
39
Starting and Using the SFC View Demo Application
Test the The following table describes the procedure for testing the connection between the
connection OFS and the PLC.
between the
Step Action
OFS and the PLC
1 Start the OFS client via Start → Programs → Schneider Electric → OFS →
OFS Test Client.
Note: The program OFS Client is only available if the appropriate option was
selected for the OFS installation.
2 Click on Schneider Aut.OFS as server and confirm using OK.
3 Create a new group via Group → New Group... and give it the name: e.g.
GRP1.
4 Under Notification activate all the options and select the following settings:
l Update rate: 1000 ms
l Dead banding: 0.000000 [0.0,1.0]
l OPC version: Auto
Confirm with OK.
5 Via Item → New... open the AddItemwindow.
6 In the tree structure in the left window of the project select TestSFCV. The
project variables are shown in the right hand window.
7 Click on a variable e.g. ACT1 and confirm with OK.
8 If a green symbol appears to the left of the variable in the properties window
which now appears, the connection between the OFS and the PLC is intact.
Diagnosis Errors which might appear are shown in red in the OPC Factory Server diagnosis
window for window.
the OFS
40
Starting and Using the SFC View Demo Application
Starting the The following table describes the procedure for starting the demo application.
demo application
Step Action
1 Execute the command Start → Programs → Schneider Electric →
Unity SFC View → SFC View Demo Application .
2
Using the button select the project TestSFCV so that it can be opened,
and confirm it using OK.
3 The project data are loaded from the Unity Pro project.
4
Start the demo application via the demo application button .
5 Select the appropriate view via one of the following command buttons:
l Overview
l Details
l DetailsSimple
Using the Use the items View and Run in the main menu to activate and deactivate the
demo application individual properties, methods and events in SFC View and to observe the changes
to the individual views.
41
Starting and Using the SFC View Demo Application
42
SFCView appearance
and behavior
6
Introduction
Overview This chapter contains information on how to control the appearance and behavior of
SFCView.
Further information on the control elements object, method, event, and constant can
be found in theFunctional Reference, p. 87 chapter.
43
SFCView appearance and behavior
44
SFCView appearance and behavior
Introduction
Overview This chapter contains information on the general control of the appearance and
behavior of SFCView.
Controlling is carried out using objects, properties, methods, events and constants.
All general controlling options are described in the following chapter.
All controlling options assigned to a particular view will be described in the
appropriate chapter.
45
SFCView appearance and behavior
General The appearance and behavior of the SFCView can be controlled using objects,
properties, methods, events, and constants.
Object An object, as used in object-oriented programming, is any data structure which has
its own code.
An object could be a button that "knows" how it is pressed and what then happens.
Property Properties are data that are assigned to an object. Properties are used to make
information and settings available to an object.
Height and width, for example, can be properties of an info window.
Methods A method is a subprogram that returns or does not return a value. In traditional
programming a method is called a "procedure" or "function". In object oriented
programming a method is assigned to a specific object and ensures access to the
object data.
For example, a window for displaying error messages may have a method which is
triggered by an error string. This opens the window and the error is shown.
Event Events are triggered using input devices or when states or value change. E.g.
events can be triggered by a mouse click or a signal from a timer.
In object oriented programming, events are used for communicating between
objects, e.g. between a control and its container.
Constants A constant is a parameter that cannot be changed. The value of a constant does not
change while a program is running.
Constants can be used to define the value for a property. E.g. In a program for
recording operating data, the number of manhours per shift might be defined. If this
value is changed later it only needs to be changed in one place.
46
SFCView appearance and behavior
SFCView
GetOFSInfo
OFSInfo
OFSDevices
OFSDevices
Item OFSDevice
47
SFCView appearance and behavior
Project data The following properties are available for loading project data.
Property Description
ProjectFile Sets the project file inlc. the project path.
AutomaticProjectReload When this is set, the project data is automatically reloaded
when changes are made in the PLC.
UnityNetworkServer For a distributed configuration, this sets the PC where the
Unity Pro-Program is located (PC name and IP address).
OFS The following properties are available for communicating with the OPC Factory
communication Server (OFS):
Property Description
UseOPCProject Specifies that the project file is automatically determined
from the OFS path ( OPCAccessPath).
Alternatively the ProjectFile property can also be used.
EnableOPCUpdates Specifies that changes in the PLC are reported from the
OPC Factory Server to SFCView.
OPCNetworkServer For a distributed configuration, this sets the PC where the
OPC Factory Server is located (PC name and IP address).
OPCAccessPath Sets the path for the OFS alias. The alias is defined in the
OFS configuration tool ( OPC Factory Server Presettings,
p. 34).
OPCConnect Creates the connection between the OPC factory server and
the SFC View.
OPCUpdateRate Sets the time delay for the OPC Factory Server to read data
from the PLC [in msec].
48
SFCView appearance and behavior
OFS information You can access the OFS information via the following properties
Property Description
OPCNode For a distributed configuration this sets the PC where the
OPC Factory Server is located (PC name and IP address).
OFSDevices Makes information regarding the OFS device collection
available.
Device collection Properties on the device collection defined in the OFS configuration tool
properties
Property Description
count Is the number of devices in the OFS device collection.
Item Is the index of a device in the OFS device collection.
Device Properties for the devices defined in the OFS configuration tool
properties
Property Description
Symb Is the name and path of a file with file ending information
(e.g. *STU).
Alias Is the alias name for a device in the OFS device collection.
MaxChannel Is the maximum number of channels in a device.
Path Is the device address.
Width The following property specifies the width of the SFCView control.
Property Description
Width Specifies the width of the control
49
SFCView appearance and behavior
Background The following property specifies the background color of the SFCView control.
color
Property Description
BackColor Background color in the views
l Details and
l Details Simple
50
SFCView appearance and behavior
Controlling The following methods are available for controlling the PLC:
the PLC
Methods Description
PLCDisableActions Activates/deactivates the actions for the selected string
step.
PLCDisableSection Activates/deactivates the selected string step.
PLCDisableTimeCheck Activates/deactivates the time monitoring for the selected
section.
PLCDisableTransitions Activates/deactivates the transitions for the selected
section.
PLCGotoNextStep Activates the next step. It can be predefined as to whether
the next transition must be carried out or not
(unconditional false/true).
PLCResetTimeErrors Resets the supervision time for the section.
PLCSetInitializeFlag Sets the initialize flag or releases it.
PLCClearChain Resets all active steps in the chain.
DANGER
Danger of unsafe, dangerous and destructive processes.
The "Initialize chain", "Reset chain", "Cancel analysis of transitions",
"Cancel editing of actions and reset all actions of the chain", "Activate
the next step independently of the transition condition" and "Activate the
next step depending on the transition condition " functions should not
be used to search for controller errors in machine tools, processes or
material management systems, if they are running.
Failure to follow this precaution will result in death, serious injury,
or equipment damage.
51
SFCView appearance and behavior
52
SFCView appearance and behavior
ChainStatus- The ChainStatusChanged (Change in state of the chain, p. 52) event can be
Flagsconstants made up of one or more ChainStatusFlagsconstants.
Constants Value Description
CsfRunning 0 The chain is activated.
CsfSectionDisabled 1 The chain is deactivated.
CsfInitializeFlagSet 2 The chain initialize flag is set.
CsfTimeCheckDisabled 4 Time monitoring is deactivated.
CsfTransitionDisabled 8 The transitions are deactivated.
CsfActionsDisabled 16 The actions are deactivated.
CsfUnknown 4096 The chain state is unknown.
53
SFCView appearance and behavior
Introduction
Overview This chapter contains general information about the view: Overview, that displays
the SFCView.
54
SFCView appearance and behavior
General description
Brief description The view: Overview, the SFCView offers the following options:
l Selecting a Unity Pro project
l Navigate through the project via the function view
l Listing all chains of a Unity Pro project
l Display of real-time information on the status of the step chains
l Selecting one or more step chains of the project
l Switching to a different view (Details or Details Simple) for a step chain
Station Chain Name Step Name Parallel Chain Sta- Step Comment
SFC_para S_3_5 1 Running Step sets ACT5.ACT5 is mapped to I/O but not read by any logi
SFCDiag SFC_seq S_4_1 1 Running Step sets ACT13.ACT13 is mapped to I/O but not read by any lo
PLCDiag
55
SFCView appearance and behavior
Controlling the To control the behavior and the appearance of the SFCView, the person carrying out
controls the configuration has various methods, events, constants and properties available
for use.
All the controlling options which are assigned to the Overview display are described
in the following chapter.
All general controlling options are described in their own chapter General controlling,
p. 45 .
56
SFCView appearance and behavior
Step chain view The OnChainOpen property specifies the view that is shown when opening a step
chain.
Property Description
OnChainOpen Specifies the behavior when opening a step chain.
The behavior is set using constants.
(OnChainOpen constants , p. 59).
l 0 = NoAction
l 1 = ShowDetails
l 2 = ShowDetailsSimple
Note: The SFCView texts are stored in English by default but can be changed by
the person carrying out the configuration.
57
SFCView appearance and behavior
ChainStatus Tests in the ChainStatuscolumn. These texts are also shown in the: Details
column contents Simple view.
Property Description
OverviewTextRunning Specifies the text in the ChainStatus column if
the chain status flag is set to CsfRunning.
OverviewTextSectionDisabled Specifies the text in the ChainStatus column if
the chain status flag is set to
CsfSectionDisabled.
OverviewTextSetInitializeFlag Specifies the text in the ChainStatus column if
the chain status flag is set to
CsfInitializeFlagSet.
OverviewTextDisableTimeCheck Specifies the text in the ChainStatus column if
the chain status flag is set to
CsfTimeCheckDisabled.
OverviewTextDisableTransitions Specifies the text in the ChainStatus column if
the chain status flag is set to
CsfTransitionDisabled.
OverviewTextDisableActions Specifies the text in the ChainStatus column if
the chain status flag is set to
CsfActionsDisabled.
Note: The SFCView texts are stored in English by default but can be changed by
the person carrying out the configuration.
58
SFCView appearance and behavior
OnChainOpen- The OnChainOpen (Step chain view, p. 57) property is set using the following
constants constants:
Constants Value Description
NoAction 0 The input is ignored.
ShowDetails 1 The step string is shown in the details overview.
ShowDetailSimple 2 The step string is shown in the details simple
overview.
59
SFCView appearance and behavior
Introduction
Overview This chapter contains general information about the view: Details, which displays the
SFCView.
60
SFCView appearance and behavior
General description
Brief description The view: Details, the SFCView offers the following options:
l Display of real-time information on the status of a section
l Display of two steps at a time and the associated transition
l Shows the actions for the steps
l Shows the diagnostic information
l Shows state of variables, errors etc. using various colors
l Navigation between active steps for parallel branches
l Navigation between the sections via methods, e.g. DisplayNextStep
1(2)
Transition variable
Three lines of comment text
61
SFCView appearance and behavior
62
SFCView appearance and behavior
Diagnostic Then, for example, a field with diagnostic information and its associated FBD section
information from a Unity Pro project are used to give an initial overview.
The appearance of the field with the diagnostic information can be controlled using,
for example, the properties ValueOffColor, ShowAllTransitionInputs,
ShowBlockNames, ContentErrorStateColumn, StateErrorStateColumn
etc.
More detailed information on the properties, methods, events and constants which
are available for controlling the diagnostic information display can be found in the
following chapters.
Example: Diagnostic information and its FBD section
FBI_11_1 (3)
AND_16
1 2 4 3 5 6 ACT11 AND1 OUT TV11
SFC_Start15 AND2
ACT2 AND3
AND4
.11.4(1) .11.5 (2) AND5
NOT_BOOL OR_BOOL AND6
AND7
ACT10
ACT1 AND8
AND9
AND10
AND11
AND12
AND13
AND14
AND15
AND16
63
SFCView appearance and behavior
Controlling the To control the behavior and the appearance of the SFCView, the person carrying out
controls the configuration has various methods, events, constants and properties available
for use.
All the controlling options which are assigned to the details display are described in
the following chapter.
All general controlling options are described in their own chapter General controlling,
p. 45 .
64
SFCView appearance and behavior
2 5
3
4
6 7
65
SFCView appearance and behavior
Direct view Direct view of a chain in the views: Details and Details Simple.
of a chain
Property Description
ChainName Via this property a chain can be displayed
directly in the Details or Details Simple views
(without going through the Overview view).
Note: The SFCView texts are stored in English by default but can be changed by
the person carrying out the configuration.
66
SFCView appearance and behavior
Variables display Color display for variables (actions, transitions and diagnostic variables)
Property Description
ValueOffBackColor The background color for a variable in its off
state.
ValueOffForeColor The text color for a variable in its off state.
ValueOnBackColor The background color for a variable in its on
state.
ValueOnForeColor The text color for a variable in its on state.
Note: Further information on diagnostics can be found in the Prerequisites for the
diagnosis, p. 22 chapter.
67
SFCView appearance and behavior
68
SFCView appearance and behavior
69
SFCView appearance and behavior
Column widths
Property Description
WidthErrorStepNameColumn Width of the ErrorStep column
WidthErrorVariableColumn Width of the ErrorVariable column
WidthErrorPinTypeColumn Width of the ErrorPinType column (only via SFCView
blocks for diagnostics)
WidthErrorStateColumn Width of the ErrorState column (only via SFCView
blocks for diagnostics)
WidthErrorCommentColumn Width of the ErrorComment column
70
SFCView appearance and behavior
Texts
Property Description
ColumnHdrErrorStep ErrorStep column header
ColumnHdrErrorVariable ErrorVariable column header
ColumnHdrErrorPinType Header for the ErrorPinType column (only via
SFCView blocks for diagnostics)
ColumnHdrErrorState Header for the ErrorState column (only via SFCView
blocks for diagnostics)
ColumnHdrErrorComment ErrorComment column header
Note: The SFCView texts are stored in English by default but can be changed by
the person carrying out the configuration.
Texts
Property Description
ColumnHdrActionQualifier ActionQualifier column header
ColumnHdrActionTime ActionTime column header
ColumnHdrActionName ActionName column header
ColumnHdrActionType ActionType column header
ColumnHdrActionComment ActionComment column header
Note: The SFCView texts are stored in English by default but can be changed by
the person carrying out the configuration.
71
SFCView appearance and behavior
Note: The font that is set using the DetailsStepNameFont property is also used
for chain names and the transition names. The font for all the other texts is set
using the Font property.
Texts
Property Description
StepMaxTimeErr Text that is shown in the step information field, if the
maximum monitoring time is exceeded.
StepMinTimeErr Text that is shown in the step information field, if the
minimum monitoring time has not been reached.
Note: The SFCView texts are stored in English by default but can be changed by
the person carrying out the configuration.
72
SFCView appearance and behavior
Functions for The following methods are available for controlling the PLC diagnostics functions:
diagnostics
Methods Description
via the PLC
diagnostics DiagResetErrorBuffer Resets all diagnosis errors in the PLC.
buffer DiagRetrigger Triggers another analysis of the diagnosis error in the
section which is currently being shown in the details view.
Control of the The following methods are available for controlling the steps and transitions display:
steps display
Methods Description
and transitions
DisplayInitialStep Shows the first step of the step chain.
DisplayNextActiveStep Shows the next active step.
DisplayNextAltTran Shows the next alternative transition.
DisplayNextParStep Shows the next parallel step
DisplayNextStep Displays the next step.
DisplayPreviousStep Displays the previous step.
DisplayPrevActiveStep Shows the previous active step
DisplayPrevAltTran Shows the previous alternative transition.
DisplayPrevParStep Shows the previous parallel step
73
SFCView appearance and behavior
74
SFCView appearance and behavior
75
SFCView appearance and behavior
Introduction
Overview This chapter contains general information about the view: Details Simple, which
shows the SFC View.
76
SFCView appearance and behavior
General description
Brief description The view: Details Simple of the SFCView offers the following options:
l Display of real-time information on the status of the active or selected step in a
step chain
l Navigation between active steps for parallel branches
l Navigation between the step chains via methods, e.g. DisplayNextStep
S_3_1 4
Step sets ACT1, ACT1 is mapped to I/O but not read
by any logic. Has a delay time of 2 sec. 5
77
SFCView appearance and behavior
Controlling To control the behavior and the appearance of the SFCView, the person carrying out
the controls the configuration has various methods, events, constants and properties available
for use.
All the controlling options which are assigned to the Details Simple display are
described in the following chapter.
All general controlling options are described in their own chapter General controlling,
p. 45 .
Direct view Direct view of a chain in the views: Details and Details Simple.
of a chain
Property Description
ChainName Via this property a chain can be displayed directly in the
Details or Details Simple views (without going through the
Overview view).
78
SFCView appearance and behavior
Property Description
DetailsSimpleShow Specifies that a bar on the left and right of the field indicates
InitialStepIndicator that the field is an initial step.
DetailsSimpleShow When this is set the buttons for navigating between the
Navigation active steps for parallel branches are displayed.
Note: If the line with the state of the chain or the line with the error message is not
shown, then the state of the chain or an error in the chain is shown by a color
outline around the line with the chain name. The color outline is set in the
ChainFlagsOffBackColor/ChainFlagsOnBackColor or in the
StepMaxTimeErrBackColor/StepMinTimeErrBackColorproperties.
Text for displaying the step chain state. These texts are also shown in the Overview
view in the column ChainStatus.
Property Description
OverviewTextRunning Sets the text shown if the chain status flag is set
to CsfRunning.
OverviewTextSectionDisabled Sets the text shown if the chain status flag is set
to CsfSectionDisabled.
OverviewTextSetInitializeFlag Sets the text shown if the chain status flag is set
to CsfInitializeFlagSet.
OverviewTextDisableTimeCheck Sets the text shown if the chain status flag is set
to CsfTimeCheckDisabled.
OverviewTextDisableTransitions Sets the text shown if the chain status flag is set
to CsfTransitionDisabled.
OverviewTextDisableActions Sets the text shown if the chain status flag is set
to CsfActionsDisabled.
79
SFCView appearance and behavior
Note: The SFCView texts are stored in English by default but can be changed by
the person carrying out the configuration.
80
SFCView appearance and behavior
Controlling The following methods are available for controlling the display of steps:
the display
Methods Description
for the steps
DisplayInitialStep Shows the first step of the step chain.
DisplayNextActiveStep Shows the next active step (for parallel branches).
DisplayNextStep Displays the next step.
DisplayPreviousStep Displays the previous step.
DisplayPrevActiveStep Shows the previous active step (for parallel branches).
81
SFCView appearance and behavior
82
Tips and Tricks
7
Introduction
Overview This chapter contains tips for improving the performance of your system and tricks
that have arisen from previous versions of SFCView.
83
Tips and Tricks
Reading the When SFCView is first started, all of the SFC sections in the Unity Pro project are
Unity Pro project read.
If the SFC View internal diagnostic was selected via the diagnosis block, all of the
FBD sections will be read also.
84
Tips and Tricks
System performance
Loading Unity Preference should be given to the following procedures in order to speed up the
Pro projects loading time for Unity Pro projects:
l Set the ViewMode property (using the OPCAccessPath property) before you
load the project.
l If you are using the view: Details or Details Simple, set the ChainName property
(using the OPCAccessPath property) before you load the project.
l Only load the project once the SFCView window has opened.
l Use the UseEasySwitchMode property only if you really need it, otherwise
SFCView always has to load the data for both diagnostics modes.
Communication Preference should be given to the following procedures in order to speed up the
in the system communications in the system:
l In the OFS configuration tool, increase the MaxChannels option. Use the
maximum value allowed by the application.
l Set the ViewMode property before creating a link to the PLC. SFC View only
instantiates the OPC groups that are required in the desired view.
l If you are using the view: Details or Details Simple, set the ChainName property
before you create a link to the PLC. SFC View only instantiates the OPC groups
that are required for the desired section.
l Set the EnableOPCUpdates property, for the time in which the SFCView
window remains in the background, to false. This will reduce the data traffic for
this duration.
Resetting To revert to the SFC View Controls presettings, you must delete it from the ActiveX
SFCView container and then insert it again.
mfc42.dll SFC View was developed with Microsoft Visual Studio 6.0 (SP5). Therefore, the
control requires mfc42.dll, version 6.0 or higher.
If the ActiveX container used by you has a lower DLL version, it can create conflicts
between SFC View and the ActiveX container.
Therefore you must ensure that your ActiveX container works correctly with
mfc42.dll, version 6.0 or higher.
85
Tips and Tricks
86
Functional Reference
II
At a glance
Introduction In this part you will find information about objects, properties, methods, events and
constants.
87
Functional Reference
88
Objects
8
At a glance
Introduction In this chapter you will find information about the objects.
89
Objects
OFSDevice Object
Brief description An OFSDevice object contains OFS' configuration data for a device.
Remarks The unique string to access an element of the OFSDevices collection is the value of
the OFSDevice object's Alias property.
See the Visual Basic documentation for more information about collections.
OFSDevices Collection
Syntax object.OFSDevices
object.OFSDevices (index)
The syntax lines above refer to the collection and to individual elements in the
collection, respectively, according to the standard collection syntax.
The OFSDevices collection syntax has these parts:
Part Description
object An object expression that evaluates to an OFSInfo object.
index Either an integer or string that uniquely identifies a member of an
OFSDevices collection.
Remarks The unique string to access an element of the OFSDevices collection is the value of
the OFSDevice object's Alias property.
See the Visual Basic documentation for more information about collections.
90
Objects
OFSInfo Object
Brief description Makes data of the currently configured OFS devices available.
Syntax OFSInfo
Remarks When the object is created by a call to the GetOFSInfo method of the SFC View
control, the OFS configuration data currently available in the system registry is read.
Brief description A SFC View control is a graphical control to display the contents and the current
state of all SFC sections of a Concept project in a PLC.
Syntax SFCView
Remarks See the chapter Overview for an overview of the main concepts of the control or look
for the details in the other chapters of this reference.
91
Objects
92
Properties
9
At a glance
Introduction In this chapter you will find information about the properties.
93
Properties
94
Properties
At a glance
Introduction In this section you will find an overview of the ChainXxx properties.
95
Properties
ChainName Property
Brief description Returns/Sets string value, which represents chain name displayed in detail view.
ChainControlVariableName Property
Brief description Returns/Sets string value, which represents variable name used as input variable of
the SFCVIEW_CTRL in the Unity Pro project.
96
Properties
ChainFlagsOffBackColor Property
Brief description Returns/Sets the background color to display the 'Off' state of the chain status flags.
Remarks See the Visual Basic documentation about possible color values or color constants.
ChainFlagsOffForeColor Property
Brief description Returns/sets the foreground color to display the 'Off' state of the chain status flags.
Remarks See the Visual Basic documentation about possible color values or color constants.
97
Properties
ChainFlagsOnBackColor Property
Brief description Returns/Sets the background color to display the 'On' state of the chain status flags.
Remarks See the Visual Basic documentation about possible color values or color constants.
ChainFlagsOnForeColor Property
Brief description Returns/Sets the foreground color to display the 'On' state of the chain status flags.
Remarks See the Visual Basic documentation about possible color values or color constants.
98
Properties
At a glance
Introduction In this section you will find an overview of the ColumnHdrActionXxx properties.
99
Properties
ColumnHdrActionComment Property
Brief description Returns/Sets the header text of the Comment column for step actions.
ColumnHdrActionName Property
Brief description Returns/sets the header text of the Name column for step actions.
ColumnHdrActionQualifier Property
Brief description Returns/Sets the header text of the Qualifier column for step actions.
100
Properties
ColumnHdrActionTime Property
Brief description Returns/Sets the header text of the Time column for step actions.
ColumnHdrActionType Property
Brief description Returns/sets the header text of the Type column for step actions.
101
Properties
At a glance
Introduction In this section you will find an overview of the ColumnHdrChainXxx properties.
102
Properties
ColumnHdrChainComment Property
Brief description Returns/Sets the header text of the Chain Comment column.
ColumnHdrChainName Property
Brief description Returns/Sets the header text of the Chain Name column.
103
Properties
ColumnHdrChainStatus Property
Brief description Returns/sets the header text of the Chain Status column.
104
Properties
At a glance
Introduction In this section you will find an overview of the ChainHdrErrorXxx properties.
105
Properties
ColumnHdrErrorComment Property
Brief description Returns/sets the header text of the Comment column for transition errors.
ColumnHdrErrorStep Property
Brief description Returns/Sets the header text of the Step column for transition errors.
106
Properties
ColumnHdrErrorVariable Property
Brief description Returns/sets the header text of the Variable column for transition errors.
ColumnHdrErrorPinType Property
Brief description Returns/sets the header text of the Pin Type column for transition errors.
Remarks Column ErrorPin and ErrorState occur only when UsePLCDiagSystem property is
set to false.
107
Properties
ColumnHdrErrorState Property
Brief description Returns/sets the header text of the Comment column for transition errors.
Remarks Column ErrorPin and ErrorState occur only when UsePLCDiagSystem property is
set to false.
108
Properties
At a glance
Introduction In this section you will find an overview of the ColumnHdrStepXxx properties.
109
Properties
ColumnHdrParallelSteps Property
Brief description Returns/sets the header text of the Parallel Steps column.
ColumnHdrStepComment Property
Brief description Returns/sets the header text of the Step Comment column.
110
Properties
ColumnHdrStepName Property
Brief description Returns/Sets the header text of the Step Name column.
111
Properties
At a glance
Introduction In this section you will find an overview of the DetailsXxx properties.
112
Properties
DetailsActiveStepBackColor Property
Brief description Returns/Sets the background color to display a step in active-state in the detail view.
Remarks See the Visual Basic documentation about possible color values or color constants.
DetailsInactiveStepBackColor Property
Brief description Returns/Sets the background color to display a step in inactive-state in the detail
view.
Remarks See the Visual Basic documentation about possible color values or color constants.
113
Properties
DetailsInitialStepBackColor Property
Brief description Returns/Sets the background color to display initial step indicator in the details and
details simple view. In details simple view dependently on property.
DetailsSimpleShowInitStepIndicator the Initial step indicator or step name label will
be displayed in this color when currently displayed step is initial.
Remarks See the Visual Basic documentation about possible color values or color constants.
DetailsWaitingStepBackColor Property
Brief description Returns/Sets the background color to display a step in waiting-state in the details
simple view. Waiting-state means that displayed step is initial step or reset flag is set
for the chain.
Remarks See the Visual Basic documentation about possible color values or color constants.
114
Properties
DetailsViewLinesColor Property
Remarks See the Visual Basic documentation about possible color values or color constants.
115
Properties
At a glance
Introduction In this section you will find an overview of the DetailsSimpleXxx properties.
116
Properties
DetailsSimpleShowChainName Property
Brief description Returns/Sets whether the chain name is displayed in details simple view.
117
Properties
DetailsSimpleShowChainStatus Property
Brief description Returns/Sets whether the chain status is displayed in details simple view. When set
to false the chain status will be indicated by back groundcolor of step name label.
118
Properties
DetailsSimpleShowChainComment Property
Brief description Returns/Sets whether the chain comment is displayed in details simple view.
119
Properties
DetailsSimpleShowStepErrorLabel Property
Brief description Returns/Sets whether step error state is displayed in the details simple view. When
set to false the error state will be indicated by background color of step name label.
120
Properties
DetailsSimpleShowStepComment Property
Brief description Returns/Sets whether the step comment is displayed in details simple view.
121
Properties
DetailsSimpleShowInitStepIndicator Property
Brief description Returns/Sets whether indicator for initial step is displayed in the details simple view.
When set to false the initial step will be indicated by background color of step name
label.
122
Properties
DetailsSimpleShowNavigation Property
Brief description Returns/Sets whether navigation buttons are displayed in details simple view.
123
Properties
DetailsSimpleStepNameFont Property
Brief description Returns/Sets the font to display the step name in the details simple view.
Remarks The same font is used for the chain name in the detail simple view, too. All other
texts in the detail view and in overview are displayed with the font specified with the
standard Font property.
124
Properties
At a glance
Introduction In this section you will find an overview of the DetailsStepXxx properties.
125
Properties
DetailsStepNameFont Property
Brief description Returns/Sets the font to display the step name in the details view.
Remarks The same font is used for the chain name and the transition name in the detail view,
too. All other texts in the detail view and in overview are displayed with the font
specified with the standard Font property.
DetailsStepsLeft Property
Brief description Returns/Sets the left positions to display the steps in the detail view.
Remarks The DetailsStepsLeft property determines the distance between the inner left edge
of the SFC View control and the left edge of the rectangles in which the steps are
displayed in the detail view.
This property is measured in Twips. See the Visual Basic documentation for more
information about this measurement unit.
126
Properties
DetailsStepsWidth Property
Brief description Returns/Sets the width to display the steps in the detail view.
Remarks The DetailsStepsWidth property determines the width of the rectangles in which the
steps are displayed in the detail view.
This property is measured in Twips. See the Visual Basic documentation for more
information about this measurement unit.
127
Properties
At a glance
Introduction In this section you will find an overview of the DetailsTextXxx properties.
128
Properties
DetailsTextDisableActions Property
Brief description Returns/Sets the text to display the chain state 'Actions Disabled' in the detail view.
DetailsTextDisableTimeCheck Property
Brief description Returns/Sets the text to display the chain state 'Time Check Disabled' in the detail
view.
129
Properties
DetailsTextDisableTransitions Property
Brief description Returns/Sets the text to display the chain state 'Transitions Disabled' in the detail
view.
DetailsTextSectionDisabled Property
Brief description Returns/Sets the text to display the chain state 'Section Disabled' in the detail view.
130
Properties
DetailsTextSetResetFlag Property
Brief description Returns/Sets the text to display the chain state 'Reset Flag Set' in the detail view.
131
Properties
At a glance
Introduction In this section you will find an overview of the DiagXxx properties.
132
Properties
DiagAutoRetrigger Property
Brief description Returns/Sets whether diag errors are automatically re-triggered for analysis or not.
Remarks If the property is set to false, the client application can re-trigger the analysis by
calling the method DiagRetrigger.
133
Properties
DiagAutoRetriggerInterval Property
Brief description Returns/Sets the interval (1 to 65535ms) at which diag entries will be retriggered.
Default is 1000ms.
Remarks Setting the value too low might have a negative influence on the system
performance.
134
Properties
At a glance
Introduction In this section you will find an overview of the OPCXxx properties.
135
Properties
OPCNetworkServer Property
Brief description Returns/Sets information about the location of the OPC server.
OPCAccessPath Property
Brief description Returns/Sets information how the OPC server should get the data.
Remarks The string has to be one of the alias names defined with the OFS configuration tool,
which determines the Concept project and the PLC to be used by OFS.
When the property is set with the control's property pages, one can select an alias
name from the current OFS configuration data. This configuration data can also be
retrieved with the GetOFSInfo method.
136
Properties
OPCConnect Property
Brief description Returns/Sets whether to connect to or disconnect from the OPC server.
Remarks The OPCConnect property is ignored at designtime. At runtime, the connection with
the OPC server will be started only after the project data was read by the control and
when the OPCConnect property is set to true.
137
Properties
OPCUpdateRate Property
Brief description Returns/Sets the fastest rate at which the OPC server should deliver changed data.
Remarks The OPCUpdateRate property determines how often the OPC server should send
changed data to the control. Setting the value too low might have a negative
influence on the system performance.
138
Properties
At a glance
Introduction In this section you will find an overview of the OverviewTextXxx properties.
139
Properties
OverviewTextDisableActions Property
Brief description Returns/Sets the text to display the chain state 'Actions Disabled' in the overview
and details simple view.
OverviewTextDisableTimeCheck Property
Brief description Returns/Sets the text to display the chain state 'Time Check Disabled' in the
overview and details simple view.
140
Properties
OverviewTextDisableTransitions Property
Brief description Returns/Sets the text to display the chain state 'Transitions Disabled' in the overview
and details simple view.
OverviewTextRunning Property
Brief description Returns/Sets the text to display the chain state 'Running' in the overview.
141
Properties
OverviewTextSectionDisabled Property
Brief description Returns/Sets the text to display the chain state 'Section Disabled' in the overview
and details simple view.
OverviewTextSetResetFlag Property
Brief description Returns/Sets the text to display the chain state 'Reset Flag Set' in the overview and
details simple view.
142
Properties
At a glance
Introduction In this section you will find an overview of the ShowXxx properties.
143
Properties
ShowActiveStep Property
Brief description Returns/Sets whether the details and details simple views displays always the active
step.
ShowAllDiagErrors Property
Brief description Returns/Sets whether all diag errors are shown or not.
144
Properties
Remarks The property is valid only when UsePLCDiagSystem property is set to true.
ShowAllTransitionsInput Property
Brief description Returns/Sets whether diagnostic information is shown for all active steps or only for
actually selected step.
Remarks The property is valid only when UsePLCDiagSystem property is set to false.
145
Properties
ShowChainGroups Property
Brief description Returns/Sets whether the overview displays the hierarchy of the chain groups.
Remarks It's recommended to configure chain groups (functional moduls) in the Unity/
Concept project and to set this property to True, if there are many SFC sections in
the project. Since the control needs real-time data for all steps in all chains displayed
in the overview at the same time, it might have a negative influence on the system
performance when there are too much chains displayed in the overview.
146
Properties
ShowStatistics Property
ShowStepComments Property
Brief description Returns/Sets whether step comments or chain comments are displayed in the
overview grid.
147
Properties
ShowTimeInms Property
Brief description Returns/Sets whether in the details and details simple views, step delay time and
current time are displayed in milliseconds.
148
Properties
ShowBlockNames Property
Brief description Returns/Sets whether to display structure of logic assigned to transition in the grid
for transition errors.
Remarks The property is valid only when UsePLCDiagSystem property is set to false.
149
Properties
At a glance
Introduction In this section you will find an overview of the StepMaxTimeErrXxx properties.
150
Properties
StepMaxTimeErrBackColor Property
Brief description Returns/Sets the background color to display that the maximum step time is
exceeded.
Remarks See the Visual Basic documentation about possible color values or color constants.
StepMaxTimeErrForeColor Property
Brief description Returns/Sets the foreground color to display that the maximum step time is
exceeded.
Remarks See the Visual Basic documentation about possible color values or color constants.
151
Properties
StepMaxTimeErrText Property
Brief description Returns/Sets the text to display that the maximum step time is exceeded (detail
view).
152
Properties
At a glance
Introduction In this section you will find an overview of the StepMinTimeErrXxx properties.
153
Properties
StepMinTimeErrBackColor Property
Brief description Returns/Sets the background color to display that the minimum step time was not
reached.
Remarks See the Visual Basic documentation about possible color values or color constants.
StepMinTimeErrForeColor Property
Brief description Returns/Sets the foreground color to display that the minimum step time was not
reached.
Remarks See the Visual Basic documentation about possible color values or color constants.
154
Properties
StepMinTimeErrText Property
Brief description Returns/Sets the text to display that the minimum step time was not reached (detail
view).
155
Properties
At a glance
Introduction In this section you will find an overview of the UseXxx properties.
156
Properties
UseOPCProject Property
Brief description Returns/Sets whether the project file will be determined automatically from the OPC
access path.
157
Properties
Brief description Returns/Sets whether the PLC's diagnostic system is used to get the causes of
transition errors. If set to false, the causes are determined internally. If changed at
runtime, it reloads the current project or not depending on the UseEasySwitchMode
property.
158
Properties
UsePLCDiagSystem Property
Brief description Returns/Sets whether the PLC's diagnostic system is used to get the causes of
transition errors. If set to false, the causes are determined internally. If changed at
runtime, it reloads the current project.
159
Properties
UseEasyModeSwitch Property
Brief description Returns/Sets whether reload or not current project when UsePLCDiagSystem
property has changed.
160
Properties
At a glance
Introduction In this section you will find an overview of the ValueXxx properties.
161
Properties
ValueOffBackColor Property
Brief description Returns/Sets the background color to display a variable value in `Off' state.
Remarks See the Visual Basic documentation about possible color values or color constants.
ValueOffForeColor Property
Brief description Returns/Sets the foreground color to display a variable value in `Off' state.
Remarks See the Visual Basic documentation about possible color values or color constants.
162
Properties
ValueOnBackColor Property
Brief description Returns/Sets the background color to display a variable value in `On' state.
Remarks See the Visual Basic documentation about possible color values or color constants.
ValueOnForeColor Property
Brief description Returns/Sets the foreground color to display a variable value in `On' state.
Remarks See the Visual Basic documentation about possible color values or color constants.
163
Properties
At a glance
Introduction In this section you will find an overview of the WidthActionXxx properties.
164
Properties
WidthActionQualifierColumn Property
Brief description Returns/Sets width of Action Qualifier column in the grid for step (actual and next)
actions.
Remarks To hide a column you have to set Width property of the column to 0.
WidthActionTimeColumn Property
Brief description Returns/Sets width of Error Variable column in the grid for step (actual and next)
actions.
Remarks To hide a column you have to set Width property of the column to 0.
165
Properties
WidthActionVariableColumn Property
Brief description Returns/Sets width of Pin Type column in the grid for step (actual and next) actions.
Remarks To hide a column you have to set Width property of the column to 0.
WidthActionCommentColumn Property
Brief description Returns/Sets width of Error State column in the grid for step (actual and next)
actions.
Remarks To hide a column you have to set Width property of the column to 0.
166
Properties
At a glance
Introduction In this section you will find an overview of the WidthErrorXxx properties.
167
Properties
WidthErrorStepNameColumn Property
Brief description Returns/Sets width of Step Name column in the grid for transition errors.
Remarks When UsePLCDiagSystem property is true, width of Error State and Pin Type
columns is always 0. When ShowAllTransitionsInput property is set to false, Step
Name column width is also 0.
Note: To hide a column you have to set Width property of the column to 0.
WidthErrorVariableColumn Property
Brief description Returns/Sets width of Error Variable column in the grid for transition errors.
Remarks When UsePLCDiagSystem property is true, width of Error State and Pin Type
columns is always 0. When ShowAllTransitionsInput property is set to false, Step
Name column width is also 0.
Note: To hide a column you have to set Width property of the column to 0.
168
Properties
WidthErrorPinTypeColumn Property
Brief description Returns/Sets width of Pin Type column in the grid for transition errors.
Remarks When UsePLCDiagSystem property is true, width of Error State and Pin Type
columns is always 0. When ShowAllTransitionsInput property is set to false, Step
Name column width is also 0.
Note: To hide a column you have to set Width property of the column to 0.
WidthErrorStateColumn Property
Brief description Returns/Sets width of Error State column in the grid for transition errors.
Remarks When UsePLCDiagSystem property is true, width of Error State and Pin Type
columns is always 0. When ShowAllTransitionsInput property is set to false, Step
Name column width is also 0.
Note: To hide a column you have to set Width property of the column to 0.
169
Properties
WidthErrorCommentColumn Property
Brief description Returns/Sets width of Error Comment column in the grid for transition errors.
Remarks When UsePLCDiagSystem property is true, width of Error State and Pin Type
columns is always 0. When ShowAllTransitionsInput property is set to false, Step
Name column width is also 0.
Note: To hide a column you have to set Width property of the column to 0.
170
Properties
At a glance
Introduction In this section you will find an overview of the other properties.
171
Properties
Alias Property
Brief description Returns a string specifying the alias name of a device configured for use with OFS.
Syntax object.Alias
172
Properties
AutomaticProjectReload Property
Brief description Returns/Sets whether to reload the project automatically after a change of the
project within the PLC was recognized.
Remarks If the property is set to false, the client application can implement its own strategy
for reloading the project by responding to the ProjectChanged event with calling the
method ReloadProject only under special circumstances.
173
Properties
BackColor Property
Brief description Returns/Sets the control background color in details and details simple view.
Remarks See the Visual Basic documentation about possible color values or color constants.
Count Property
Brief description Returns the number of OFSDevice objects in the OFSDevices collection.
Syntax object.Count
174
Properties
ContentErrorStateColumn Property
Brief description Returns/Sets what to display in the Error State column in the grid for transition
errors.
175
Properties
EnableOPCUpdates Property
Brief description Returns/Sets whether to start or stop notifications about changed data by the OPC
server.
Remarks By setting the property to false, the client application can temporarily stop
notifications about changed data (from the OPC server to the SFC View control),
e.g. when the window with the control is currently in the background.
Font Property
Brief description Returns/Sets the font to display chain status, chain comment, step comment etc in
the overview details and details simple view.
176
Properties
Item Property
Brief description Returns a specific member of the OFSDevices collection either by position or by key.
It is not necessary to specify the name of this property as shown in the second
syntax line above, since the Item property is the default property of the OFSDevices
object.
The Item property syntax has these parts:
Part Description
object An object expression that evaluates to an OFSDevices object.
index An expression that specifies the position of a member of the
collection. If a numeric expression, index must be a number from 1
to the value of the collection's Count property. If a string expression,
index must correspond to the Alias property of the OFSDevice
member object referred to.
MaxChannel Property
Brief description Returns a number specifying the maximum number of channels of a device
configured for use with OFS.
Syntax object.MaxChannel
177
Properties
NumberErrorGridLines Property
Brief description Returns/Sets value, which indicates number of lines displayed in error grid.
OFSDevices Property
Syntax object.OFSDevices
178
Properties
OnChainOpen Property
Brief description Returns/Sets the action to be performed when the user double clicks a row in the
grid while in overview mode.
Settings For the settings for value see OnChainOpenActions Constants, p. 218.
Path Property
Brief description Returns a string specifying the address of a device configured for use with OFS.
Syntax object.Path
179
Properties
ProjectFile Property
Brief description Returns/Sets the name of the file with the project data.
Remarks The string should contain the complete path to the Concept/Unity project (.STU for
Unity; .PRJ for Concept) file.
This property will be set automatically by setting the OPCAccessPath property when
the property UseOPCProject is set to true at the same time.
The ProjectFile property is ignored at designtime. At runtime, the control starts
reading the project data when the property is set. If there was a connection with the
OPC server with any previous project, the connection will be closed and started
again for the new project data.
Refresh Property
Brief description Returns a number specifying whether automatic refresh of a device configured for
use with OFS is enabled.
Syntax object.Refresh
180
Properties
StateErrorStateColumn Property
Brief description Returns/Sets what indicate the background color in the Error State column in the
grid for transition errors.
181
Properties
Symb Property
Brief description Returns a string specifying the full path to the file with information about the symbols
of a device configured for use with OFS.
Syntax object.Symb
UnityNetworkServer Property
Brief description Returns/Sets information about the location of the Unity Pro program.
182
Properties
ViewMode Property
Settings For the settings for value see SFCViewModes Constants, p. 219.
183
Properties
184
Methods
10
At a glance
Introduction In this chapter you will find information about the methods.
185
Methods
186
Methods
At a glance
Introduction In this section you will find an overview of the DiagXxx methods.
187
Methods
DiagResetErrorBuffer Method
Syntax object.DiagResetErrorBuffer
DiagRetrigger Method
Brief description Retriggers the analysis of the diagnostic errors of the chain, which is currently
displayed in the detail view.
Syntax object.DiagRetrigger
188
Methods
At a glance
Introduction In this section you will find an overview of the DisplayXxx methods.
189
Methods
DisplayInitialStep Method
Brief description Navigate to and display the initial step. This method works in details and details
simple view mode.
Syntax object.DisplayInitialStep
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
DisplayNextActiveStep Method
Brief description Navigate to and display the next active step. This method works in details and
details simple view mode.
Syntax object.DisplayNextActiveStep
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
190
Methods
DisplayNextAltTran Method
Brief description Navigate to and display the next alternate transition. This method works only in
details mode.
Syntax object.DisplayNextAltTran
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
DisplayNextParStep Method
Brief description Navigate to and display the next parallel step. This method works only in details
mode.
Syntax object.DisplayNextParStep
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
191
Methods
DisplayNextStep Method
Brief description Navigate to and display the next step. This method work in details and details simple
mode.
Syntax object.DisplayNextStep
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
DisplayPreviousStep Method
Brief description Navigate to and display the previous step. This method work in details and details
simple mode.
Syntax object.DisplayPreviousStep
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
192
Methods
DisplayPrevActiveStep Method
Brief description Navigate to and display the previous active step. This method works in details and
details simple mode.
Syntax object.DisplayPrevActiveStep
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
DisplayPrevAltTran Method
Brief description Navigate to and display the previous alternate transition. This method works only in
details mode.
Syntax object.DisplayPrevAltTran
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
193
Methods
DisplayPrevParStep Method
Brief description Navigate to and display the previous parallel step. This method works only in details
mode.
Syntax object.DisplayPrevParStep
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
194
Methods
At a glance
Introduction In this section you will find an overview of the PLCXxx methods.
195
Methods
PLCClearChain Method
WARNING
Danger of unsafe, dangerous and destructive operations for tools
or processes.
PLCClearChain should not be used for trouble shooting while
operating machine tools, processes or material administration systems
while they are running. This can lead to unsafe, dangerous and
destructive operations by the tools or processes linked to the controller.
Failure to follow this precaution can result in death, serious injury,
or equipment damage.
Syntax object.PLCClearChain(value)
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
Remarks The sequence can only be started again by the 1 -> 0 edge of the
PLCSetInitializeFlag.
196
Methods
PLCDisableActions Method
Brief description Enables or disables the processing of actions for the selected SFC section.
WARNING
Danger from unsafe, dangerous and destructive operations in
tools or processes.
PLCDisableActions should not be used for finding errors with
controllers of machine tools, processes or material maintenance
systems, when they are running. Since no logic processing is taking
place any longer, the control panel ignores all input information. This
can cause unsafe, dangerous, and destructive operations of tools or
processes connected to the control.
Failure to follow this precaution can result in death, serious injury,
or equipment damage.
Syntax object.PLCDisableActions(disable)
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
197
Methods
PLCDisableSection Method
Brief description Enables or disables the processing of the selected SFC section.
WARNING
Danger from unsafe, dangerous and destructive operations in
tools or processes.
PLCDisableSection should not be used for controllers of machine
tools, processes or material maintenance systems, when they are
running. Since no logic processing is taking place any longer, the
control panel ignores all input information. This can cause unsafe,
dangerous, and destructive operations of tools or processes connected
to the control.
Failure to follow this precaution can result in death, serious injury,
or equipment damage.
Syntax object.PLCDisableSection(disable)
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
198
Methods
PLCDisableTimeCheck Method
Syntax object.PLCDisableTimeCheck(disable)
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
199
Methods
PLCDisableTransitions Method
WARNING
Danger from unsafe, dangerous and destructive operations in
tools or processes.
PLCDisableTransitions should not be used for controllers of
machine tools, processes or material maintenance systems, when they
are running. Since no logic processing is taking place any longer, the
control panel ignores all input information. This can cause unsafe,
dangerous, and destructive operations of tools or processes connected
to the control.
Failure to follow this precaution can result in death, serious injury,
or equipment damage.
Syntax object.PLCDisableTransitions(disable)
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
200
Methods
PLCGotoNextStep Method
WARNING
Danger from unsafe, dangerous and destructive operations in
tools or processes.
Using the method PLCGotoNextStep it is possible to activate the next
step, even when the transition is not satisfied. PLCGotoNextStep
should therefore not be used for finding errors with controllers of
machine tools, processes or material maintenance systems, when they
are running. This can cause unsafe, dangerous, and destructive
operations of tools or processes connected to the control.
Failure to follow this precaution can result in death, serious injury,
or equipment damage.
Syntax object.PLCGotoNextStep(unconditional)
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
Remarks If unconditional is true, the next step will be activated independent of the state of the
transition, but not until the delay time of the active step has expired.
In parallel branches, a step in each branch will be activated, while in alternative
branches it always activates the left branch.
201
Methods
PLCResetTimeErrors Method
Brief description Resets supervision time errors for the selected SFC section.
Syntax object.PLCResetTimeErrors
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
202
Methods
PLCSetInitializeFlag Method
WARNING
Danger of unsafe, dangerous and destructive operations for tools
or processes.
PLCSetInitializeFlag should not be used for trouble shooting
while operating machine tools, processes or material administration
systems while they are running. This can lead to unsafe, dangerous and
destructive operations by the tools or processes linked to the controller.
Failure to follow this precaution can result in death, serious injury,
or equipment damage.
Syntax object.PLCSetInitializeFlag(value)
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
Remarks Use the initialize flag to initialize the sequence for a standardized start.
To initialize the sequence, activate the initialize flag. This will stop the sequence and
all actions will be initialized. Operator interventions are not possible.
Standardized sequence start:
To start the sequence, the initialize flag must first be activated and then deactivated.
The 1 -> 0 edge will initialize the sequence, i.e. the initial step is activated.
203
Methods
At a glance
Introduction In this section you will find an overview of the other methods.
204
Methods
About Method
Syntax object.About
GetOFSInfo Method
Syntax object.GetOFSInfo
Return Value An object of type OFSInfo, which allows to read OFS configuration data.
205
Methods
ReloadProject Method
Syntax object.ReloadProject
Return Value A boolean value indicating the success (true) or failure (false) of the operation.
Remarks If there was a connection with the OPC server previously, the connection will be
closed and started again.
206
Events
11
At a glance
Introduction In this chapter you will find information about the events.
207
Events
208
Events
At a glance
Introduction In this section you will find an overview of the ChainXxx events.
209
Events
ChainOpen Event
Brief description Raised in overview mode when the user double clicks on a chain in the grid or
presses the Enter key while the grid has the focus.
ChainSelect Event
Brief description Raised in overview mode when the user selects a new row in the grid.
210
Events
ChainStatusChanged Event
211
Events
At a glance
Introduction In this section you will find an overview of the other events.
212
Events
ActionVarSelect Event
Brief description Raised in detail mode when the user double clicks on the grid with the current or next
step's actions in it. The variable clicked on is passed with the chain name.
DetailsSimpleDblClick Event
Brief description Raised in details simple mode when the user double clicks on the step name label.
213
Events
DiagVarSelect Event
Brief description Raised in detail mode when the user double clicks on the grid with the diagnostics
in it. The variable clicked on is passed with the chain name.
ProjectChanged Event
Brief description Raised when a change of the project within the PLC was recognized.
214
Events
ViewModeChanged Event
215
Events
216
Constants
12
At a glance
Introduction In this chapter you will find information about the constants.
217
Constants
ChainStatusFlags Constants
Constants:
Constant Value Description
CsfRunning 0 The chain is in running mode.
CsfSectionDisabled 1 The chain is disabled.
CsfResetFlagSet 2 The chain's reset flag is set (Concept).
CsfInitializeFlagSet The chain's initialize flag is set (Unity Pro).
CsfTimeCheckDisabled 4 The chain's time check is disabled.
CsfTransitionsDisabled 8 The chain's transitions are disabled.
CsfActionsDisabled 16 The chain's actions are disabled.
CsfUnknown 4096 The chain's status is unknown.
OnChainOpenActions Constants
Constants The following values can be written to or returned from the control's property
OnChainOpen, which allows to get or set the action to be performed when the user
double clicks a row in the grid while in overview mode.
Constants:
Constant Value Description
NoAction 0 The user's input will be ignored.
ShowDetails 1 The chain will be shown in detail view.
ShowDetailsSimple 2 The chain will be shown in details simple view.
218
Constants
SFCViewModes Constants
Constants The following values can be written to or returned from the control's property
ViewMode, which allows getting or setting the control's current display mode.
Additionally, the control's ViewModeChanged event delivers one of these values
when the view mode has changed.
Constants:
Constant Value Description
SfcOverview 0 The chain is/will be shown in the overview.
SfcDetails 1 The chain is/will be shown in the detail view.
SfcDetailsSimple 2 The chain is/will be shown in the details simple view.
ContentsErrorStateColumn Constants
Constants The following values can be written to or returned from the control's property
ContentErrorStateColumn, which allows getting or setting the content of Error State
column in error grid.
Constants:
Constant Value Description
CecEmpty 0 Error State column is empty.
CecErrorState 1 Error state column contains error state of input
variable.
CecVariableName 2 Error state column contains variable name.
CecPinType 3 Error state column contains Pin Type.
219
Constants
StatesErrorStateColumn Constants
Constants The following values can be written to or returned from the control's property
StateErrorStateColumn, which allows to get or set what indicate the background
color in the Error State column.
Constants:
Constant Value Description
sescNoState 0 The background color is gray.
sescErrorState 1 The background color indicate, if the variable is an
error or not.
sescPinState 2 The background color indicate pin state, to which the
variable is directly connected.
sescVariableState 3 The background color indicate variable state.
220
SFCView block library
III
Introduction
Overview The SFC View block library contains three diagnostic EFBs and an EFB for
controlling step chains by SFC View, which are not included in the standard
Unity Pro shipping.
221
SFCView block library
222
Block types and their applications
13
Introduction
Overview This chapter describes the different block types and their applications.
223
Block types and their applications
Block types
Block types Different block types are used in Unity Pro. The general term for all block types is
FFB.
There are the following types of block:
l Elementary Function (EF)
l Elementary Function Block (EFB)
l Derived Function Block (DFB)
l Procedure
Elementary Elementary functions (EF) have no internal status.. If the input values are the same,
Function the value at the output is the same for all executions of the function, e.g. the addition
of two values gives the same result at every execution.
An elementary function is represented in the graphical languages (FDB and LD) as
a block frame with inputs and an output. The inputs are always represented on the
left and the outputs always on the right of the frame The name of the function, i.e.
the function type, is shown in the center of the frame.
The number of inputs can be increased with some elementary functions.
Elementary Elementary function blocks (EFB) have an internal status. If the inputs have the
function block same values, the value on the output can have another value during the individual
executions. For example, with a counter, the value on the output is incremented.
An elementary function block is represented in the graphical languages (FDB and
LD) as a block frame with inputs and outputs. The inputs are always represented on
the left and the outputs always on the right of the frame The name of the function
block, i.e. the function block type, is shown in the center of the frame. The instance
name is displayed above the frame.
Derived function Derived function blocks (DFBs) have the same properties as elementary function
block blocks. They are created by the user in the programming languages FBD, LD, IL
and/or ST.
224
Block types and their applications
FFB Structure
Structure Each FFB is made up of an operation (name of the FFB), the operands required for
the operation (formal and actual parameters) and an instance name for elementary/
derived function blocks.
Call of a function block in the FBD programming language:
Instance name Operation Operand
(FFB name)
Formal Actual
parameter parameter
MY_TON
TON
ENABLE EN ENO ERROR
EXAMP IN Q OUT
TIME1 PT ET TIME2
Operands
Operation The operation determines which function is to be executed with the FFB, e.g. shift
register, conversion operations.
225
Block types and their applications
Operand The operand specifies what the operation is to be executed with. With FFBs, this
consists of formal and actual parameters.
Formal/actual Inputs and outputs are required to give values to the FFB or to take values from the
parameters FFB. These are called formal parameters.
Objects are connected to the formal parameters which contain the current process
states. These are called actual parameters.
During program runtime, the actual parameters are used to pass the process values
to the FFB and output them after processing.
The data type of the actual parameters must match the data type of the input/output
(formal parameters). The only exceptions are generic inputs/outputs, for which the
data types are determined by the actual parameters. If all actual parameters are
literals, the correct data type for the function block will be selected.
FFB Call in IL/ST In text languages IL and ST, FFBs can be called in formal and in informal form.
Details can be found in the Reference manual.
Example of a formal function call:
out:=LIMIT (MN:=0, IN:=var1, MX:=5) ;
Example of an informal function call:
out:=LIMIT (0, var1, 5) ;
Note: Take note that the use of EN and ENO is only possible for formal calls.
226
Block types and their applications
VAR_IN_OUT FFBs are often used to read a variable on an input (input variables), to process them
variable and output the changed value of the same variable again (output variables).
This is special case for an input/output variable and is also called VAR_IN_OUT
variable.
The input and output variable are linked in the graphic languages (FBD and LD)
using a line showing that they belong together.
Function block with VAR_IN_OUT variable in FBD:
MY_EXAMP1
EXAMP1
Input1 IN1 OUT1 Output1
Input2 IN2 OUT2 Output2
Comb_IN_OUT IO1 IO1 Comb_IN_OUT
227
Block types and their applications
EN and ENO
Description An EN input and an ENO output can be configured for all FFBs.
If the value of EN is "0" when the FFB is called up, the algorithms defined by the FFB
are not executed and ENO is set to "0".
If the value of EN is "1" when the FFB is called up, the algorithms defined by the FFB
are executed. After the algorithms have been executed successfully, the value of
ENO is set to "1". If an error occurs when executing these algorithms, ENO is set to
"0".
If ENO is set to "0" (caused by EN=0 or an error during execution):
l Function blocks
l EN/ENO-handling with function blocks that (only) have one connection as
output parameter:
FunctionBlock_1 FunctionBlock_2
EN ENO EN ENO
IN1 OUT IN1 OUT
IN2 IN2
228
Block types and their applications
l Functions/Procedures
As defined in IEC61131-3, the outputs from deactivated functions (EN-input set
to "0") is undefined. (The same applies for procedures.)
Nevertheless here is an explanation of the output statuses for this case:
l EN/ENO-handling with function/procedure blocks that (only) have one
connection as output parameter:
Function/Procedure_1 Function/Procedure_2
EN ENO EN ENO
IN1 OUT IN1 OUT
IN2 IN2
Conditional/ "Unconditional" or "conditional" calls are possible with each FFB. The condition is
Unconditional realized by pre-linking the input EN.
FFB Call l EN connected
conditional calls (the FFB is only processed if EN = 1)
l EN not used or set to TRUE
unconditional calls (FFB is always processed)
Note for FBD If the EN input is used, it must be connected to logic (conditional call) or permanently
set to TRUE (unconditional call) because otherwise the FFB will never be
processed.
Note for LD In LD, each FFB must be connected with the left power rail using a Boolean input.
Normally, the EN input is used for this purpose.
If the EN input is not connected to the left power rail, it cannot be used or it must be
permanently set to TRUE because otherwise the FFB will never be processed.
229
Block types and their applications
Note for The use of EN and ENO is only possible in the text languages for a formal FFB call,
IL and ST e.g.
MY_BLOCK (EN:=enable, IN1:=var1, IN2:=var2,
ENO=>error, OUT1=>result1, OUT2=>result2);
Assigning the variables to ENO must be done with the operator =>.
With an informal call, EN and ENO cannot be used.
230
AND_16: boolean AND
with 16 predefined inputs
14
Description
Function This function block is used to implement a boolean AND operation with up to 16
description inputs. For ascertaining the results of the operation only used, i.e. connected inputs
are used.
Note: If no inputs are connected the block returns the value ‘TRUE’.
Representation Representation:
in FBD
AND_16
Value_1 AND1 OUT Result
Value_2 AND2
Value_3 AND3
Value_4 AND4
Value_5 AND5
Value_6 AND6
Value_7 AND7
Value_8 AND8
Value_9 AND9
Value_10 AND10
Value_11 AND11
Value_12 AND12
Value_13 AND13
Value_14 AND14
Value_15 AND15
Value_16 AND16
231
AND_16
232
AND_OR_8: Combined boolean
AND-OR with 8 predefined inputs
15
Description
Function This block is used to implement a boolean AND connection with up to 8 inputs and
description a Boolean OR-connection with up to 8 inputs.
The result of the AND_OR_8-block is an AND-connection of the above connections.
Formula OUT = (AND1 & AND2 & ANDn) AND (OR1 OR OR2 OR ORn)
Representation Representation:
in FBD AND_OR_8
233
AND_OR_8
234
OR_16: boolean OR
with 16 predefined inputs
16
Description
Function This block is used to implement a boolean OR connection with up to 16 inputs. For
description ascertaining the results of the operation only used, i.e. connected inputs are used.
Note: If no inputs are connected the block returns the value 'FALSE'.
Representation Representation:
in FBD OR_16
Value_1 OR1 OUT Result
Value_2 OR2
Value_3 OR3
Value_4 OR4
Value_5 OR5
Value_6 OR6
Value_7 OR7
Value_8 OR8
Value_9 OR9
Value_10 OR10
Value_11 OR11
Value_12 OR12
Value_13 OR13
Value_14 OR14
Value_15 OR15
Value_16 OR16
235
OR_16
236
SFCVIEW_CTRL:
Step chain control via SFCView
17
Description
Function The function block is used to control the execution chain sequences via the
description ChainControlVariableName property in SFCView.
For example, you can go through step by step, processing transition conditions can
be turned on or off or the chain can be reset to its initialization state.
DANGER
Danger of unsafe, dangerous and destructive processes.
The "Initialize chain", "Reset chain", "Cancel analysis of transitions",
"Cancel editing of actions and reset all actions of the chain", "Activate
the next step independently of the transition condition" and "Activate the
next step depending on the transition condition " functions should not
be used to search for controller errors in machine tools, processes or
material management systems, if they are running.
Failure to follow this precaution will result in death, serious injury,
or equipment damage.
Representation Representation:
in FBD SFCVIEW_CTRL_Instance
SFCVIEW_CTRL
INVREF InvalidReference
INVCMD InvalidCommand
SVC_Command SVCCMD SVCCMD SVC_Command
237
SFC View_CTRL
238
Index
B
AC
A ChainOpen Event, 210
ChainSelect Event, 210
About Method, 205 ChainStatusChanged Event, 211
ActionVarSelect Event, 213 ChainStatusFlags Constants, 218
ActiveX Control
ColumnHdrActionComment Property, 100
Implementation, 32
ColumnHdrActionName, 100
Alias Property, 172
ColumnHdrActionQualifier Property, 100
AND_16, 231 ColumnHdrActionTime Property, 101
AND_OR_8, 233 ColumnHdrActionType, 101
AutomaticProjectReload Property, 173 ColumnHdrChainComment Property, 103
ColumnHdrChainName Property, 103
ColumnHdrChainStatus Property, 104
B ColumnHdrErrorComment Property, 106
BackColor Property, 174 ColumnHdrErrorPinType Property, 107
Block ColumnHdrErrorState Property, 108
AND_OR_8, 233 ColumnHdrErrorStep Property, 106
SFCVIEW_CTRL, 237 ColumnHdrErrorVariable Property, 107
block ColumnHdrParallelSteps Property, 110
AND_16, 231 ColumnHdrStepComment Property, 110
OR_16, 235 ColumnHdrStepName Property, 111
Block library Conditional FFB Call, 229
SFCView, 221 Constants, 217
Block types, 224 ChainStatusFlags, 218
ContentsErrorStateColumn, 219
OnChainOpenActions, 218
C SFCViewModes, 219
ChainControlVariableName Property, 96 StatesErrorStateColumn, 220
ChainFlagsOffBackColor Property, 97 Constants for controlling the view
ChainFlagsOffForeColor Property, 97 Details, 75
ChainFlagsOnBackColor Property, 98 Overview, 59
ChainFlagsOnForeColor Property, 98 Constants for general controlling of
ChainName Property, 96 SFCView, 53
239
Index
240
Index
G GetOFSInfo, 205
PLCClearChain, 196
General controlling, 45
PLCDisableActions, 197
General description of the control elements,
PLCDisableSection, 198
46
PLCDisableTimeCheck, 199
General description of the view
PLCDisableTransitions, 200
Details, 61
PLCGotoNextStep, 201
Details Simple, 77
PLCResetTimeErrors, 202
Overview, 55
PLCSetInitializeFlag, 203
GetOFSInfo Method, 205
ReloadProject, 206
Methods, 185
I Methods for controlling the view
Details, 73
Implementation of the SFC View ActiveX Details Simple, 81
Controls, 32 Methods for general controlling of SFCView,
Installation, 27 50
SFC View Library, 30
Installation and registration of Unity Pro and
OFS, 28 N
Installation of the SFC View Library, 30
NumberErrorGridLines Property, 178
Installation sequence, 28
Installing SCF View, 29
Instantiating groups, 84 O
Item Property, 177
Objects, 89
OFSDevice Object, 90
L OFSDevices Collection, 90
OFSInfo Object, 91
Library
SFC View Control, 91
SFC View, install, 30
Objects for general controlling of SFCView,
46
M OFSDevice Object
Objects, 90
MaxChannel, 177 OFSDevices Collection
Method Objects, 90
About, 205 OFSDevices Property, 178
DiagResetErrorBuffer, 188 OFSInfo Object
DiagRetrigger, 188 Objects, 91
DisplayInitialStep, 190 OnChainOpen Property, 179
DisplayNextActiveStep, 190 OnChainOpenActions Constants, 218
DisplayNextAltTran, 191 Online controlling
DisplayNextParStep, 191 Prerequisites for, 22
DisplayNextStep, 192 OPC Factory Server Presettings, 34
DisplayPrevActiveStep, 193 OPC Factory Server Settings, 34
DisplayPrevAltTran, 193 OPCAccessPath Property, 136
DisplayPreviousStep, 192 OPCConnect Property, 137
DisplayPrevParStep, 194
241
Index
242
Index
243
Index
StepMinTimeErrForeColor, 154 V
StepMinTimeErrText, 155
ValueOffBackColor Property, 162
Symb Property, 182
ValueOffForeColor Property, 162
System Architecture, 18
ValueOnBackColor Property, 163
System performance, 85
ValueOnForeColor Property, 163
System requirements, 18
View
Details, 60
T Display of, 61
General description of the, 61
Tips and Tricks
Details Simple, 76
Instantiating groups, 84
Display of, 77
Reading data, 84
General description of the, 77
System performance, 85
Overview, 54
Display for the, 55
General description of the, 55
U View display
Unconditional FFB Call, 229 Details, 61
Unity Pro Details Simple, 77
Settings, 34 Overview, 55
Unity Pro presettings, 34 ViewMode Property, 183
Unity Pro settings, 34 ViewModeChanged Event, 215
UnityNetworkServer Property, 182
UseEasyModeSwitch Property, 160
UseOPCProject Property, 157 W
UsePLCDiagSystem Property, 158, 159
WidthActionCommentColumn Property, 166
User
WidthActionQualifierColumn Property, 165
requirements, 21
WidthActionTimeColumn Property, 165
User requirements, 21
WidthActionVariableColumn Property, 166
WidthErrorCommentColumn Property, 170
WidthErrorPinTypeColumn Property, 169
WidthErrorStateColumn Property, 169
WidthErrorStepNameColumn Property, 168
WidthErrorVariableColumn Property, 168
244