Telit Wireless Solutions WL865E4-P Use Case Reference Manual

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 1 2019-06-14

PRELIMINAR

Y

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 – 2019-06-14

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 2 2019-06-14

PRELIMINAR

Y

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 licensors contained herein or in the Telit

products described in this instruction manual may not be copied, reproduced, distributed, merged

or modified in any manner without the express written permission of Telit. Furthermore, the

purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel,

or otherwise, any license under the copyrights, patents or patent applications of Telit, as arises

by operation of law in the sale of a product.

COMPUTER SOFTWARE COPYRIGHTS

The Telit and 3rd Party supplied Software (SW) products described in this instruction manual

may include copyrighted Telit and other 3rd Party supplied computer programs stored in

semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit

and other 3rd Party supplied SW certain exclusive rights for copyrighted computer programs,

including the exclusive right to copy or reproduce in any form the copyrighted computer program.

Accordingly, any copyrighted Telit or other 3rd Party supplied SW computer programs contained

in the Telit products described in this instruction manual may not be copied (reverse engineered)

or reproduced in any manner without the express written permission of Telit or the 3rd Party SW

supplier. Furthermore, the purchase of Telit products shall not be deemed to grant either directly

or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent

applications of Telit or other 3rd Party supplied SW, except for the normal non-exclusive, royalty

free license to use that arises by operation of law in the sale of a product.

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 3 2019-06-14

PRELIMINAR

Y

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 prohib-

ited by law. No part of the software or documentation may be reproduced, transmitted, tran-

scribed, 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 Sup-

port, 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 SOFT-

WARE IS DERIVED (COLLECTIVELY “OTHER CODE”), AND THE USE OF ANY OR ALL THE

OTHER CODE IN CONNECTION WITH THE SOFTWARE, INCLUDING (WITHOUT LIMITA-

TION) 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.

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 4 2019-06-14

PRELIMINAR

Y

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 5 2019-06-14

PRELIMINAR

Y

Contents

NOTICE ........................................................................................................................................2

COPYRIGHTS ..............................................................................................................................2

COMPUTER SOFTWARE COPYRIGHTS ...................................................................................2

USAGE AND DISCLOSURE RESTRICTIONS ............................................................................3

I.License Agreements ............................................................................................................3

II.Copyrighted Materials .........................................................................................................3

III.High Risk Materials ............................................................................................................3

IV.Trademarks ........................................................................................................................3

V.Third Party Rights ...............................................................................................................3

Document History ............................................................................................................................. 7

1 Introduction .................................................................................................................................... 8

1.1 Scope ......................................................................................................................................8

1.2 Audience ..................................................................................................................................8

1.3 Contact Information, Support ...................................................................................................8

1.4 Text Convention ......................................................................................................................9

1.5 Related Documents .................................................................................................................9

1.5.1 Related Documents and Download ................................................................................9

1.5.2 Related Documents requiring a Non Disclosure Agreement ........................................10

2 General Operations ...................................................................................................................... 11

2.1 IP Configuration .....................................................................................................................11

2.1.1 Static IP Configuration .................................................................................................11

2.1.1.1 Use Case 1: Static IP Configuration ....................................................................11

2.1.2 DHCP Server ...............................................................................................................12

2.1.2.1 Use Case 1: Start DHCP Server ..........................................................................12

3 Wireless ........................................................................................................................................ 13

3.1 Wireless Mode .......................................................................................................................13

3.1.1 Station Mode ................................................................................................................13

3.1.1.1 Use Case 1: Create a Station Mode ....................................................................13

3.1.2 Limited AP Mode ..........................................................................................................15

3.1.2.1 Use Case 1: Create an Access Point/Network/Limited AP ..................................15

3.2 Concurrent Mode ...................................................................................................................16

3.2.1 Use Case 1:To configure WL865E4-P module in Concurrent Mode ............................16

4 Data Transfer ................................................................................................................................ 19

4.1 TCP (Transmission Control Protocol) ....................................................................................19

4.1.1 TCP Client ....................................................................................................................19

4.1.1.1 Use Case 1: .........................................................................................................19

4.1.2 TCP Server ..................................................................................................................21

4.1.2.1 Use Case 1: .........................................................................................................21

4.2 UDP (User Datagram Protocol) .............................................................................................22

4.2.1 UDP Client ...................................................................................................................22

4.2.1.1 Use Case 1: .........................................................................................................22

4.2.2 UDP Server ..................................................................................................................24

4.2.2.1 Use Case 1: .........................................................................................................24

4.3 HTTP Client (HTTPC) ............................................................................................................25

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 6 2019-06-14

PRELIMINAR

Y

4.3.1 Use Case 1: .................................................................................................................25

4.4 MQTT ....................................................................................................................................26

4.4.1 Use Case 1: .................................................................................................................26

5 Advanced Services ....................................................................................................................... 29

