1VV0301426, Rev 1.0

Copyright © 2017 Telit. All rights reserved.

GS2200M SKB TLS Low Power Quick Start GuideSupports GS2200Mxx SKBThis Quick Start Guide will walk you through the steps to setup andrun Temperature and Light (TLS) Low Power application onGS2200M SKB (Starter Kit Board).

You will need the following items:

• GS2200M Starter Kit Board• Serial Cable (USB to Mini-USB)• Windows PC• Wi-Fi Access Point/Network• Tera Term VT Utility installed on PC

1 Build the Package

Step 1 Open the SDK Builder www.gainspan.com/secure/login and select the following for TLS Low Power:

If you do not have a login, sign up and register for aPortal account at:https://www.gainspan.com/secure/register.

Step 2 Based on the Application/Use Case customer intends to use, following options are to be selected in SDK Builder.

Use Case1: Periodic data upload to Cloud (Standby Mode).

a).On the ‘Product Info’ page, select use case “periodic update to the server”.

TLS LP AEK comes up in provisioning Limited-AP mode or STA mode based on default System mode selected in System Configuration tab in SDK Builder. Provisioning Limited-AP mode is limited only to provision the GS node to an Access Point or to do ‘Over the Air Firmware Upgrade’ when newer firmware versions are available.

In Client Mode, TLS LP ADK showcases the low power capabilities of GS node such as hibernate, standby, fast boot-up from hibernate, maintaining association with Access Point across standby, maintaining association with Cloud Server consuming very low power by going into standby across beacons. All the above mentioned capabilities are demonstrated using 3 use cases namely,

1. Periodic data upload to Cloud (Standby Mode)2. Event Notification to Cloud (Hibernate Mode)3. Always Cloud Connected (PS POLL Applet Mode)

b). On the ‘Connectivity Conf’ tab, enter details of the Access Point to which GS node has to connect and the Server to which data is sent. Server can be HTTPS or UDP.

(i) Selection - if the server is HTTPS

1VV0301426, Rev 1.0

Copyright © 2017 Telit. All rights reserved.

Use Case2: Event Notification to Cloud (Hibernate Mode)

a). On the ‘Product Info’ page, select use case “”sending asynchronous events to the server”.

b). Asynchronous events can be sent either to HTTPS Server or UDP Server, enter the details in ‘Connectivity Conf’ tab.

(i) Selection - if the server is HTTPS

(ii) Selection - if the server is UDP

Use Case 3: Always Cloud Connected (PS POLL Applet Mode)

a). On the ‘Product Info’ page, select use case “Always Cloud con-nected ready to receive asynchronous events from cloud server”

Step 3 Browse through each tab and proceed selection by click-ing on the NEXT button.

a). In the “System Configuration” tab, select “Connectivity Mode” and disable power profiling option so that the serial logs are seen. Optionally disable ‘Event Profiling’ logs to avoid more logs on serial terminal.

(ii) Selection - if the server is UDPb). Details regarding the HTTPS cloud server needs to be added in “Connectivity Conf” tab.

1VV0301426, Rev 1.0

Copyright © 2017 Telit. All rights reserved.

3 Configure the Serial TerminalOpen a Serial Terminal Emulation Software of your choice. Select the serial COM port associated with the board. In this example we are using Tera Term VT. You can download a copy of Tera Term VT at: http://ttssh2.sourceforge.jp/

Setup the Serial port as below:

Step 4 Press and hold down both the PROGRAM and RESTORE buttons, simultaneously press and release the RESET button to put the GS2200 SKB into flash programming mode. Now release the PROGRAM and RESTORE buttons.

Step 5 Launch the GainSpan Serial Flash Programmer GUI utility from "\Tools\GS_programming_tool\gs2k_flashprogram.exe".

Step 6 Select UART interface, the port assigned to the SKB is921600 baud.

Step 7 Click Check Connection -if the status reported is Con-nection OK, proceed else repeat steps 2 through step 6 carefully verifying the UART settings are correct and ensure the button pressing sequence exactly as described.

