HART-IP data source reference
- Last UpdatedJan 06, 2023
- 4 minute read
The PI AF model for the HART gateways and sub-devices are based on element templates created by the connector. There is a template created for each gateway and sub-device based on manufacturer name and device type. Element templates and associated attributes can be viewed using PI System Explorer.
The following is an example of PI AF element templates created by the connector and used to create the PI AF elements shown in this document.
HART device attributes
The following table is a list of attributes shared by all HART gateways and sub-devices.
|
Attribute |
Description |
Values |
|---|---|---|
|
Address |
HART device address. |
String: aaa.bbb.ccc.ddd |
|
Assignment to PV |
Device variable mapped to primary variable (PV). |
Byte |
|
Assignment to SV |
Device variable mapped to secondary variable (SV). |
Byte |
|
Assignment to TV |
Device variable mapped to tertiary variable (TV). |
Byte |
|
Assignment to QV |
Device variable mapped to quaternary variable (QV). |
Byte |
|
Configuration Change Counter |
Number of times configuration changed on the device. |
UInt16 |
|
Descriptor |
Device description. |
String |
|
Device Hardware Revision |
Hardware revision level of the electronics in this particular device. |
Byte |
|
Device ID |
Unique Device Identifier. |
UInt32 |
|
Device Revision Level |
Device revision level (see HCF_SPEC-99 Command Summary Specification). |
Byte |
|
Device Type |
Expanded Device Type (see HCF_SPEC-183 Common Table 1, Device Type Codes and the Command Specification, Section 6). |
UInt32 |
|
Flags |
Device flags (see HCF_SPEC-183 Common Table 11, Flag Assignments). |
Byte |
|
Is Wireless Device |
Is device wireless? |
Boolean: True (wireless) False (wired) |
|
Is Wireless Gateway |
Is device a gateway? |
Boolean: True (gateway) False (not a gateway) |
|
Is Wireless Wdi7 |
Is device Wdi7? |
Boolean: True (Wdi7) False (not Wdi7) |
|
Long Tag |
Long tag name of the device. |
String |
|
Major Revision Number |
HART Protocol Major Revision Number implemented by this device. For HART Revision 7, this value must be the number 7. |
Byte |
|
Manufacturer |
Manufacturer Name and ID (see HCF_SPEC-183 Common Table 8, Manufacturer Identification Codes). |
String |
|
Maximum Device Variables |
Maximum number of device variables. This indicates the last device variable code that a host application should expect to be found in the device. |
Byte |
|
Minimum Preambles Request |
Minimum number of preambles required for the request message from the master device to the slave device. This number includes the two preambles used in asynchronous Physical Layer (along with the Delimiter) to detect the start of message. |
Byte |
|
Minimum Preambles Response |
Minimum number of preambles to be sent with the response message from the slave device to the master device. |
Byte |
|
Physical Signaling |
Physical Signaling Code (see HCF_SPEC-183 Common Table 10, Physical Signaling Codes). |
Byte |
|
Private Label Distributor |
Private Label Distributer Name and ID Code (see HCF_SPEC-183 Common Table 8, Manufacturer Identification Codes). |
String: Manufacturer defined: Manufacturer (ID) Manufacturer not defined: ID Code: ID |
|
Profile String |
Device Profile (see HCF_SPEC-183 Common Table 57). |
String |
|
Software Revision Level |
Software revision level of this device. Levels 254 and 255 are reserved. |
Byte |
|
Tag |
Short tag name of the device. |
String |
|
Unique Address |
Device Type and Device ID |
String: [TypeCode_IdCode] Example: 264E 0B7A2A |
HART Gateway attributes
The following table is a list of attributes specific to HART gateways.
|
Attribute |
Description |
Values |
|---|---|---|
|
Master Mode Communication on Channels |
The master mode for communication on channels. |
Byte: 0 (Secondary Master) 1 (Primary Master) (Default) |
|
Maximum Channels Per IOCard |
The maximum number of channels per I/O card. Must be greater than or equal to 1. |
Byte |
|
Maximum Delayed Responses Supported by IOSystem |
Maximum number of delayed responses supported by I/O system. Must be at least two. |
Byte |
|
Maximum Number IOCards |
The maximum number of I/O cards. Must be greater than or equal to 1. |
Byte |
|
Maximum Number of SubDevices Per Channel |
The maximum number of sub-devices per channel. Must be greater than or equal to 1. |
Byte |
|
Number of Devices Detected |
The number of devices detected. The count includes the I/O system itself. |
UInt16 |
|
Retry Count for Commands To SubDevice |
Retry count to use when sending commands to a sub-device. Valid range is 2 to 5. 3 retries is default. |
Byte |
HART SubDevice attributes
The following table is a list of attributes specific to HART sub-devices.
|
Attribute |
Description |
Values |
|---|---|---|
|
Channel |
Channel |
Byte |
|
IOCard |
IO card |
Byte |
|
SubDevice Index |
Sub-device index |
UInt16 |
HART Measurement attributes
The following table is a list of attributes shared by all HART measurements.
|
Attribute |
Description |
Values |
|---|---|---|
|
Device Variable Classification |
Device variable classification. |
String |
|
Device Variable Code |
Device variable code. |
Byte |
|
Parent |
Parent HART device containing the measurement. |
String: Unique address of Parent |
|
Units |
Units Code (see HCF_SPEC-183 Common Tables Specifications). |
String |