Telit Wireless Solutions GS2200M Reference Manual
Telit Wireless Solutions GS2200M Reference Manual

Telit Wireless Solutions GS2200M Reference Manual

Ip2wifi adapter command
Hide thumbs Also See for GS2200M:
Table of Contents

Advertisement

Quick Links

GS2200M
IP2WiFi Adapter Command
Reference Guide
1VV0301501
Rev. 1.0 – 2018-03-12

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GS2200M and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Telit Wireless Solutions GS2200M

  • Page 1 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev. 1.0 – 2018-03-12...
  • Page 2 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.
  • Page 3 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.
  • Page 4 APPLICABILITY TABLE PRODUCT GS2200M Software Release 5.5.2...
  • Page 5: Table Of Contents

    GS2200M IP2WiFi Adapter Command Reference Guide 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...
  • Page 6 GS2200M IP2WiFi Adapter Command Reference Guide 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...
  • Page 7 GS2200M IP2WiFi Adapter Command Reference Guide 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...
  • Page 8 GS2200M IP2WiFi Adapter Command Reference Guide 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...
  • Page 9: 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.
  • Page 10 GS2200M IP2WiFi Adapter Command Reference Guide 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 –...
  • Page 11 GS2200M IP2WiFi Adapter Command Reference Guide Table 2 Document Text Conventions (Continued) Convention Type Description <CR> Each command is terminated by a carriage return. Carriage return <LF> Each command is terminated by a line feed. Line feed <CR> <LF> Each response is started with a carriage return and line feed with some Carriage return exceptions.
  • Page 12 GS2200M IP2WiFi Adapter Command Reference Guide Table 3, page 12, describes the symbol conventions used in this manual for notification and important instructions Table 3 Symbol Conventions Icon Type Description Provides helpful suggestions needed in understanding Note a feature or references to material not available in the manual.
  • Page 13 Table 4 Documentation List Part Number Document Title Description Provides information to help WiFi system designers to build systems using GS2200M Low Power WiFi Mini-Module Hardware User GainSpan GS2200M module and 1VV0301396 Guide develop wireless applications. Provides references for using GainSpan...
  • Page 14 GS2200M IP2WiFi Adapter Command Reference Guide Table 5 Other Documents and References Title Description GS Based Module Evaluation Board schematics supporting: Schematics GS2200M • IP-to-WiFi (IP2WiFi) based firmware Module Firmware and • Firmware Release Notes Programming Utilities • GSFlashprogram utility for programming the...
  • Page 15 GS2200M IP2WiFi Adapter Command Reference Guide Contact Information, Support For general contact, technical support services, technical questions and to report documentation errors contact Telit Technical Support at: TS-SRD@telit.com 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”...
  • Page 16 GS2200M IP2WiFi Adapter Command Reference Guide 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.
  • Page 17 GS2200M IP2WiFi Adapter Command Reference Guide 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. 1. Visit http://www.telit.com, go to Products> Wi-Fi and Blue-tooth, then scroll down the Telit Wi- Fi Portal.
  • Page 18 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev. 1.0 2018-03-12...
  • Page 19: Chapter 1 Getting Started

    GS2200M IP2WiFi Adapter Command Reference Guide 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.
  • Page 20 GS2200M IP2WiFi Adapter Command Reference Guide 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...
  • Page 21: Using Sdk Builder

    GS2200M IP2WiFi Adapter Command Reference Guide 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.
  • Page 22 GS2200M IP2WiFi Adapter Command Reference Guide NOTE: When building Firmware Binary for EVK or AEK Package, it is recommended that you use the Default Evaluation Build. Otherwise, you can build Custom, SDK, or ADK Packages for your environment. The tabular selections to build your IP-to-WiFi (Hosted) application and firmware are as follows •...
  • Page 23: Chapter 2 Architecture

    GS2200M IP2WiFi Adapter Command Reference Guide Chapter 2 Architecture This chapter describes the overview and architecture of IP-to-WiFi Application. • Overview, page 23 • Serial Interface, page 24 • System Initialization, page 24 • Command Processing Mode, page 26 •...
  • Page 24: Serial Interface

    GS2200M IP2WiFi Adapter Command Reference Guide • System Initialization, page 24 • Command Processing Mode, page 26 • Data Handling, page 27 • Serial Data Handling, page 29 • Wireless Network Management, page 30 The software for the IP-to-WiFi Application is mainly driven using a state machine. Upon powering on, the required initialization of all the modules is performed and then the state machine is entered.
  • Page 25: Profile Definition

    GS2200M IP2WiFi Adapter Command Reference Guide – Interface enters the command processing state. Figure 2 Operating Modes of the IP-to-WiFi Application IP-to-WiFi binary uses the interface and configuration as per the binary configuration options selected in SDK Builder. The evaluation binary packages use the following defaults: •...
  • Page 26: Command Processing Mode

    GS2200M IP2WiFi Adapter Command Reference Guide 2.4 Command Processing Mode In Command mode, the application receives commands over the serial port. Commands are processed line by line. Verbose Mode is used when referring to commands being executed, refers to the displaying of status of any command executed in ASCII (human readable) format.
  • Page 27: Data Handling

    GS2200M IP2WiFi Adapter Command Reference Guide The default Time Out till S2W Application buffers the data from HOST is 100milliseconds which can be configured using ATS Command, refer 4.3.7 Identification Information, page 2.5 Data Handling In Data Processing Mode, data transfers are managed using various escape sequences.
  • Page 28: Unsolicited/Unassociated/Beacon Mode Data Handling

    GS2200M IP2WiFi Adapter Command Reference Guide 2.5.1 Unsolicited/Unassociated/Beacon Mode Data Handling In Unsolicited Data Mode (data transmission without association), data transfer is managed using escape sequences. Each escape sequence starts with the ASCII character 27 (0x1B), equivalent to the Escape <ESC> key. For more details, see 5.2.1 Unassociated/Unsolicited Tx, page...
  • Page 29: Serial Data Handling

    GS2200M IP2WiFi Adapter Command Reference Guide 2.6 Serial Data Handling The Serial Data Handler receives and transmits data to and from the hardware serial controller. Data read from the serial port is passed to: – The command processor in command mode –...
  • Page 30: Wireless Network Management

    GS2200M IP2WiFi Adapter Command Reference Guide 2.7 Wireless Network Management 2.7.1 Scanning The IP-to-WiFi interface can instruct the WiFi radio to scan for access points with a specified SSID, BSSID and/or channel for a specified scan time. Scanning can be performed to find networks with a specific SSID or BSSID, networks operating on a specific radio channel or a combination of these constraints.
  • Page 31 GS2200M IP2WiFi Adapter Command Reference Guide Table 8 Expected and Input SSID Expected SSID Input SSID Remarks TEST TEST Valid (satisfies rule 2) TEST “TEST” Valid (satisfies rule 2) TE”ST TE”ST Valid (satisfies rule 3) TE”ST “TE”ST” Invalid (breaks rule 3) TE,ST “TE,ST”...
  • Page 32 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev. 1.0 2018-03-12...
  • Page 33: Chapter 3 Host Interaction

    GS2200M IP2WiFi Adapter Command Reference Guide Chapter 3 Host Interaction This chapter describes how a communication interface is established between Host and GS node. IP-to-WiFi Application (GS node) interacts with host using one of the following ways: • Single interface: It supports to use one of the following interfaces to communicate with Host.
  • Page 34: Startup Handling

    GS2200M IP2WiFi Adapter Command Reference Guide 3.1 Startup Handling 3.1.1 Single Interface Startup Handling For proper synchronization between Host micro controller (MCU) and GS node (IP2WiFi Application), the following steps must be followed: Once the GS node is up, Host MCU needs to first read the complete IP2WiFi start-up banner r\nIP2WiFi<SP>APP\r\n before issuing any command.
  • Page 35: Dual Interface Startup Handling

    GS2200M IP2WiFi Adapter Command Reference Guide 5. If Host MCU gets reset for some reason, then GS node (IP2WiFi Application) must be explicitly reset using EXT_RESET pin and the Host MCU should wait for the host wake-up signal to become high in case of SPI interface. However, if reset provision is not available, then Host MCU must continuously send dummy ‘AT’...
  • Page 36 GS2200M IP2WiFi Adapter Command Reference Guide Default Profile, page Command Syntax ATB=<baudrate>[[,<bitsperchar>][,<parity>][,<stopbits>]] Usage NOTE: 1> All standard baud rates are supported. 2> It is strongly recommended to use hardware or software flow control to prevent data loss and data corruption.
  • Page 37: Software Flow Control

    GS2200M IP2WiFi Adapter Command Reference Guide 3.2.1.2 Software Flow Control This command is used to enable or disable software flow control for the UART interface. AT&Kn Command Syntax Parameter Description Table 12, page 37 describes the Software Flow Control parameters.
  • Page 38: Hardware Flow Control

    GS2200M IP2WiFi Adapter Command Reference Guide 3.2.1.3 Hardware Flow Control This command is used to enable or disable hardware flow control for the UART interface. AT&Rn Command Syntax Parameter Description Table 14, page 38 describes the Hardware Flow Control parameters.
  • Page 39: Spi Interface And Configuration

    GS2200M IP2WiFi Adapter Command Reference Guide 3.2.2 SPI Interface and Configuration For higher throughput application, we make use of SPI interface between MCU and GS node. SPI mode is a combination of clock polarity and clock phase with respect to the data. There are four types of SPI modes: •...
  • Page 40: Spi Byte Stuffing (Legacy Spi, Spi-No-Dma)

    GS2200M IP2WiFi Adapter Command Reference Guide Table 17, page 40 describes the configuration for clock polarity and clock phase with respect to SPI Mode. Table 17 SPI Modes, Clock Polarity, and Clock Phase SPI Mode Clock Polarity Clock Phase Synchronous Response...
  • Page 41: Spi Command Response (Spi-Dma)

    GS2200M IP2WiFi Adapter Command Reference Guide Table 19 SPI Transmit Data Handling Link Pattern Pattern Encoded as Description 0xFB 0xFB 0xDB Control ESCAPE 0xF5 0xFB 0xD5 IDLE character 0xFF 0xFB 0xDF Inactive link detection 0xF3 0xFB 0xD3 SPI link ready indication One dedicated GPIO signal (GS_SPI _HOST_WAKEUP) is available for data ready indications from Slave GS node to Master Host controller.
  • Page 42 GS2200M IP2WiFi Adapter Command Reference Guide The HI Format is used for the message exchange. Refer to 3.2.2.3 Annexure - HI Frame Format (From Host), page 52 3.2.2.4 Annexure - HI Frame Response (From GS Node), page Based on MCU capabilities (such as multi threaded application, single threaded application, interrupt supported application, and so on), SPI command response method supports the following methodologies to transfer data between MCU and GS node.
  • Page 43 GS2200M IP2WiFi Adapter Command Reference Guide NOTE: 2.) If a race condition occurs when the GS node wants to send data to MCU and MCU wants to send data to GS node at the same time, then this scenario is...
  • Page 44 GS2200M IP2WiFi Adapter Command Reference Guide Figure 3, page 44 shows the timing diagram from step 1 to step 3. Figure 3 Transferring data from MCU to GS node 4. GS node receives the four bytes in SPI FIFO. It parses the WRITE_REQUEST and formulates the WRITE_RESPONSE.
  • Page 45 GS2200M IP2WiFi Adapter Command Reference Guide 9. MCU sends the actual data. 10. When the size of data is less than 1024 bytes, the time GPIO37 takes to become low after step 5 is 16 clock cycles (WRITE_RESPONSE + Data Header). When the size of data is more than 1024 bytes, the time taken wait cycle will be (Data length-1024+16) clocks.
  • Page 46 GS2200M IP2WiFi Adapter Command Reference Guide 3. When GS node receives A first 4bytes of READ_REQUEST in SPI FIFO, it triggers an interrupt to pull the GPIO37 LOW. Here the MCU need not wait for GPIO37 to go HIGH. After receiving the READ_REQUEST, GS node parses the READ REQUEST, formulates the READ RESPONSE, puts the READ RESPONSE along with the Data header in the PING buffer, and pulls the GPIO37 high.
  • Page 47 GS2200M IP2WiFi Adapter Command Reference Guide 3.2.2.2.2 Polling Methodology This method can only be used if the MCU is not capable to generate the interrupts where the MCU is single threaded. Currently its not recommended to use this mode. For high speed MCUs, it is always recommended to use interrupt mode.
  • Page 48 GS2200M IP2WiFi Adapter Command Reference Guide a. Class field – WRITE_RESPONSE_OK/WRITE_RESPONSE_NOK b. Length as the size of the data, MCU initiates to send data. c. The status field is WRITE_RESPONSE_OK if it is ready to receive the data and WRITE_RESPONSE_NOK if it is not ready to receive the data.
  • Page 49 GS2200M IP2WiFi Adapter Command Reference Guide 3. MCU sends the command READ_REQUEST to GS node. It uses HI frame with: a. Class field - READ_REQUEST b. Length is the size of data that MCU can receive from GS node. –...
  • Page 50 GS2200M IP2WiFi Adapter Command Reference Guide When the size of data is less than 1024 bytes, the time GPIO37 takes to NOTE: become low after step 6 is 16 clock cycles (READ RESPONSE + Data Header). When the size of data is more than 1024 bytes, the wait cycle will be (Data length-1024+16) clocks.
  • Page 51 GS2200M IP2WiFi Adapter Command Reference Guide Figure 6, page 51 shows the timing diagram for MCU write (>1024 Bytes) to GS node. Figure 6 MCU Write (>1024 Bytes) to GS Node MCU Read to GS Node Figure 7, page 51 shows the timing diagram for MCU Read (<=1024 Bytes) to GS node.
  • Page 52: Annexure - Hi Frame Format (From Host)

    GS2200M IP2WiFi Adapter Command Reference Guide Figure 8, page 52 shows the timing diagram for MCU Read (>1024 Bytes) to GS node. Figure 8 MCU Read (>1024 Bytes) to GS Node 3.2.2.3 Annexure - HI Frame Format (From Host) All messages carried over the Host Interface have a common format. They are composed of a HI header, and parameters depending on the header.
  • Page 53: Annexure - Hi Frame Response (From Gs Node)

    GS2200M IP2WiFi Adapter Command Reference Guide The format of HI Parameters field is determined by the service class. The service class of each frame is signaled by the value of the first field. Available service class identifiers (see Table 20, page 53).
  • Page 54: Pin Connection For Spi Interface

    GS2200M IP2WiFi Adapter Command Reference Guide Table 21 HI Frame Response (from GS Node) Identifier Description Start of frame 0xA5 0x11 - WRITE_RESPONSE_OK to MCU side 0x12 - READ_RESPONSE_OK to MCU side Class 0x13 - WRITE_RESPONSE_NOK to MCU side 0x14 - READ_RESPONSE_NOK to MCU side...
  • Page 55: Sdio Interface

    GS2200M IP2WiFi Adapter Command Reference Guide 3.2.3 SDIO Interface GS node is supported to be configured as SDIO slave only. It uses the SDIO interface with a maximum clock frequency of 33 MHz. NOTE: There is no command available to configure SDIO interface. This interface can be only enabled from the SDK Builder while compiling the firmware.
  • Page 56: Sdio Host Slave Initialization And Communication

    GS2200M IP2WiFi Adapter Command Reference Guide 3.2.3.2 SDIO Host Slave Initialization and Communication This section provides initialization steps to be performed by the Host (SDIO Master) after power up. NOTE: Before the Host powers up, GS node needs to be interfaced with Host via SDIO.
  • Page 57 GS2200M IP2WiFi Adapter Command Reference Guide – Set the 4bit/1 bit mode depends on the above capability 4. Write the CCR register 0x02 to enable the SDIO card. 5. Write the CCR register 0x04 to enable the card interrupt for a function 6.
  • Page 58 GS2200M IP2WiFi Adapter Command Reference Guide 3.2.3.2.5 Host Read Sequence When GS node writes data to the Host, it receives read interrupt. Upon receiving the interrupt following steps should be performed by the HOST. • Check 'Interrupt Pending' register. - Read Interrupt Pending register (function 0 address 0x05) - If value is '0x02', it means there is an interrupt pending.
  • Page 59: Sdio Host Recommendations

    GS2200M IP2WiFi Adapter Command Reference Guide – If HIGH, continue with WRITE operation • Issue CMD53 with respective arguments for writing the data to GS node. NOTE: It is strongly recommended to send maximum of 1400 bytes in a single write.
  • Page 60 GS2200M IP2WiFi Adapter Command Reference Guide receive any more data. At this point, Host MCU cannot perform WRITE and READ operations as the SDIO CMD response returns failure. To avoid WRITE and READ failures, Host needs to perform the following: 1.
  • Page 61: Pin Description

    GS2200M IP2WiFi Adapter Command Reference Guide 3.2.3.4 Pin Description The following are the pin descriptions in GS module: Table 24 Pin Descriptions Description GPIO_35/SDIO_CLK/SPI0_CLK SDIO Clock/ SPI0 Clock GPIO_34/SDIO_CMD/SPI0_DIN SD4 bit mode, command line SD1 bit mode, command line SPI mode, Data input...
  • Page 62 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev.1.0 2018-03-12...
  • Page 63: Chapter 4 General Operations

    GS2200M IP2WiFi Adapter Command Reference Guide Chapter 4 General Operations This chapter describes the commands for generic operations as required by IP-to-WiFi Application. • Version, page 63 • Time Setting, page 65 • Profile Setting, page 67 • Reset, page 98 •...
  • Page 64 GS2200M IP2WiFi Adapter Command Reference Guide – Build time – Build date – WLAN firmware extension version – Application firmware extension version – WLAN feature bitmap – GEPS firmware extension version – Module flash ID with storage capacity AT+VER=?? Example 2 IP2WiFi APP VERSION=5.1.4...
  • Page 65: Time Setting

    GS2200M IP2WiFi Adapter Command Reference Guide 4.2 Time Setting 4.2.1 Set System Time 4.2.1.1 Manual Setting This command is used to set the GS node’s system time to the time specified as the parameters and returns the standard command response. GS node expects either one of the time parameters.
  • Page 66: Get System Time

    GS2200M IP2WiFi Adapter Command Reference Guide 4.2.2 Get System Time This command is used to receive the current system time in milliseconds since epoch (1970) followed by the standard command response to the serial interface. AT+GETTIME=? Command Syntax Synchronous Response...
  • Page 67: Profile Setting

    GS2200M IP2WiFi Adapter Command Reference Guide 4.3 Profile Setting GS node supports different operating modes with various settings pre-configured to work with the system. A pre-defined set of variables can be stored in a profile. GS node currently supports storing two different profiles (profile0 and profile1).
  • Page 68: Save Profile

    GS2200M IP2WiFi Adapter Command Reference Guide 4.3.2 Save Profile This command is used to save the current profile. Upon deployment of this command, the current configuration settings are stored in non-volatile memory under the specified profile, (profile 0, or profile 1). In order to ensure that these parameters are restored after power cycling the GS node, the command AT&Y must also be issued, using the same profile...
  • Page 69: Load Profile

    GS2200M IP2WiFi Adapter Command Reference Guide 4.3.3 Load Profile This command is used to load a profile. Upon deployment of this command, the currently configured settings are overwritten by those stored in non-volatile memory under the specified profile. Command Syntax...
  • Page 70: Select Default Profile

    GS2200M IP2WiFi Adapter Command Reference Guide 4.3.4 Select Default Profile This command is used to select the default profile. The settings from the profile that are chosen as the default profile are loaded from non-volatile memory when the device is started.
  • Page 71: Restore Profile

    GS2200M IP2WiFi Adapter Command Reference Guide 4.3.5 Restore Profile This command is used to restore current profile to factory default values. The factory default values are stored in RAM, and will be lost after each power cycle. Upon deployment of this command, the current configuration variables are reset to the factory defaults.
  • Page 72 GS2200M IP2WiFi Adapter Command Reference Guide Table 37 Define Profile Parameters (Continued) Parameter Values Reference 802.11 Radio Mode Enabled, Disabled 6.1.1 Active Radio Receive, page 143 Wireless Interface Security Configuration Authentication Mode Open, Shared 5.3.8 Advanced Commands, page 122 PSK Valid Valid, Invalid 5.3.3.5 WPA-PSK and WPA2-PSK Key...
  • Page 73: Identification Information

    GS2200M IP2WiFi Adapter Command Reference Guide 4.3.7 Identification Information This command is used to return various identification information of GS node. ATIn Command Syntax Parameter Description Table 38, page 73 describes the Identification Information parameters. Table 38 Identification Information Parameters...
  • Page 74: Enhanced Asynchronous Notification

    GS2200M IP2WiFi Adapter Command Reference Guide 4.3.8 Enhanced Asynchronous Notification This command is used to support enhanced asynchronous notification method. AT+ASYNCMSGFMT=n Command Syntax Parameter Description Table 40, page 74 describes the Enhanced Asynchronous Notification parameters. Table 40 Enhanced Asynchronous Notification Parameters...
  • Page 75: Reset

    GS2200M IP2WiFi Adapter Command Reference Guide 4.4 Reset This command is used to reset the GS node. When this command is used without parameter (AT+RESET), it forcefully resets the module core and comes out with a fresh boot message “APP Reset-APP SW Reset”.
  • Page 76: Mac

    GS2200M IP2WiFi Adapter Command Reference Guide 4.5 MAC All new GainSpan modules will have “00:21:7E:xx:xx:xx” as MAC address with Telit Organizational Unique Identifier (OUI). 4.5.1 Set MAC Address NOTE: This command is obsolete as GS node uses the MAC address from OTP.
  • Page 77 GS2200M IP2WiFi Adapter Command Reference Guide Table 44, page 77 describes the synchronous responses and remarks for the Set MAC Address command. Table 44 Set MAC Address Synchronous Responses Responses Remarks Success ERROR:INVALID INPUT If value is not in the valid format.
  • Page 78: Get Mac Address

    GS2200M IP2WiFi Adapter Command Reference Guide 4.5.2 Get MAC Address This command is used to output the current MAC address of the wireless interface to the serial port. NOTE: 1.) The GS node is stored with two MAC addresses. One when it is in STA mode and the other when it is in AP mode.
  • Page 79 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev.1.0 2018-03-12...
  • Page 80 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev.1.0 2018-03-12...
  • Page 81: Chapter 5 Wireless

    GS2200M IP2WiFi Adapter Command Reference Guide Chapter 5 Wireless This chapter describes commands for configurations and operations related to WLAN layer. • Wireless Generic, page 81 • Beacon Mode (Unassociated Mode), page 93 • Station/AP Mode, page 104 • WiFi Direct Mode, page 123 5.1 Wireless Generic...
  • Page 82: Get Regulatory Domain

    GS2200M IP2WiFi Adapter Command Reference Guide Table 46 Set Regulatory Domain Parameters Parameter Optional/ Value Regulatory Supported Desired Power Level Mandatory Domain Channels Internal PA External PA (0 as default) (2 as default) 0 (default) 1 to 11 2-15 Regulatory Domain Mandatory...
  • Page 83: Operation Mode

    GS2200M IP2WiFi Adapter Command Reference Guide 5.1.2 Operation Mode This command is used to set the wireless mode and related parameters. Command Syntax AT+WM=<wireless mode>[,<beacon interval in LAP mode>,<broadcast ssid in LAP mode>, <no. of stations allowed in LAP mode>,<DTIM period in LAP mode>,<inactivity timeout in LAP mode>,<reserved>,<rate...
  • Page 84 GS2200M IP2WiFi Adapter Command Reference Guide Table 49 Mode Parameters Parameter Optional/Mandatory Value Description 1 - 16 No. of stations This configures the upper limit on the Minimum value: 1 allowed to associate Optional number of STAs to be allowed to associate...
  • Page 85 GS2200M IP2WiFi Adapter Command Reference Guide Table 49 Mode Parameters Parameter Optional/Mandatory Value Description This is used to derive minimum PHY rate in rate rate adaptation algorithm. 0-22 Mbps adaptation-minimum Optional Note: If rate adaptation - device type is application...
  • Page 86: Mac Retry

    GS2200M IP2WiFi Adapter Command Reference Guide 5.1.3 MAC Retry This command is used to set the current retry count set to the supplied value. AT+WRETRY=<n> Command Syntax Parameter Description Table 51, page 86 describes the Set Retry Count parameters. Table 51 Set Retry Count Parameters...
  • Page 87: Sync Loss Interval

    GS2200M IP2WiFi Adapter Command Reference Guide 5.1.4 Sync Loss Interval This command is used to set the GS node for sync loss interval for n times the beacon interval so that if the GS node does not receive the beacon for this time, it informs the user this event is “Disassociation event.”...
  • Page 88: Set Rts Threshold

    GS2200M IP2WiFi Adapter Command Reference Guide Table 55 Sync Loss Interval Asynchronous Responses Responses Remarks 314Disassociation Event Where, Subtype - 3 GS node does not receive beacons for this time Length - 14 (ASCII equivalent decimal is 20 characters, i.e., informs the user with this message.
  • Page 89: Transmit Data Rate

    GS2200M IP2WiFi Adapter Command Reference Guide Table 57 RTS Threshold Synchronous Responses Responses Remarks Success Example AT+WRTS=0 5.1.6 Transmit Data Rate NOTE: These commands are obsolete and they are retained for backward compatibility. It is recommended to use the default dynamic rate selection.
  • Page 90 GS2200M IP2WiFi Adapter Command Reference Guide Table 58 Set Transmit Rate Parameters Parameter Optional/Mandatory Value Corresponding Description Transmission Rate 1 MBPS 2 MBPS 5.5 MBPS 6.5 MBPS 6 MBPS 9 MBPS 11 MBPS This parameter specifies the 12 MBPS transmission rate for data frames.
  • Page 91: Get Transmit Rate

    GS2200M IP2WiFi Adapter Command Reference Guide Synchronous Response Table 59, page 91 describes the synchronous responses and remarks for the Set Transmit Rate command. Table 59 Set Transmit Rate Synchronous Responses Responses Remarks Success If parameters are not valid ERROR:INVALID INPUT...
  • Page 92: Graceful Shutdown Of Wlan

    GS2200M IP2WiFi Adapter Command Reference Guide 5.1.7 Graceful Shutdown of WLAN This command is used to prepare WLAN for graceful shutdown. It writes intermediate calibration data in SRAM to flash. This command needs to be used when there is a possibility of loosing calibration data and other WLAN related data stored in RAM or RTC memory.
  • Page 93: Beacon Mode (Unassociated Mode)

    GS2200M IP2WiFi Adapter Command Reference Guide 5.2 Beacon Mode (Unassociated Mode) Beacon mode or unassociated mode supports to receive and transmit frames on WLAN interface without association. 5.2.1 Unassociated/Unsolicited Tx This command is used to transmit 802.11 management frames, control frames, or data frames without associating with an Access Point based on the configured parameters.
  • Page 94 GS2200M IP2WiFi Adapter Command Reference Guide Table 62 Unassociated/Unsolicited Tx Parameters (Continued) Parameter Optional/Mandatory Value Description This field consists of two fields, 12 bits (LSB) of sequence number and 4 bits of (MSB) fragment number. Sequence Control Mandatory 0-65535 For more information, refer 802.11 specification.
  • Page 95 GS2200M IP2WiFi Adapter Command Reference Guide Table 62 Unassociated/Unsolicited Tx Parameters (Continued) Parameter Optional/Mandatory Value Description Types of frames with their values are as follows: • 1: Beacon frame • 2: Probe request frame • 4: Probe response frame • 8: Multi cast data frame •...
  • Page 96 GS2200M IP2WiFi Adapter Command Reference Guide Table 63, page 96 provides the transmission rate and the corresponding input value range for Power in Unassociated/unsolicited Tx command. Table 63 Transmission Rate and input value range for Power Transmission Rate Input Value Range for Power...
  • Page 97 GS2200M IP2WiFi Adapter Command Reference Guide Table 65 Unassociated/Unsolicited Tx command Examples Frame Control Example AT Command Type Type Description Subtype Subtype Description Bits-B7B6B5B4 Association AT+UNSOLICITEDTX=0,0,1,2,1, 0000 request 1,5,0,00:1d:c9:aa:bb:dd Association AT+UNSOLICITEDTX=16,0,1,2,1 0001 response ,1,5,0,00:1d:c9:aa:bb:dd Reassociation AT+UNSOLICITEDTX=32,0,1,2,1 0010 Request ,1,5,0,00:1d:c9:aa:bb:dd Reassociation...
  • Page 98: Unassociated/Unsolicited Rx

    GS2200M IP2WiFi Adapter Command Reference Guide AT+UNSOLICITEDTX=8,0,1,2,1,1,10,0,20:f8:5e:aa:25:05 For sending Data frame where sequence number is 1 and fragment number is 0 in Sequence Example 3 Control field: The hex value for the Sequence Control field = 0x0010 The decimal value for the Sequence Control field = 16...
  • Page 99 GS2200M IP2WiFi Adapter Command Reference Guide Table 66 Unassociated/Unsolicited Rx Parameters Parameter Optional/Mandatory Value Description Types of frames: • 1: Beacon frame • 2: Probe request frame • 4: Probe response frame • 8: Multi cast data frame • 16: Unicast data frame •...
  • Page 100 GS2200M IP2WiFi Adapter Command Reference Guide Table 66 Unassociated/Unsolicited Rx Parameters (Continued) Parameter Optional/Mandatory Value Description It is used to filter a frame based on the configured Information Element (IE) within a frame. Note: • This parameter is valid only when...
  • Page 101: Examples For Unassociated/Unsolicited Tx And Rx Commands

    GS2200M IP2WiFi Adapter Command Reference Guide – 0x06: CTS – 0x07: RTS – 0x08: Associated request – 0x09: Associated response – 0x0F: Raw data with MAC header • 3 bytes of reserved field which is left empty. • 4 bytes of time stamp in ticks which specifies the reception time-stamp of the frame at MAC layer.
  • Page 102: Unassociated/Unsolicited Rx Stop

    GS2200M IP2WiFi Adapter Command Reference Guide 5.2.3 Unassociated/Unsolicited Rx Stop This command is used to stop the unsolicited data reception. AT+UNSOLICITEDRXSTOP Command Syntax 1VV0301501 Rev. 1.0 2018-03-12...
  • Page 103: Unassociated/Unsolicited Data Encryption

    GS2200M IP2WiFi Adapter Command Reference Guide 5.2.4 Unassociated/Unsolicited Data Encryption This command is used to enable or disable encryption in unassociated/unsolicited mode. Command Syntax AT+UAMENC=<Enable/Disable>,<Encryption Type>,<Encryption Key>,<IE ID> Parameter Description Table 67, page 103 describes the Unassociated/unsolicited data encryption parameters.
  • Page 104: Station/Ap Mode

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3 Station/AP Mode 5.3.1 Scan Time Settings 5.3.1.1 Set Scan Time This command is used to set the minimum and maximum scan time per channel. The maximum scan time should always be greater than or equal to the minimum scan time.
  • Page 105: Get Scan Time

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3.1.2 Get Scan Time This command is used to display minimum and maximum scan time in milliseconds. AT+WST=? Command Syntax Synchronous Response Table 70, page 105 describes the synchronous responses and remarks for the Get Scan Time command.
  • Page 106: Authentication Mode

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3.2 Authentication Mode This command is used to configure the authentication mode. AT+WAUTH=n Command Syntax Parameter Description Table 71, page 106 describes the WiFi Security Configuration Authentication Mode parameters. Table 71 WiFi Security Configuration Authentication Mode...
  • Page 107: Security Configuration

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3.3 Security Configuration 5.3.3.1 Security Setting This command is used to configure the GS node with different security configuration. Command Syntax AT+WSEC=n Parameter Description Table 73, page 107 describes the Security Configuration parameters. Table 73 Security Configuration Parameters...
  • Page 108: Wep Keys

    GS2200M IP2WiFi Adapter Command Reference Guide Table 74, page 108 describes the synchronous responses and remarks for the Security Configuration command. Table 74 Security Configuration Synchronous Responses Responses Remarks Success If parameters are not valid. ERROR:INVALID INPUT (n value is other than above mentioned value)
  • Page 109: Wep Key Type Configuration

    GS2200M IP2WiFi Adapter Command Reference Guide Synchronous Response Table 76, page 109 describes the synchronous responses and remarks for the WEP Keys command. Table 76 WEP Keys Synchronous Responses Responses Remarks Success If parameters are not valid. ERROR:INVALID INPUT (n value is other than 1,2,3, and 4 or key is...
  • Page 110 GS2200M IP2WiFi Adapter Command Reference Guide Table 77 WEP Key Type Configuration Parameters Parameter Optional/Mandatory Value Description This parameter value enables ASCII mode where the WEP key entered through the AT+WWEPn=<key> enable ASCII Mandatory command are characters whose ASCII value gets stored.
  • Page 111: Wpa-Psk And Wpa2-Psk Passphrase

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3.3.4 WPA-PSK and WPA2-PSK Passphrase This command is used to set the WPA-PSK and WPA2-PSK passphrase. Upon receiving the command, the PSK passphrase is reset to the value provided. NOTE: It is recommended to use AT+WPAPSK command instead of the following 5.3.3.5 WPA-PSK and WPA2-PSK Key Calculation, page 112...
  • Page 112: Wpa-Psk And Wpa2-Psk Key Calculation

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3.3.5 WPA-PSK and WPA2-PSK Key Calculation This command is used to compute and store the value of the WPA/WPA2 PSK, derived from the SSID and Passphrase values. Computation of the PSK from the passphrase is complex and consumes substantial amounts of time and energy.
  • Page 113: Wpa-Psk And Wpa2-Psk Key

    GS2200M IP2WiFi Adapter Command Reference Guide Example AT+WPAPSK=GainSpanDemo,test12345 Computing PSK from SSID and PassPhrase... AT+WA=GainSpanDemo,,11 AT&W0 AT+PSSTBY=1000 Out of StandBy-Timer AT+WA=GainSpanDemo,,11 5.3.3.6 WPA-PSK and WPA2-PSK Key This command is used to configure the WPA/WPA2 PSK key directly. It directly sets the pre-shared key as provided.
  • Page 114 GS2200M IP2WiFi Adapter Command Reference Guide Synchronous Response Table 83, page 114 describes the synchronous responses and remarks for the WPA-PSK and WPA2-PSK Key command. Table 83 WPA-PSK and WPA2-PSK Key Synchronous Responses Responses Remarks Success After the PSK has been entered, the commands AT&W (to save the relevant profile) and AT&Y (to ensure that the profile containing the new...
  • Page 115: Scanning

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3.4 Scanning This command is used to scan for networks with the specified parameters and displays the results. Scanning can be performed to find networks with specific SSID or in a particular operating channel, or a combination of these parameters. Scanning for a specific SSID employs active scanning, in which probe requests are transmitted with the SSID fields being filled appropriately.
  • Page 116 GS2200M IP2WiFi Adapter Command Reference Guide Table 85 Scanning Synchronous Responses Responses Remarks <CR><LF><7 SP><BSSID><14 SP><SSID><21 SP><Channel><2 SP><TYPE><2 Success SP><RSSI><SP><Security><CR><LF><SP> Type is INFRA for infrastructure network and <CR><LF><No.Of><SP><AP><SP><Found:><CR><LF> ADHOC for ad-hoc networks. <CR><LF>OK<CR><LF> Example Use Case 1 - for Infrastructure...
  • Page 117: Association

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3.5 Association This command is used to create or join an infrastructure network (limited access point mode). AT+WA=<SSID>[,[<BSSID>][,<Channel>],[Rssi Flag],[WPS Command Syntax Registrar],[Unscheduled automatic power save delivery configuration]] • The WPS registrar is supported only with WPA/WPA2 security. It is not supported in Command Note open security.
  • Page 118 GS2200M IP2WiFi Adapter Command Reference Guide Table 86 Associate with Network or Create an AP Network Parameters Parameter Optional/Mandatory Value Description The SSID is a string containing between 1 and 32 SSID Mandatory 1-32 characters ASCII characters. See 2.7.3 SSID and Passphrase, page 30 for SSID format details.
  • Page 119 GS2200M IP2WiFi Adapter Command Reference Guide Table 86 Associate with Network or Create an AP Network Parameters (Continued) Parameter Optional/Mandatory Value Description This parameter specifies whether RSSI Flag is enabled or disabled based on the following configuration values: 0: GS node associates with AP of the first found...
  • Page 120: Disassociation

    GS2200M IP2WiFi Adapter Command Reference Guide 5.3.6 Disassociation This command is used to disassociate the current infrastructure network or stop the limited AP created by the node. It is also used to disconnect P2P mode. AT+WD Command Syntax Synchronous Response...
  • Page 121: Wlan Keep Alive Interval

    GS2200M IP2WiFi Adapter Command Reference Guide Table 90 Association Keep Alive Timer Parameters Parameter Optional/Mandatory Value Description 0 to 255 seconds Mandatory When set to 0, the Keep alive timer is disabled. 0 (default) Synchronous Response Table 91, page 121 describes the synchronous responses and remarks for the Association Keep Alive Timer command.
  • Page 122: Advanced Commands

    GS2200M IP2WiFi Adapter Command Reference Guide Table 92 WLAN Keep Alive Interval Parameters Parameter Optional/Mandatory Value Description 0 to 255 seconds This parameter specifies the time GS node keeps sending NULL frame to AP to Interval Mandatory maintain the association.
  • Page 123: Wifi Direct Mode

    GS2200M IP2WiFi Adapter Command Reference Guide Table 94 Get Clients Information Synchronous Responses Responses Remarks Success No. Of Stations Limited AP mode: Connected=<NoOfClients> MAC address and the IP of each of the client <MacAddr> IP <no> associated to the Limited AP. The IP address will be the one assigned to the client using DHCP.
  • Page 124 GS2200M IP2WiFi Adapter Command Reference Guide Command Syntax AT+P2PSETDEV=<Group owner intent value>,<Operating class>,<Listen channel>,<Operating channel>,<WPS config methods>, <country code><CR> Parameter Description Table 95, page 124 describes the Set Device parameters. Table 95 Set Device Parameters Parameter Optional/Mandatory Value Description The group owner intent value is p2p device’s...
  • Page 125: Set Wps

    GS2200M IP2WiFi Adapter Command Reference Guide Table 96 Set Device Synchronous Responses Events Verbose mode Non Verbose mode Remarks Success <CR><LF>OK<CR><LF> <CR><LF>0<CR><LF> All parameters are valid. Failure <CR><LF>ERROR:<SP>INPUT<CR><LF> <CR><LF>2<CR><LF> Parameters are valid. Example 1 AT+P2PSETDEV=7,81,6,6,2388,US Intent Value=7 Regulatory class:1-13 Listen class: 6...
  • Page 126: Start Find

    GS2200M IP2WiFi Adapter Command Reference Guide Table 97 Set WPS Parameters Parameter Optional/Mandatory Value Description Unique name to identify the device. P2P Device manufacturers should attempt to 32 bit character. create unique Device Names and user Device name Mandatory interfaces that maximize the probability of...
  • Page 127 GS2200M IP2WiFi Adapter Command Reference Guide Table 99 Start Find Parameters Parameter Optional/Mandatory Value Description If timeout is not specified, then it is 0 (default) considered as infinite, i.e., the system will be Timeout Mandatory (0 to 4294967296) in find phase forever or until stopped...
  • Page 128 GS2200M IP2WiFi Adapter Command Reference Guide Table 101, page 128 describes the asynchronous responses and remarks for the Set P2P Find command. Table 101 Start Find Asynchronous Responses Events Verbose mode Non Verbose mode Remarks Enhanced Enhanced Asynchronous Asynchronous Asynchronous...
  • Page 129: Stop Find

    GS2200M IP2WiFi Adapter Command Reference Guide 1. Mac addr, devaddr, type, config methods, device cap and group cap values are Command Note displayed in Hex. 2. P2P find is NOT supported in GO mode. 5.4.4 Stop Find This command is used to stop the P2P find operation that is currently in progress.
  • Page 130: Provoke

    GS2200M IP2WiFi Adapter Command Reference Guide 5.4.5 Provoke This command triggers the WPS- registrar functionality for GO. Once this command is issued the registrar automatically turns off after 120seconds. If the command is issued multiple times, the timeout starts from the last issued command.
  • Page 131: Provision Discovery

    GS2200M IP2WiFi Adapter Command Reference Guide 5.4.6 Provision Discovery This command is used to send provisioning discovery request to given peer with the given configuration method and wait for provisioning discovery response. AT+P2PPD=<peer P2P device MAC address>,<WPS configration Command Syntax method><CR>...
  • Page 132: Group Form (Group Owner Negotiation)

    GS2200M IP2WiFi Adapter Command Reference Guide Table 107 Provision Discovery Synchronous Responses Events Verbose mode Non Verbose mode Remarks Provision Discovery Response with Push Button Method • Peer p2p device triggers Provision Discovery Response with the push method and the Push Button Method <Provision Discovery Response with Push...
  • Page 133 GS2200M IP2WiFi Adapter Command Reference Guide This command is used to start P2P group formation with a discovered P2P peer.Before issuing this command P2Pfind has to be stopped. Command Syntax AT+P2PGRPFORM=<peer (p2p device)MAC address>,<peer (p2p device)listen channel>,<WPS config method>,<WPS PIN>,<group owner intent value>,<Trigger GO Negotiation Request>,<p2p group type><CR>...
  • Page 134 GS2200M IP2WiFi Adapter Command Reference Guide Table 108 Group Form (Group Owner Negotiation) Parameters Parameter Optional/Mandatory Value Description Note: The intent value in AT+P2PSETDEV is same asAT+P2PGRPFORM 0-Timeout per request id 1000ms, i.e, the time state expecting the GO negotiation 0- Trigger GO response.
  • Page 135 GS2200M IP2WiFi Adapter Command Reference Guide peer P2P device with MAC address “42:b0:fa:62:74:ac,1,4,,13,1,0” Channel 1 Push Button Method Intent value of 13 Don’t trigger “GO negotiation request” In case group owner, start temporary group. Response p2p-go-neg-complete client,<ssid>,<channel>,<GO device address>,<passphrase>|<psk> Example 1 - When a...
  • Page 136: Provision Discovery Request Handling

    GS2200M IP2WiFi Adapter Command Reference Guide AT+P2PGRPFORM=02:1d:c9:01:02:03,6,2,42746188,1,15,1,0 At the peer where the PIN needs to be displayed, the following command should be given: AT+P2PGRPFORM=02:1d:c9:01:02:04,6,3,42746188,0,4,0,0 The GO negotiation should happen between the two devices followed by provisioning and connection and then he following response is given out.
  • Page 137 GS2200M IP2WiFi Adapter Command Reference Guide Response - Display Method p2p-prov-disc-req display-pin <PIN> <peer address>,<device address>,>,<primary device category>,<primary device subcategory>,<secondary device category>,<secondary device subcategory>,<,<device name>,<config methods>,<device capability>,<group capability> The user action should be to show the PIN on a display and issue following.
  • Page 138: Client Join

    GS2200M IP2WiFi Adapter Command Reference Guide 5.4.8 Client Join This command is used to join the P2P group owner. Provision discovery request and response (AT+P2PPD) needs to be exchanged with the group owner’s intent to join. AT+P2PJOIN=<GO MAC address>,<wps config Command Syntax method>,<WPS-pin><CR>...
  • Page 139 GS2200M IP2WiFi Adapter Command Reference Guide Table 111 Client Join Synchronous Responses Events Verbose mode Non Verbose mode Remarks <CR><LF>p2p-join-success-client<SP>< <CR><LF>p2p-join-success-client<SP>< WPA-personal Connected SSID>,<channel><<MAC address for SSID>,<channel><<MAC address for PSK per shared key successfully to GO>WPA2-personal GO>WPA2-personal is 32bytes long PSK<CR><LF>OK<CR><LF>...
  • Page 140: Invitation Procedures

    GS2200M IP2WiFi Adapter Command Reference Guide 5.4.9 Invitation Procedures This command is used to send an invitation request to the given peer address to join an active group. AT+P2PINVITE=<peer p2p device MAC address><CR> Command Syntax The invitation is sent to request the peer to join the group for which this device is a GO or Usage to request the peer to join the group for which the device address is specified.
  • Page 141: Disconnect

    GS2200M IP2WiFi Adapter Command Reference Guide Table 114 Invitation Procedure Asynchronous Responses Events Verbose mode Non Verbose mode Remarks Enhanced Enhanced Asynchronous Asynchronous Asynchronous Asynchronous same as same as same as Peer P2P device doesn't <CR><LF>p2p-invitation-sent<SP verbose & verbose &...
  • Page 142 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev. 1.0 2018-03-12...
  • Page 143: Chapter 6 Power Management - Radio And System

    GS2200M IP2WiFi Adapter Command Reference Guide Chapter 6 Power Management - Radio and System This chapter describes the commands for configurations and operations related to power management for radio and system. • Radio Receiver Setting, page 143 • Battery Measurement, page 149 •...
  • Page 144 GS2200M IP2WiFi Adapter Command Reference Guide NOTE: The number of times radio is enabled using AT+WRXACTIVE, that many times has to be disabled. Example AT+WRXACTIVE=1 AT+WRXACTIVE=1 AT+WRXACTIVE=0 AT+WRXACTIVE=0 Radio receiver is always on, Power Save mode is enabled but will not save power since the Example Use Case 1 receiver is left on.
  • Page 145: Standard Power Save Radio Receive Based On Dtim/Listen Interval

    GS2200M IP2WiFi Adapter Command Reference Guide 6.1.2 Standard Power Save Radio Receive based on DTIM/Listen Interval 6.1.2.1 IEEE PS Poll Listen Interval This command is issued once to configure the mode (DTIM based wakeup, Listen interval based wake up or Custom wake up) and then to enable the configuration (in commands issued when configured for listen interval based wakeup).
  • Page 146 GS2200M IP2WiFi Adapter Command Reference Guide Table 117 IEEE PS Poll Listen Interval Parameters (Continued) Parameter Optional/Mandatory Value Description 0: DTIM based wakeup 1: Listen interval based wakeup Optional (valid if wakeup type is WakeupType 0 - 3 listen interval and custom)
  • Page 147 GS2200M IP2WiFi Adapter Command Reference Guide – Wake up for DTIM – Wake up for a custom number of beacons To configure the STA to wake up for the listen interval, the command is Wake up for Listen Interval AT+WIEEEPSPOLL=2,10,1. This means that the STA will advertise in the Association Request that the listen interval will be for every 10 beacons.
  • Page 148: Custom Power Save Radio Receive

    GS2200M IP2WiFi Adapter Command Reference Guide 6.1.3 Custom Power Save Radio Receive This command is used to enter Power Save Mode. Once enabled, radio will be switched off (after informing AP) when ever possible (e.g., in between beacons intervals, when there is no data transmission).
  • Page 149: Battery Measurement

    GS2200M IP2WiFi Adapter Command Reference Guide beacons, set by the Access Point configuration. Many Access Points default to 100msec between beacons; in most cases this parameter can be adjusted. 6.2 Battery Measurement 6.2.1 Battery Check Start This command is used to send out a unit of battery check frequency in number of packets from the IP-to-WiFi Application, and store the resulting values in nonvolatile memory.
  • Page 150: Battery Warning/Standby Level Set

    GS2200M IP2WiFi Adapter Command Reference Guide 6.2.2 Battery Warning/Standby Level Set This command is used to set the battery warning/standby level to and enable the GS node’s internal battery level monitoring logic starts. This command should be executed before the battery check start command (see 6.2.1 Battery Check Start, page...
  • Page 151: Battery Check Set

    GS2200M IP2WiFi Adapter Command Reference Guide 6.2.3 Battery Check Set This command is used to set/reset the battery check period after the battery check has been started. Upon receipt, the GS node records the new value of the battery check frequency so that GS node performs the battery voltage check with the new value set.
  • Page 152: Battery Check Stop

    GS2200M IP2WiFi Adapter Command Reference Guide 6.2.4 Battery Check Stop This command is used to halt battery check. Command Syntax AT+BCHKSTOP Response This command returns standard command response or ERROR, if the operation fails. 6.2.5 Battery Value Get This command is used to retrieve the results of battery check operations.
  • Page 153: System Power Save

    GS2200M IP2WiFi Adapter Command Reference Guide 6.3 System Power Save 6.3.1 Hibernate This command is used to enable the GS nodes to enter the hibernate mode. In this mode, the power consumption is at the lowest possible value and no information is retained in latch memory.
  • Page 154: Standby

    GS2200M IP2WiFi Adapter Command Reference Guide 6.3.2 Standby 6.3.2.1 Putting the System in Standby This command is used to request a transition to ultra-low-power Standby operation. Command Syntax AT+PSSTBY=x[,<DELAY TIME>,<ALARM1ALARM4 POL>,<ALARM2 POL>] When this command is issued, the GS node will enter the ultra-low-power Standby state...
  • Page 155 GS2200M IP2WiFi Adapter Command Reference Guide Table 128 Request Standby Mode Parameters Parameter Optional/Mandatory Value Description This is the Standby time in x=Standby time milliseconds. If a delay time is Mandatory in milliseconds provided, the Standby count begins after the delay time has expired.
  • Page 156: Enabling Standby Mode Between Beacons

    GS2200M IP2WiFi Adapter Command Reference Guide 6.3.2.2 Enabling Standby Mode Between Beacons This command is used to enable the GS node to transition to ultra low power standby mode between beacons. Command Syntax AT+PSSTBYBWBEACON=1 Parameter Description Table 130, page 156 describes the Enabling standby mode between beacons parameters.
  • Page 157: Configuring Standby Between Beacons

    GS2200M IP2WiFi Adapter Command Reference Guide 6.3.2.3 Configuring Standby Between Beacons This command is used to configure GS node to support transitioning to ultra low power standby mode between beacons. Command Syntax AT+PSSTBYBWBEACONCONF = <Conf ID>,<Value> Parameter Description Table 132, page 157 describes the Configuring standby mode between beacons parameters.
  • Page 158 GS2200M IP2WiFi Adapter Command Reference Guide Synchronous Response Table 133, page 160 describes the synchronous responses and remarks for Request Standby Mode command. 1VV0301501 Rev. 1.0 2018-03-12...
  • Page 159 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev. 1.0 2018-03-12...
  • Page 160: Deep Sleep

    GS2200M IP2WiFi Adapter Command Reference Guide Table 133 Configure Standby Mode Between Beacons Synchronous Responses Responses Remarks Success ERROR:INVALID INPUT If parameters are not valid. 6.3.3 Deep Sleep This command is used to enable the GS node’s power-saving Deep Sleep processor mode.
  • Page 161 GS2200M IP2WiFi Adapter Command Reference Guide Table 134 Enable/Disable GS node Deep Sleep Parameters Parameter Optional/Mandatory Value Description Node goes to deep sleep state for the Integer by 32bit configured time in milliseconds and upon Timeout Optional value time out exits the node from deep sleep state.Max time out value is 32 bit.
  • Page 162: Power Save In Limited Ap

    GS2200M IP2WiFi Adapter Command Reference Guide 6.3.4 Power Save in Limited AP This command is used to configure power save in Limited AP Mode. AT+WAPPSCFG=<Power-Save Command Syntax Configuration>,<Reserved>,<Receiver on-time after Tx>,<Power-save behavioral control> When enabled, the module will enter the power saving mode when no actions are pending.
  • Page 163: Hardware Cryptography

    GS2200M IP2WiFi Adapter Command Reference Guide The following table provides the behavior of an AP corresponding to the combination of values configured for Power-save control and Power-save configuration parameters. Table 137 AP behavior based on Power-Save Control and Power-Save Configuration...
  • Page 164 GS2200M IP2WiFi Adapter Command Reference Guide NOTE: If the user wants to save power or does not want to use this feature, then they are allowed to switch off the hardware crypto block. The SW internally keeps a count of ON and OFF requests and when the count becomes 0, it is switched off.
  • Page 165: Chapter 7 Peripherals

    GS2200M IP2WiFi Adapter Command Reference Guide Chapter 7 Peripherals This chapter describes commands for configurations and operations related to GainSpan supported peripherals. • GPIO Commands, page 165 7.1 GPIO Commands 7.1.1 GPIO Out HIGH/LOW This command is used to set or reset the GPIO ‘GPIO-NO’ pin level to high or low as per the SET/RESET parameter.
  • Page 166 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev. 1.0 2018-03-12...
  • Page 167: Chapter 8 Production And Debug

    GS2200M IP2WiFi Adapter Command Reference Guide Chapter 8 Production and Debug This chapter describes commands for configurations and operations used in Production and helpful in debugging. • RF Test, page 167 • Live Calibration, page 182 • Debug, page 187 8.1 RF Test...
  • Page 168: Gain Control Table

    GS2200M IP2WiFi Adapter Command Reference Guide 8.1.1.3 Gain Control Table Table 141 Gain Control Table Data Rate 1 Mbps 2 Mbps 5.5 Mbps 11 Mbps 6 Mbps 9 Mbps 12 Mbps 18 Mbps 24 Mbps 36 Mbps Data Rate 48 Mbps 54 Mbps MCS0...
  • Page 169 GS2200M IP2WiFi Adapter Command Reference Guide Table 142 Asynchronous Frame Transmission Parameters Parameter Optional/Mandatory Value Description Note: for continuous transmission, configure this parameter with the value 99. Once configured in continuous transmission mode, to come out of this mode, stop the test mode and start the test mode again (i.e., AT+WRFTESTSTOP, AT+WRFTESTSTART).
  • Page 170: Start Asynchronous Frame Reception

    GS2200M IP2WiFi Adapter Command Reference Guide Table 143 Asynchronous Frame Transmission Data Rates TxRate HtEnable Data Rate (Mbps) MCS0 MCS1 MCS2 MCS3 MCS4 MCS5 MCS6 MCS7 Example AT+WFRAMETXTEST=1,0,50000,1000,11,16,00:11:22:33:44:55,00 :50:c2:5e:10:99,0,0,0,0,0,4,0,2,0,1 NOTE: Check the wireless sniffer to see if the frames are on air.
  • Page 171 GS2200M IP2WiFi Adapter Command Reference Guide Table 144 Asynchronous Frame Reception Start Parameters Parameter Optional/Mandatory Value Description The channel on which the data is to be Channel Mandatory 1 to 14 sent (1-14). BandWidth Mandatory The values of 0 is 20MHz.
  • Page 172 GS2200M IP2WiFi Adapter Command Reference Guide No of packets received at 48M = 0 No of packets received at 54M = 6988 No of packets received atrespective MCS Index with Short GI=00000000 No of packets received atrespective MCS Index with Long GI=00000000 NOTE: This will receive frames with MAC address 00:1d:c9:17:8d:b1.
  • Page 173: Stop Asynchronous Frame Reception

    GS2200M IP2WiFi Adapter Command Reference Guide 8.1.1.8 Stop Asynchronous Frame Reception This command is used to stop RF reception. Command Syntax AT+WRXSTOP When the command is executed it stops the frame reception and displays the PER stats: Example AT+WRXTEST=6,0,4294930106,00:11:22:33:44:55,0 AT+WRXSTOP...
  • Page 174: Asynchronous Frame Transmission (Tx99 Mode)

    GS2200M IP2WiFi Adapter Command Reference Guide 8.1.1.9 Asynchronous Frame Transmission (TX99 mode) This command is used to enable TX99 mode. NOTE: Issue AT+WRFTESTSTART command before issuing the FrameTX test or the TX99 test commands; otherwise a WLAN exception/reset will occur.
  • Page 175 GS2200M IP2WiFi Adapter Command Reference Guide Table 145 Asynchronous Frame Transmission Parameters Parameter Optional/Mandatory Value Description 0, 1 GuardInterval Mandatory It specifies the guard interval. • 0 - Short guard interval • 1 - Long guard interval 0, 1 It specifies whether to enable or...
  • Page 176 GS2200M IP2WiFi Adapter Command Reference Guide Table 145 Asynchronous Frame Transmission Parameters Parameter Optional/Mandatory Value Description • 000 (0)- All 1’s • 001 (1)- All 0’s • 010 (2)- Alternate 1’s and 0’s It specifies the type of test pattern to •...
  • Page 177 GS2200M IP2WiFi Adapter Command Reference Guide Table 146 ModeSelect, TxRate, PHY test transmit rates for corresponding Data rates (TX99 mode) Data Rate (Mbps) ModeSelect Mode TxRate PhyTestTxRate MCS0 MCS1 MCS2 MCS3 802.11n MCS4 MCS5 MCS6 MCS7 To support data rate of 11 Mbps, configure the ModeSelect parameter to 1, TxRate Example for Mode 802.11b...
  • Page 178 GS2200M IP2WiFi Adapter Command Reference Guide Table 147 Examples for Asynchronous Frame Transmission (TX99 mode) Data Rate (Mbps) Example AT+WTX99TEST=1,0,99,1000,0,27,00:11:22:33:44:55,00:50: c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,3,0 AT+WTX99TEST=1,0,99,1000,0,27,00:11:22:33:44:55,00:50: c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,7,0 AT+WTX99TEST=1,0,99,1000,0,27,00:11:22:33:44:55,00:50: c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,2,0 AT+WTX99TEST=1,0,99,1000,0,27,00:11:22:33:44:55,00:50: c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,6,0 AT+WTX99TEST=1,0,99,1000,0,26,00:11:22:33:44:55,00:50: c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,1,0 AT+WTX99TEST=1,0,99,1000,0,25,00:11:22:33:44:55,00:50: c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,5,0 AT+WTX99TEST=1,0,99,1000,0,24,00:11:22:33:44:55,00:50: c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,0,0 AT+WTX99TEST=1,0,99,1000,0,19,00:11:22:33:44:55,00:50: c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,4,0 AT+WTX99TEST=1,0,99,1000,0,27,00:11:22:33:44:55,00:50: MCS0 c2:5e:10:99,0,0,0,0,0,0,0,0,0,0,3,0,2 AT+WTX99TEST=1,0,99,1000,1,27,00:11:22:33:44:55,00:50: MCS1...
  • Page 179: Asynchronous Frame Transmission (Tx100 Mode)

    GS2200M IP2WiFi Adapter Command Reference Guide 8.1.1.10 Asynchronous Frame Transmission (TX100 mode) This command is used to enable the TX100. Command Syntax AT+WTX100TEST=<Channel>,<BandWidth>,<TxPower>,<Antenna>,< Cca>,<Agc>,<ContPreambleMode>,<Spreader>,<Scrambler>,<Pre amble>,<PreambleType>,<TestPatternType>,<PhyTestTxRate>,< ModeSelect> Parameter Description Table 148, page 179 describes the Asynchronous Frame Transmission (TX100 mode) parameters.
  • Page 180 GS2200M IP2WiFi Adapter Command Reference Guide Table 148 Asynchronous Frame Transmission (TX100 mode) (Continued) Parameter Optional/Mandatory Value Description Selects the test pattern to be transmitted. TestPatternType Mandatory • 0 - All 1s • 1 - All 0s The rate will differ depending on the...
  • Page 181: Carrier Wave Transmission

    GS2200M IP2WiFi Adapter Command Reference Guide 8.1.1.11 Carrier Wave Transmission This command is used to enable the carrier wave transmission. Command Syntax AT+WCARWAVTEST=<Channel>,<BandWidth>,<TxPower>,<Antenna>, <CustomWavePeriod> Parameter Description Table 150, page 181 describes the Carrier Wave Transmission parameters. Table 150 Carrier Wave Transmission Parameters...
  • Page 182: Live Calibration

    GS2200M IP2WiFi Adapter Command Reference Guide 8.2 Live Calibration 8.2.1 Enable Live Calibration NOTE: This command is obsolete and it is retained for backward compatibility. This command is used to enable or disable live calibration. When live calibration is enabled, •...
  • Page 183 GS2200M IP2WiFi Adapter Command Reference Guide Parameter Description Table 151, page 183 describes the Live Calibration parameters. Table 151 Live Calibration Parameters Parameter Optional/Mandatory Value Description 0:Disables live calibration. 1:Enables live calibration. 0, 1, ? ?:Provides the current value of the live...
  • Page 184: Erase Live Calibration

    GS2200M IP2WiFi Adapter Command Reference Guide 8.2.2 Erase Live Calibration This command is used to erase the live calibration data in flash and reset live calibration to factory default settings. It invalidates any previous settings related to live calibration, erases all the previous information such as enable or disable live calibration from flash, and enables live calibration.
  • Page 185: Start Live Calibration

    GS2200M IP2WiFi Adapter Command Reference Guide 8.2.3 Start Live Calibration This command and associated API is added to support all-channel calibration for customers that want to perform all-channel calibration in their production line to get better performance right from beginning. The calibration is performed for ambient temperature range.
  • Page 186 GS2200M IP2WiFi Adapter Command Reference Guide Table 155 Start Live Calibration Synchronous Responses Responses Remarks Calibration Info: status = SUCCESS Length = Length of Calibration data Success Data: Calibration data Calibration Info: status = FAIL Length = Length of Calibration data...
  • Page 187: For Complete Sequence Of Live Calibration

    GS2200M IP2WiFi Adapter Command Reference Guide 8.2.4 For Complete Sequence of Live Calibration After cold boot, it is highly recommended to issue following live calibration commands before performing any of the Wi-Fi operations: AT+WLCALERASE AT+RESET AT+WLCALSTART=1 8.3 Debug 8.3.1 Log Level This command is used to configure the debug level so that the response of a command will include more information (error reason) in case of an error.
  • Page 188: Echo

    GS2200M IP2WiFi Adapter Command Reference Guide Table 157 Error Code Synchronous Responses Responses Remarks Success ERROR Failure AT+LOGLVL=1 Example - AT+WA=GSDEMO SSID NOT FOUND ERROR 8.3.2 Echo NOTE: This command is applicable for all the AT Commands, but not to their Responses.
  • Page 189: Verbose

    GS2200M IP2WiFi Adapter Command Reference Guide Synchronous Response Table 159, page 189 describes the synchronous responses and remarks for the Echo command. Table 159 Echo Synchronous Responses Synchronous Responses Remarks Success ERROR: INVALID INPUT If parameters are not valid. 8.3.3 Verbose This command is used to enable or disable verbose mode for synchronous and asynchronous responses.
  • Page 190: Rssi

    GS2200M IP2WiFi Adapter Command Reference Guide 8.3.4 RSSI This command is used to get information regarding the received signal strength of the incoming packets in dBm. All incoming management and data frames are considered. AT+WRSSI=? Command Syntax Synchronous Response Table 162, page 190 describes the synchronous responses and remarks for the Get RSSI command.
  • Page 191: Wlan Statistics

    GS2200M IP2WiFi Adapter Command Reference Guide Example 1 - Not AT+WSTATUS associated state NOT ASSOCIATED Example 2 - AT+WA=GainSpanDemo,,11 Associated state AT+WSTATUS MODE:0CHANNEL:11 SSID:”GainSpanDemo” BSSID:98:fc:11:4a:b8:56SECURITY:NONE 8.3.6 WLAN Statistics This command is used to transmit or request statistics from WLAN. After providing the statistics it resets all the counters.
  • Page 192 GS2200M IP2WiFi Adapter Command Reference Guide Table 164 GS Node WLAN TX Statistic Counters (Continued) WLAN Statistic Counters Description Legacy frames ht20l HT-LongGl-20MHz ht20s HT-Shrtl-20MHz ht40l HT-LongGl-40MHz ht40s HT-ShrtGl-40MHZ mcs32s MCS-32 ShortGl mcs32l MCS-32 LongGl probersp Probe response proberreq Probe request...
  • Page 193 GS2200M IP2WiFi Adapter Command Reference Guide Table 165 GS Node WLAN RX Statistic Counters (Continued) WLAN Statistic Counters Description irxtkipmf MIC failed for TKIP irxrf CCM Replay Failure irxtkiprf TKIP Replay Failure irxdip Defragmentation in Progress irxdf Defragmentation Failure irxex...
  • Page 194 GS2200M IP2WiFi Adapter Command Reference Guide Table 165 GS Node WLAN RX Statistic Counters (Continued) WLAN Statistic Counters Description amsdu_mc_data Unicast AMSDU data amsdu_oth_data Other AMSDU data oth_mgmt Other Management frame oth_ctrl Other Control frame Other type 1VV0301501 Rev. 1.0...
  • Page 195: Appendix A Response Codes

    GS2200M IP2WiFi Adapter Command Reference Guide Appendix A Response Codes This appendix provides a list of response codes for IP-to-WiFi AT commands. • Synchronous Messages, page 195 • Asynchronous & Enhanced Asynchronous Messages, page 195 The possible responses sent by the Adapter to the serial host are categorized as follows: •...
  • Page 196 GS2200M IP2WiFi Adapter Command Reference Guide Starts with “CR” and “LF” and ends with “CR” and “LF” or “\r\n” or “\n\r\” or “\r\n\r\n” or “\r\n\n\r”. Enhanced asynchronous message format: <ESC><Type><Subtype><Length><message> Table 167 Response codes for Asynchronous and Enhanced Asynchronous Messages...
  • Page 197 GS2200M IP2WiFi Adapter Command Reference Guide Table 167 Response codes for Asynchronous and Enhanced Asynchronous Messages Events Verbose mode Non Verbose Mode Asynchronous message Enhanced Asynchronous Enhanced asynchronous message message asynchronous message APP Reset-APP SW \n\rAPP Reset-APP SW <ESC>Af216APP <ESC>Af20211\r\...
  • Page 198 GS2200M IP2WiFi Adapter Command Reference Guide Table 167 Response codes for Asynchronous and Enhanced Asynchronous Messages Events Verbose mode Non Verbose Mode Asynchronous message Enhanced Asynchronous Enhanced asynchronous message message asynchronous message <ESC>F<CR><LF>Erro Error verifying signature r<SP>verifying<SP>sign \r\n40\r\n ature<CR><LF> <ESC>Af0021c\r\ p2p-Dev-found <SP>P2P Dev Found\r\n <ESC>Af0...
  • Page 199: Exception Messages

    GS2200M IP2WiFi Adapter Command Reference Guide A.3.1 Exception Messages The possible exception messages sent by the Adapter to the serial host are enumerated in Table 168, page 199. Table 168 Exception Messages ASCII String Meaning Adapter reset due to WLAN \r\n\n\rAPP Reset-Wlan SW Reset\r\n\r\n processor software reset.
  • Page 200: Boot Messages

    GS2200M IP2WiFi Adapter Command Reference Guide A.3.2 Boot Messages The possible boot messages sent by the Adapter to the serial host are enumerated in Table 169, page 200. Table 169 Boot Messages ASCII String Meaning Normal IP-to-WiFi adapter boot \r\nIP2WiFi APP\r\n message with internal PA.
  • Page 201 GS2200M IP2WiFi Adapter Command Reference Guide – DATA+ASYNCHRONOUS MESSAGE – COMMAND RESPONSE + DATA – COMMAND RESPONSE + ASYNCHRONOUS MESSAGE NOTE: a.) If S2W ECHO is disabled, then whenever HOST MCU issues any AT command, GainSpan only responds with corresponding COMMAND RESPONSE.
  • Page 202 GS2200M IP2WiFi Adapter Command Reference Guide 1VV0301501 Rev. 1.0 2018-03-12...

Table of Contents