Figure 6 shows an overview of the DeviceType with its Properties.
Figure 6 — Overview of DeviceType
The general DeviceType from the OPC UA information model for the device configuration is taken as the basis in this specification. This information model is defined in IEC62541-100:2015.
All sub types derived from CommercialKitchenDevice can be supplemented by vendor-specific types.
The DeviceType defines the DeviceClass property. The classification is industry-specific and is defined for commercial kitchen devices in Table 9.
Table 9 — Values for the DeviceClass property
DeviceClass |
Description |
Fryer |
Fryer Device |
Frying Pan |
Frying Pan Device |
Combi Steamer |
Combi Steamer Device |
Convection Oven, Multiple Deck Oven |
Convection Oven, Multiple Deck Oven Device |
Pressure Cooking Kettle |
Pressure Cooking Kettle Device |
Cooking Kettle |
Cooking Kettle Device |
Multi Function Pan |
Multi Function Pan Device |
Pasta Cooker / Cook Marie |
Pasta Cooker / Cook Marie Device |
Coffee Machine |
Coffee Machine Device |
Dishwashing Machine |
Dishwashing Machine Device |
Servery System |
Servery System Device |
Cooking Zone |
Cooking Zone Device |
Frying And Grilling Appliance |
Frying And Grilling Appliance Device |
Microwave Combination Oven |
Microwave Combination Oven Device |
Ice Machine |
Ice Machine Device |
The manufacturer of the device is provided as freely definable text in the Manufacturer property.
The device designation is provided as freely definable text in the Model property.
The identification number, e.g. the serial number of the device, is provided as freely definable text in the SerialNumber property.
The hardware version of the device is provided as freely definable text in the HardwareRevision property.
The software version of the device is provided as freely definable text in the SoftwareRevision property.
The status of the device is provided as DeviceHealth enumeration in the DeviceHealth property. The possible values are NORMAL_0, FAILURE_1, CHECK_FUNCTION_2, OFF_SPEC_3 and MAINTENANCE_REQUIRED_4.
NORMAL_0 The device functions normally.
FAILURE_1 Malfunction of the device or any of its peripherals. Typically caused device-internal or process related.
CHECK_FUNCTION_2Functional checks are currently performed. Examples: Change of configuration, local operation, substitute value entered.
OFF_SPEC_3 Off-spec means that the device is operating outside its specified range (e.g. measuring or temperature range) or that internal diagnoses indicate deviations from measured or set values due to internal problems in the device or process characteristics.
MAINTENANCE_REQUIRED_4Although the output signal is valid, the wear reserve is nearly exhausted or a function will soon be restricted due to operational conditions e.g. build-up of deposits.
The CommercialKitchenDeviceType represents the basic type for all device classes according to Table 9. It is derived from the general DeviceType from the OPC UA information model for the device configuration. This information model is defined in IEC 62541-100:2015.
Figure 7 shows an overview of the CommercialKitchenDeviceType with its properties and associated Objects. The type is formally defined in Table 10.
Figure 7 — Overview of CommercialKitchenDeviceType
The CommercialKitchenDeviceType is formally defined in Table 10.
Table 10 — CommercialKitchenDeviceType Definition
Attribute |
Value |
|||||
BrowseName |
CommercialKitchenDeviceType |
|||||
IsAbstract |
True |
|||||
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
|
Subtype of the DeviceType defined in OPC 10000-100. |
||||||
HasProperty |
Variable |
1:DeviceClass |
String |
PropertyType |
M |
|
HasProperty |
Variable |
DeviceLocationName |
String |
PropertyType |
O |
|
HasComponent |
Object |
BatchInformation |
|
BatchInformationType |
O |
|
HasComponent |
Object |
ErrorConditions |
|
BaseObjectType |
M |
|
HasComponent |
Object |
InformationConditions |
|
BaseObjectType |
M |
|
HasComponent |
Object |
HACCPValues |
|
FunctionalGroupType |
O |
The property DeviceClass of the DeviceType is overwritten in order to change the ModellingRule to Mandatory. The DeviceClass Strings used for this specification are defined in Table 9.
The DeviceLocationName property represents a user-defined designation of the machine location.
Using this property the user can assign a name to the location, e.g. a room number.
The BatchInformation object contains information on batch and article tracking. The BatchInformationType is defined in section 5.3.
The ErrorConditions object contains a list of currently pending error messages.
The basis for the processing of error messages is the Alarm and Condition Model from OPC UA, which is defined in IEC 62541-9:2015.
An error message is represented by an object of the type AlarmConditionType or by a type derived from it.
The AlarmConditionType and its base types define various states such as EnabledState, AckedState or ActiveState and further properties such as Severity, Message, Time and SourceNode. The Retain Property indicates whether an error message is of interest to the client.
Changes to the status of an error message are supplied to the clients via Events. A client can request the current status for all error messages where Retain = true as an event via the ConditionRefresh method. Clients can thus request a list of pending error messages after establishment of a connection.
Clients can confirm error messages via Methods in order, for example, to change the AckedState of the error message.
The InformationConditions object contains a list of currently pending information messages.
The basis for the processing of information messages is the Alarm and Condition Model from OPC UA, which is defined in IEC 62541-0:2015.
An item of information is represented by an object of the type AlarmConditionType or by a type derived from it.
The HACCPValues object contains a list of HACCP-relevant measured values.
If a device provides HACCP-relevant measured values, these measured values must be referenced via the FunctionalGroup HACCPValues.
For HACCP-relevant measured values the corresponding variable must reference an information object of the type KitchenDeviceHAConfigType with the name "HA Configuration". The KitchenDeviceHAConfigType and its use are defined in section 5.4.
The BatchInformationType defines the data for the tracking of batches and articles.
Figure 8 shows an overview of the BatchInformationType with its Properties. The type is formally defined in Table 11.
Figure 8 — Overview of BatchInformationType
The BatchInformationType is formally defined in Table 11.
Table 11 — BatchInformationType Definition
Attribute |
Value |
|||||
BrowseName |
BatchInformationType |
|||||
IsAbstract |
False |
|||||
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
|
Subtype of the BaseObjectType defined in OPC 10000-5. |
||||||
HasProperty |
Variable |
OrderId |
String |
PropertyType |
M |
|
HasProperty |
Variable |
BatchId |
String |
PropertyType |
M |
|
HasProperty |
Variable |
SystemTime |
UtcTime |
PropertyType |
M |
|
HasProperty |
Variable |
LocalTime |
TimeZoneDataType |
PropertyType |
O |
The OrderId Property represents the machine user's order number for the traceability.
The BatchId Property represents the machine user's batch number for the traceability.
The SystemTime Property represents the current system time as a coordinated world time in UTC format.
The LocalTime property represents the current difference between the local time and the UTC time. The data type TimeZoneDataType is defined in OPC 10000-5.
The KitchenDeviceHAConfigType configures the logging of HACCP-relevant data.
Figure 9 shows an overview of the KitchenDeviceHAConfigType with its Properties. The type is formally defined in Table 12.
In the case of variables for which HACCP-relevant measured values are logged on the device, the corresponding variable must offer the settings relevant for the logging via an object with the name "HA Configuration". The BrowseName must have the Namespace Index 0. The KitchenDeviceHAConfigType or a type derived from it is used as the type for this Object.
Figure 9 — Overview of KitchenDeviceHAConfigType
The KitchenDeviceHAConfigType is formally defined in Table 12.
Table 12 — KitchenDeviceHAConfigType Definition
Attribute |
Value |
|||||
BrowseName |
KitchenDeviceHAConfigType |
|||||
IsAbstract |
False |
|||||
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
|
Subtype of the HistoricalDataConfigurationType defined in OPC 10000-11. |
||||||
HasProperty |
Variable |
HistoryDuration |
Duration |
PropertyType |
M |
|
HasProperty |
Variable |
SamplingInterval |
Duration |
PropertyType |
M |
The HistoryDuration Property represents the logging time in milliseconds for which data are stored in the device.
The SamplingInterval Property represents the sampling rate for the logging in milliseconds.
The KitchenDeviceParameterType is formally defined in Table 13. It represents the abstract base type for the device-specific parameter object types.
Table 13 — KitchenDeviceParameterType Definition
Attribute |
Value |
|||||
BrowseName |
KitchenDeviceParameterType |
|||||
IsAbstract |
True |
|||||
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
ModellingRule |
|
Subtype of the BaseObjectType defined in OPC 10000-5. |
||||||
HasComponent |
Variable |
ProgramId |
Int32 |
BaseDataVariableType |
O, R |
|
HasComponent |
Variable |
ProgramName |
LocalizedText |
BaseDataVariableType |
O, R |
|
HasComponent |
Variable |
ProgramUId |
Guid |
BaseDataVariableType |
O, R |
The ProgramId Variable with the data type Int32 represents the program number of the currently selected program.
The ProgramName Variable with the data type LocalizedText represents the program name of the currently selected program. If no names are available, the program number can also be used as text.
The ProgramUId Variable with the data type Guid represents the globally unique identifier of the currently selected program.