Telit Wireless Solutions GS2101M Series Operating manual

GS2101M
IP2WiFi Adapter Command
Reference Guide
1VV0301499 Rev. 2.0 – 2019-08-05

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 2 2019-08-05
SPECIFICATIONS ARE SUBJECT TO CHANGE WITHOUT NOTICE
NOTICE
While reasonable efforts have been made to assure the accuracy of this document, Telit
assumes no liability resulting from any inaccuracies or omissions in this document, or from
use of the information obtained herein. The information in this document has been carefully
checked and is believed to be reliable. However, no responsibility is assumed for inaccuracies
or omissions. Telit reserves the right to make changes to any products described herein and
reserves the right to revise this document and to make changes from time to time in content
hereof with no obligation to notify any person of revisions or changes. Telit does not assume
any liability arising out of the application or use of any product, software, or circuit described
herein; neither does it convey license under its patent rights or the rights of others.
It is possible that this publication may contain references to, or information about Telit
products (machines and programs), programming, or services that are not announced in your
country. Such references or information must not be construed to mean that Telit intends to
announce such Telit products, programming, or services in your country.
COPYRIGHTS
This instruction manual and the Telit products described in this instruction manual may be,
include or describe copyrighted Telit material, such as computer programs stored in
semiconductor memories or other media. Laws in the Italy and other countries preserve for
Telit and its licensors certain exclusive rights for copyrighted material, including the exclusive
right to copy, reproduce in any form, distribute and make derivative works of the copyrighted
material. Accordingly, any copyrighted material of Telit and its licensor contained herein or in
the Telit products described in this instruction manual may not be copied, reproduced,
distributed, merged or modified in any manner without the express written permission of Telit.
Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by
implication, estoppel, or otherwise, any license under the copyrights, patents or patent
applications of Telit, as arises by operation of law in the sale of a product.
COMPUTER SOFTWARE COPYRIGHTS
The Telit and 3rd Party supplied Software (SW) products described in this instruction manual
may include copyrighted Telit and other 3rd Party supplied computer programs stored in
semiconductor memories or other media. Laws in the Italy and other countries preserve for
Telit and other 3rd Party supplied SW certain exclusive rights for copyrighted computer
programs, including the exclusive right to copy or reproduce in any form the copyrighted
computer program. Accordingly, any copyrighted Telit or other 3rd Party supplied SW
computer programs contained in the Telit products described in this instruction manual may
not be copied (reverse engineered) or reproduced in any manner without the express written
permission of Telit or the 3rd Party SW supplier. Furthermore, the purchase of Telit products
shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any
license under the copyrights, patents or patent applications of Telit or other 3rd Party supplied
SW, except for the normal non-exclusive, royalty free license to use that arises by operation of
law in the sale of a product.

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 3 2019-08-05
USAGE AND DISCLOSURE RESTRICTIONS
I. License Agreements
The software described in this document is the property of Telit and its licensors. It is furnished
by express license agreement only and may be used only in accordance with the terms of
such an agreement.
II. Copyrighted Materials
Software and documentation are copyrighted materials. Making unauthorized copies is
prohibited by law. No part of the software or documentation may be reproduced, transmitted,
transcribed, stored in a retrieval system, or translated into any language or computer
language, in any form or by any means, without prior written permission of Telit
III. High Risk Materials
Components, units, or third-party products used in the product described herein are NOT
fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control
equipment in the following hazardous environments requiring fail-safe controls: the operation
of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic
Control, Life Support, or Weapons Systems (High Risk Activities”). Telit and its supplier(s)
specifically disclaim any expressed or implied warranty of fitness for such High Risk Activities.
IV. Trademarks
TELIT and the Stylized T Logo are registered in Trademark Office. All other product or service
names are the property of their respective owners.
V. Third Party Rights
The software may include Third Party Right software. In this case you agree to comply with all
terms and conditions imposed on you in respect of such separate software. In addition to
Third Party Terms, the disclaimer of warranty and limitation of liability provisions in this
License shall apply to the Third Party Right software.
TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESS OR IMPLIED FROM
ANY THIRD PARTIES REGARDING ANY SEPARATE FILES, ANY THIRD PARTY
MATERIALS INCLUDED IN THE SOFTWARE, ANY THIRD PARTY MATERIALS FROM
WHICH THE SOFTWARE IS DERIVED (COLLECTIVELY “OTHER CODE”), AND THE USE
OF ANY OR ALL THE OTHER CODE IN CONNECTION WITH THE SOFTWARE,
INCLUDING (WITHOUT LIMITATION) ANY WARRANTIES OF SATISFACTORY QUALITY
OR FITNESS FOR A PARTICULAR PURPOSE.NO THIRD PARTY LICENSORS OF OTHER
CODE SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT
LIMITATION LOST PROFITS), HOWEVER CAUSED AND WHETHER MADE UNDER
CONTRACT, TORT OR OTHER LEGAL THEORY, ARISING IN ANY WAY OUT OF THE
USE OR DISTRIBUTION OF THE OTHER CODE OR THE EXERCISE OF ANY RIGHTS
GRANTED UNDER EITHER OR BOTH THIS LICENSE AND THE LEGAL TERMS
APPLICABLE TO ANY SEPARATE FILES, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 4 2019-08-05
APPLICABILITY TABLE
PRODUCT
GS2101M
Software Release
5.8.0

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 5 2019-08-05
Table of Contents
Chapter 1 Getting Started ................................................................................................................ 18
1.1 Overview ................................................................................................................................18
1.2 Using SDK Builder ................................................................................................................. 20
1.2.1 IP-to-WiFi Module Information .....................................................................................20
Chapter 2 Architecture ..................................................................................................................... 22
2.1 Overview ................................................................................................................................22
2.2 Serial Interface ...................................................................................................................... 23
2.3 System Initialization ...............................................................................................................23
2.3.1 Profile Definition ........................................................................................................... 24
2.4 Command Processing Mode .................................................................................................25
2.5 Data Handling ........................................................................................................................ 26
2.5.1 Unsolicited/Unassociated/Beacon Mode Data Handling ..............................................27
2.5.2 Software Flow Control ..................................................................................................27
2.5.3 Hardware Flow Control ................................................................................................27
2.6 Serial Data Handling .............................................................................................................. 28
2.7 Wireless Network Management .............................................................................................29
2.7.1 Scanning ......................................................................................................................29
2.7.2 Association ...................................................................................................................29
2.7.3 SSID and Passphrase ..................................................................................................29
Chapter 3 Host Interaction ............................................................................................................... 31
3.1 Startup Handling .................................................................................................................... 32
3.1.1 Single Interface Startup Handling ................................................................................32
3.1.2 Dual Interface Startup Handling ...................................................................................33
3.2 Interface .................................................................................................................................33
3.2.1 UART ........................................................................................................................... 33
3.2.1.1 UART Parameters ............................................................................................... 33
3.2.1.2 Software Flow Control .........................................................................................35
3.2.1.3 Hardware Flow Control ........................................................................................ 36
3.2.2 SPI Interface and Configuration ...................................................................................37
3.2.2.1 SPI Byte Stuffing (Legacy SPI, SPI-NO-DMA) ....................................................38
3.2.2.2 SPI Command Response (SPI-DMA) ..................................................................39
3.2.2.3 Annexure - HI Frame Format (From Host) ...........................................................50
3.2.2.4 Annexure - HI Frame Response (From GS Node) ..............................................51
3.2.2.5 Pin Connection for SPI Interface ......................................................................... 52
3.2.3 SDIO Interface .............................................................................................................53
3.2.3.1 Capabilities ..........................................................................................................53
3.2.3.2 SDIO Host Slave Initialization and Communication .............................................54
3.2.3.3 SDIO Host Recommendations ............................................................................57
3.2.3.4 Pin Description ....................................................................................................59
3.2.4 Interface Verification ....................................................................................................59
Chapter 4 General Operations......................................................................................................... 60
4.1 Version ..................................................................................................................................60
4.2 Time Setting .......................................................................................................................... 62
4.2.1 Set System Time ..........................................................................................................62
4.2.1.1 Manual Setting .....................................................................................................62
4.2.2 Get System Time .........................................................................................................63

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 6 2019-08-05
4.3 Profile Setting ........................................................................................................................64
4.3.1 Get Profile ....................................................................................................................64
4.3.2 Save Profile ..................................................................................................................65
4.3.3 Load Profile ..................................................................................................................66
4.3.4 Select Default Profile ....................................................................................................67
4.3.5 Restore Profile ............................................................................................................. 68
4.3.6 Define Profile ................................................................................................................68
4.3.7 Identification Information ..............................................................................................70
4.3.8 Enhanced Asynchronous Notification .......................................................................... 71
4.4 Reset .....................................................................................................................................72
4.5 MAC ....................................................................................................................................... 73
4.5.1 Set MAC Address .........................................................................................................73
4.5.2 Get MAC Address ........................................................................................................75
Chapter 5 Wireless ......................................................................................................................... 76
5.1 Wireless Generic ...................................................................................................................76
5.1.1 Regulatory Domain ......................................................................................................76
5.1.1.1 Set Regulatory Domain .......................................................................................76
5.1.1.2 Get Regulatory Domain .......................................................................................77
5.1.2 Operation Mode ...........................................................................................................78
5.1.3 MAC Retry .................................................................................................................81
5.1.4 Sync Loss Interval ........................................................................................................ 83
5.1.5 Set RTS Threshold .......................................................................................................84
5.1.6 Transmit Data Rate ......................................................................................................85
5.1.6.1 Set Transmit Rate ................................................................................................85
5.1.6.2 Get Transmit Rate ...............................................................................................87
5.1.7 Graceful Shutdown of WLAN .......................................................................................88
5.1.8 SSID Hide ....................................................................................................................89
5.2 Beacon Mode (Unassociated Mode) .....................................................................................90
5.2.1 Unassociated/Unsolicited Tx ........................................................................................90
5.2.2 Unassociated/Unsolicited Rx .......................................................................................96
5.2.2.1 Examples for Unassociated/Unsolicited Tx and Rx Commands ..........................99
5.2.3 Unassociated/Unsolicited Rx Stop ...............................................................................99
5.2.4 Unassociated/Unsolicited Data Encryption ..................................................................99
5.3 Station/AP Mode ..................................................................................................................100
5.3.1 Scan Time Settings ....................................................................................................100
5.3.1.1 Set Scan Time ...................................................................................................100
5.3.1.2 Get Scan Time ...................................................................................................101
5.3.2 Authentication Mode ..................................................................................................102
5.3.3 Security Configuration ................................................................................................103
5.3.3.1 Security Setting .................................................................................................103
5.3.3.2 WEP Keys .........................................................................................................104
5.3.3.3 WEP Key Type Configuration ............................................................................105
5.3.3.4 WPA-PSK and WPA2-PSK Passphrase ............................................................107
5.3.3.5 WPA-PSK and WPA2-PSK Key Calculation ......................................................108
5.3.3.6 WPA-PSK and WPA2-PSK Key ........................................................................109
5.3.4 Scanning ....................................................................................................................111
5.3.5 Association .................................................................................................................113
5.3.6 Disassociation ............................................................................................................ 116
5.3.7 Connection Maintenance ...........................................................................................116
5.3.7.1 Keep Alive Timer ...............................................................................................116
5.3.7.2 WLAN Keep Alive Interval .................................................................................117
5.3.8 Advanced Commands ................................................................................................118
5.3.8.1 Get Client Information ........................................................................................118

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 7 2019-08-05
5.4 WiFi Direct Mode ................................................................................................................. 119
5.4.1 Set Device ..................................................................................................................119
5.4.2 Set WPS .....................................................................................................................121
5.4.3 Start Find ....................................................................................................................122
5.4.4 Stop Find ....................................................................................................................125
5.4.5 Provoke ......................................................................................................................126
5.4.6 Provision Discovery ....................................................................................................127
5.4.7 Group Form (Group Owner Negotiation) ....................................................................128
5.4.7.1 Provision Discovery Request Handling ..............................................................132
5.4.8 Client Join ..................................................................................................................134
5.4.9 Invitation Procedures .................................................................................................136
5.4.10 Disconnect ...............................................................................................................137
Chapter 6 Power Management - Radio and System ..................................................................... 138
6.1 Radio Receiver Setting ........................................................................................................ 138
6.1.1 Active Radio Receive .................................................................................................138
6.1.2 Standard Power Save Radio Receive based on DTIM/Listen Interval .......................140
6.1.2.1 IEEE PS Poll Listen Interval ..............................................................................140
6.1.3 Custom Power Save Radio Receive ..........................................................................143
6.2 Battery Measurement ..........................................................................................................144
6.2.1 Battery Check Start ....................................................................................................144
6.2.2 Battery Warning/Standby Level Set ...........................................................................145
6.2.3 Battery Check Set ......................................................................................................146
6.2.4 Battery Check Stop ....................................................................................................147
6.2.5 Battery Value Get .......................................................................................................147
6.3 System Power Save ............................................................................................................148
6.3.1 Hibernate ....................................................................................................................148
6.3.2 Standby ......................................................................................................................149
6.3.2.1 Putting the System in Standby ..........................................................................149
6.3.2.2 Enabling Standby Mode Between Beacons ...................................................... 151
6.3.2.3 Configuring Standby Between Beacons ............................................................152
6.3.3 Deep Sleep ................................................................................................................155
6.3.4 Power Save in Limited AP ..........................................................................................157
6.3.5 Hardware Cryptography .............................................................................................158
Chapter 7 Peripherals .................................................................................................................... 160
7.1 GPIO Commands ................................................................................................................160
7.1.1 GPIO Out HIGH/LOW ................................................................................................160
Chapter 8 Production and Debug .................................................................................................. 161
8.1 RF Test ................................................................................................................................161
8.1.1 Regulatory and Transmit Tests using RF Test Commands .......................................161
8.1.1.1 Regulatory Testing ............................................................................................161
8.1.1.2 Transmit Testing ................................................................................................ 161
8.1.1.3 Gain Control Table ............................................................................................162
8.1.1.4 Start RF Test .....................................................................................................162
8.1.1.5 Stop RF Test .....................................................................................................162
8.1.1.6 Asynchronous Frame Transmission ..................................................................162
8.1.1.7 Start Asynchronous Frame Reception ...............................................................164
8.1.1.8 Stop Asynchronous Frame Reception ...............................................................167
8.1.1.9 Asynchronous Frame Transmission (TX99 mode) ............................................168
8.1.1.10 Asynchronous Frame Transmission (TX100 mode) ........................................173
8.1.1.11 Carrier Wave Transmission .............................................................................175
8.2 Live Calibration ....................................................................................................................176

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 8 2019-08-05
8.2.1 Enable Live Calibration ..............................................................................................176
8.2.2 Erase Live Calibration ................................................................................................178
8.2.3 Start Live Calibration ..................................................................................................179
8.2.4 For Complete Sequence of Live Calibration .............................................................. 181
8.3 Debug ..................................................................................................................................181
8.3.1 Log Level ....................................................................................................................181
8.3.2 Echo ...........................................................................................................................182
8.3.3 Verbose ......................................................................................................................183
8.3.4 RSSI ...........................................................................................................................184
8.3.5 WLAN Status ..............................................................................................................184
8.3.6 WLAN Statistics .........................................................................................................185
Appendix A Response Codes ........................................................................................................ 189
A.1 Synchronous Messages ......................................................................................................189
A.2 Asynchronous & Enhanced Asynchronous Messages ........................................................189
A.3.1 Exception Messages ..................................................................................................193
A.3.2 Boot Messages ..........................................................................................................194

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 9 2019-08-05
About This Manual
This manual provides guidelines for using the GainSpan® AT command-line interface to
design, configure, and provision the GS2101M series module to enable IP-to-WiFi
embedded devices with a UART/SPI interface to access an 802.11-compliant WiFi wireless
network connection using only serial commands.
Refer to the following sections:
• Revision History, page 9
• Audience, page 9
• Standards, page 10
• Documentation Conventions, page 10
• Documentation, page 13
• References, page 14
• Contact Information, Support, page 15
• Returning Products to Telit, page 16
• Accessing the Telit Wi-Fi Portal, page 16
Revision History
This revision history of the GainSpan IP-to-WiFi Adapter Application Programmer
Reference Guide is maintained in the following table:
Audience
This manual is designed for software engineers who want to evaluate, design, and
implement GainSpan Ultra Low Power 802.11 WiFi Modules within their environment. To
use this manual you will need a basic understanding of WiFi networks, network principles,
and network protocols.
Table 1 Revision History
Version Date Remarks
1.0 May 2019 Initial Release
2.0 August 2019 Added a note to enable “Ping and Trace Route” option under section
8.3.6 WLAN Statistics, page 185

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 10 2019-08-05
Standards
The standards that are supported by the Telit GS module series are:
– IEEE 802.11 b/g/n
Documentation Conventions
This manual uses the following text and syntax conventions:
– Special text fonts represent particular commands, keywords, variables, or window
sessions
– Color text indicates cross-reference hyper links to supplemental information
– Command notation indicates commands, subcommands, or command elements
Table 2, page 10, describes the text conventions used in this manual for software
procedures that are explained using the AT command line interface.
Table 2 Document Text Conventions
Convention Type Description
command syntax
monospaced font
This monospaced font represents command strings entered on a
command line and sample source code.
AT XXXX
Proportional font
description
Gives specific details about a parameter.
<Data> DATA
UPPERCASE
Variable parameter
Indicates user input. Enter a value according to the descriptions that
follow. Each uppercased token expands into one or more other token.
lowercase
Keyword parameter
Indicates keywords. Enter values exactly as shown in the command
description.
[ ]
Square brackets
Enclose optional parameters. Choose none; or select one or more an
unlimited number of times each. Do not enter brackets as part of any
command.
[parm1|parm2|parm3]
?
Question mark
Used with the square brackets to limit the immediately following token
to one occurrence.
<ESC>
Escape sequence
Each escape sequence <ESC> starts with the ASCII character 27 (0x1B).
This is equivalent to the Escape key.
<ESC>C

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 11 2019-08-05
<CR>
Carriage return Each command is terminated by a carriage return.
<LF>
Line feed Each command is terminated by a line feed.
<CR> <LF>
Carriage return
Line feed
Each response is started with a carriage return and line feed with some
exceptions.
< >
Angle brackets
Enclose a numeric range, endpoints inclusive. Do not enter angle
brackets as part of any command.
<SSID>
=
Equal sign
Separates the variable from explanatory text. Is entered as part of the
command.
PROCESSID = <CID>
.
dot (period)
Allows the repetition of the element that immediately follows it multiple
times. Do not enter as part of the command.
.AA:NN can be expanded to 1:01 1:02 1:03.
A.B.C.D
IP address
IPv4-style address.
10.0.11.123
LINE
End-to-line input token
Indicates user input of any string, including spaces. No other parameters
may be entered after input for this token.
string of words
WORD
Single token
Indicates user input of any contiguous string (excluding spaces).
singlewordnospaces
Table 2 Document Text Conventions (Continued)
Convention Type Description

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 12 2019-08-05
Table 3, page 12, describes the symbol conventions used in this manual for notification and
important instructions.
Table 3 Symbol Conventions
Icon Type Description
Note
Provides helpful suggestions needed in understanding
a feature or references to material not available in the
manual.
Alert Alerts you of potential damage to a program, device,
or system or the loss of data or service.
Caution Cautions you about a situation that could result in
minor or moderate bodily injury if not avoided.
Warning Warns you of a potential situation that could result in
death or serious bodily injury if not avoided.
Electro-Static Discharge
(ESD)
Notifies you to take proper grounding precautions
before handling a product.

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 13 2019-08-05
Documentation
The Telit documentation suite listed in Table 4, page 13 includes the part number,
documentation name, and a description of the document. The documents are available from
the Telit Wi-Fi Portal. Refer to Accessing the Telit Wi-Fi Portal, page 16 for details.
Table 4 Documentation List
1VV0301416 GS2101M Evaluation Board Quick Start
Guide
Provides an easy to follow guide on
how to unpack and setup GainSpan
GS2000 based module kit for the
GS2000 based modules.
1VV0301437 GS2K Module Programming User Guide
Provides users steps to program the
on-board Flash on the GainSpan
GS2000 based modules using DOS or
Graphical User Interface utility
provided by GainSpan. The user guide
uses the evaluation boards as a
reference example board.
1VV0301435 GS2K Module Evaluation Board Hardware
User Guide
Provides instructions on how to setup
and use the GS2000 based module
evaluation board along with component
description, jumper settings, board
specifications, and pinouts.
1VV0301395 GS2101M Low Power Wi-Fi Module
Hardware User Guide
Provides information to help WiFi
system designers to build systems using
GainSpan GS2101M module and
develop wireless applications.
1VV0301438 GS2K SDK Builder User Guide
Allows OEMs and system developers to
configure and generate custom
firmware binary images for GainSpan
low power embedded GS2000 based
WiFi modules. The SDK Builder
supports the GainSpan GEPS software
released, including the corresponding
WLAN firmware.
1VV0301409 GS2K SDK Quick Start Guide
Provides an easy to follow guide that
will walk you through easy steps to
setup, evaluation, develop, and debug
the full capabilities and features of the
embedded platform software.
1VV0301444 GS2K S2W Use Case Reference Guide
Provides references for using GainSpan
AT commands and its usage in different
scenarios using different features and
protocols.

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 14 2019-08-05
Documentation Feedback
We encourage you to provide feedback, comments, and suggestions so that we can improve
the documentation. You can send your comments by logging into Telit Support Portal. If
you are using email, be sure to include the following information with your comments:
– Document name
– URL or page number
– Hardware release version (if applicable)
– Software release version (if applicable)
References
The references listed in Table 5, page 14 are available on the Telit Wi-Fi Portal. Refer to
Accessing the Telit Wi-Fi Portal, page 16 for details.
Table 5 Other Documents and References
Title Description
Schematics
GS Based Module Evaluation Board schematics
supporting:
GS2101M
Module Firmware and
Programming Utilities
• IP-to-WiFi (IP2WiFi) based firmware
• Firmware Release Notes
• GSFlashprogram utility for programming the
modules
Software Utilities
Serial terminal program to evaluate and demonstrate
IP-to-WiFi (IP2WiFi) applications such as
– gs2k_flashprogram.exe

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 15 2019-08-05
Contact Information, Support
For general contact, technical support services, technical questions and to report
documentation errors contact Telit Technical Support at:
[email protected]
We recommend adding “Wi-Fi” in subject of the email. For example, the subject of email
can be “Wi-Fi: Your actual issue or question in brief” like “Wi-Fi: SPI Driver Issue”.
Also, in description of your email, please provide details about the issue, product and
module including software firmware version, module version and type, application being
used, customizations done to application, use case, issue frequency, and ability to recreate
it among other things wherever applicable.
Alternatively, for more Technical Support information or assistance, perform the following
steps:
1. Visit https://www.telit.com, go to Products> Wi-Fi and Blue-tooth, then scroll down to
the Telit Wi- Fi Portal.
2. Click Access the Portal Here icon which will direct you to the Telit Wi-Fi portal
https://wifi.telit.com/secure/login
1. Log in with your customer Email and Password.
2. Select the Location.
3. Select Q&A tab.
4. Select Ask a New Question.
5. Enter your technical support question, product information, and a brief description.
For detailed information about where you can buy the Telit modules or for
recommendations on accessories and components visit:
https://www.telit.com
Our aim is to make this guide as helpful as possible. Keep us informed of your comments
and suggestions for improvements. Telit appreciates feedback from the users of our
information.

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 16 2019-08-05
Returning Products to Telit
If a problem cannot be resolved by Telit technical support, a Return Material Authorization
(RMA) is issued. This number is used to track the returned material at the factory and to
return repaired or new components to the customer as needed.
To return a hardware component:
1. Determine the part number and serial number of the component.
2. Obtain an RMA number from Sales/Distributor Representative.
3. Provide the following information in an email or during the telephone call:
– Part number and serial number of component
– Your name, organization name, telephone number, and fax number
– Description of the failure
4. The support representative validates your request and issues an RMA number for
return of the components.
5. Pack the component for shipment.
Guidelines for Packing Components for Shipment
To pack and ship individual components:
– When you return components, make sure they are adequately protected with
packing materials and packed so that the pieces are prevented from moving
around inside the carton.
– Use the original shipping materials if they are available.
– Place individual components in electrostatic bags.
– Write the RMA number on the exterior of the box to ensure proper tracking.
Accessing the Telit Wi-Fi Portal
To find the latest version of Telit documentation supporting the Telit Wi-Fi product release
you are interested in, you can search the Telit Wi-Fi Portal website by performing the
following steps:
NOTE: Do not return any components to Telit unless you have first obtained an
RMA number. Telit reserves the right to refuse shipments that do not have an
RMA. Refused shipments will be returned to the customer by collect freight.
CAUTION! Do not stack any of the components.

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 17 2019-08-05
1. Visit https://www.telit.com, go to Products> Wi-Fi and Blue-tooth, then scroll down
the Telit Wi- Fi Portal.
2. Click Access the Portal Here icon which will direct you to the Telit Wi-Fi portal
https://wifi.telit.com/secure/login
3. Log in using your customer Email and Password.
4. Click the Getting Started tab to view a Quick Start tutorial on how to use various
features within the Telit Wi-Fi Portal.
5. Click the Agreements tab to download and upload the SLA for ADK and SDK
respectively.
6. Click on the Documents tab to search, download, and print product documentation.
7. Click the Software tab to search and download the latest software versions.
8. Click the Kits Purchased tab to view customer account history.
9. Click the Legal Documents tab to view Non-Disclosure Agreement (NDA).
10. Click the Certifications tab to view GS certifications.
NOTE: You must first contact Telit Support to set up an account, and obtain a
customer user name and password before you can access the Telit Wi-Fi Portal.

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 18 2019-08-05
Chapter 1 Getting Started
This chapter describes how to get started.
• Overview, page 18
• Using SDK Builder, page 20
1.1 Overview
The IP-to-WiFi stack is used to provide WiFi capability to any device having a serial
interface. This approach offloads WLAN, TCP/IP stack and network management
overhead to the WiFi chip, allowing a small embedded host (for example an MCU) to
communicate with other hosts on the network using a WiFi wireless link. The host
processor can use serial commands to configure the IP-to-WiFi Application and to create
wireless and network connections.
OTP stands for One Time Programmable Memory. It is divided into two parts, one for
Application firmware and another for WLAN firmware. It contains important system
related information for Application and WLAN firmware. For Application firmware, it
contains information about MAC address, regularity information, module related
information, and so on. For WLAN firmware, it contains information about calibration
data.
The user will have to register on GainSpan website, sign the NDA and check with the local
sales team for any queries during this procedure. This gives access to all the respective
documentation according to the product purchased.
The following is the basic application development sequence for a IP-to-WiFi user.
1. Evaluate GainSpan hardware and firmware
– Download the software, program, and execute.
– To download the software, go to SDK builder (www.gainspan.com/secure/login),
and download all the latest packages including the binary (Refer GS2K SDK
Builder User Guide).
– Flash the binary using module programmer user guide on the custom hardware or
GS evaluation board and execute in RUN mode. (Refer “GS2K Module
Programming User Guide”).
2. Design the custom hardware by following the design guidelines. (Refer GS2xxxM
Hardware Design Guidelines)

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 19 2019-08-05
3. Develop Host firmware
– Following Live Calibrations commands are highly recommended to be issued
before doing any Wi-Fi operations:
AT+WLCALERASE
AT+RESET
AT+WLCALSTART=1
– Interface host application using AT commands. (Refer GS2xxxM S2W Adapter
Command Reference Guide)
Configure the serial interface (UART/SPI/SDIO) as required, refer UART,
page 33, SPI Interface and Configuration, page 37 and SDIO Interface, page 53 for
mode, polarity.For software interface, choose Command & Response, Byte
stuffing/de-stuffing as “None” for UART and SDIO options.
– Issue general, power save, and security related commands as required.
– Start connection to an Access Point or do provisioning as required.
– Obtain IP Address and Start Data Transfer.
– Select advanced services if any.
4. Debug Host and GainSpan module
– Debug using provided AT commands and other options if required. (Refer
GS2xxxM S2W Adapter Command Reference Guide)
– Analyze using Wire shark over wireless. For more details, refer information about
AirPcap Nx in http://www.riverbed.com
5. Production Process
– Perform generic recommendations in production line
– Check if Live Calibration needs to be explicitly controlled (rarely used),
– Perform RF tests
NOTE: For desired functionality use appropriate AT Commands. Refer “GS2K
S2W Reference Use Case User Guide”
NOTE: Refer to “GS2K S2W Reference Use Case User Guide” document for
detailed use cases and examples.

GS2101M IP2WiFi Adapter Command Reference Guide
1VV0301499 Rev. 2.0 20 2019-08-05
1.2 Using SDK Builder
1.2.1 IP-to-WiFi Module Information
Selecting the IP-to-WiFi (Hosted) under the SDK Builder Configuration screen displays
the module information that includes the module selected, firmware version, application,
SRAM (APP/WLAN/RTC), and Flash (Internal/External) summary information. There
are several tabs that allow you to select various features and options to build and configure
the IP-to-WiFi (Hosted) application.