Page is loading ...
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:
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
/