Multitech MultiConnect mDotT, MTDOT-915, MTDOT-868 Developer's Manual

MultiConnect

MTDOT Developer Guide

mDot

MULTICONNECT MDOT DEVELOPER GUIDE

MultiConnect mDot Developer Guide

Models: MTDOT-915-xxx, MTDOT-868-xxx includes also the MTUDK2-ST-MDOT Developer Kit

Part Number: S000612, Version 1.5

This publication may not be reproduced, in whole or in part, without the specific and express prior written permission signed by an executive officer of Multi-Tech Systems, Inc. All rights reserved. Copyright © 2015 by Multi-Tech Systems, Inc.

Multi-Tech Systems, Inc. makes no representations or warranties, whether express, implied or by estoppels, with respect to the content, information, material and recommendations herein and specifically disclaims any implied warranties of merchantability, fitness for any particular purpose and noninfringement.

Multi-Tech Systems, Inc. reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of Multi-Tech Systems, Inc. to notify any person or organization of such revisions or changes.

Trademarks and Registered Trademarks

MultiTech, and the MultiTech logo, and MultiConnect are registered trademarks and mDot and Conduit are a trademark of Multi-Tech Systems, Inc. All other products and technologies are the trademarks or registered trademarks of their respective holders.

Legal Notices

The MultiTech products are not designed, manufactured or intended for use, and should not be used, or sold or re-sold for use, in connection with applications requiring fail-safe performance or in applications where the failure of the products would reasonably be expected to result in personal injury or death, significant property damage, or serious physical or environmental damage. Examples of such use include life support machines or other life preserving medical devices or systems, air traffic control or aircraft navigation or communications systems, control equipment for nuclear facilities, or missile, nuclear, biological or chemical weapons or other military applications (“Restricted Applications”). Use of the products in such Restricted Applications is at the user’s sole risk and liability.

MULTITECH DOES NOT WARRANT THAT THE TRANSMISSION OF DATA BY A PRODUCT OVER A CELLULAR COMMUNICATIONS NETWORK WILL BE UNINTERRUPTED, TIMELY, SECURE OR ERROR FREE, NOR DOES MULTITECH WARRANT ANY CONNECTION OR ACCESSIBILITY TO ANY CELLULAR COMMUNICATIONS NETWORK. MULTITECH WILL HAVE NO LIABILITY FOR ANY LOSSES, DAMAGES, OBLIGATIONS, PENALTIES, DEFICIENCIES, LIABILITIES, COSTS OR EXPENSES (INCLUDING WITHOUT LIMITATION REASONABLE ATTORNEYS FEES) RELATED TO TEMPORARY INABILITY TO ACCESS A CELLULAR COMMUNICATIONS NETWORK USING THE PRODUCTS.

The MultiTech products and the final application of the MultiTech products should be thoroughly tested to ensure the functionality of the MultiTech products as used in the final application. The designer, manufacturer and reseller has the sole responsibility of ensuring that any end user product into which the MultiTech product is integrated operates as intended and meets its requirements or the requirements of its direct or indirect customers. MultiTech has no responsibility whatsoever for the integration, configuration, testing, validation, verification, installation, upgrade, support or maintenance of such end user product, or for any liabilities, damages, costs or expenses associated therewith, except to the extent agreed upon in a signed written document. To the extent MultiTech provides any comments or suggested changes related to the application of its products, such comments or suggested changes is performed only as a courtesy and without any representation or warranty whatsoever.

Contacting MultiTech

Knowledge Base

The Knowledge Base provides immediate access to support information and resolutions for all MultiTech products. Visit http://www.multitech.com/kb.go.

Support Portal

To create an account and submit a support case directly to our technical support team, visit: https://support.multitech.com.

Support

Business Hours: M-F, 8am to 5pm CT

Country By Email By Phone

Europe, Middle East, Africa: support@multitech.co.uk +(44) 118 959 7774

U.S., Canada, all others: support@multitech.com (800) 972-2439 or (763) 717-5863

Warranty

To read the warranty statement for your product, visit www.multitech.com/warranty.go. For other warranty options, visit www.multitech.com/es.go.

World Headquarters

Multi-Tech Systems, Inc.

2205 Woodale Drive, Mounds View, MN 55112