Step 3 Switch SKB power switch to the ‘ON’ position and check if the green LED near the switch is illuminated.

Step 2 Ensure the Power Measurement Switch SW6 is in the “ACTIVE” Position.

Note: If this is the first time connecting the board, it may take Windows a few minutes to install the USB serial port driver.Ensure the driver is installed properly.

Step 1 Plug the mini-USB cable, one end of the USB port to GS2200 SKB USB and the other end of the USB port to the com-puter or laptop.

2 Program the GS2200M SKB

4 Run the GS2200M SKBThe ultra low power capabilities GainSpan silicon (SoC) and itsmodules (primarily GS2011Mxx and GS2200Mxx) with TLS LowPower Application are demonstrated in 3 use cases for which beloware the prerequisites.

Pre-requisites:

1. All the Low power capabilities of GS2200 SKB are demonstrated only in Client Mode. GS node can be started in Client Mode in two ways:

- Configure SDK Builder, under ‘System Configuration’ tab, the Fac-tory Default System Mode should be ‘Connectivity Mode’.

OR- Provision the GS node to connect to an Access Point of your

choice. In this case, GS node will come up in ‘Provisioning Mode (Limited AP mode) and connect iPhone/Android phone and provi-sion the GS2200M SKB to connect to any Access Point.

Step 8 Browse to and select the Super Block file, named superblock… and select the Current FW Version file name gs2200…,located at “\Embedded”.”Erase and Program” button and wait for the programming utility to indicate it has finished programming.

c). Continue with the default selection and submit the build to generate the firmware.

Step 4 Once firmware is generated, an email notification about the build completion is sent and the firmware package can be downloaded using the HISTORY tab on SDK Builder.

b). Click the NEXT tab for “Battery Life Calculator” (is an optional setting), if customer desires to know the battery life for the use case

1VV0301426, Rev 1.0

Copyright © 2017 Telit. All rights reserved.

4a Use Case 1: Periodic Data upload to Cloud (Standby)

Using HTTPS

Step 1 Open SDK Builder and follow the steps as in “1 Build Package” and “2 Program the GS2200M SKB”. GS node powers up, does an L2 connect and gets IP address. Now GS node establishes HTTPS connection (HTTPS Server should have been started) and send 256 bytes of non-sensor data. The serial logs are seen below:

Step 2 Refer “GS2K TLS Low Power Server Setup User Guide.pdf” document to start the HTTPS server on Laptop at port 443. HTTPS Server logs will be in “C:\Apache2\cgi-bin\” which will show the data being received periodically (every 3 minutes in this example).

Using UDP

Step 1 Open SDK Builder and follow the steps as in “1 Build Package” and “2 Program the GS2200M SKB”. GS node powers up, does an L2 connect and gets IP address. Now GS node estab-lishes UDP server connection (UDP Server should have been started) and send 256 bytes of non-sensor data. The serial logs are seen below:

3. If the debug prints are not seen on serial port of Tera-term, check whether “Power Profiling = Enable” is enabled in the “buildCong.txt”. This option is enabled only while performing power measurement and disabled when the logs on serial port is required.

2. All the 3 use cases demonstrated interact with cloud servers and would require the below mentioned ‘Server and Software’ to be installed:

Use Case 1: a).Periodic data upload to cloud (Standby) over HTTPSb).Periodic data upload to cloud (Standby) over UDPRequired Server & Software: a).HTTPS Server with Apache Softwareb). UDP Server with Nodejs

Use Case 2: a).Event Notification to Cloud (Hibernate) over HTTPSb).Event Notification to Cloud (Hibernate) over UDPRequired Server & Software: a).HTTPS Server with Apache Softwareb).UDP Server with Nodejs

Use Case 3: Always Cloud Connected (PS POLL Applet Mode)Required Server & Software: TCP SSL Server with Nodejs

In the “buildConfig.txt” file which is part of the downloaded pack-age, check the “#UseCase=…” mentioned and based on that the respective server and software needs to be setup for evaluation. Refer “GS2K TLS Low Power Server Setup User Guide.pdf” from documentation folder.

1VV0301426, Rev 1.0

