OPC UA for the Powertrain - Part 2: Functional Model
11.1 PtLogEntryDataType
Table 92 - PtLogEntryDataType Structure
Name
Type
Description
Optional
PtLogEntryDataType
structure
FaultSituationNumber
0:Byte
Identification of fault situation. 0 means current fault situation. Usually, an operator acknowledge generates a new fault situation if the server maintains different fault situations or snapshots in the diagnosis system.
False
EventNumber
0:UInt32
Unique number of event. LogEntries with the same EventNumber belong to different fault situations.
False
EventType
PtEventTypeEnumeration
Characterization of the event (fault, warning, etc.), encoded as PtEventTypeEnumeration Must never have the value "UNSPECIFIED".
False
EventClass
PtEventClassEnumeration
Fault-code identifying a fault or warning, encoded as PtEventClassEnumeration. Must never have the value "UNSPECIFIED".
False
VendorEventCode
0:Int32
Optional field containing the vendor specific fault code. Set to -1 if not used. -1 is reserved and may not be used as error code. In case of an existing definition of -1 as error code, it must be mapped to a different value. Clients should not expect this field to be present (backward compatibility).
False
VendorEventSubcode
0:UInt32
Additional information specifying more detailed information for the VendorEventCode.
True
EventText
0:LocalizedText
Brief description of the fault or warning.
False
EventComing
0:DateTime
Time when the event appears.
False
EventGoing
0:DateTime
Time when the event disappears. May not be set when the log entry is created. The field shall be set to "1900-01-01T00:00:00Z" to indicate an "empty" value in this case. Must be set when the event disappears.
False
EventAcknowledged
0:DateTime
Time when the event is acknowledged. May not be set when the log entry is created. The field shall be set to "1900-01-01T00:00:00Z" to indicate an "empty" value in this case. Must be set when the event is acknowledged.
False
Its representation in the AddressSpace is defined in Table 93
Table 93 - PtLogEntryDataType Definition
Attribute
Value
BrowseName
PtLogEntryDataType
IsAbstract
False
References
NodeClass
BrowseName
DataType
TypeDefinition
Other
Subtype of the 0:Structure type defined in OPC 10000-3.
Conformance Units
Powertrain Logbook Readable
Note: EventType refers to the diagnosis of Axis function. In addition to this, asset component related health status is available in the asset model (see [OPC 40400-1]).
If the Server provides the LogObject, the LogRecords provided by this 0:LogObjectTypeObject shall make the same information as the PtLogEntryDataType elements of the LogbookObject'sLogEntries array available for the Client. The necessary mapping of PtLogEntryDataType fields to 0:LogRecord fields is specified in Table 94.
Table 94 - Mapping of PtLogEntryDataTypeFields
LogRecord field
PtLogEntryDataType field mapped
Used Value
Time
EventComing, EventGoing, EventAcknowledged
Time when the event appears, disappears or is acknowledged. Each of these generates a new event.
PtLogObjectEventType if a corresponding PtLogObjectEventTypeEvent is generated, otherwise Null NodeId.
SourceNode
-
NodeId of the PtFunctionTypeObject representing the axis/drive affected.
SourceName
-
BrowseName of the SourceNode.
Message
EventText
TraceContext
-
AdditionalData[] {"LogEntry", Value}
Value = PtLogbookEventType.LogEntry
Use LogEntryProperty of corresponding PtLogObjectEventType. If Events are not supported, use corresponding element of the PtLogbook LogEntries component.
Table 95 maps the EventType fields' enumeration values of the PtLogEntryDataType to severity ranges specified in OPC 10000-26, "Table 9 - LogRecord Severity Mapping".
Table 95 - Mapping of EventType Field Value to Severity ranges