AnalogInput (FB) ¶ FUNCTION_BLOCK AnalogInput EXTENDS PointWithFlags DNP3 data point of type Analog Input. DNP3 Analog Input provides the option to use certain data types to represent the value using AnyNumber . SINT (8bit -128 .. 127) USINT (16bit 0 .. 255) INT (16bit -32768 .. 32767) UINT (16bit 0 .. 65535) DINT (32bit -2147483648 .. 2147483647) UDINT (32bit 0 .. 4294967295) REAL DOUBLE Any one of the types listed can be used for value, lowLimit, highLimit and deadBand, all variables have to be of same base type. Please be aware: AnyNumber provides a value representation as well as a POINTER TO value representation. InOut: Scope Name Type Initial Comment Inherited from Input description STRING Description of the data point - configuration, no changes accepted if Outstation is enabled Point number INT -1 Point number - can be set if needed to either: start with Point number > 0 have gaps in Point numbers If set to -1 (the default) the OutstationDataModel (more precisely the related “Group”) takes care to set the Point number internally: starting at 0, if first Point number is not set explicitly. increment by 1 In case you set Point number explicitly please keep it consistent: Point numbers need to be >= 0 Point numbers need to be ascending Point eventClass CmpDNP3.IEC_TMWDEFS_CLASS_MASK CmpDNP3.TMWDEFS.TMWDEFS_CLASS_MASK_ONE The initial event class - configuration, no changes accepted if Outstation is enabled Operational event class may be changed by a master. Point eventMode CmpDNP3.IEC_TMWDEFS_EVENT_MODE CmpDNP3.IEC_TMWDEFS_EVENT_MODE.TMWDEFS_EVENT_MODE_SOE The event mode - configuration, no changes accepted if Outstation is enabled Only used if the sampling rate is set within the outstation configuration. Point flags BYTE CmpDNP3.DNPDEFS.DNPDEFS_DBAS_FLAG_ON_LINE Flags used by the point. Can be changed in case a point goes offline or any other error. If set to 0, the variation without flags will be used by DNP3 PointWithFlags value AnyNumber The value to operate with. lowLimit AnyNumber The low limit to operate with - default is -INF highLimit AnyNumber The high limit to operate with - default is +INF. deadBand AnyNumber The deadband to operate with - default is 1.0.
AnalogInputDeadband (FB) ¶ FUNCTION_BLOCK AnalogInputDeadband EXTENDS Point DNP3 data point of type Analog Input Deadband. A DNP3 data point of type Analog Input Deadband allows to read / write the deadband of a data point of type Analog Input with the same Point number. So application access to the Analog Input deadband has to be done at the Analog Input itself. Analog Input Deadband is sipposed to expose the deadband to a DNP3 Master. InOut: Scope Name Type Initial Comment Inherited from Input description STRING Description of the data point - configuration, no changes accepted if Outstation is enabled Point number INT -1 Point number - can be set if needed to either: start with Point number > 0 have gaps in Point numbers If set to -1 (the default) the OutstationDataModel (more precisely the related “Group”) takes care to set the Point number internally: starting at 0, if first Point number is not set explicitly. increment by 1 In case you set Point number explicitly please keep it consistent: Point numbers need to be >= 0 Point numbers need to be ascending Point eventClass CmpDNP3.IEC_TMWDEFS_CLASS_MASK CmpDNP3.TMWDEFS.TMWDEFS_CLASS_MASK_ONE The initial event class - configuration, no changes accepted if Outstation is enabled Operational event class may be changed by a master. Point eventMode CmpDNP3.IEC_TMWDEFS_EVENT_MODE CmpDNP3.IEC_TMWDEFS_EVENT_MODE.TMWDEFS_EVENT_MODE_SOE The event mode - configuration, no changes accepted if Outstation is enabled Only used if the sampling rate is set within the outstation configuration. Point
AnalogOutput (FB) ¶ FUNCTION_BLOCK AnalogOutput EXTENDS PointWithFlags DNP3 data point of type Analog Output. DNP3 Analog Output provides the option to use certain data types to represent the value (using AnyNumber): SINT (8bit -128 .. 127) USINT (16bit 0 .. 255) INT (16bit -32768 .. 32767) UINT (16bit 0 .. 65535) DINT (32bit -2147483648 .. 2147483647) UDINT (32bit 0 .. 4294967295) REAL DOUBLE Any one of the types listed can be used for value, lowLimit, highLimit and deadBand, all variables have to be of same base type. Please be aware: AnyNumber provides a value representation as well as a POINTER TO value representation. InOut: Scope Name Type Initial Comment Inherited from Input description STRING Description of the data point - configuration, no changes accepted if Outstation is enabled Point number INT -1 Point number - can be set if needed to either: start with Point number > 0 have gaps in Point numbers If set to -1 (the default) the OutstationDataModel (more precisely the related “Group”) takes care to set the Point number internally: starting at 0, if first Point number is not set explicitly. increment by 1 In case you set Point number explicitly please keep it consistent: Point numbers need to be >= 0 Point numbers need to be ascending Point eventClass CmpDNP3.IEC_TMWDEFS_CLASS_MASK CmpDNP3.TMWDEFS.TMWDEFS_CLASS_MASK_ONE The initial event class - configuration, no changes accepted if Outstation is enabled Operational event class may be changed by a master. Point eventMode CmpDNP3.IEC_TMWDEFS_EVENT_MODE CmpDNP3.IEC_TMWDEFS_EVENT_MODE.TMWDEFS_EVENT_MODE_SOE The event mode - configuration, no changes accepted if Outstation is enabled Only used if the sampling rate is set within the outstation configuration. Point flags BYTE CmpDNP3.DNPDEFS.DNPDEFS_DBAS_FLAG_ON_LINE Flags used by the point. Can be changed in case a point goes offline or any other error. If set to 0, the variation without flags will be used by DNP3 PointWithFlags value AnyNumber The value to operate with. lowLimit AnyNumber The low limit to operate with - default is -INF highLimit AnyNumber The high limit to operate with - default is +INF. deadBand AnyNumber The deadband to operate with - default is 1.0.
BinaryCounter (FB) ¶ FUNCTION_BLOCK BinaryCounter EXTENDS PointWithFlags DNP3 data point of type Binary Counter. InOut: Scope Name Type Initial Comment Inherited from Input description STRING Description of the data point - configuration, no changes accepted if Outstation is enabled Point number INT -1 Point number - can be set if needed to either: start with Point number > 0 have gaps in Point numbers If set to -1 (the default) the OutstationDataModel (more precisely the related “Group”) takes care to set the Point number internally: starting at 0, if first Point number is not set explicitly. increment by 1 In case you set Point number explicitly please keep it consistent: Point numbers need to be >= 0 Point numbers need to be ascending Point eventClass CmpDNP3.IEC_TMWDEFS_CLASS_MASK CmpDNP3.TMWDEFS.TMWDEFS_CLASS_MASK_ONE The initial event class - configuration, no changes accepted if Outstation is enabled Operational event class may be changed by a master. Point eventMode CmpDNP3.IEC_TMWDEFS_EVENT_MODE CmpDNP3.IEC_TMWDEFS_EVENT_MODE.TMWDEFS_EVENT_MODE_SOE The event mode - configuration, no changes accepted if Outstation is enabled Only used if the sampling rate is set within the outstation configuration. Point flags BYTE CmpDNP3.DNPDEFS.DNPDEFS_DBAS_FLAG_ON_LINE Flags used by the point. Can be changed in case a point goes offline or any other error. If set to 0, the variation without flags will be used by DNP3 PointWithFlags value AnyNumber Pointer to value to operate with.
GroupDoubleBitInputs (FB) ¶ FUNCTION_BLOCK GroupDoubleBitInputs EXTENDS GroupDoubleBitInputsBase Group of data points of type Double Bit Input. InOut: Scope Name Type Comment Inherited from Output itfGroup IGroupDoubleBitInputs GroupDoubleBitInputsBase Input aPoints POINTER TO DoubleBitInput Pointer to array of DoubleBitInput uiNumPoints UINT Number of Points
GroupFrozenCounters (FB) ¶ FUNCTION_BLOCK GroupFrozenCounters EXTENDS GroupFrozenCountersBase Group of data points of type Frozen Counter. InOut: Scope Name Type Comment Inherited from Output itfGroup IGroupFrozenCounters GroupFrozenCountersBase Input aPoints POINTER TO FrozenCounter Pointer to array of FrozenCounter uiNumPoints UINT Number of Points
Outstation ¶ ETHdeviceHelper (FunctionBlock) Outstation (FunctionBlock) IdToString (Method) Name (Property) OutstationConfiguration (FunctionBlock) GetEnableUnsolicitedResponses (Method) OutstationConfigurationCOM (FunctionBlock) OutstationConfigurationIP (FunctionBlock) OutstationDataModel (FunctionBlock)
ETHdeviceHelper (FB) ¶ FUNCTION_BLOCK ETHdeviceHelper ETHdeviceHelper provides application support to use a CODESYS Ethernet adapter in conjunction with OutstationConfigurationIP .localIP. Place an ETHdeviceHelper underneath a CODESYS Ethernet adapter within the CODESYS device tree. Configure the CODESYS Ethernet adapter acordingly and assign ETHdeviceHelper.IPaddress to OutstationConfigurationIP.localIP if/when appropriate. ETHdeviceHelper allows to check: if there is a valid IP if configured IP (of related CODESYS Ethernet adapter) equals actual IP This information can be used to enable / disable an Outstation accordingly. InOut: Scope Name Type Initial Comment Input xCheckIPasConfigured BOOL FALSE Check, if the actual IP equals configured IP - in case not set xError. Output xError BOOL Error - no valid Ethernet adapter selected or invalid configuration xIPaddressValid BOOL The Ethernet adapter does have a valid IP address. IPaddress STRING Actual IP address of Ethernet adapter
Outstation (FB) ¶ FUNCTION_BLOCK Outstation IMPLEMENTS IOutstation Function block representing a DNP3 outstation. An Outstation needs to be configured regarding its data model (data points and there type/variation etc.) communication (TCP vs. serial) Outstation data points of same type are grouped in a data point group. Data point groups needed for a specific Outstation do specify the OutstationDataModel which is connected to Outstation input dataModel. A specific OutstationConfiguration (actually either OutstationConfigurationIP or OutstationConfigurationCOM ) is also connected to Outstation input configuration. If the Outstation is enabled, the dataModel and the configuration is checked for consistency. InOut: Scope Name Type Initial Comment Input xEnable BOOL Enables the Outstation. The data model and the configuration is checked, in case of errors, xError / eErrorID is set accordingly, otherwise xBusy is set to TRUE dataModel IOutstationDataModel _nullDataModel Outstation data model - configuration, no changes accepted if Outstation is enabled configuration IOutstationConfiguration _nullConfiguration Outstation configuration - no changes accepted if Outstation is enabled udiLogOptions UDINT LoggingOptions.None LoggingOptions can be combined using OR Output xBusy BOOL The Outstation is operational. xError BOOL An error occured. eErrorID Error The specific error. Properties: Name Methods: IdToString Structure: IdToString (Method) Name (Property)
OutstationConfiguration (FB) ¶ FUNCTION_BLOCK ABSTRACT OutstationConfiguration IMPLEMENTS IOutstationConfiguration Function block representing an Outstation configuration. InOut: Scope Name Type Initial Comment Input address UINT 0 The outstation address. name STRING The outstation name. validateMaster BOOL FALSE Validate the master address. This allows only the master with “masterAddress” a connection. masterAddress UINT 0 The master address which is allowed to connect. samplingRate TIME TIME#1s0ms The time difference between two samples of the data points. enableUnsolicitedResponse BOOL FALSE Enable or disable the unsolicited responses. If disabled the client will not be able to enable them. Methods: GetEnableUnsolicitedResponses Structure: GetEnableUnsolicitedResponses (Method)