Tightening Systems - 9 OPC UA VariableTypes

The ResultType is a subtype of the BaseDataVariableType. It aggregates the properties of Result data which are reported for a given joining system.

Figure 12 defines the structure. It is formally defined in Table 58. Refer section 10.4 for the description of the parameters.

Figure 12 - Overview of ResultType

Table 58 - ResultType Definition

Attribute		Value
BrowseName		ResultType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		ResultDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponent	Variable		ResultId	0:Guid	0:BaseDataVariableType	M, RO
0:HasComponent	Variable		ProcessingTimes	ProcessingTimesDataType	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		CreationTime	0:UtcTime	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ResultEvaluation	ResultEvaluation	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ResultEvaluationCode	0:Int32	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ResultEvaluationDetails	0:LocalizedText	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		SequenceNumber	0:Int32	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		Tags	TagDataType[]	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		Classification	0:Byte	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		OperationMode	0:Byte	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		IsSimulated	0:Boolean	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		IsPartial	0:Boolean	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ReporterAssetId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		GeneratorAssetId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ResultContent	0:BaseDataType	0:BaseDataVariableType	O, RO

9.2 TighteningResultType

It is used report data associated with Tightening Result and the corresponding measurement values. It is formally defined in Table 59. Refer section 10.5 for the description of the parameters.

Table 59 - TighteningResultType Definition

Attribute		Value
BrowseName		TighteningResultType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		TighteningResultDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponent	Variable		ProgramId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ProgramVersionId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		FailureReason	0:Byte	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		OverallResultValues	ResultValueDataType[]	0:BaseDataVariableType	M, RO
0:HasComponent	Variable		StepResults	StepResultDataType[]	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		Errors	ErrorInformationDataType[]	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		FailingStepResultId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		JointId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		Trace	TighteningTraceDataType	0:BaseDataVariableType	O, RO

9.3 ResultValueType

The ResultValueType is a subtype of the BaseDataVariableType. It is used to report measurement values of the joining operation. Those are meant to characterize the quality of the process. It is formally defined in Table 60. Refer section 10.6 for the description of the parameters.

Table 60 - ResultValueType Definition

Attribute		Value
BrowseName		ResultValueType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		ResultValueDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponent	Variable		Name	0:String	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		Value	0:Double	JoiningDataVariableType	M, RO
0:HasComponent	Variable		ResultEvaluation	ResultEvaluation	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ValueId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ValueTag	0:Byte	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		TracePointIndex	0:Int32	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		TracePointTimeOffset	0:Double	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ReporterId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ViolationType	0:Byte	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ViolationConsequence	0:Byte	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		SensorId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		LowLimit	0:Double	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		HighLimit	0:Double	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		TargetValue	0:Double	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ResultStep	0:String	0:BaseDataVariableType	O, RO

9.4 StepResultType

The StepResultType is a subtype of the BaseDataVariableType. It is used report measurement values corresponding to a given step in the program. It is formally defined in Table 61. Refer section 10.7 for the description of the parameters.

Table 61 - StepResultType Definition

Attribute		Value
BrowseName		StepResultType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		StepResultDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponent	Variable		StepResultId	0:Guid	0:BaseDataVariableType	M, RO
0:HasComponent	Variable		ProgramStepId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ProgramStep	0:String	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		Name	0:String	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ResultEvaluation	ResultEvaluation	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		StartTimeOffset	0:Double	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		StepTraceId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		StepResultValues	ResultValueDataType []	0:BaseDataVariableType	O, RO

9.5 ErrorInformationType

The ErrorInformationType is a subtype of the BaseDataVariableType. It is used report errors occurred in the system which are outside the boundaries of the given program. It is formally defined in Table 62. Refer section 10.8 for the description of the parameters.

Table 62 - ErrorInformationType Definition

Attribute		Value
BrowseName		ErrorInformationType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		ErrorInformationDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponent	Variable		ErrorType	0:Byte	0:BaseDataVariableType	M, RO
0:HasComponent	Variable		ErrorId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		LegacyError	0:String	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		ErrorMessage	0:LocalizedText	0:BaseDataVariableType	O, RO

9.6 TraceType

The TraceType is a subtype of the BaseDataVariableType. It is a base type to encapsulate common data for a Trace. It is formally defined in Table 63. Refer section 10.9 for the description of the parameters.

Table 63 - TraceType Definition

Attribute		Value
BrowseName		TraceType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		TraceDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponent	Variable		TraceId	0:Guid	0:BaseDataVariableType	M, RO
0:HasComponent	Variable		ResultId	0:Guid	0:BaseDataVariableType	M, RO

The mandatory TraceId is the system-wide unique identifier of the Trace.

9.7 TighteningTraceType

The TighteningTraceType is a subtype of the TraceType. This structure is to describe the content of traces for all the steps in the given program. It is formally defined in Table 64. Refer section 10.10 for the description of the parameters.

