DNP3 analog input and output points

DNP3 analog point syntax

Telem_Server_<ScopeName>:%<OutstationFullName>;<PointType>;<PointNumber>{;ZSValue}{;FSValue}{;DBValue}{%}{;[PointName]}

where items enclosed in { curly brackets } are optional.

• PointType: AI or AO

• PointNumber: a decimal number from 0 to 65535 that maps to the "Point Number" field in the Telemetry Server dashboard. The maximum point number is device-dependent.

• Optional fields: ZSValue, FSValue, DBValue, and PointName. You can enter these fields in any order. If no value is entered, the default values for these fields are used.

  • ZSValue: This sets the zero scale limit of the tag in the Telemetry Server, and uses the format "ZS<value>", where <value> is a double data-type value and includes both positive and negative numbers. If <value> is out of range, point creation fails.

  • FSValue: This sets the full scale limit of the tag in the Telemetry Server. It uses the format "FS<value>", where <value> is a double data-type value and includes both positive and negative numbers. If the value given is out of the range, point creation fails.

  • DBValue: This sets the Significant Change option (deadband) of the tag in the Telemetry Server. You can enter the deadband as an absolute or percentage value, as follows:

    • DB<value> sets the Significant Change field to Absolute, and sets the Deadband field to <value>.

    • DB<value>% sets the Significant Change field to Percentage of Change, and sets the Deadband field to <value>.

    • The <value> specified for both Absolute and Percentage of Change must be a positive double data-type value.

    • When Percentage of Change is used, the maximum value is 100.

  • PointName: a descriptive name for the point, for example, [LiftStationPump_01]. If specified, the PointName must be enclosed in brackets.

    • If PointName is not specified, the point is assigned a default name that uses point type and number, in the format PointType_PointNumber, for example, AI_100.

    • If you want to create the new point in a different group than the Outstation group, include the group name: GroupName.PointName.

Analog reference examples

Without optional parameters:

Telem_Server_Node-12:%Group.DNP3_Outstation;AI;100

References analog input point 100, which is given the name AI_100

With the optional zero scale, full scale, and deadband parameters:

Telem_Server_Node-12:%Group.DNP3_Outstation;AI;100;ZS-10;FS250;DB25%

References the same analog input point as above, but defines the zero scale limit as -10, the full scale limit as 250, and the deadband as 25%

With the optional point name parameter that includes group name (include the group name when creating the point in a different group than the Outstation):

Telem_Server_Node-12:%Group.DNP3_Outstation;AI;100;[Group2.Point_Name]

References analog input point 100, which is named Point_Name and is created in Group2.