AT Command Reference Guide for EDGE Wireless ... - wless.ru
AT Command Reference Guide for EDGE Wireless ... - wless.ru
AT Command Reference Guide for EDGE Wireless ... - wless.ru
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Chapter 10 – Internet Service <strong>Command</strong>s<br />
10.5 <strong>AT</strong>^SISR Internet Service Read Data<br />
Description:<br />
Test <strong>Command</strong> Syntax:<br />
Response:<br />
Write <strong>Command</strong> Syntax:<br />
Response:<br />
Unsolicited Result Code:<br />
<strong>AT</strong>^SISR write command triggers reading data via the Internet service configured with<br />
<strong>AT</strong>^SISS.<br />
The Multi-Tech <strong>Wireless</strong> <strong>EDGE</strong> modem returns the amount of data which can be<br />
transferred:<br />
• value equal 0 indicates that the Multi-Tech <strong>Wireless</strong> <strong>EDGE</strong> modem<br />
failed to enter online data mode. Details about the cause of failure is available using<br />
<strong>AT</strong>+CEER.<br />
• value greater than 0 indicates that the Multi-Tech <strong>Wireless</strong> <strong>EDGE</strong><br />
modem switches into online data mode to transfer the given number of bytes.<br />
A URC “^SISR: , [, ]" will be issued<br />
if<br />
• data is available after opening an Internet service or<br />
• less data was confirmed (in ) than requested (with<br />
) during the last “Read Data” operation and new data is available.<br />
This mechanism eliminates the need to poll <strong>for</strong> fresh data and frees the TA <strong>for</strong> other tasks.<br />
<strong>AT</strong>^SISR=<br />
OK<br />
<strong>AT</strong>^SISR=, <br />
^SISR: , Number of data bytes are sent as specified by<br />
<br />
OK<br />
ERROR<br />
+CME ERROR: <br />
^SISR: , [, ]<br />
Data availability status of the Internet service configured with <strong>AT</strong>^SISS has changed.<br />
Parameter Descriptions:<br />
<br />
0 ... 9 specified with <strong>AT</strong>^SISS.<br />
<br />
Requested number of data bytes to be read via the Internet service configured in .<br />
1...1500<br />
<br />
Confirmed number of data bytes to be read via the Internet service configured <strong>AT</strong>^SISS. This number may be<br />
less or equal to the value requested with . 0 value indicates that no data can be read.<br />
<br />
Indicates whether or not data is available <strong>for</strong> reading with <strong>AT</strong>^SISR.<br />
0 No data available <strong>for</strong> reading<br />
1 New data is available and can be read by sending <strong>AT</strong>^SISR. While the service is open, this URC appears<br />
each time when new data is available again. This eliminates the need to poll <strong>for</strong> fresh data.<br />
2 Data transfer has been finished (all data read) and the service can be closed with <strong>AT</strong>^SISC.<br />
.<br />
Optional third parameter of the "^SISR" URC displayed only if the Socket service uses UDP.<br />
The UDP protocol requires that data are received in the same order that they were sent from the remote host.<br />
Consequently, the reception of each datagram must be completed be<strong>for</strong>e the next datagram can be received.<br />
This may be a problem if the buffer of the host application is limited and not designed to handle the maximum<br />
packet size of 1500 bytes. To compensate this, the host is advised to request, via , an amount<br />
less or equal its maxmimum buffer capacity and wait <strong>for</strong> the resulting "^SISR" URC with parameter<br />
. The benefit of this approach is that the host may properly receive all parts of a UDP<br />
datagram, as after each received data part the number of remaining bytes is synchronized, until reading the<br />
datagram is finished.<br />
If the currently read datagram is smaller than the number of bytes requested by the host the<br />
parameter is omitted.<br />
0 Indicates that all bytes of the current UDP datagram are read.<br />
1...(max. data size)-1<br />
Indicates that the currently read UDP datagram is not yet complete. The displayed value<br />
is the remaining number of bytes.<br />
is unequal 0 until reading all parts of the current datagram<br />
is finished.<br />
Multi-Tech Systems, Inc. <strong>AT</strong> <strong>Command</strong>s <strong>for</strong> <strong>EDGE</strong> Modems (S000371B) 138