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
}
Any 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: