Telit Wireless Solutions NE310H2 User manual

[01.2017]
Mod. 0809 2017-01 Rev.8
NE310H2 & NL865H2
Quick Start Guide
80630NT11837A Rev. 1 –2020-09-03

80630NT11837A Rev. 1 Page 2of 40 2020-09-03
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 tonotify 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 theTelit 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.

80630NT11837A Rev. 1 Page 3of 40 2020-09-03
USAGE AND DISCLOSURE RESTRICTIONS
I. License Agreements
The software described in this document is the property of Telit and its licensors. It is
furnished by express license agreement only and may be used only in accordance with the
terms of such an agreement.
II. Copyrighted Materials
Software and documentation are copyrighted materials. Making unauthorized copies is
prohibited by law. No part of the software or documentation may be reproduced,
transmitted, transcribed, stored in a retrieval system, or translated into any language or
computer language, in any form or by any means, without prior written permission of Telit
III. High Risk Materials
Components, units, or third-party products used in the product described herein are NOT
fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control
equipment in the following hazardous environments requiring fail-safe controls: the
operation of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air
Traffic Control, Life Support, or Weapons Systems (High Risk Activities"). Telit and its
supplier(s) specifically disclaim any expressed or implied warranty of fitness for such High
Risk Activities.
IV. Trademarks
TELIT and the Stylized T Logo are registered in Trademark Office. All other product or
service names are the property of their respective owners.
V. Third Party Rights
The software may include Third Party Right software. In this case you agree to comply with
all terms and conditions imposed on you in respect of such separate software. In addition
to Third Party Terms, the disclaimer of warranty and limitation of liability provisions in this
License shall apply to the Third Party Right software.
TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESS OR IMPLIED
FROM ANY THIRD PARTIES REGARDING ANY SEPARATE FILES, ANY THIRD PARTY
MATERIALS INCLUDED IN THE SOFTWARE, ANY THIRD PARTY MATERIALS FROM
WHICH THE SOFTWARE IS DERIVED (COLLECTIVELY “OTHER CODE”), AND THE
USE OF ANY OR ALL THE OTHER CODE IN CONNECTION WITH THE SOFTWARE,
INCLUDING (WITHOUT LIMITATION) ANY WARRANTIES OF SATISFACTORY
QUALITY OR FITNESS FOR A PARTICULAR PURPOSE.
NO THIRD PARTY LICENSORS OF OTHER CODE SHALL HAVE ANY LIABILITY FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED
AND WHETHER MADE UNDER CONTRACT, TORT OR OTHER LEGAL THEORY,
ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE OTHER CODE
OR THE EXERCISE OF ANY RIGHTS GRANTED UNDER EITHER OR BOTH THIS
LICENSE AND THE LEGAL TERMS APPLICABLE TO ANY SEPARATE FILES, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

80630NT11837A Rev. 1 Page 4of 40 2020-09-03
APPLICABILITY TABLE
PRODUCTS
NE310H2-W1
NL865H2-W1

80630NT11837A Rev. 1 Page 5of 40 2020-09-03
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
APPLICABILITY TABLE................................................................................ 4
CONTENTS.................................................................................................... 5
1. INTRODUCTION.......................................................................... 7
2. GENERAL DESCRIPTION......................................................... 10
Module Main Features................................................................ 10
Communication Port ................................................................... 10
3. APPLICATION MAIN FLOW...................................................... 11
4. NETWORK REGISTRATION ..................................................... 12
PDN Connection Setup............................................................... 12
4.1.1. Auto Dial..................................................................................... 12
Fast Registration......................................................................... 13
Signal strength and quality.......................................................... 14
Module registration network status query.................................... 14
Operator Information................................................................... 15
PPP dial...................................................................................... 15
5. DNS SCRIPT.............................................................................. 16
6. TCP/UDP SCRIPT...................................................................... 17
6.1.1. Example for UDP........................................................................ 17
6.1.2. Example for TCP ........................................................................ 18
7. FTP/FTPS SCRIPT..................................................................... 19
8. NIDD SCRIPT............................................................................. 20

80630NT11837A Rev. 1 Page 6of 40 2020-09-03
9. PSM AND EDRX........................................................................ 21
PSM overview............................................................................. 21
PSM script.................................................................................. 22
eDRX overview........................................................................... 25
eDRX script ................................................................................ 25
PSM/eDRX Graphs..................................................................... 27
10. MQTT......................................................................................... 28
11. FTP FOTA.................................................................................. 29
12. LWM2M...................................................................................... 31
13. TLS............................................................................................. 34
14. HTTP.......................................................................................... 36
15. GLOSSARY AND ACRONYMS ................................................. 38
16. DOCUMENT HISTORY.............................................................. 39

80630NT11837A Rev. 1 Page 7of 40 2020-09-03
1. INTRODUCTION
1.1. Scope
Scope of this document is to give an overview and basic instructions of how to start using
the NE310H2 and NL865H2 module.
1.2. Audience
This document is intended for customers who want to use and test the NE310H2 and
NL865H2 products.
1.3. Contact Information, Support
For general contact, technical support services, technical questions and report
documentation errors contact Telit Technical Support at:
•TS[email protected]
•[e-mail]
•TS-APA[email protected]
Alternatively, use:
http://www.telit.com/support
For detailed information about where you can buy the Telit modules or for recommendations
on accessories and components visit:
http://www.telit.com
Our aim is to make this guide as helpful as possible. Keep us informed of your comments
and suggestions for improvements.
Telit appreciates feedback from the users of our information.

80630NT11837A Rev. 1 Page 8of 40 2020-09-03
1.4. Text Conventions
Danger –This information MUST be followed or catastrophic equipment
failure or bodily injury may occur.
Caution or Warning –Alerts the user to important points about integrating the
module, if these points are not followed, the module and end user equipment
may fail or malfunction.
Tip or Information –Provides advice and suggestions that may be useful
when integrating the module.
All dates are in ISO 8601 format, i.e. YYYY-MM-DD.

80630NT11837A Rev. 1 Page 9of 40 2020-09-03
1.5. Related Documents
•NE310H2-W1 HW Design Guide, 1VV0301608
•NL865H2-W1 HW Design Guide, 1VV0301616
•NE310H2 Interfaces User Guide, 1VV0301617
•NL865H2 Interfaces User Guide, 1VV0301629
•NE310H2 and NL865H2 AT Commands User Guide, 1VV0301611
•xL865 Global Form Factor Application Note, 80000NT11207A
•xE310 Global Form Factor Application Note, 80617NT11846A

80630NT11837A Rev. 1 Page 10 of 40 2020-09-03
2. GENERAL DESCRIPTION
Module Main Features
The NE310H2-W1 and NL865H2-W1 are the NBIoT evolution of the Telit Series of LTE
modules based on the xE310 and xL865 form factor.
Specified in the approved Release 14 of the 3GPP standard, Cat NB2 devices are
specifically tailored for IoT applications, offering optimized power consumption and
enhanced coverage.
•NBIoT Category NB2 3GPP release 14 compliant
•Half Duplex FDD (see HW Design guide for details on supported bands)
•Single Rx, single antenna
•3GPP Rel. 12 Power Saving Mode (PSM)
•3GPP Rel. 13 Extended Discontinuous Reception (eDRX)
•Control via AT commands according to 3GPP TS27.005, 27.007 and customized
AT commands
•SMS
•IPv4/IPv6 stack with TCP and UDP protocol
•Over-the-Air firmware update
•UDP, TCP, TLS, HTTP, HTTPS, FTP, COAP, MQTT, NIDD, LWM2M
TIP:
the IP address/port set in this document is just for test, when in product
application, please instead with the proper value.
Communication Port
•NE310H2-W1 supports:
o3 UARTs (Main and secondary with flow control and Auxiliary with RX TX only)
oUSB for debug only.
•NL865H2-W1 supports:
o2 UARTs (Main with flow control and Auxiliary with RX TX only)
oUSB for debug only.
Product
UART Interface
Use
NE310H2-W1
UART0
Software Download
AT Communication
UART1
AT Communication
AUX UART
Print Log
NL865H2-W1
UART0
Software Download
AT Communication
AUX UART
AT Communication

80630NT11837A Rev. 1 Page 11 of 40 2020-09-03
3. APPLICATION MAIN FLOW
Boot/WakeUp
Configure
Register?
Dataservice
success?
Enter PSM
Y
Y
RESET
N
N
AT#IOTBNDFULLPWR=1
TIP:
Configure step includes APN config / Band lock / Frequency lock / PSM config
and so on.
NOTE:
As per default setting and as shown in the above diagram, the module after
the Power ON will enter in Power Saving state if no activities are requested.
In order to change this setting is possible to use the AT#TSLK=1 command
after the startup.

80630NT11837A Rev. 1 Page 12 of 40 2020-09-03
4. NETWORK REGISTRATION
PDN Connection Setup
AT*MCGDEFCONT command, set the connection settings for PDN connection.
In NB-IOT, when the module attach to the NB-IOT network, after it power on, it performs a
PDN connection setup. Thus, the PDN connection settings must be set and stored in the
NVRAM preior to the attcach procudeure so it will be used by the module during the
attach procedure.
The set parameters of this command will take effect after restart the module.
AT*MCGDEFCONT=<PDP_type>[,<APN>[,<username>[,<password>]]]
The standard +CGDCONT command, should be used to define PDP context.
4.1.1. Auto Dial
Once the module power on, it will establishPDN connection automatically. And will report
+IP:xxx.xxx.xxx.xxx when PS connection established. As shown below:
*MATREADY: 1
+CFUN: 1
+CPIN: READY
+IP: 100.82.105.9

80630NT11837A Rev. 1 Page 13 of 40 2020-09-03
Fast Registration
In order to shorten the register process with the network the below commands may be
used to narrow down the number of bands and frequancies to scan.
AT*MFRCLLCK - Lock UE to specific frequency and optionally Cell ID
This command is used to lock UE to specific frequency and optionally Cell ID.
It will take effect once setting, and will be invalid after restart the module
AT*MFRCLLCK=1,10,3,301 // Lock to EARFCN 10, offset 0, PCI 301
OK
AT*MFRCLLCK=0 //Remove lock
OK
AT*MBSC - Lock BAND
This command is used to lock a specific band, and it will take effect after restart the module
AT*MBSC=3,3,5,8 //lock three bands, that is band3,5,8
*MBSC: 0
OK
AT*MBANDSL - Set Modem NB-IOT Search Prefer Band List
This command is to define the search prefer list
AT*MBANDSL=1,1,2,3,5 // Enable and se the prefer list
OK

80630NT11837A Rev. 1 Page 14 of 40 2020-09-03
Signal strength and quality
If the mobile device is already registered on the network. The following AT commands can
be used to query the received signal strength and quality, thus giving an indication of the
reliability of the wireless link.
AT+CESQ
Assuming that the module is not connected to the antenna or the network cannot be
covered at all, there are:
AT+CESQ
+ CESQ: 99,99,255,255,255,255 // In this case, the module cannot be connected to the network
OK
Now, the antenna is connected to the module and the network coverage reaches the
current position. Execute the above AT command again:
AT+CESQ
+ CESQ: 17,99,255,255,26,87 // 17 is the received signal strength indicator
OK
Module registration network status query
Execute the following AT command to verify whether the module has been registered on
the EPS network using E-UTRAN method:
AT+CEREG?
AT+CEREG? // Verify that the module is registered
+ CEREG: 0,1 // registered
OK
Now, suppose there is no signal (the module is not connected to the antenna) and
execute this command again:
AT+CEREG?
+ CEREG: 0,3 // In this case, the module cannot be connected to the network
OK
AT+CEREG=2 // Enable EPS network registration and position information to report actively, the results are as
follows:
+ CEREG: <stat> [, [<tac>], [<ci>], [<AcT>]]

80630NT11837A Rev. 1 Page 15 of 40 2020-09-03
Operator Information
Use the following AT command to return to the current mode, currently selected operator
and current access technology:
AT+COPS?
E.g:
AT+COPS?
+ COPS: 0,0, "46011", 9
OK
Now, if there is no signal (the module is not connected to the antenna) and it is assumed
that the detailed extended error return result has been enabled. Execute the above
command again:
AT+COPS?
+ COPS: 0 // In this case, the module did not select an operator
OK
PPP dial
Configure Ubuntu Dialup Connection:
1) Send command AT#TSLK=1 before PPP dail.
2) Issue command “sudo gedit /etc/ppp/options”
3) Change crtscts to nocrtscts, comment modem, lcp-echo-interval, lcp-echo-failure
#lcp-echo-interval
#lcp-echo-failure