Phone: (800) 328-9717 or (763) 785-3500

Fax (763) 785-9874

2 MultiConnect®mDotTMMTDOT Developer Guide

CONTENTS

Contents

Chapter 1 Product Overview .................................................................................................................................... 6

Overview ....................................................................................................................................................................... 6

Getting Started.............................................................................................................................................................. 6

Documentation Overview ............................................................................................................................................. 7

Related Documentation .............................................................................................................................................. 7

mbed Documentation ................................................................................................................................................... 7

Programming the mDot Microcontroller .................................................................................................................... 7

General mBed Links .................................................................................................................................................... 8

mDot Platform ........................................................................................................................................................... 8

EUI and Networking ..................................................................................................................................................... 8

Product Build Options ................................................................................................................................................... 9

Chapter 2 Mechanical Drawings with Pinouts ........................................................................................................ 10

MTDOT-xxx-X1P-SMA.................................................................................................................................................. 10

MTDOT-xxx-X1P-U.FL .................................................................................................................................................. 11

MTDOT-xxx-X1-SMA.................................................................................................................................................... 12

MTDOT-xxx-X1-UFL ..................................................................................................................................................... 13

MTDOT-xxx-M1-UFL.................................................................................................................................................... 14

MTDOT-xxx-M1-TRC.................................................................................................................................................... 15

Chapter 3 Specifications and Pin Information ........................................................................................................ 16

MTDOT Specifications ................................................................................................................................................. 16

Power Draw................................................................................................................................................................. 19

Electrical Characteristics ............................................................................................................................................. 20

Pin Information .......................................................................................................................................................... 20

mDot Pinout Design Notes.......................................................................................................................................... 22

Serial Pinout Notes.................................................................................................................................................... 22

Serial Settings.............................................................................................................................................................. 22

LoRa ............................................................................................................................................................................ 22

Throughput Rates...................................................................................................................................................... 22

Range ........................................................................................................................................................................ 23

Chapter 4 Antennas ............................................................................................................................................... 24

Antenna System ......................................................................................................................................................... 24

Pulse Electronics Antenna........................................................................................................................................... 24

Antenna Specifications ............................................................................................................................................. 24

OEM Integration ......................................................................................................................................................... 24

FCC & IC Information to Consumers ......................................................................................................................... 24

FCC Grant Notes........................................................................................................................................................ 25

Host Labeling............................................................................................................................................................. 25

MultiConnect®mDotTMMTDOT Developer Guide 3

CONTENTS

Chapter 5 Safety Information................................................................................................................................. 26

Handling Precautions .................................................................................................................................................. 26

Radio Frequency (RF) Safety ....................................................................................................................................... 26

Sécurité relative aux appareils à radiofréquence (RF).............................................................................................. 26

Interference with Pacemakers and Other Medical Devices ...................................................................................... 27

Potential interference............................................................................................................................................... 27

Precautions for pacemaker wearers ........................................................................................................................ 27

Device Maintenance ................................................................................................................................................... 27

User Responsibility...................................................................................................................................................... 27

Chapter 6 Regulatory Information ......................................................................................................................... 28

EMC, Safety, and R&TTE Directive Compliance ......................................................................................................... 28

47 CFR Part 15 Regulation Class B Devices ................................................................................................................. 28

FCC Interference Notice ............................................................................................................................................. 28

FCC Grant .................................................................................................................................................................... 29

FCC Part 15................................................................................................................................................................ 29

FCC Notice................................................................................................................................................................... 29

Industry Canada Class B Notice................................................................................................................................... 29

Industry Canada ......................................................................................................................................................... 30

Chapter 7 Environmental Notices........................................................................................................................... 31

Waste Electrical and Electronic Equipment Statement .............................................................................................. 31

WEEE Directive.......................................................................................................................................................... 31

Instructions for Disposal of WEEE by Users in the European Union ........................................................................ 31

REACH Statement ....................................................................................................................................................... 32

Registration of Substances........................................................................................................................................ 32

Substances of Very High Concern (SVHC) ................................................................................................................ 32

Restriction of the Use of Hazardous Substances (RoHS) ............................................................................................ 33

Information on HS/TS Substances According to Chinese Standards ......................................................................... 34

Information on HS/TS Substances According to Chinese Standards (in Chinese) ...................................................... 35

