Siemens MC55 AT manual EodFlagnum, ReqWriteLength, CnfWriteLength num

Models: MC55 AT

1 475
Download 475 pages 54.64 Kb
Page 249
Image 249

If Socket service is selected with UDP protocol

-<reqWriteLength>=0 can be used to send an empty UDP packet;

-the maximum requestable write size specified via <reqWriteLength> is limited to 1460 bytes. Any attempt to write more bytes will be denied and causes the following URC to appear: "^SIS: <id>, 0, 9, The supplied buffer was too small / large".

<eodFlag>(num)

End of data indication flag.

Parameter is ignored for HTTP.

[0]

No end of data. Other data may follow to be transmitted via the Internet service.

1

End of data is signalled to the Internet Service. Further AT^SISW write com-

 

mands return an error response. However, reading data may be possible. The

 

<eodFlag> is effective only if the <reqWriteLength> equals <cnfWrite-

 

Length>, in particular if the <reqWriteLength> equals 0.

 

If <mode> equals 1 the <eodFlag> is effective only if the write operation has

 

been finished with CTRL-Z.

<mode>(num)

Control how the application provides the data bytes to be sent.

[0]

Binary mode

 

This mode allows sending a number of bytes defined with parameter

 

<reqWriteLength>.

1

Interactive text mode

 

This mode allows the user to type and send 8-bit ASCII characters while the

 

service is open. Ctrl-Z terminates data input and causes the data to be trans-

 

ferred.

 

Interactive text mode requires that the <reqWriteLength> is set to any value

 

greater than 0 (though it is not necessary to specify the precise number of

 

bytes). In this case the <cnfWriteLength> parameter indicates the maxi-

 

mum length of the data stream without control character CTRL-Z. The

 

<txCount> counter is incremented only by the portion of data actually trans-

 

mitted.

 

In interactive text mode, the following characters are defined as control codes:

 

• BACKSPACE ("\x08") deletes the last given character,

 

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 warn-

 

ing 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.10, Internet Service URC "^SIS". ATE0 disables the

 

echo mode generally.

 

 

<cnfWriteLength>(num)

 

0...1500

Confirmed number of data bytes which can be transmitted via the Internet ser-

 

vice configured in <srvProfileId>. In binary mode (see <mode>) this num-

 

ber 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.

MC55_ATC_V04.00

Page 249 of 475

3/17/06

Confidential / Released

 

 

Page 249
Image 249
Siemens MC55 AT manual EodFlagnum, ReqWriteLength, CnfWriteLength num