5.1 Application Features ..............................................................................................................29

5.1.1 Provisioning .................................................................................................................29

5.1.1.1 Use Case 1: Wi-Fi Provisioning with BLE ............................................................29

5.1.2 Firmware Upgrade ......................................................................................................37

5.1.2.1 Use Case 1: Firmware upgrade using OTAFU ....................................................37

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 7 2019-06-14

PRELIMINAR

Y

Document History

Revision Date Changes

0.0 June 2019 First Issue.

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 8 2019-06-14

PRELIMINAR

Y

1 Introduction

• Scope, page 8

• Audience, page 8

• Contact Information, Support, page 8

• Text Convention, page 9

• Related Documents, page 9

1.1 Scope

This manual provides references for using Telit “AT” commands and it’s usage in different

scenarios using different features and protocols. It is to be used as a reference guide for

using a set of AT commands customized as per host requirements.

This document provides AT command use cases and examples for all layers and it needs to

be used as reference only.

1.2 Audience

This document is intended for Telit customers, who are integrators, about to implement

their applications using our WL865E4-P modules.

Readers of this document should be familiar with Telit modules and their ease of

controlling by means of AT Commands.

1.3 Contact Information, Support

For general contact, technical support services, technical questions and report

documentation errors contact Telit Technical Support at:

• [email protected]

For detailed information about where you can buy the Telit modules or for

recommendations on accessories and components visit:

https://www.telit.com

Our aim is to make this guide as helpful as possible. Keep us informed of your comments

and suggestions for improvements.

Telit appreciates feedback from the users of our information.

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 9 2019-06-14

PRELIMINAR

Y

1.4 Text Convention

Table 1, page 9, shows the symbol conventions used in this manual for notification and

important instructions.

All dates are in ISO 8601 format, i.e. YYYY-MM-DD

1.5 Related Documents

Please refer to http://www.telit.com/ for current documentation and downloads.

1.5.1 Related Documents and Download

– Datasheets

– Product User Guides

– EVK User Guides

– Software User Guides

– Application Notes

– TelitView installation and documentation

Table 1 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.

Danger

Indicates information MUST be followed or

catastrophic equipment failure or bodily injury may

occur

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 10 2019-06-14

PRELIMINAR

Y

1.5.2 Related Documents requiring a Non Disclosure Agreement

– Authorized Software User Guides

– Product firmware

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 11 2019-06-14

PRELIMINAR

Y

2 General Operations

This chapter describes the use cases for generic operations as required by Serial to Wireless

Application.

• IP Configuration, page 11

2.1 IP Configuration

2.1.1 Static IP Configuration

2.1.1.1 Use Case 1: Static IP Configuration

Description In this use case, 192.168.45.3 is used as fixed IP address to configure the Telit node in

station mode.

Prerequisite NA

Precondition NA

Setup Architecture The setup requires an AP (router) and a Telit node which act as Station, where the Station

connects to AP and uses a user defined IP address.

Procedure Following commands are used to configure the static IP address in station mode.

at+WNI=0 // for station mode

at+WNIPC=0,1,192.168.45.3,255.255.255.0,192.168.45.1

Logs NA

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 12 2019-06-14

PRELIMINAR

Y

2.1.2 DHCP Server

2.1.2.1 Use Case 1: Start DHCP Server

Description To configure Telit node in AP mode and enable DHCP server, where the client associates

to the node and obtains an IP address automatically.

Prerequisite NA

Precondition NA

Setup Architecture The setup requires two nodes, where one node act as AP and another act as STA. These

nodes connect to the AP node and obtain IP address specified by the DHCP server in AP

node.

Procedure Following commands are used to configure DHCP server AP mode, where the node is in

AP mode and starts the DHCP server specifying the IP address to the client within the

specified range.

at+WNI=1

at+WNIPC=0,1,192.168.45.3,255.255.255.0,192.168.45.1

at+WNAPIPC=0,192.168.45.4,192.168.45.10,10000

Logs NA

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 13 2019-06-14

PRELIMINAR

Y

3 Wireless

This chapter describes the use cases for configurations and operations related to advanced

services of Network and WL865E4-P supported Application features.

• Wireless Mode, page 13

• Concurrent Mode, page 16

3.1 Wireless Mode

3.1.1 Station Mode

3.1.1.1 Use Case 1: Create a Station Mode

Description Demonstrates the configuration of Telit module in Station mode and connects to the AP.

Prerequisite AP or router must be in ON state with specific SSID.

Precondition NA

Setup Architecture The setup requires a AP (router) and a Telit node in Station mode.

Procedure Following commands are used to configure Telit module in station mode, configure the

node as STA and connect the STA node to an AP (AE_Hardik).

at+wni=0 // '0' for station mode

at+wncn=1,"AE_Hardik" // at+wncn=1,"ssid"

