Use the OPC Quick Client to Confirm Report Statuses
Once you've established a device connection, you'll likely be looking to enable a report so it may be helpful to check the device data before opening your Designer. The OPC Quick Client can be a useful tool for checking report statuses or for troubleshooting purposes. Navigate to OPC Client > OPC Quick Client to access the Ignition OPC UA Server folder and locate your IED under the Devices folder. The configured device data is stored in three main folders:
- Model: The Model folder contains logical nodes that can be directly polled for information.
Reports: The Reports folder includes all the available reports and attributes available for subscription.Note: Subscribing to any reporting control block attribute will trigger Ignition to attempt to enable the associated report via the RptEna attribute. If enabling of a report cannot be achieved you will see quality like Bad_OutOfService: The source of the data is not operational.
- Diagnostics: The Diagnostics folder containd subfolders that can help identify the status of certain aspects of the configured devices.
If you are unsure of your report subscription status, you can use the Read link [r] for the RptEna tag within the related Reports folder to confirm if the report is available before you try to enable it. If the value returns as True, that report is already enabled elsewhere and unavailable for use.
Few events in the IEC 61850 standard allow for writes to occur, and no write actions should be attempted on the Quick Client page. See Device Operations below for recommended practices to write back to an IED.
|Name||The name of this IEC61850 device connection.|
|Description||Device connection description (optional). Can be used to provide any useful information / comments about this connection.|
|Enabled||If True (checked), the connection is enabled; if False (unchecked), the connection is disabled.|
|Hostname||The IP Address of the device.|
|Port||The port to use when connecting to an IEC61850 device, default is 102.|
|Request Timeout||Determines the maximum amount of time a request to the device will wait for a response, default is 2000.|
|Authentication Enabled||Determines if a password will be provided for authenticating requests to the device, default is false.|
|Authentication Password||The password used to authenticate requests to the device, default is an empty string.|
|SCD File Setting|
|Use SCD File|
Determines if a SCD file upload will be used when requesting from the device. The default value is false.
|Use Configured Hostname||Override any hostname that may have been set by the SCD file with the configured hostname, default is false.|
|Use Configured OSI Params||Override any OSI params that may have been set by the SCD file with the configured OSI params, default is false.|
|IED Name||If Use SCD File is enabled, this field will be populated automatically with the selected IED name during the SCD File Upload.|
|Access Point Name||If Use SCD File is enabled, this field will be populated automatically with the selected IED access point information during the SCD File Upload.|
|Advanced Client OSI Parameters|
|Client AE Qualifier||Sets the client Application Entity Qualifier, default is 12.|
|Client AP Title||Sets the client Application Process Title, default is 1,1,1,999,1.|
|Client Presentation-Selector||Sets the client Presentation-Selector (P-SEL), default is 00000001.|
|Client Session-Selector||Sets the client Session-Selector (S-SEL), default is 0001.|
|Client Transport-Selector||Sets the client Transport-Selector (T-SEL). It is optionally transmitted in the OSI Transport Layer connection request (CR), default is 0001.|
|Advanced Server OSI Parameters|
|Server AE Qualifier||Sets the server Application Entity Qualifier, default is 12.|
|Server AP Title||Sets the server Application Process Title, default is 1,1,1,999,1.|
|Server Presentation-Selector||Sets the server Presentation-Selector (P-SEL), default is 00000001.|
|Server Session-Selector||Sets the server Session-Selector (S-SEL), default is 0001.|
|Server Transport-Selector||Sets the server Transport-Selector (T-SEL). It is optionally transmitted in the OSI Transport Layer connection request (CR), default is 0001.|
|Misc. Advanced Settings|
|Use Report Timestamp||Determines if the timestamp from the report will be used instead of the timestamp associated with each reported value.|
Reports can exchange monitoring information, power metering, power quality, and fault event analysis, among other data from IED servers to clients. Device data and reports are sent to the client based on user-defined device configuration through report control blocks (RCBs) and SCL files. The IEC 61850 driver supports Unbuffered/Buffered Report Control Blocks (URCB/BRCB). Remember, an RCB can only be enabled by a single device connection to the IED. This is because an RCB is blocked once a client has registered to receive a report by enabling it. Therefore, if the report is in use elsewhere, an attempted overlap could prevent connections from occurring. You will need to replicate the report on your IED if you want multiple Ignition Gateways to access the same report or leverage a Remote Tag Provider.
- Buffered Reports: Reports are buffered by the IED in case a connection to the client is interrupted so that report data is still available to the client when the connection resumes.
- Unbuffered Reports: Information is not stored during a connection loss, so any data that may have been sent during the lost connection time is not available. Reporting begins again after the connection has resumed.
If you are using a buffered report, be aware the config.idb file will be frequently updated with the last report_id received. This could cause the auto-backup to trigger every 2 minutes when Ignition sees a change to the config.idb file. Changes to the auto-backup settings are encouraged to prevent threads pausing until the DB finishes being backed up. Changes can be made by modifying either of the following properties in the data/gateway.xml file.
The first modification option is to change the value in minutes for how often the auto-backup is triggered based on when Ignition checks for changes. The current value as shown is 2 minutes.
The following method is not recommended, but you can also change the true value to false, which will turn off this feature entirely if desired.
Use the Tag Browser to Enable a Report
Adding a report folder in your Designer immediately enables a report and allows you to see related attributes in the Tag Browser. This process is done in the same manner as creating a tag.
As you navigate to your desired Logical Node and Points folder, you'll notice a different format than what you might expect from a typical tag in the Tag Browser where all attributes are contained in a single tag. Attributes are listed as separate tags with their own qualified values (e.g. value, quality, and timestamps). This is because the Ignition needs to map the 61850 specification to the OPC UA model that requires an associated value, quality, and timestamp. Ignition will attempt to retrieve the q and t attributes that correspond with reported value attributes if they are available. Be sure to only add a single folder from the Points folder to your Tag Browser to avoid any issues that can occur from enabling multiple reports.
Once a specific attribute tag has been added in the Connected Devices window, you'll see your enabled report data in the Tag Browser. You can further curate this data by deleting unwanted data from the browser display.
IEC 61850 Hierarchical Data Model
Additionally, the OPC item path that Ignition uses can be isolated to identify individual attribute data because paths are built with an hierarchical data model. The data included in the path identifies the IED, logical device, logical node, data object, and attribute information. The example attribute we've been using in this section is shown below.
- IED: SSSA_52AFA_FPR
- Logical Device: LD0/LLN0
- Logical Node: rcbDigitals05$SSSA_52AFA_FPRCTRL/CBCILO1
- Data Object: EnaCls
- Attribute: stVal
Disable a Report
Deleting all Points from the Tag Browser in your Designer and/or deleting all report point subscriptions from the OPC Quick Client page will disable a report. You can confirm a report is successfully disabled by using the read from link [r] for the corresponding RptEna tag on the OPC Quick Client page.
Additionally, if a device is disabled while a subscription is still active, the subscription status code will show
Uncertain_LastUsableValue instead of the