PHD Adaptor Features

The PHD Adaptor supports PHD 300.1.0.1. The adaptor must have this version of the PHDAPINET.dll installed. If this version is not installed then the PHD Adaptor will not be able to connect to PHD.

The PHD Adaptor provides standardised access to Honeywell's Uniformance PHD Desktop Historian servers, hiding the complexity of obtaining data from PHD.

The PHD Adaptor requires the Honeywell PHD API to be installed to access real-time and historical data from Honeywell's PHD historian. This requires a license for the Honeywell PHD API, which is a third party component.


64-bit Support

A separate PHD 410 64-bit Adaptor is available in the Explorer installer. This has the same capabilities and configuration options as the PHD300 Adaptor, but is designed specifically for 64-bit systems.


Domain Authentication

PHD 300 has removed the need to log on using a user name and password, this is now done through the user that is logged on and running the PHD API. In order for P2 Server to use this feature, the Adaptor Pool Service must be set to a user that has access to the PHD system.


Tag Fetching

The PHD API that is used by the adaptor does not support batch fetching of tags and therefore cannot perform batch fetching. It is recommended that the fetch is done in a single fetch or it is filtered by A-Z; this will depend on how many tags exist in PHD.


Minimum and Maximum Values

The PHD Adaptor can understand minimum and maximum values that are defined using exponential notation (e.g. -1.643e6 to mean -1643000.0). If the adaptor does not recognise the value configured for a tag’s minimum or maximum, it sets both to ‘null’ (meaning “unknown”) rather than failing to fetch the tag. In versions prior to Server 4.5.3, these values would be rejected. 


PHD Adaptor Settings

The following table lists the adaptor's parameters, along with the name and type to be used in the Import/Export spreadsheet.

Parameter Description and example Name Type
Server Name of the server machine on which the historian is hosted. Server String
Connection Type The connection type to use when connecting to the PHD historian. While the Default type is normally sufficient, using Remote API may be necessary when connecting to a PHD server residing on a different domain to the machine where the adaptor is running. Options: Default, Remote API.
Note: This option was added in v4.5.3.
ConnectionType String
User ID User ID to use to connect to the historian. User ID String
Password Password for the User ID used to connect to the historian. Password EncryptedString
Use Domain Authentication When enabled, domain authentication will be used for the connection; please see the description for the "User ID" setting. This should be enabled if connecting to PHD 300 and disabled if connecting to PHD 200. Options: True, False. Use Domain Authentication Boolean
PHD Single Point Collapse Method Specifies the handling method when more than one datum is returned for a single-point fetch. Default: Oldest. PHD Single Point Collapse Method String
PHD Default Average Sample Interval The default average sampling interval (in seconds) to use when an incoming data request specifies the Average sample method. Setting this parameter to zero (the default) will cause all all raw data to be fetched when calculating the average. PHD Default Average Sample Interval Integer
PHD Average Sampling Type The sampling type for PHD to use when an incoming data request specifies the Average sample method. Default: Resampled. PHD Average Sampling Type String
PHD Average Reduction Type The reduction type for PHD to use when an incoming data request specifies the Average sample method. Default: Average. PHD Average Reduction Type String
PHD Reduction Offset The reduction offset for PHD to use when an incoming data request specifies the Average sample method. Default: Before.
Note: Prior to version 4.4.6, the default was After.
PHD Reduction Offset String
Enable Timing Logs Enable this setting to log request timing information to the P2 Server logs, independently of whether reporting timing information is enabled on the incoming Data Broker request. Note: Log Level may need to be increased for these timing results to become visible in the logs. Options: True, False. Enable Timing Logs Boolean
Allow Write Whether this data source should allow P2 Server client applications to write data to tags on the historian. Options: True, False. AllowWrite Boolean
Null Handling Controls how the adaptor handles the presence of "null" (confidence is -1) data points in the historian. Changing this setting can, depending on the functions used, significantly affect the results of calculations based on tags from this datasource, should those tags contain such "null" points within the fetch range (default: As Historian). Options:

  • AsHistorian
  • Omit
  • ReplaceWithNoValueErrorNoConfidence
  • ReplaceWithNoValueErrorFullConfidence
NullHandling String

Release History

  • PHD Adaptor Features 4.13.0
    • Support for data types int(I) and long(L)
  • PHD Adaptor Features 4.10.3
    • Added a separate 64-bit PHD Adaptor to the installer 
  • PHD Adaptor Features 4.6.5
    • Added Null Handling
  • PHD Adaptor Features 4.5.3
    • Added Connection Type
    • Added support for minimum and maximum values that are defined using exponential notation
  • PHD Adaptor Features 4.3.1
    • Initial version

Comments are closed