80630NT11837A Rev. 1 Page 16 of 40 2020-09-03
5. DNS SCRIPT
If the base station does not allocate DNS, then you need to configure the DNS server
through the AT command EDNSSET. If the module is not configured with a DNS server,
all services related to domain name resolution cannot be performed. EDNSSET can be
configured with two IPV4 DNS servers and two IPV6 DNS servers.After EDNSSET
configures DNS, it needs to re-register the network to take effect.The following
demonstrates an example of setting up an ipv4 DNS server, then re-registering the
network, and using the EDNS command to resolve the domain name.
Note:
You can use command AT+CGCONTRDP=1 to query whether the network
allocates DNS.
AT+EDNSSET=0,0,"114.114.114.114"
OK
AT+CFUN=0
OK
AT+CFUN=1
OK
+CPIN: READY
+IP: 100.113.57.57
AT+EDNS="www.google.com
OK
+EDNS:31.13.83.1

80630NT11837A Rev. 1 Page 17 of 40 2020-09-03
6. TCP/UDP SCRIPT
An example of UDP communication over NB-IoT is reported below; in this scenario, The
ESOC command is used to create a socket, you can use parameters to control whether it
is UDP or TCP,ESOCON is used to establish a connection (UDP does not need to
connect, here is only used to mark the address information of the communication peer,
mainly for the consistency of AT commands),ESOSEND sends data, the data format is a
hexadecimal string.+ESOMNI is used to report the received data(Hexadecimal string
format).If you want to send data in the original format, you need to use ESODATAMODE
to enter the data mode, you can use "+++" to exit the data mode to the command line
mode, you must close the data channel after using ESODATAMODE. ESOCL closes the
socket.
Note:
The interval between the three +++ should be less than 1s, and the
interval between the first +and other inputs or the last + and other
inputs should be greater than 1s.
6.1.1. Example for UDP
AT+ESOC=1,2,1 // Create UDP socket
+ESOC=0
OK
AT+ESOCON=0,12345,"192.168.1.1" // Open a session to a server
OK
AT+ESOSEND=0,8,4142434445464748,1 // Send 8 bytes to the server
OK
+ESONMI=0,8,4141424243434545 // Get 8 bytes from the server
AT+ESOCL=0 // Terminate the session with the server
OK