Copyright © 2017 Telit. All rights reserved.

Step 2 Refer “GS2K TLS Low Power Server Setup User Guide.pdf” to start the UDP server on Laptop at port 8255 (it should be the same as specified in SDK Builder). On the command prompt, 256 bytes of data will be received on the server every 5 minutes.

4b Use Case 2: Event Notification to Cloud (Hibernate Mode)

Step 1 Open SDK Builder and follow the steps as in “1 Build Package” and “2 Program GS2200M SKB”. GS node powers up, does an L2 connect and gets IP Address. Now GS node estab-lishes HTTPS connection and send 256 bytes of non-sensor data that goes into hibernate mode. It can be woken up only by wake button. When woken up, the boot info indicates as 1 and GS node will send 256 bytes of non-sensor data to configure the server. The serial logs are seen below:

Step 2 Similar to Use Case 1, either HTTPS Server or UDP Server will receive the data based on configuration in SDK Builder. The example shows HTTPS Server receiving the data.

1VV0301426, Rev 1.0

Copyright © 2017 Telit. All rights reserved.

4c Use Case 3: Always Cloud Connected (PS POLL Applet Mode)

Step 1 Open SDK Builder and follow the steps as in “1 Build Package” and “2 Program GS2200M SKB”. GS node powers up, does an L2 connect and gets IP Address.Now GS node establishes HTTPS connection and waits for events from the cloud server. GS module is always connected to the cloud server in low-power mode. The module is woken up by the remote SSL TCP server. SSL TCP Server is chosen instead of HTTPS Server as control is better over server configuration.

Step 2 Refer “GS2K TLS Low Power Server Setup User Guide.pdf” to start the SSL TCP server on Laptop. SSL TCP Server scripts has option to send events to GS node periodically or by trigger. Start “tls-lp_tcpSslServer_wakeup_by_timer.js” to send periodic event.

For example, TCP Server @port 9000 is started and the event is triggered every 60 seconds.

Step 3 Check the “logfile1.txt” on the server, observe that:

a. Server has periodically sent an event to GS node every 60 seconds. b. GS node will send 256 bytes of data as a response. c. Server will send an acknowledgment along with 256 bytes of data to GS node. d. Every 5 minutes, GS node will send a Keep Alive packet to the Server so that the Server doesn’t throw away GS node client due to inactivity.

• GS2K SDK Application Programming Guide - If SDK is purchased, for setting up, compiling, and debugging

firmware using IAR IDE. This also has reference codes for var-ious use cases, debugging mechanisms, detailed description of various modules and features and much more

• GS2K S2W Use Case Reference Guide - For sequence of AT commands to be used for any particular

use case

• GS2200M S2W Adapter Command Reference Guide - For detailed description of every AT command

• GS2K SKB Hardware User Guide• GS2K TLS Low Power Server Setup User Guide

- For evaluation board description and hardware setup, jumper settings, component description, board specifications, and pin outs

• GS2K Live Calibration Application Note- For calibrating the module for optimum reception, which needs

to be done once in the lifetime of the product unless the flash is erased completely for some reason

• GS2K Memory Map and File System Application Note- Provides the memory architecture of the Wi-Fi modules and

provide details about types of memory, location, and content of various items in these memory locations

For further information, please visit the website link:https://www.telit.com/products/wifi-and-bluetooth/#wifi

Technical and Product SupportFor any clarification, technical and product support, pleasee-mail to Telit Technical Support at:TS-SRD@telit.com

We recommend adding “Wi-fi” in subject of the e-mail. For exam-ple, the subject of e-mail can be “Wi-Fi: Association failing”, “Wi-Fi: SPI Driver Issue”.Also, in description of your e-mail, please provide details aboutthe issue, product, module and use case including software firm-ware version, module version and type, application being used,customizations done to application, use case and issue fre-quency and ability to recreate it.

Information

For information, please refer to the following documents:

• GS2K SDK Builder User Guide- Configuring and generating custom S2W firmware binary

images from web portal based on features required

• GS2K Module Programming User Guide- How to Program the module