Specifications
Chapter 10 – Internet Service Commands
Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B) 135
<socketState>
Socket state identifier.
1 Socket not assigned; i.e., no TCP/UDP connection active.
2 Socket assigned as CLIENT.
3 Socket assigned as LISTENER.
4 Socket assigned as SERVER.
<rxCount>
Number of bytes received via AT^SISR since last successful AT^SISO write command.
<txCount>
Number of bytes sent via AT^SISW since last successful AT^SISO write command.
<locAddr>
Local IP address in dotted-four-byte format and TCP port, separated by colon; e.g., “192.60.10.10:80”.
<remAddr>
Remote IP address in dotted-four-byte format or evaluated DNS name and TCP port, separated by colon; e.g.,
“192.60.10.10:80”.
<urcCause>
URC cause identifier.
0 An error has occurred after opening or while using an Internet service.
Error number is presented via <urcInfoId>, optionally additional information may be
supplied via <urcInfoText>.
1 Indicates that an open socket listener service is receiving a connection request from a
remote client.
The incoming socket connection is dynamically assigned to the next free Internet
service profile. In this case, the parameter <urcInfoId> inside the “^SIS”
URC equals the <srvProfileId> of the dynamically assigned service profile.
This ID shall be used to accept the connection request with AT^SISO or to
reject it with AT^SISC.
The connection status may be requested by using the AT^SISO read command.
Among other details, the response indicates the IP address of the
remote client (parameter <remAddr>). This may be helpful to decide whether
to accept or reject the request.
2 Incoming Socket service client connection has failed.
The client request was rejected automatically because no free Internet service profile
was available.
3 HTTP only: Indicates that the message delivered by the "^SIS" URC is provided for
information only, it is not an error. For details refer to Info URCs in Section 10.7.3, URC
Information Elements Related to HTTP Service.
Example: ^SIS: 2, 3, 2200, "HTTP Redirect to:192.168.1.3:800//products/info/"
<urcInfoId>
Information identifier related to <urcCause>.
See Section 10.7, Information Elements Related to Internet Service URCs for further detail. As stated above, if a
Socket connection request from a remote client is received the <urcInfoId> equals the <srvProfileId> of the
dynamically assigned free service profile.
<urcInfoText>
Information text related to <urcCause>. See Section 10.7, Info. Elements Related to Internet Service URCs.
10.3.1 Example: Accepting/Rejecting Socket Connection Request from Remote
Client
Host 1 configured as Socket listener with IP address 10.10.0.187 at port 65534 is receiving a connection request from
the remote client 10.10.0.185 (at port 1024). The example assumes that connection and service profiles have been
created as stated earlier.
Start the Socket service in listener mode, then query the IP address dynamically assigned to the Socket listener:
at^siso=4 Host 1 opens the Socket service.
at^siso? Query the current status of all services. All service profiles are unused,
except for service profile 4 which is running in listener mode, where
<srvState>=3 (listening) and <socketState>=3 (LISTENER). The
response also indicates the IP address dynamically assigned to the
listener. The listener’s access data (IP address and TCP port number)
shall be passed on to the client.
^SISO: 0, “”
^SISO: 1, “”
^SISO: 2, “”
^SISO: 3, “”
^SISO: 4, “Socket”,”3”,”3”,”0”,”0”,”10.10.0.187:65534”,”0.0.0.0:0”
^SISO: 6, “”
^SISO: 7, “”
^SISO: 8, “”^SISO: 9, “”
OK