Siemens TC65 manual Sending an AT Command to the Device, the send Method, Data Connections

TC65 JAVA User's Guide

Strictly confidential / Released

s

12.1.1.2Sending an AT Command to the Device, the send() Method

An AT command is sent to the device by using the send() method. The AT command is sent as a string which must include the finalizing line feed "\r" or the corresponding line end character.

String response = atc.send(“at+cpin?\r”);

/* method returns when the module returns a response */ System.out.println(response);

Possible response printed to System.out:

+CPIN: READY OK

This send function is a blocking call, which means that the calling thread will be interrupted until the module returns a response. The function returns the response, the result code of the AT command, as a string.

Occasionally it may be infeasible to wait for an AT command that requires some time to be processed, such as at+cops?. There is a second, non-blocking, send function which takes a second parameter in addition to the AT command. This second parameter is a callback instance, ATCommandResponseListener. Any response to the AT command is delivered to the callback instance when it becomes available. The method itself returns immediately. The ATCommandResponseListener and the non-blocking send method are described in Section 12.1.2.

Note: Using the send methods with strings with incorrect AT command syntax will cause errors.

12.1.1.3Data Connections

If a data connection is created with the ATCommand class, for instance with ‘atd’, an input stream is opened to receive the data from the connection. Similarly, an output stream can be opened to send data on the connection.

/* Please note that this example would not work unless the module had * been initialized and logged into a network. */

System.out.println("Dialing: ATD" + CALLED_NO); response = atc.send("ATD" + CALLED_NO + "\r"); System.out.println("received: " + response);

if (response.indexOf("CONNECT") >= 0) { try {

//We have a data connection, now we do some streaming...

//IOException will be thrown if any of the Stream methods fail OutputStream dataOut = ATCmd.getDataOutputStream(); InputStream dataIn = ATCmd.getDataInputStream();

//out streaming...

dataOut.write(new String("\n\rHello world\n\r").getBytes()); dataOut.write(new String("\n\rThis data was sent by a Java " +

"MIDlet!\n\r").getBytes()); dataOut.write(new String("Press 'Q' to close the " +

"connection\n\r").getBytes());

// ...and in streaming

System.out.println("Waiting for incoming data, currently " + dataIn.available() + " bytes in buffer.");

rcv = 0;

TC65 JAVA User's Guide_V05 Page 83 of 90 26.09.2005