<< Click to Display Table of Contents >>
Internal Tags |
Device |
Item |
Operation |
Meaning |
---|---|---|---|
ServerName |
ServerStatus |
Read |
Returns the internal status of this Driver. If the Device parameter is only equal to ServerName, then this status is relative to the device as a whole. Possible values are 0: Starting, 1: Reading LD files, 2: Retrieving directory (GetServerDirectory), 3: Processing a single LD (Tag Browsing), 4: Retrieving a directory of files, 5: Processing LDs, 6: Finishing, 7: Finished OK, 8: Finishing with error, 9: Finished with error, 10: Reconnecting, or 11: Finished (waiting) |
ServerName:LDName |
ServerStatus |
Read |
If the Device parameter is equal to ServerName:LDName, then status is relative to the Logical Device. Possible values are 0: Waiting, 1: Reading LD file, 2: Retrieving LD directory, 3: Retrieving LN directory, 4: Retrieving data definition, 5: Creating a cache of Tags, 6: Discovering Reports, 7: Retrieving DataSets, 8: Retrieving the content of DataSets, 9: Retrieving Nameplates, 10: Retrieving versions of Reports, 11: Checking versions, 12: Programming Reports, 13: Operation (runtime), 14: Finishing, or 15: Finishing with error |
ServerName |
ComtradeTransferStatus |
Read |
Returns the activity status of file transfers via COMTRADE. Possible values are 0: Not connected, 1: Connected, 4: Waiting to list files, 5: Retrieving a list of files, 6: Files transferred (synced), 7: Waiting to transfer files, 8: Transferring file, 101: Empty list of files in the relay, 102: Format errors in the reading command, 103: Error when saving COMTRADE file, or 104: Error when transferring file |
ServerName |
LastComtradeFileName |
Read |
Informs the name of the last transferred COMTRADE file |
ServerName |
ServerRebuild |
Read |
Removes cache files (.LD) and restarts communication with a device. The Device parameter can have the same name of the IED, with or without a Logical Device |
ServerName |
UserDefinedReportList |
Write |
Allows defining a list of user-created Reports |
ServerName |
LastComtradeFileTime |
Read and write |
Indicates the date of the last collected COMTRADE file. When starting an application and avoid files already collected to be retrieved again, this Tag must receive a writing with the date of the last existing file. So, It is recommended that an application stores the value of this Tag when quitting and write back this value when starting, or use the options Save/Get Last Comtrade Time from File.
When the option Name+Index File Transfer is set, this tag indicates the last file transfer index, and it can also be R/W. Important to observe that if the IED is totally reset, the IED file index can return to an initial value (ex: 1), so if you want the new files to be transfered starting at this index, it is necessary to write at this tag the new value. (Note: Files are overwritten if names are duplicated). |
ServerName |
ComtradeInfo |
Read |
Returns a Block Tag with three Elements with COMTRADE properties. Values for Elements are 0: ComtradeTransferStatus, 1: LastComtradeFileTime, and 2: LastComtradeFileName |
ServerName |
BRCBActualList |
Read |
Returns a Block Tag with four Elements with a list of Buffered Reports in use. Values for Elements are 1: LDName, 2: ReportName, 3: TimeOfEntry, and 4: EntryID |
ServerName |
URCBActualList |
Read |
Returns a Block Tag with two Elements with a list of Unbuffered Reports in use. Values for Elements are 1: LDName and 2: ReportName |
ElipseClientInfo |
InternalClock |
Read |
Returns a Block Tag with two Elements with the current time and quality from internal clock. Values for Elements are 0: Current time (TIME) and 1: TimeQuality. The meaning of the bits of Element 1 (one) is 7: Leap Seconds Known, 6: Not used, 5: Sync Error, and 4-0: Precision (in power of 2-y) |
- |
ServerInitialBuild |
Write |
Allows changing IEDs parameters before starting communication. Please check section ServerInitialBuild Item for more information |
- |
GatewayRef |
Write |
Block tag with 4 elements which allows to inform an external gateway reference to a 61850 object, through a write operation. The elements are: 0: IEDName (Name of 61850 Server configured at the driver) 1: LDName (Logical Device Name) 2: Object (61850 object/item ex: LLN0$ST$Data$DataAttr) 3: Reference (String that represents this item address in an external driver, like DNP. Ex: "202;34" indicates an object 2 variation 2 and index 34 in a DNP Slave driver.
For more information please check the topic Gateway Configuration. |
- |
FinishedGtwRef |
Write |
IOTag which allows to inform through a write operation, the end of gateway reference addition.
For more information please check the topic Gateway Configuration. |
- |
GatewayEventOK |
Write |
Block tag with 4 elements, which informs that an event was confirmed by a 3rd party master in an external protocol in a gateway application, allowing the next EntryID to be set at the EID File, in order to avoid event loss or duplication on startup. The elements are: 0: Reference: (String that represents this item address in an external driver, like DNP. Ex: "202;34" indicates an object 2 variation 2 and index 34 in a DNP Slave driver). 1: Value (Value of the received event) 2: TSValid (Tells if the timestamp is valid and is being used at the slave protocol) 3: Timestamp (at the format of seconds since 1970)
For more information please check the topic Gateway Configuration. |
ServerName |
IPSelect |
Read |
Informs which IP address is in operation, in cases of using main and backup IP addresses |
ServerName |
IOKitEvent |
Read |
Returns IOKit events for the specified IED especificado, according to the Read Driver Events Tag available on topic Documentation of I/O Interfaces |
ServerName |
GetFileDirectory |
Read |
Informs a list of existing files in the IED after a GetFileDirectory (write) request. If there is no previous request or if there is no data available, returns an empty list |
ServerName |
FinishedWriteTimeOfEntry |
Write |
Please check topic Reports Tab for more information |
ServerName |
FinishedWriteEntryID |
Write |
Please check topic Using EntryID for more information |
ServerName |
IPSwitch |
Write |
Requests a switch from the main IP address to the backup address or vice versa |
ServerName |
DeclareClientDSList |
Write |
Declares a list of DataSets defined in the client. Please check topic Reports Tab for more information |
ServerName |
PopulateClientDSList |
Write |
Populates the members of each DataSet defined in the previous item. Please check topic Reports Tab for more information |
ServerName |
GetFileDirectory |
Write |
Requests a list of files in the IED, based on a directory informed in Tag's value or on the root directory if no directory is informed |
ServerName |
GetFile |
|
Requests a transfer of a file with the name informed in the Tag. This file is saved with the same name on the default directory of COMTRADE files |
ServerName |
DeleteFile |
|
Requests a removal of a file with the name informed in the Tag directly in the IED |
ServerName |
CompareLogicalDeviceDirectory |
|
Compares the content of a Logical Device (LD) retrieved from a cache file (.LD) with the current content in the IED. If they do not match, a new cache file is generated |
ServerName:LDName |
CompareDataDefinition |
|
Compares the content of a Logical Node (LN) retrieved from a cache file (.LD) with the current content in the IED. If they do not match, a new cache file is generated |
ServerName:LDName |
GetDataValues |
Write |
Requests a reading of an item, which can be LN, DO, or DA. Values are returned in their respective Tags |
ServerName:LDName |
SetDataValues |
Write |
Requests a writing of current values of the informed item, which can be LN, DO, or DA |
ServerName:LDName |
GetDataSetValues |
Write |
Requests a reading of all items belonging to a DataSet. Values are returned in their respective Tags |
ServerName:LDName |
GetAllDataValues |
Write |
Requests a reading of all items belonging to a Functional Constraint. Tag's value must be in the format LN$FC. Values are returned in their respective Tags |
ServerName:LDName |
DeleteDataSet |
Write |
Request the removal of a DataSet informed in the Tag |
In the next example, supposing there is an IniBuild Tag with its Item parameter equal to ServerInitialBuild, an IED with index 0 (zero) is enabled and the TSel parameter is changed.
Dim CommArr(1)
CommArr(0) = Array("IEC61850.Device[0].Disable", 0)
CommArr(1) = Array("IEC61850.Device[0].TSel", 1)
Write -1, 0, 0, 3, CommArr
Item("IniBuild").WriteEx(1)