Telit NE310H2, NL865H2 Quick Start Guide

Mod. 0809 2017-01 Rev.8
NE310H2 & NL865H2
Quick Start Guide
80630NT11837A Rev. 1 Page 2 of 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 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.
80630NT11837A Rev. 1 Page 3 of 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 4 of 40 2020-09-03
APPLICABILITY TABLE
PRODUCTS
NE310H2-W1
NL865H2-W1
80630NT11837A Rev. 1 Page 5 of 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 6 of 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 7 of 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-EMEA@telit.com
TS-AMERICAS@telit.com
TS-APAC@telit.com
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 8 of 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 9 of 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:
o 3 UARTs (Main and secondary with flow control and Auxiliary with RX TX only) o USB for debug only.
NL865H2-W1 supports:
o 2 UARTs (Main with flow control and Auxiliary with RX TX only) o USB 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?
Data service
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
Loading...
+ 28 hidden pages