80630NT11837A Rev. 1 Page 18 of 40 2020-09-03
6.1.2. Example for TCP
AT+CGPADDR=0 // Read IP address
AT+ESOC=1,1,1 // Create TCP socket
+ESOC=0
OK
AT+ESOCON=0,12345,"192.168.1.1" // Open a session to a server
OK
AT+ESOSEND=0,8,4142434445464748,1 // Send 8 bytes to the server
OK
+ESONMI=0,8,4141424243434545 // Get 8 bytes from the server
AT+ESOCL=0 // Terminate the session with the server
OK

80630NT11837A Rev. 1 Page 19 of 40 2020-09-03
7. FTP/FTPS SCRIPT
An example of FTP/FTPS communication over NB-IoT is reported below; in this scenario,
FTPOPEN is used to connect to the server. NB-IOT may be slow to connect to the FTPS
server and it may take a few seconds.FTPPUTCON is used to establish a data channel
connection with the server to provide services for uploading files.The FTPPUTDATA
parameter indicates whether it is the last packet to upload data.
AT+FTPOPEN="192.168.1.1",21,"test","test",1,0,61000
OK
+FTPOPEN: OPEN SUCCESS
AT+FTPSIZE=/,testwu1.txt
+FTPSIZE: 34
OK
AT+FTPPUTCON=/,testwu1.txt
OK
+FTPPUTCON: SUCCESS
AT+FTPPUTDATA=0
CONNECT
NO CARRIER
AT+FTPPUTDATA=1
CONNECT
NO CARRIER
+FTPPUTDATA: END SUCCESS
AT+FTPGET=/,testwu1.txt,0,512
OK
+FTPGET:512,Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST1
23567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!test
TEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()He
llo!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^
&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!
@#$%^&*()Hello!testTEST123567890!@#$%^&*()123
Hello!testTE

80630NT11837A Rev. 1 Page 20 of 40 2020-09-03
+FTPGET:488,ST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@
#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567
890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST
123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!tes
tTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()Hello!testTEST123567890!@#$%^&*()H
ello!testTEST123567890!@#$%^&*()123
+FTPGET: END
AT+FTPCLOSE
OK
8. NIDD SCRIPT
AT+NIDD=0,PDN,user,password // Create NIDD account
+NIDD=0,Account_ID
OK
AT+NIDD=1,Accunt_ID // Create NIDD Sockett
+NIDD=1,NIDD_ID
OK
AT+NIDD=2,NIDD_ID // Set NIDD socket
OK
AT+NIDD=3,NIDD_ID,”3132333435 // Send data to the server
OK
+NIDD=4,NIDD_ID,”3637383941” // Reciev data from the server