Telit Cinterion IoT Developer Community
Concept Board: Internet Services - Transparent Socket
Tutorial, August 6, 2014 - 2:50pm, 12429 views
This is part of tutorial series for Internet Services usage on Gemalto Concept Board:
- Concept Board: Internet Services - basics
- Concept Board: Internet Services - HTTP
- Concept Board: Internet Services - Transparent Socket
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.
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