Chapter 8 Labels .................................................................................................................................................... 36

Approvals and Certification......................................................................................................................................... 36

Example Labels............................................................................................................................................................ 36

Chapter 9 Developer Kit Overview ......................................................................................................................... 37

Developer Board Overview ......................................................................................................................................... 37

Developer Board Features ........................................................................................................................................ 37

MTUDK2-ST-MDOT Developer Kit Contents .............................................................................................................. 37

MTUDK2-ST-CELL Developer Kit Contents ................................................................................................................. 37

Chapter 10 Board Components .............................................................................................................................. 39

Developer Board ........................................................................................................................................................ 39

Developer Board Connectors ...................................................................................................................................... 41

Board Components ..................................................................................................................................................... 41

4 MultiConnect®mDotTMMTDOT Developer Guide

CONTENTS

LED Indicators ............................................................................................................................................................. 42

Chapter 11 Developer Board Installation ............................................................................................................... 43

Installing an mDot on the Developer Board ............................................................................................................... 43

Arduino Shield............................................................................................................................................................. 44

mDot Arduino Pins .................................................................................................................................................... 44

Installing an Arduino Shield with an mDot ............................................................................................................... 44

RSMA to U.FL Cables ................................................................................................................................................... 45

Connecting an Antenna through the Developer Board Connectors ........................................................................... 45

Chapter 12 Developer Board Schematics................................................................................................................ 46

Block Diagram ............................................................................................................................................................. 46

Schematics .................................................................................................................................................................. 47

Chapter 13 Design Considerations.......................................................................................................................... 52

Noise Suppression Design ........................................................................................................................................... 52

PC Board Layout Guideline ......................................................................................................................................... 52

User Accessible Areas ............................................................................................................................................... 52

Electromagnetic Interference .................................................................................................................................... 53

Electrostatic Discharge Control................................................................................................................................... 53

USB Design ................................................................................................................................................................. 54

Chapter 14 AT Commands...................................................................................................................................... 55

MultiTech AT Command Set ....................................................................................................................................... 55

General Commands................................................................................................................................................... 55

Network/Addressing Commands .............................................................................................................................. 55

Radio Configuration .................................................................................................................................................. 56

Send/Receive ............................................................................................................................................................ 57

Sleep/Serial Data Mode Options............................................................................................................................... 57

Index...................................................................................................................................................................... 59

MultiConnect®mDotTMMTDOT Developer Guide 5

CHAPTER 1 PRODUCT OVERVIEW

Chapter 1 Product Overview

Overview

The MultiConnect mDot is a programmable, long-range RF module that provides encrypted data connectivity to sensors, industrial equipment, and remote appliances. By using LoRa™Long Range Spread Spectrum technology, bidirectional data communication can be maintained for distances up to 5 miles/8 km line of sight, deep into buildings, or within noisy environments*using the unlicensed ISM bands in North America, Europe and worldwide. mDot simplifies local connectivity for Internet of Things (IoT) applications.

The mDot features an integrated ARM®Cortex®-M4 processor and mbedTMcompatible software library for developers to control, monitor and bring edge intelligence to their Internet of Things (IoT) applications.

Actual distance depends on conditions, configuration, antennas, desired throughput, and usage frequency. In

dense urban environments, a typical range is 1-2 miles.

Getting Started

Getting started depends on what you want to do. By default, mDot ships with firmware that supports AT Commands that use the serial I/O. Refer to Chapter 14, AT Commands.

To send commands to the mDot:

1. Mount the mDot on the developer board. For details, refer to Chapter 11, Developer Board Installation.

2. Connect a serial cable into the DB-9 connector.

3. Open communications software, such as HyperTerminal or TeraTerm.

4. Set the following:

■ Baud rate = 115,200

■ Data bits = 8

■ Parity = N

■ Stop bits = 1

■ Flow control = Off

6 MultiConnect®mDotTMMTDOT Developer Guide

CHAPTER 1 PRODUCT OVERVIEW

Two serial interfaces are available through the USB interface, one is used to program the mDot and the other is for debug messages. Refer to “mDot Pinout Design Notes” in Chapter 3, Specifications and Pin Information for information on which pins are available out of the box.

To develop using mbed, the mDot mbed page includes libraries and test cases. Refer to “mBed Documentation” for details and links.

For help setting up a MultiConnect®Conduit™to send data to and from an mDot, refer to “Related Documentation.”

Documentation Overview

This manual is one part of mDot documentation. Refer to the Related Documentation and mbed sections for additional information needed to program your mDot and integrate your application with the MultiConnect Conduit gateway.

This document includes the following sections:

■ mDot device information: Mechanical drawings, specifications, safety and regulatory information, and other

device specific content. Chapters 1-8

■ Universal Developer Kit information: Using the MTUDK-ST-MDOT Developer Kit, including design

considerations, schematics, and installation and operation information. Chapters 9-13

■ AT commands: Includes MultiTech AT Commands. Chapter 14.

This manual is available at www.multitech.com/support.

mbed Documentation

ARM mbed is a free, open-source platform and operating system for embedded devices using the ARM Coretx-M microcontrollers. The mbed website provides free software libraries, hardware designs, and online tools for rapid prototyping of products. The platform includes a standards-based C/C++ SDK, a microcontroller HDK, and supported development boards, an online compiler and online developer collaboration tools.

Note: To send and receive data, you need a LoRaWAN 1.0 gateway, such as MultTech's MultiConnect Conduit

(MTCDT) with an MTAC-LORA accessory card installed.

Programming the mDot Microcontroller

With the mDot and the MTUDK2-ST-xx developer board, use the ARM mbed ecosystem to program the microcontroller. Compile in the cloud or locally, copy the resulting binary file to the mbed USB drive, and reset the mDot.

Note: To program the mDot, you need an mDot model with programming header, model MTDOT-xx-X1P-SMA.

MultiConnect®mDotTMMTDOT Developer Guide 7

CHAPTER 1 PRODUCT OVERVIEW

On the mDot mbed page, MultiTech supplies source code for non-RF portions of the mDot and MTAC-LORA cards. To comply with FCC and ETSI certification, some portions of the software will be available only as binary libraries.

General mBed Links

■ Explore mbed: http://developer.mbed.org/explore

■ Getting Started with mbed: http://developer.mbed.org/getting-started

■ mbed Handbook: http://developer.mbed.org/handbook/Homepage

mDot Platform

The mDot mbed page includes the mDot library, firmware, and test cases https://developer.mbed.org/platforms/MTS-mDot-F411

EUI and Networking

All mDots have a factory-programmed Extended Unique Identifier (EUI). This is marked as Node on the mDot label.

To connect an mDot to a network, you will need to program it with the network ID for the network you are connecting to as well as the network key and application key. For information on setting up mDots as part of a LoRa network, go to: www.multitech.net

8 MultiConnect®mDotTMMTDOT Developer Guide

CHAPTER 1 PRODUCT OVERVIEW

Product Build Options

Product Description Quanity to Order

North America

MTDOT-915-X1-SMA 915 MHz XBee LoRa SMA 1 or 50

MTDOT-915-X1P-SMA 915 MHz XBee LoRa SMA with Programming Header 1

MTDOT-915-X1-UFL 915 MHz XBee LoRa U.FL 1 or 50

MTDOT-915-M1-UFL 915 MHz SMT LoRa U.FL 1 or 100

MTDOT-915-M1-TRC 915 MHz SMT LoRa RF Pad 1 or 100

EMEA

MTDOT-868-X1-SMA 868 MHz XBee LoRa SMA 1 or 50

MTDOT-868-X1P-SMA 868 MHz XBee LoRa SMA with Programming Header 1

MTDOT-868-X1-UFL 868 MHz XBee LoRa U.FL 1 or 50

MTDOT-868-M1-UFL 868 MHz SMT LoRa U.FL 1 or 100

MTDOT-868-M1-TRC 868 MHz SMT LoRa RF Pad 1 or 100

Developer Kits

MTUDK2-ST-MDOT mDot Developer Kit 1

Note:

■ The complete product code may end in .Rx. For example, MTDOT-915-M1-X1.Rx, where R is revision

and x is the revision number.

MultiConnect®mDotTMMTDOT Developer Guide 9

CHAPTER 2 MECHANICAL DRAWINGS WITH PINOUTS

Chapter 2 Mechanical Drawings with Pinouts