Table 64 - TighteningTraceType Definition

Attribute		Value
BrowseName		TighteningTraceType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		TighteningTraceDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the TraceType
0:HasComponent	Variable		StepTraces	StepTraceDataType[]	0:BaseDataVariableType	M, RO

9.8 StepTraceType

The StepTraceType is a subtype of the BaseDataVariableType. It is to describe of the trace for a given program step. It is formally defined in Table 65. Refer section 10.11 for the description of the parameters.

Table 65 - StepTraceType Definition

Attribute		Value
BrowseName		StepTraceType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		StepTraceDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponent	Variable		StepTraceId	0:Guid	0:BaseDataVariableType	M, RO
0:HasComponent	Variable		StepResultId	0:Guid	0:BaseDataVariableType	M, RO
0:HasComponent	Variable		NumberOfTracePoints	0:UInt32	0:BaseDataVariableType	M, RO
0:HasComponent	Variable		SamplingInterval	0:Double	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		StartTimeOffset	0:Double	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		StepTraceContent	TraceContentDataType[]	0:BaseDataVariableType	M, RO

The mandatory StepTraceId is the system-wide unique identifier of the step trace.

9.9 TraceContentType

The TraceContentType is a subtype of the BaseDataVariableType. It is to describe of the trace samples for a given program step. It is formally defined in Table 66. Refer section 10.12 for the description of the parameters.

Table 66 - TraceContentType Definition

Attribute		Value
BrowseName		TraceContentType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		TraceContentDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasComponent	Variable		Values	0:Double[]	JoiningDataVariableType	M, RO
0:HasComponent	Variable		SensorId	0:Guid	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		Name	0:String	0:BaseDataVariableType	O, RO
0:HasComponent	Variable		Description	0:String	0:BaseDataVariableType	O, RO

The mandatory Values is an array of trace samples. The values correspond to the PhysicalQuantity attribute of JoiningDataVariableType in the following section 9.10.

9.10 JoiningDataVariableType

The JoiningDataVariableType is a subtype of the BaseDataVariableType. It is to describe common sematic required for variables in a given system. In this version of the specification, it provides information about physical quantity and Engineering Units. It is formally defined in Table 67.

Table 67 - JoiningDataVariableType Definition

Attribute		Value
BrowseName		JoiningDataVariableType
IsAbstract		False
ValueRank		−2 (−2 = Any)
DataType		BaseDataType
References	NodeClass		BrowseName	DataType	TypeDefinition	Others
Subtype of the BaseDataVariableType defined in OPC 10000-5.
0:HasProperty	Variable		PhysicalQuantity	0:Byte	0:PropertyType	O, RO
0:HasProperty	Variable		0:EngineeringUnits	0:EUInformation	0:PropertyType	O, RO

The optional PhysicalQuantity is to determine the type of the physical quantity associated to a given value(s). It has the following pre-defined values which shall be used for each instance of this type.

0 - OTHER
1 - TIME
2 - TORQUE
3 - ANGLE
4 - IMPULSE
5 - DISTANCE
6 - AREA
7 - VOLUME
8 - FORCE
9 - PRESSURE
10 - VOLTAGE
11 - CURRENT
12 - RESISTANCE
13 - POWER
14 - ENERGY
15 - MASS
16 - TEMPERATURE
17 - FREQUENCY
18 - JOLT
19 - VIBRATION
20 - NUMBER
21 - DISTANCE_SPEED is the change of distance over time.
22 - ANGULAR_SPEED is the change of angle over time.
23 - DISTANCE_ACCELERATION is the change of DISTANCE_SPEED over time.
24 - ANGULAR_ACCELERATION is the change of ANGULAR_SPEED over time.
25 - TORQUE_SPEED is the change of torque over time.
26 - TORQUE_ACCELERATION is change of TORQUE_SPEED over time.
27 - TORQUE_PER_ANGLE_GRADIENT is the change of torque over angle.
28 - TORQUE_PER_ANGLE_GRADIENT2 is the change of TORQUE_PER_ANGLE_GRADIENT over angle. Example: It is used for yield and snug detection. It represents change of the slope in a torque over angle graph.

The optional 0:EngineeringUnits defines the engineering unit of the values.

Note: The quantity and units of the value is of importance and it is going to be defined in harmonized way. This specification waits for this to be solved in the base OPC UA specification (OPC 10000-8), and that will be updated afterwards.

Note on Physical Quantity and Engineering Units

JoiningDataVariableType defined in 9.10 describes a minimal way to provide the PhysicalQuantity and EngineeringUnits properties for a given value.

This might get updated in future version based on the updates from OPC UA Core Specifications. Hence the JoiningDataVariableType properties are marked as Optional to avoid breaking changes later.

An application can ensure that those are available by using a corresponding Conformance Unit defined for this use case.

If an application does not provide the EngineeringUnits for a given value, it is assumed to be in International System of Units (SI).