User manual

Toolbox 32 User Manual 1.47d www.cse-semaphore.com/mykingfisher
Page
272
Communication Statistics
#YPERRnn
Port error. 1=Error. For GPRS, 0=modem initialised successfully
Read
#YPINACnn
(0-60,000) Inactivity Timer. The number of seconds since the last valid message
received on port nn. If the timer reaches 60,000 seconds it will stop incrementing.
Read
#YPRTUnn
Online RTU address (for PSTN). Returns the RTU address (1-249) of the remote
RTU that the local RTU is currently connected to via PSTN.
For GPS_NMEA protocol (for a GPS device), used to set which network registers
store the GPS information. Eg if #YPRTU2 is set to 5, the GPS information will be
stored in the network registers for RTU5 ie #NR5.xx. Please refer to the
GPS_NMEA protocol document for more information.
Read
#YPRXCnn
Received Characters. The number of unread bytes/characters currently in the
receive buffer of port nn. This parameter is used with the Rx User ladder block to
determine when to read the port buffer.
Read
#YPSIGnn
(0-65535) Signal strength. Device dependent.
For GPRS, returns the signal strength and quality as a single number -
Result=Signal strength x 100 + Signal quality. Eg. If #YPSIGnn=1204 (decimal),
then the signal strength is 12 and the signal quality is 4. Note: 65535 = invalid
response.
Read
#YPSTnn.cc
Port status
Ch1 Reserved
Ch2
1 = Message waiting for a reply on port nn. Used to check that a port is
free before initiating a new message from that port. Please see the topic
Example – Sending the Exception Report.
Read
Ch3 1 = Port online (PSTN modem and TMR only). Please see the topic
Configuration, Port List, Pre Tx for more information.
Read
Ch4 1 = Off Hook (TMR only)
Read
Ch5 1 = Calling / incoming call (TMR only)
Read
Ch6 1 = In Service (TMR, Mobitex radio and GPRS only)
For GPRS, 1=modem connected to the network in listen mode.
Read
Ch7 1 = Link Active (Ethernet T option board, TMR, Mobitex & DV1000 only).
Note: supported by Ethernet T option boards version 1.1 and newer (port
is labeled E'NET-T 1.1).
Read
Ch8
1 = Last Dial Failed. Only applicable to PSTN. Set whenever a dial fails on
the port and remains set until a dial is successful on the port. Last Dial
Failed is cleared after a warm start.
Read
Ch9
1 = Block message pending. A block message generates other child
messages to retrieve the information required. A block message can
generate hu
ndreds of child messages and be active for minutes. The block
message bit is set while the block message is still in progress. If a block
message has multiple target RTUs then the block message pending bit is
referenced to the port (and RTU address) of the first RTU in the list. It is
recommended that only one block message be initiated at any one time.
This prevents overloading of the message buffer and prevents the RTU
toggling between the child messages of the block messages. While a
block message is in progress, the child messages still cause the message
pending bits for the port and network link to be set and reset.
Read
Ch10 1 = Port error (Mobitex radio only)
Read
Ch11 1= Initialise GPRS modem.
Write
Ch12 0 = Use fixed UDP destination port based on port protocol [default]
1 = Use dynamic UDP destination port. Required when using Citect 6.x+.
Note: this parameter is not supported by MC-10/11 Ethernet ports.
Read/Write
Ch14 1= CTS Active. Eg: The CTS pin on the port can be wired to the ring
indicator on a modem to monitor an incoming call.
Read
Ch15 Character error. RTU use only
Read
Ch16 1 = Data Carrier Detected
Read