Thales' cellular IoT products business is now part of Telit Cinterion, find out more.

You are here

Telit Cinterion IoT Developer Community

Concept Board: Internet Services - Transparent Socket

Tutorial, August 6, 2014 - 2:50pm, 12948 views

This is part of tutorial series for Internet Services usage on Gemalto Concept Board:

General overview

EHS6 offers Transparent Internet Service to be used over AT command interface. With the usage of the service the modem can operate as tunnelling device that passes all incoming data to remote TCP or UDP server.

Configuring of Internet Service

For tutorial purpose an Internet Service will be created under service profile id equal 1. Let's assume that Internet Connection has already been configured under connection profile id equal 0.

First set service type using following command:

AT^SISS=1,"srvType","Transparent"

Then assign the service to previously created connection profile:

AT^SISS=1,"conId",0

Depending on used protocol configure the address:

Configuration of Transparent TCP Socket

Configure the address with port and supply <etxChar> parameter which is decimal-coded ASCII escape character used for passing from transparent to AT command mode. For example if SUB character (ctrl+z) is to be used to leave transparent mode <etxChar> must be set to 26.

AT^SISS=1,"address","socktcp://<address>:<port>;etx=<etxChar>"

No further configuration is needed.

Configuration of Transparent UDP Socket

Configure the address with port and supply <etxChar> parameter - see desciption above.

AT^SISS=1,"address","sockudp://<address>:<port>;etx=<etxChar>"

No further configuration is needed.

Check the documentation for additional configuration options.

Opening the service

If configuration is complete the service may be open with:

AT^SISO=1

After above command is invoked ^SISW: 0,1 should appear indicating the module is ready to accept the data.

Passing to transparent mode

To pass to transparent mode enter the command:

AT^SIST=1

After that CONNECT should appear indicating the module passed to transparent mode. From this moment all the data sent to this interface is transmitted to the server.

Leaving transparent mode and closing the service

There are three ways to leave transparent mode and pass back to AT command mode:

1. Entering <etxChar>

2. Entering escape sequence consisting of three pluses (+++)

3. Toggling DTR line if AT&D is configured to 1 or 2

Please notice that after leaving transparent mode the service remains open and can be entered again with AT^SIST. To close the service use this command:

AT^SISC=1

Examples

Please take a look at following example AT command logs from Transparent Services usage:

Transparent TCP Socket

at^sics=0,"conType","gprs0"

OK

at^sics=0,"apn","internet"

OK

at^siss=1,"srvType","Transparent"

OK

at^siss=1,"conId","0"

OK

at^siss=1,"address","socktcp://123.123.123:123;etx=26"

OK

at^siso=1

OK

^SISW: 1,1

at^sist=1

CONNECT

echo test 1

OK <-- leaving with ctrl+z

at^sist=1

CONNECT

echo test 2

OK <-- leaving with toggling DTR

at^sist=1

CONNECT

echo test 3

OK <-- leaving with +++ escape sequence

at^sisc=1

OK

Transparent UDP Socket

at^sics=0,"conType","gprs0"

OK

at^sics=0,"apn","internet"

OK

at^siss=1,"srvType","Transparent"

OK

at^siss=1,"conId","0"

OK

at^siss=1,"address","sockudp://123.123.123.123:123;etx=47"

OK

at^siso=1

OK

^SISW: 1,1

at^sist=1

CONNECT

echo test

OK <-- leaving with /

at^sisc=1

OK

Summary

As you can see, you can setup the module to work in as transparent socket client with only few AT commands. Remember that for other Gemalto products the usage may vary. Feel free to check refer to product documentation for details.

A very good and straightforward example. Do you know any free to use test servers in the internet? Many customers would like to test the hw/sw against a server they don't need to set up and program. Another good example would be transparent communication between two boards...

Antero Markkula
Communication and Mechatronics

Enkom Active Oy – www.enkom-active.fi
Upseerinkatu 3 A, 02600 Espoo, Finland
Mobile: +358 400 411368
Office: +358 10 204 0000
Fax: +358 10 204 0010
E-mail: antero.markkula@enkom-active.fi

You might be interested in HTTPBin - http://httpbin.org. You can use it for HTTP service testing.
There are lot's of tools to install over the Internet, but don't know any free to use working online server. If you have public IP SIM card you can setup dial-up connection on PC and run echo server app. Regards Jedrzej

Author

Jędrzej Gemalto Moderator's picture
Jędrzej Gemalto Moderator