Usage Of Parameter <Eodflag - Multi-Tech MultiModem EDGE Reference Manual

• CTRL-Z ("\x1a") terminates the input,
• ESC ("\x1b") aborts the command. An <eodFlag> is ignored in this case.
The V.25 command ATE also controls the echo mode of the interactive text mode. If echo is enabled (ATE1)
all characters are echoed until <cnfWrite-Length> is reached. Any attempt to input further data ends up with
the warning message 4001 indicated after the data stream has been completed with CTRL-Z, nevertheless
all data within the range of <cnfWriteLength> will be sent. See also Section 10.13, Internet Service URC
"^SIS". ATE0 disables the echo mode generally.
<optServParm>
Service specific parameter of the AT^SISW write command. If the Socket service is configured as UDP
endpoint this parameter is mandatory and specifies the IP address (in dotted format) and the UDP port of
the remote host. For each write request another IP address and UDP port may be given.
<cnfWriteLength>
0...1500 Confirmed number of data bytes which can be transmitted via the Internet service configured in
<srvProfileId>. In binary mode (see <mode>) this number may be less or equal to the value
requested with <reqWriteLength>.
The application has to deliver exactly the number of bytes indicated by <cnf-WriteLength>. A 0
value means that no data can be written at this time; i.e., it serves as a flow control
mechanism.
In interactive text mode, <cnfWriteLength> indicates the maximum number of bytes it can
process. Characters above the indicated number are ignored.
<unackData>
Number of data bytes already sent but not yet acknowledged at the TCP layer.
The value is constantly changing until the entire upload job has completed. If the value equals 0 all data sent
so far is acknowledged.
In binary mode, <unackData> includes the <cnfWriteLength> value of the pending write operation.
Therefore, the very first write operation of an upload job returns identical values for <cnfWriteLength> and
<unackData>.
This mechanism allows the host application to easily verify whether or not the remote host has successfully
received the data.
Parameter is not applicable to HTTP, POP3, SMTP and Socket with UDP protocol. For these services the
counter is always set to 0.
<urcCauseId>
1 The service is ready to accept new user data.
2 Data transfer has been finished successfully, and Internet service may be closed without loss
of data.
Notes
•
The AT^SISW write command must be terminated only with the ASCII character set with ATS3. The factory
default for S3 is #13 (Carriage Return). Do not send any further characters after the S3 end-of-line identifier, until
the response "^SISW" is received. This is necessary to avoid that any characters related to the AT command can
be interpreted as being part of the data stream to be transferred. Also refer to Section 1.4, AT Command Syntax.
•
If the Socket service is configured for use as UDP client and fixed size and the interactive text mode is active, the
PDU length always equals the specified fixed length. If the input characters exceed the specified fixed length,
then all surplus characters will be ignored. If the input characters are less than the specified fixed length, then the
remaining range will be filled with "\0" bytes.
10.8.1 Usage of Parameter <eodFlag>
Service Type
Socket After the service accepts the end-of-data flag the service state changes to "Closing". No further
user data is accepted.
After releasing the TCP link the service remains in state "Down".
Parameter is not applicable to Socket with UDP protocol, i.e. value is ignored.
FTP Parameter only applicable for FTP upload session.
After the service accepts the end-of-data flag the service state changes to "Closing" and starts to
end the running FTP session. No further user data is accepted
After the FTP session is completed on FTP protocol level the service state switches to "Down".
In case of successful completion the URC "^SISW: x,2" is generated.
SMTP SMTP service sends some "closing" commands to the SMTP server which are necessary to mark
the email as successfully sent on the server. The service enters "Closing" state and remains in it
until the final protocol exchange with the SMTP server has been completed.
The "OK" response following AT^SISW indicates that the SMTP service has accepted the last data
– IT DOES NOT indicate the successful completion of the SMTP service.
Successful completion will be indicated either by the appropriate URC "^SISW:x,2" or due to the
fact that the SMTP service state changes to "Down" state without any error.
HTTP/POP3 Parameter not applicable, i.e. value is ignored.
Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371G)
Chapter 10 – Internet Service Commands
153