Internal Tags

<< 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

 

ServerInitialBuild Item

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)

Was this page useful?