OPC UA Diagnostics

Introduction

The BMENUA0100 module presents both OPC UA server variables and Specific DataItems that can be used to identify the application running in the module, and to diagnose module operations.

OPC UA SERVICE_LEVEL Variable

The SERVICE_LEVEL variable provides information to a client regarding the status of the CPU and the health of the OPC UA server. The SERVICE_LEVEL variable is directly accessible under the OPC UA server node tree. The SERVICE_LEVEL variable is also duplicated in the OPCUA_STATUS.SERVICE_LEVEL element of the BMENUA0100 module DDT, and can be programmatically accessed by executing the READ_DDT elementary function when the application is in the RUN state.

NOTE: In redundant architectures, the OPC UA client needs to monitor the SERVICE_LEVEL variable in both the primary and the standby BMENUA0100 modules to manage the redundancy mechanism When the client detects that the SERVICE_LEVEL value of the standby module is greater than the SERVICE_LEVEL value of the primary module, the client needs to trigger a switchover from the primary to the standby module.

The following service level variables apply to all firmware versions of the BMENUA0100 module, except as noted:

SERVICE_LEVEL Value	Status of the CPU / OPC UA Server
SERVICE_LEVEL Value	Firmware = V1.0	Firmware ≥ V1.1
0	BMENUA0100 is in boot phase. CPU is in NOCONF or ERROR state. Example of ERROR state: MAST task is in HALT state.
1	OPC UA server has started. Data dictionary list browsing is ongoing.
5	Data dictionary browsing is started.
10	Data dictionary size overflow.
20	Data dictionary type browsing is ongoing.
50	Data dictionary variable browsing is ongoing.
100	Data dictionary browsing is complete. Reading of the CPU status is ongoing. Address space will be updated with new data dictionary content.
120¹	CPU in STOP state.	CPU in STOP STANDBY or HALT STANDBY state (Hot Standby CPU only).
150¹	CPU in WAIT STANDBY state (Hot Standby CPU only).
199¹	CPU in RUN STANDBY state (Hot Standby CPU only).
202²	<Not applicable>	Standalone_CPU only: CPU in STOP STANDALONE state. Hot Standby CPU only: When both CPUs are in STOP or HALT state, one BMENUA0100 is declared as master with service level = 202. Address space is OK and usable.
255	CPU in RUN (or RUN PRIMARY for Hot Standby CPU). OPC UA server is fully operational
1. This value does not need to be set before the server becomes operational. 2. This service level applies only to BMENUA0100 firmware V1.10 and higher.

NOTE: The larger the size of the data dictionary, the longer the data dictionary acquisition time (i.e. the time required for the module to browse and load the data dictionary). During data dictionary acquisition, SERVICE_LEVEL remains at the value 100 until acquisition is completed. When a build change is performed in Control Expert generating a new data dictionary, the OPC UA server restarts the process of browsing the data dictionary browsing. During this process updates of the currently monitored items may be halted, with monitored item values frozen at their most recently updated value.

OPC UA Server Variables

You can view these variables online using an OPC UA client device, such as the UaExpert tool from Unified Automation. Navigate the OPC UA server node tree to ServerStatus > BuildInfo to display the following OPC UA server variables:

Variable	Description
BuildDate	The date the application in the PAC was built.
BuildNumber	The number of the current PAC application build.
ManufacturerName	Always “Schneider Electric”.
ProductName	Always “BMENUA0100”.
ProductUri	The unique Uniform Resource Identifier assigned to the module.
SoftwareVersion	The current version of module firmware.

OPC UA Specific DataItems

The BMENUA0100 module supports the following Specific DataItems. These DataItems are accessible via the OPC UA server stack. While they are much like PAC data items reachable via the Control Expert software, these Special DataItems are not linked to PAC symbols and are not reachable via the Control Expert software:

DataItem	Data type	Default value	Description
#AddressSpaceState	INT16	0	The state of the address space, with its collection of objects and nodes. Possible values include: 0. Empty 1. Built 2. Updating 3. Partially built (no data dictionary exists in the application, or data dictionary overflow)
#ApplicationName	STRING	0	The PAC application name.
#ApplicationVersion	STRING	0	The PAC application version.
#CurrentDataDictionaryItemsCount	INT32	0	The number of items in the data dictionary that have been loaded into the server.
#CurrentMonitoredItemsCount	INT32	0	The number of items being monitored by the server.
#DeviceIdentity	STRING	0	The name of the CPU reference.
#PLCDatadicReady	BYTE	1	Monitors the PAC data dictionary loading status: The PAC data dictionary is not available. Possible explanations include: The data dictionary functionality is not available or enabled in the Control Expert application and cannot be embedded in the PAC. The loading/browsing of the data dictionary is in progress in OPC UA Server. The PAC data dictionary is available, for example: The loading/browsing of the data dictionary by the OPC UA server completed with success. A pre-loading (in accordance with Control Expert data dictionary project settings) can be in progress.
#PLCQualStatus	INT16	0	Monitors the communication status of a PAC. Possible (hex) values include: 0x00C0: Communication with the PAC is correct. 0x0040: No communication with the PAC for a time less than the Device Timeout (5s). 0x0: PAC is not identified.
#TSEventItemsReady	BOOL	0	A read-only item that indicates whether at source timestamped variables and at source time-stamping devices have been browsed in the M580 ePAC application: 0 = not browsed 1 = browsed NOTE: This item is meaningful only when time stamping is enabled in Control Expert and activated for the specific BMENUA0100 module.
#TSEventSynchro	BOOL	0	A read-write item that, when activated, sends a synchronized value to the entire at source time stamping devices attached to the M580 ePAC each time a write operation is performed. The purpose is to initialize all the timestamped monitored items to their current values. 0 = awaiting activation 1 = activated NOTE: The value of this item will always appear as 0. A value of 1 will never be seen as it exists only momentarily and reverts again to the awaiting activation value of 0. This item is meaningful only when time stamping is enabled in Control Expert and activated for the specific BMENUA0100 module.