DNP

Description:           Returns an instance of a DNP3 Driver

Returns:                    Object

Usage:                       Script

Format:                 Driver = DNP(PortNum, Baud, Parity, DataBits, StopBits, TimeLim, Retries, Hold, Echo, RTSKeying, KeyUpDelay, Addr8250, IRQ, KeyOffDelay, SRCAddr, ExternalPort, MasterStation, DataLinkConfirm, Class1Disable, Class2Disable, Class3Disable, MsgFailTime)

Parameters:          PortNum     { numeric }  { required }  { no default }
          Any numeric expression which defines the serial port.  The default is 1.

                             Baud     { numeric }  { required }  { no default }
          Any numeric expression giving the baud rate.  Baud must be in the range 10 to 57600, and must divide evenly into 115200 with no more than 2.5% error.

                             Parity     { numeric }  { required }  { no default }
          Any numeric expression giving the parity checking to use:

 

Parity

Checking

0

No parity

1

Odd parity

2

Even parity

3

0 Stick (space parity)

4

1 Stick (mark parity)

                             DataBits     { numeric }  { required }  { no default }
          Any numeric expression giving the number of data bits per character.  DataBits must be 5, 6, 7, or 8.

                             StopBits      { numeric }  { required }  { no default }
          Any numeric expression giving the number of stop bits per character.  StopBits must be 1 or 2.

                             TimeLim     { numeric }  { required }  { no default }
          Any numeric expression giving the waiting time in seconds to allow for a response from the outstation.

                             Retries      { numeric }  { required }  { no default }
          The number of additional attempts to be made after a communications error.

                             Hold      { Boolean }  { required }  { no default }
          Any numeric expression.  If true, data read from the outstation will be held at the last value read before an error.  If false, data will be invalidated on error.

                             Echo     { Boolean }  { required }  { no default }
          Any numeric expression which if true sets the local error option.  Echo is set to true when a local echo is present, and all data transmitted is also received.

                             RTSKeying     { Boolean }  { required }  { no default }
          Any numeric expression which enables RTS keying.  When true, the RTS keying parameter sets the RTS line to its active state when transmitting data and to its inactive state when not transmitting data.

                             KeyUpDelay     { numeric }  { required }  { no default }
          Any numeric expression which sets the time in seconds between when the RTS line goes to its active state and when the data transmission starts.  This parameter is only used when the RTSKeying parameter is true.

                             Addr8250 is not required for the 32-bit version, but is maintained for backward compatibility with previous versions of WEB; set to 0.

                             For Windows for Workgroups, (16-bit WEB) this is any variable or constant giving the absolute I/O address of a type 8250 UART chip to be used for serial port control.  For the IBM PC the standard addresses for COM1 and COM2 are 0x3F8 and 0x2F8 respectively.

                             IRQ  is not required for the 32-bit version, but is maintained for backward compatibility with previous versions of WEB; set to 0.

                             For Windows for Workgroups, (16-bit WEB) this is any variable or constant in the range of 1 - 15 giving the IRQ (interrupt) number for the port.  For the IBM PC, the standard values for COM1 and COM2 are 4 and 3 respectively.

                             KeyOffDelay     { numeric }  { required }  { no default }
          Any numeric expression which sets the time in seconds between when the data transmission ends and the RTS line goes to its inactive state.  This parameter is only used when the RTSKeying parameter is true.

                             SRCAddr      { numeric }  { required }  { no default }
          A
ny numeric expression which sets the DNP station number of the Web driver.

                             ExternalPort      { object }  { required }  { no default }
           
Object value of external port.

                             MasterStation      { Boolean }  { required }  { no default }
          Any numeric expression which if true, causes the Web driver to assume the role of a DNP master.

                             DataLinkConfirm      { Boolean }  { required }  { no default }
          Any numeric expression which if true, causes the Web driver to require that all data link layer data messages are confirmed by the outstation.

                             Class1Disable      { Boolean }  { required }  { no default }
          Any numeric expression which if true, causes the Web driver to ignore the class 1 data available flag in responses from the outstation.

                             Class2Disable      { Boolean }  { required }  { no default }
          Any numeric expression which if true, causes the Web driver to ignore the class 2 data available flag in responses from the outstation.

                             Class3Disable      { Boolean }  { required }  { no default }
          Any numeric expression which if true, causes the Web driver to ignore the class 3 data available flag in responses from the outstation.

                             MsgFailTime      { numeric }  { required }  { no default }
          Any numeric expression which sets the time in seconds that a read request which receives an error response from the outstation will wait for before attempting the read request again.

 

Topics in this section:

DNP Module Information

DNP3 Driver: Read Function

DNP3 Driver: Write Function

DNP Driver - VTS Layer

DNP I/O Addressing in VTS