Logs

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 14 2019-06-14

PRELIMINAR

Y

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 15 2019-06-14

PRELIMINAR

Y

3.1.2 Limited AP Mode

3.1.2.1 Use Case 1: Create an Access Point/Network/Limited AP

Description NA

Prerequisite NA

Precondition NA

Setup Architecture NA

Procedure Following commands are used to configure Telit module in AP mode, configure the node

as AP, where the IP of the node is set as 192.168.45.3 and the SSID set as GS_LAP.

at+WNI=1 // '1' for AP mode

at+WNIPC=0,1,192.168.45.3,255.255.255.0,192.168.45.1

at+WNAPIPC=0,192.168.45.4,192.168.45.10,10000

at+WNCR=0,"GS_LAP",6,"NONE","NONE"

(Check Wi-Fi AP list of on the laptop -'GS_LAP' has appeared as Limited AP)

Logs

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 16 2019-06-14

PRELIMINAR

Y

3.2 Concurrent Mode

3.2.1 Use Case 1:To configure WL865E4-P module in Concurrent Mode

Description NA

Prerequisite NA

Precondition NA

Setup Architecture NA

Procedure Following are the steps used to configure WL865E4-P module in concurrent mode.

Enable New AT Commands by using AT+YLC=0.

2.Initial NCM for STA mode by using the command AT+WNI.

3.Connect the module to the Access Point of SSID - “Telit_Demo”, channel – 6 and

Passphrase – “Telit123” by using command AT+WNCN.

4.Initial NCM for AP mode by using the command AT+WNI.

5.Set the static IP configurations for AP (IP address, subnet mask and Gateway) as

192.168.240.1,255.255.255.0,192.168.240.1 by using AT+WNIPC command.

6.Set the range of the IP address as 192.168.240.10 – 192.168.240.25 and DHCP lease time

– 8640000(seconds) by using AT+WNAPIPC command so that connected stations will get

IP address in the range.

7.Set SSID, channel, security type, Encryption type and passphrase by using command

AT+WNCR.

8.Start Web Provisioning server b using the command AT+WNWEBPROV.

9.Issue AT+WNIFCFG to get the current configuration of different interfaces

AT+YLC=0

AT+WNI=0

AT+WNCN=1,"Telit_Demo","Telit123"

AT+WNI=1

AT+WNIPC=0,1,192.168.240.1,255.255.255.0,192.168.240.1

AT+WNAPIPC=0,192.168.240.10,192.168.240.25,8640000

AT+WNCR=0,"Telit_AP_Demo",6,"WPA2","AES","123456789"

AT+WNWEBPROV=1

AT+WNIFCFG

10.Connect any other network STA like Laptop or mobile to the AP “Telit_Demo” and ping

to Telit STA (192.168.0.122).

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 17 2019-06-14

PRELIMINAR

Y

Now connect your Laptop to "Telit_AP_Demo"

11.Open the Chrome Browser. Enter the following URLhttp://192.168.240.1/telit.html.

This will open the webpage and asks to enter Authentication credentials. Enter "admin",

“admin” as username and password.

While ping is responding over the STA Interface, Telit module responds to the Laptop as

well by serving the webpages.

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 18 2019-06-14

PRELIMINAR

Y

Logs

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 19 2019-06-14

PRELIMINAR

Y

4 Data Transfer

This chapter describes the use cases for configurations and operations related to advanced

services of Network and WL865E4-P supported Application features.

• TCP (Transmission Control Protocol), page 19

• UDP (User Datagram Protocol), page 22

• HTTP Client (HTTPC), page 25

•

4.1 TCP (Transmission Control Protocol)

This section describes how to setup the TCP Server/Client with Telit module using the AT

command mode.

4.1.1 TCP Client

4.1.1.1 Use Case 1:

Description Demonstrates the transfer of data from Telit node (TCP client) to TCP server, where the

Telit node is configured as TCP client and sends data to TCP server.

Prerequisite Installation of Hercules utility on the PC.

Precondition TCP server must be configured to Hercules.

Setup Architecture The setup requires a Telit node (STA), a AP or router and a Hercules utility which act as

TCP server.

Procedure Following commands are used to configure the Telit node as a TCP client to send data 'telit'

to TCP server (IP address - 192.168.0.96, port - 1234)

AT+WNI=0

AT+WNCN=1,”Telit_Guest”,”qwerty123456”

AT+SC=2,1,0

AT+SCO=0,192.168.0.96,1234 //at+sco=CID, server ip, server port

AT+SN=0,,,5,telit //at+sn=CID,,,datalen, data

Logs

WL865E4-P Use Case Reference Guide

1VV0301570 Rev. 0.0 20 2019-06-14

PRELIMINAR

Y

Page is loading ...

Telit Wireless Solutions WL865E4-P Use Case Reference Manual

Related papers

Other documents