Telit Wireless Solutions GS2101M Series Reference guide

Type
Reference guide

This manual is also suitable for

GS2200M
IP2WiFi Adapter Command
Reference Guide
1VV0301501 Rev. 1.0 – 2018-03-12
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 pro-
grams, including the exclusive right to copy or reproduce in any form the copyrighted com-
puter 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 cop-
ied (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.
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.
PRODUCT
GS2200M
Software Release
5.5.2
APPLICABILITY TABLE
GS2200M IP2WiFi Adapter Command Reference Guide
1VV030 1501 Rev. 1.0 5 2018-03-12
Table of Contents
Chapter 1 Getting Started ................................................................................................................ 19
1.1 Overview ................................................................................................................................19
1.2 Using SDK Builder .................................................................................................................21
1.2.1 IP-to-WiFi Module Information .....................................................................................21
Chapter 2 Architecture ..................................................................................................................... 23
2.1 Overview ................................................................................................................................23
2.2 Serial Interface ......................................................................................................................24
2.3 System Initialization ...............................................................................................................24
2.3.1 Profile Definition ...........................................................................................................25
2.4 Command Processing Mode .................................................................................................26
2.5 Data Handling ........................................................................................................................27
2.5.1 Unsolicited/Unassociated/Beacon Mode Data Handling ..............................................28
2.5.2 Software Flow Control ..................................................................................................28
2.5.3 Hardware Flow Control ................................................................................................28
2.6 Serial Data Handling ..............................................................................................................29
2.7 Wireless Network Management .............................................................................................30
2.7.1 Scanning ......................................................................................................................30
2.7.2 Association ...................................................................................................................30
2.7.3 SSID and Passphrase ..................................................................................................30
Chapter 3 Host Interaction ............................................................................................................... 33
3.1 Startup Handling ....................................................................................................................34
3.1.1 Single Interface Startup Handling ................................................................................34
3.1.2 Dual Interface Startup Handling ...................................................................................35
3.2 Interface .................................................................................................................................35
3.2.1 UART ...........................................................................................................................35
3.2.1.1 UART Parameters ...............................................................................................35
3.2.1.2 Software Flow Control .........................................................................................37
3.2.1.3 Hardware Flow Control ........................................................................................38
3.2.2 SPI Interface and Configuration ...................................................................................39
3.2.2.1 SPI Byte Stuffing (Legacy SPI, SPI-NO-DMA) ....................................................40
3.2.2.2 SPI Command Response (SPI-DMA) ..................................................................41
3.2.2.3 Annexure - HI Frame Format (From Host) ...........................................................52
3.2.2.4 Annexure - HI Frame Response (From GS Node) ..............................................53
3.2.2.5 Pin Connection for SPI Interface .........................................................................54
3.2.3 SDIO Interface .............................................................................................................55
3.2.3.1 Capabilities ..........................................................................................................55
3.2.3.2 SDIO Host Slave Initialization and Communication .............................................56
3.2.3.3 SDIO Host Recommendations .............................................................................59
3.2.3.4 Pin Description .....................................................................................................61
3.2.4 Interface Verification ....................................................................................................61
Chapter 4 General Operations ......................................................................................................... 63
4.1 Version ..................................................................................................................................63
4.2 Time Setting ..........................................................................................................................65
4.2.1 Set System Time ..........................................................................................................65
4.2.1.1 Manual Setting .....................................................................................................65
4.2.2 Get System Time .........................................................................................................66
GS2200M IP2WiFi Adapter Command Reference Guide
1VV030 1501 Rev. 1.0 6 2018-03-12
4.3 Profile Setting ........................................................................................................................67
4.3.1 Get Profile ....................................................................................................................67
4.3.2 Save Profile ..................................................................................................................68
4.3.3 Load Profile ..................................................................................................................69
4.3.4 Select Default Profile ....................................................................................................70
4.3.5 Restore Profile .............................................................................................................71
4.3.6 Define Profile ................................................................................................................71
4.3.7 Identification Information ..............................................................................................73
4.3.8 Enhanced Asynchronous Notification ..........................................................................74
4.4 Reset .....................................................................................................................................75
4.5 MAC .......................................................................................................................................76
4.5.1 Set MAC Address .........................................................................................................76
4.5.2 Get MAC Address ........................................................................................................78
Chapter 5 Wireless ......................................................................................................................... 81
5.1 Wireless Generic ...................................................................................................................81
5.1.1 Regulatory Domain ......................................................................................................81
5.1.1.1 Set Regulatory Domain ........................................................................................81
5.1.1.2 Get Regulatory Domain .......................................................................................82
5.1.2 Operation Mode ...........................................................................................................83
5.1.3 MAC Retry ...................................................................................................................86
5.1.4 Sync Loss Interval ........................................................................................................87
5.1.5 Set RTS Threshold .......................................................................................................88
5.1.6 Transmit Data Rate ......................................................................................................89
5.1.6.1 Set Transmit Rate ................................................................................................89
5.1.6.2 Get Transmit Rate ...............................................................................................91
5.1.7 Graceful Shutdown of WLAN .......................................................................................92
5.2 Beacon Mode (Unassociated Mode) .....................................................................................93
5.2.1 Unassociated/Unsolicited Tx ........................................................................................93
5.2.2 Unassociated/Unsolicited Rx .......................................................................................98
5.2.2.1 Examples for Unassociated/Unsolicited Tx and Rx Commands ........................101
5.2.3 Unassociated/Unsolicited Rx Stop .............................................................................102
5.2.4 Unassociated/Unsolicited Data Encryption ................................................................103
5.3 Station/AP Mode ..................................................................................................................104
5.3.1 Scan Time Settings ....................................................................................................104
5.3.1.1 Set Scan Time ...................................................................................................104
5.3.1.2 Get Scan Time ...................................................................................................105
5.3.2 Authentication Mode ..................................................................................................106
5.3.3 Security Configuration ................................................................................................107
5.3.3.1 Security Setting ..................................................................................................107
5.3.3.2 WEP Keys ..........................................................................................................108
5.3.3.3 WEP Key Type Configuration ............................................................................109
5.3.3.4 WPA-PSK and WPA2-PSK Passphrase ............................................................111
5.3.3.5 WPA-PSK and WPA2-PSK Key Calculation ......................................................112
5.3.3.6 WPA-PSK and WPA2-PSK Key ........................................................................113
5.3.4 Scanning ....................................................................................................................115
5.3.5 Association .................................................................................................................117
5.3.6 Disassociation ............................................................................................................120
5.3.7 Connection Maintenance ...........................................................................................120
5.3.7.1 Keep Alive Timer ...............................................................................................120
5.3.7.2 WLAN Keep Alive Interval .................................................................................121
5.3.8 Advanced Commands ................................................................................................122
5.3.8.1 Get Client Information ........................................................................................122
5.4 WiFi Direct Mode .................................................................................................................123
GS2200M IP2WiFi Adapter Command Reference Guide
1VV030 1501 Rev. 1.0 7 2018-03-12
5.4.1 Set Device ..................................................................................................................123
5.4.2 Set WPS .....................................................................................................................125
5.4.3 Start Find ....................................................................................................................126
5.4.4 Stop Find ....................................................................................................................129
5.4.5 Provoke ......................................................................................................................130
5.4.6 Provision Discovery ....................................................................................................131
5.4.7 Group Form (Group Owner Negotiation) ....................................................................132
5.4.7.1 Provision Discovery Request Handling ..............................................................136
5.4.8 Client Join ..................................................................................................................138
5.4.9 Invitation Procedures .................................................................................................140
5.4.10 Disconnect ...............................................................................................................141
Chapter 6 Power Management - Radio and System ..................................................................... 143
6.1 Radio Receiver Setting ........................................................................................................143
6.1.1 Active Radio Receive .................................................................................................143
6.1.2 Standard Power Save Radio Receive based on DTIM/Listen Interval .......................145
6.1.2.1 IEEE PS Poll Listen Interval ..............................................................................145
6.1.3 Custom Power Save Radio Receive ..........................................................................148
6.2 Battery Measurement ..........................................................................................................149
6.2.1 Battery Check Start ....................................................................................................149
6.2.2 Battery Warning/Standby Level Set ...........................................................................150
6.2.3 Battery Check Set ......................................................................................................151
6.2.4 Battery Check Stop ....................................................................................................152
6.2.5 Battery Value Get .......................................................................................................152
6.3 System Power Save ............................................................................................................153
6.3.1 Hibernate ....................................................................................................................153
6.3.2 Standby ......................................................................................................................154
6.3.2.1 Putting the System in Standby ...........................................................................154
6.3.2.2 Enabling Standby Mode Between Beacons .......................................................156
6.3.2.3 Configuring Standby Between Beacons ............................................................157
6.3.3 Deep Sleep ................................................................................................................160
6.3.4 Power Save in Limited AP ..........................................................................................162
6.3.5 Hardware Cryptography .............................................................................................163
Chapter 7 Peripherals .................................................................................................................... 165
7.1 GPIO Commands ................................................................................................................165
7.1.1 GPIO Out HIGH/LOW ................................................................................................165
Chapter 8 Production and Debug .................................................................................................. 167
8.1 RF Test ................................................................................................................................167
8.1.1 Regulatory and Transmit Tests using RF Test Commands .......................................167
8.1.1.1 Regulatory Testing .............................................................................................167
8.1.1.2 Transmit Testing ................................................................................................167
8.1.1.3 Gain Control Table .............................................................................................168
8.1.1.4 Start RF Test .....................................................................................................168
8.1.1.5 Stop RF Test ......................................................................................................168
8.1.1.6 Asynchronous Frame Transmission ..................................................................168
8.1.1.7 Start Asynchronous Frame Reception ...............................................................170
8.1.1.8 Stop Asynchronous Frame Reception ...............................................................173
8.1.1.9 Asynchronous Frame Transmission (TX99 mode) ............................................174
8.1.1.10 Asynchronous Frame Transmission (TX100 mode) ........................................179
8.1.1.11 Carrier Wave Transmission .............................................................................181
8.2 Live Calibration ....................................................................................................................182
8.2.1 Enable Live Calibration ..............................................................................................182
GS2200M IP2WiFi Adapter Command Reference Guide
1VV030 1501 Rev. 1.0 8 2018-03-12
8.2.2 Erase Live Calibration ................................................................................................184
8.2.3 Start Live Calibration ..................................................................................................185
8.2.4 For Complete Sequence of Live Calibration ..............................................................187
8.3 Debug ..................................................................................................................................187
8.3.1 Log Level ....................................................................................................................187
8.3.2 Echo ...........................................................................................................................188
8.3.3 Verbose ......................................................................................................................189
8.3.4 RSSI ...........................................................................................................................190
8.3.5 WLAN Status ..............................................................................................................190
8.3.6 WLAN Statistics .........................................................................................................191
Appendix A Response Codes ........................................................................................................ 195
A.1 Synchronous Messages ......................................................................................................195
A.2 Asynchronous & Enhanced Asynchronous Messages ........................................................195
A.3.1 Exception Messages ..................................................................................................199
A.3.2 Boot Messages ..........................................................................................................200
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 9 2018-03-12
About This Manual
This manual provides guidelines for using the GainSpan
®
AT command-line interface to
design, configure, and provision the GS2200M 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 13
Contact Information, Support, page 15
Returning Products to GainSpan, page 16
Accessing the GainSpan 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 March2018 Initial Release
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 10 2018-03-12
Standards
The standards that are supported by the GainSpan 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
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 11 2018-03-12
<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
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 12 2018-03-12
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.
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 13 2018-03-12
Documentation
The GainSpan 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 GainSpan Portal. Refer to Accessing the GainSpan Portal, page 16 for details.
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 e-mail, 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 GainSpan references listed in Table 5, page 14 are available on the GainSpan Portal.
Refer to Accessing the GainSpan Portal, page 16 for details.
Table 4 Documentation List
Part Number Document Title Description
1VV0301396
GS2200M Low Power WiFi Mini-Module Hardware User
Guide
Provides information to help WiFi
system designers to build systems using
GainSpan GS2200M module and
develop wireless applications.
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.
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 14 2018-03-12
Table 5 Other Documents and References
Title Description
Schematics
GS Based Module Evaluation Board schematics
supporting:
GS2200M
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
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 15 2018-03-12
Contact Information, Support
For general contact, technical support services, technical questions and to report
documentation errors contact Telit Technical Support at:
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 http://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 GainSpan portal
http://www.gainspan/secure/login.com
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:
http://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.
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 16 2018-03-12
Returning Products to GainSpan
If a problem cannot be resolved by GainSpan 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 e-mail 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 GainSpan Portal
To find the latest version of GainSpan documentation supporting the GainSpan product
release you are interested in, you can search the GainSpan Portal website by performing the
following steps:
NOTE: Do not return any components to GainSpan Corporation unless you have
first obtained an RMA number. GainSpan 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.
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 17 2018-03-12
1. Visit http://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 GainSpan portal
http://www.gainspan/secure/login.com
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 GainSpan 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 GainSpan 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 GainSpan Non-Disclosure Agreement
(NDA).
10. Click the Certifications tab to view GainSpan certifications.
NOTE: You must first contact GainSpan to set up an account, and obtain a
customer user name and password before you can access the GainSpan Portal.
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 18 2018-03-12
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 19 2018-03-12
Chapter 1 Getting Started
This chapter describes how to get started.
Overview, page 19
Using SDK Builder, page 21
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)
GS2200M IP2WiFi Adapter Command Reference Guide
1VV0301501 Rev. 1.0 20 2018-03-12
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 35, SPI Interface and Configuration, page 39 and SDIO Interface, page 55 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.
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150
  • Page 151 151
  • Page 152 152
  • Page 153 153
  • Page 154 154
  • Page 155 155
  • Page 156 156
  • Page 157 157
  • Page 158 158
  • Page 159 159
  • Page 160 160
  • Page 161 161
  • Page 162 162
  • Page 163 163
  • Page 164 164
  • Page 165 165
  • Page 166 166
  • Page 167 167
  • Page 168 168
  • Page 169 169
  • Page 170 170
  • Page 171 171
  • Page 172 172
  • Page 173 173
  • Page 174 174
  • Page 175 175
  • Page 176 176
  • Page 177 177
  • Page 178 178
  • Page 179 179
  • Page 180 180
  • Page 181 181
  • Page 182 182
  • Page 183 183
  • Page 184 184
  • Page 185 185
  • Page 186 186
  • Page 187 187
  • Page 188 188
  • Page 189 189
  • Page 190 190
  • Page 191 191
  • Page 192 192
  • Page 193 193
  • Page 194 194
  • Page 195 195
  • Page 196 196
  • Page 197 197
  • Page 198 198
  • Page 199 199
  • Page 200 200
  • Page 201 201
  • Page 202 202
  • Page 203 203

Telit Wireless Solutions GS2101M Series Reference guide

Type
Reference guide
This manual is also suitable for

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI