OriginGPS OriginIoT User manual

OriginIoT™ Application Kit
USER GUIDE
OriginGPS.com

OriginIoT™ Application Kit User Guide
33, 6
Page ii
Table of Contents
TABLE OF CONTENTS
1. General............................................................................................................................... 1
1.1. Introduction ........................................................................................................... 1
1.2. Purpose and Scope ................................................................................................. 1
2. System Overview................................................................................................................. 2
2.1. OriginIoT™ System Description................................................................................ 2
2.2. OriginIoT™ Application Kit Description ..................................................................... 2
3. Getting Started.................................................................................................................... 3
3.1. OriginIoT™ Application Kit Contents......................................................................... 3
3.2. Equipment Required to Set-Up................................................................................. 3
3.3. Connecting the APK to a PC..................................................................................... 4
3.4. OriginSmart™ Tutorial............................................................................................. 7
4. Connecting The OriginIoT™ to a Server ................................................................................ 8
4.1. Mobile Network Parameters ..................................................................................... 8
4.2. Editing Mobile-Network Parameters –GSM/LTE Authentication Command .................. 9
5. OriginSmart™ Web Application............................................................................................12
5.1. Overview...............................................................................................................12
5.2. Common Commands ..............................................................................................12
5.3. User Log In ...........................................................................................................12
5.4. Web Home Tab......................................................................................................13
5.5. Module Details Tab ................................................................................................13
5.6. Common Commands ..............................................................................................15
5.7. Adding a New Command ........................................................................................15
5.8. Adding a Custom Command ...................................................................................16
5.9. Adding a List of Commands ....................................................................................16
5.10. Widget Review Tab ................................................................................................17
5.11. Widget Configuration .............................................................................................18
5.12. Profile Tab.............................................................................................................19
6. Ordering Information..........................................................................................................20
6.1. P/N 2: Application Kit .............................................................................................20
Appendix A. System Firmware Upload (Flashing) ............................................................................21
Appendix B. Sensor Configuration..................................................................................................25

OriginIoT™ Application Kit User Guide
33, 6
Page iii
List of Figures
LIST OF FIGURES
Figure 1. OriginIoT™ Application Kit Contents ................................................................................. 3
Figure 2. Connecting the OriginIoT™ to the Antennas and SIM Card ................................................ 4
Figure 3. Connecting the OriginIoT™ to the Add-On Board .............................................................. 5
Figure 4. Connecting the OriginIoT™ to the Console Debug USB ...................................................... 5
Figure 5. OriginIoT™ Expander Cable to FTDI USB .......................................................................... 6
Figure 6. Selecting the Serial Port in Tera Term............................................................................... 6
Figure 7. Serial Port Setup in Tera Term ......................................................................................... 6
Figure 8. OriginIoT™ Connected to the Debug Console.................................................................... 7
Figure 9. OriginIoT™ Help List ....................................................................................................... 7
Figure 10. OriginIoT™ Configuration Example ................................................................................. 8
Figure 11. Setting Up the OriginIoT™ Network Configuration with the Debug Console ....................... 9
Figure 12. GSM Authentication Command –Output ........................................................................10
Figure 13. Setting up Authentication Credentials ............................................................................10
Figure 14. GSM Authentication Process ..........................................................................................11
Figure 15. OriginIoT™ Web App - Login Page.................................................................................12
Figure 16. OriginIoT™ Home Tab ..................................................................................................13
Figure 17. Module Details Tab .......................................................................................................13
Figure 18. Command Details .........................................................................................................14
Figure 19. Loopback Message Displaying System-Server Link Status ................................................15
Figure 20. New Command Window ................................................................................................15
Figure 21. New Multi-GET Command Window.................................................................................16
Figure 22. Custom Command Details .............................................................................................16
Figure 23. New Command List.......................................................................................................17
Figure 24. Widget Review Tab.......................................................................................................17
Figure 25. Widget Configuration Window .......................................................................................18
Figure 26. Profile Tab ...................................................................................................................19
Figure 27. Firmware Upload ..........................................................................................................21
Figure 28. Connector Pins .............................................................................................................22
Figure 29. STM32 ST-LINK Utility Window......................................................................................23
Figure 30. Connecting to System with STM32 ST-LINK Utility ..........................................................23
Figure 31. Program & Verify in STM32 ST-LINK Utility.....................................................................24
Figure 32. Download Window........................................................................................................24
Figure 33. Successful Firmware Download Window.........................................................................24

OriginIoT™ Application Kit User Guide
33, 6
Page iv
List of Tables
LIST OF TABLES
Table 1. Wireless Connection to Application Board..........................................................................22
Table 2. Sensor Configuration .......................................................................................................25

OriginIoT™ Application Kit User Guide
33, 6
Page v
Table of Revisions
TABLE OF REVISIONS
Ver. #
Description
Author/s
Date
1.0
First Edition
May 26, 2020
1.1
Updated Table 2 in appendix B
June 11, 2020

OriginIoT™ Application Kit User Guide
33, 6
Page vi
Abbreviations
ABBREVIATIONS
Abbreviation
Description
APN
Access Point Network
ADC
Analog-to-Digital Converter
APK
Application Kit
DHCP
Dynamic Host Configuration Protocol
ESD
Electronic Sensitive Device
FTDI
Future Technology Devices International
GNSS
Global Navigation Satellite System
GPIO
General-Purpose Input/Output
GSM
Global System for Mobile Communications
GUI
Graphics User Interface
I2C
Inter-Integrated Circuit
IMEI
International Mobile Equipment Identity
IMS
IP Multimedia Subsystem
IoT
Internet of Things
LTE
Long-Term Evolution –a standard for wireless broadband communication for mobile
devices and data terminals
OriginIoT™
Cellular IoT system to accelerate IoT product development
OriginSmart™
Web-based GUI to configure and manage OriginIoT™ systems
RF
Radio Frequency
SMA
Subminiature version A (RF connector)
SPI
Serial Peripheral Interface
UART
Universal Asynchronous Receiver Transmitter
UID
Unique Identifier

OriginIoT™ Application Kit User Guide
33, 6
Page vii
Related Documentation
RELATED DOCUMENTATION
#
Document Name
1
OriginIoT™ Datasheet
2
OriginSmart™ API Specifications

OriginIoT™ Application Kit User Guide
Page viii
Scope
SCOPE
This document describes the features and specifications of the OriginIoT™
Application Kit.
DISCLAIMER
All trademarks are properties of their respective owners.
Performance characteristics listed in this document do not constitute a
warranty or guarantee of product performance. OriginGPS assumes no
liability or responsibility for any claims or damages arising out of the use of
this document, or from the use of integrated circuits based on this document.
OriginGPS assumes no liability or responsibility for unintentional
inaccuracies or omissions in this document. OriginGPS reserves the right to
make changes in its products, specifications and other information at any time
without notice.
OriginGPS reserves the right to conduct, from time to time, and at its sole
discretion, firmware upgrades.
As long as those FW improvements have no material change on end
customers, PCN may not be issued.
OriginGPS navigation products are not recommended to use in life saving or
life sustaining applications.
SAFETY INFORMATION
Improper handling and use can cause permanent damage to the product.
ESD SENSITIVITY
This product is ESD sensitive device and must be handled with care.
CONTACT INFORMATION
[e-mail] www.origingps.com

OriginIoT™ Application Kit User Guide
Page 1
General
1. GENERAL
1.1. Introduction
Welcome to the OriginIoT™ Application Kit (APK) User Guide. The APK is a
compact development and evaluation tool for use with the OriginIoT™
system. The APK enables users to interactively configure their OriginIoT™
systems according to their project requirements. The APK enables the quick
and easy configuration of the IoT module through an interactive debug
console, and also enables debugging commands to be sent to the module.
The OriginIoT™ is a miniature cellular IoT system that enables the speedy
development of IoT projects without writing embedded code and without
knowledge of RF engineering. This guide assumes the reader has basic
software and hardware knowledge.
1.2. Purpose and Scope
The purpose of this guide is to explain, step by step, how to use the
OriginIoT™ Application Kit. It is intended to provide all the necessary
information to configure and test new cellular IoT projects and development
innovations. This guide includes a description of the system functions and
capabilities, contingencies and alternate modes of operation, and step-by-step
procedures for setting up, configuring, and using the OriginIoT™ APK.

OriginIoT™ Application Kit User Guide
Page 2
System Overview
2. SYSTEM OVERVIEW
2.1. OriginIoT™ System Description
The OriginIoT™ is a miniature cellular IoT system with a GNSS tracker and
interfaces to peripheral sensors and devices. The data is transferred through
cellular communication, stored in a remote server (cloud), and displayed on a
Web GUI.
The system communicates through a GSM or LTE interface (2G, 3G, Cat1,
CatM, or NB-IoT) through a cloud-based application.
The OriginIoT™ functions as a multi-purpose IoT sensor platform and can
accommodate sensors and other peripheral devices using UART, SPI, I2C,
USB, ADC, or GPIO with superior positional accuracy of stand-alone GNSS.
Data is configured over a Web interface and embedded firmware development
is not required by the user. The ease and flexibility of developing a vast array
of applications based on the OriginIoT™ dramatically improves time to
market while minimizing the size of your IoT sensor device.
2.2. OriginIoT™ Application Kit Description
The OriginIoT™ Application Kit is a development and evaluation tool for use
with the OriginIoT™ system. With the OriginIoT™ APK, users can see live
results of the configurations of the OriginIoT™ system according to their
project requirements while using a debug console.
The OriginIoT™ APK may be used for the following activities:
•Connecting the OriginIoT™ system to a server
•Testing the functionality of the add-on
•Connecting and configuring new sensors
•Debugging and configuring the OriginIoT™ system locally

OriginIoT™ Application Kit User Guide
Page 3
Getting Started
3. GETTING STARTED
3.1. OriginIoT™ Application Kit Contents
The OriginIoT™ Application Kit package includes the following items:
•OriginIoT™ system
•OriginIoT™add-on board
•GNSS antenna 12x12x4.3 mm with a W.FL connector
•Penta-band GSM antenna with a U.FL connector
•ST-LINK and FTDI USBs
•Cable from USBs to add-on board
•Cable to connect battery (not shown)
•Nano SIM card with optional data package
Figure 1. OriginIoT™ Application Kit Contents
3.2. Equipment Required to Set-Up
The following items are required in order to set up and start working with the
OriginIoT™ Application Kit:
•Nano SIM card with data package
•Server:
Option A: OriginGPS provides a cloud server for evaluation purposes
free of charge at: http://18.184.85.107. The latest IP address can be
found in the latest version of this document on our website.
Option B: Users can develop their own server tailored to their
project’s requirements based on OriginSmart™ open source code,
provided with the purchase of the OriginIoT™ system.
•PC with terminal emulator (ex. Tera Term, a free, open-source software,
downloadable here)

OriginIoT™ Application Kit User Guide
Page 4
Getting Started
3.3. Connecting the APK to a PC
In order to configure the OriginIoT™ to establish a connection between the
GSM/LTE network and Web server, the module using the debug port
connection to the PC must be configured, according to the following steps:
1. Insert a Nano SIM card to the dedicated slot on the OriginIoT™ system.
This step is not required with the ORG2101-XXXX-E model, which
includes an integrated embedded SIM card.
2. Connect the GSM/LTE cellular antenna to the U.Fl connector on the
OriginIoT™ (Figure 2).
3. Connect the GNSS antenna to the W.Fl connector on the OriginIoT™
(Figure 2). This step is only required when evaluating GNSS functionality.
Figure 2. Connecting the OriginIoT™ to the Antennas and SIM Card
4. Connect the OriginIoT™ system to the add-on board using the micro USB
cable (Figure 3).

OriginIoT™ Application Kit User Guide
Page 5
Getting Started
Figure 3. Connecting the OriginIoT™ to the Add-On Board
5. Connect the console debug USB (Figure 4)
Figure 4. Connecting the OriginIoT™ to the Console Debug USB
6. Connect the expander cable according to (Figure 5). The FTDI
connector is used for the debug console, whereas the ST-LINK is used for
flashing the IoT module. Make sure to connect the FTDI connector to a
USB port.

OriginIoT™ Application Kit User Guide
Page 6
Getting Started
Figure 5. OriginIoT™ Expander Cable to FTDI USB
To connect to the OriginIoT™ COM port: in the Tera Term application,
go to Setup →Serial Port (Figure 6), select the relevant COM from the
port drop list, and set the baud rate to 921600 bps (
6. Figure 7). Click OK.
Figure 6. Selecting the Serial Port in Tera Term
Figure 7. Serial Port Setup in Tera Term

OriginIoT™ Application Kit User Guide
Page 7
Getting Started
7. When the OriginIoT™ is connected to a power source, a welcome message
and GSM/LTE start-up messages is displayed on your PC.
8. While the OriginIoT™ is connected to your PC, press Enter in the
terminal, and the prompt line ORG> is displayed in the terminal window
(Figure 8).
Figure 8. OriginIoT™ Connected to the Debug Console
The system may now be accessed via the debug console.
9. Enter ‘help’ in the Tera Term terminal to see a list of available commands
(Figure 9).
Figure 9. OriginIoT™ Help List
3.4. OriginSmart™ Tutorial
The following online tutorial will help you configure additional tasks on your
OriginIoT™ system while working with the OriginSmart™ API Web app.
https://www.youtube.com/watch?v=cT-c22z1pYQ&t=2s
This tutorial explains how to perform the following tasks:
•Understanding the OriginSmart™ API Specifications document
•Operating the OriginIoT™ debug console
•Logging in to the online development environment
•Interpreting notify and response messages
•Writing and sending simple Get and Set messages

OriginIoT™ Application Kit User Guide
Page 8
Connecting The OriginIoT™ to a
Server
4. CONNECTING THE ORIGINIOT™TO A SERVER
4.1. Mobile Network Parameters
The OriginIoT™ can send data over a mobile network following initial cellular
configuration. This task is only performed once for a specific SIM card and
includes the following SIM parameters from your mobile network operator’s
website or your SIM card:
•APN–Access Point Network
•*Username
•*Password
*Not required by all mobile network operators
Figure 10. OriginIoT™ Configuration Example
The OriginIoT™ is preconfigured to connect to the OriginGPS evaluation
server at http://18.184.85.107.
If you require your products to be pre-configured to a separate server and
network configuration, contact us at [e-mail].
Key to Figure 10:
•APN: SIM card provider’s network.
•Server IP: Hostname or IP address of cloud-based application –the
server to which the module connects.
•Server Port: Port used by cloud application to receive messages from
OriginIoT™.
•Connected: Set to 'true' when GSM/LTE is connected to access portal,
'false' if otherwise.
•Network IP: (Shown only when connected) provided to the system by the
Internet provider’s Dynamic Host Configuration Protocol (DHCP) servers
and is not configurable.

OriginIoT™ Application Kit User Guide
Page 9
Connecting The OriginIoT™ to a
Server
To set these fields, use the command:
gsm 0set <portal|hostname|port> ...
1. Save the changes to flash memory using the command:
gsm 0save
2. Reset the MCU using the command to implement these changes:
reset mcu
Examples of the above commands are shown in Figure 11:
Figure 11. Setting Up the OriginIoT™ Network Configuration with the
Debug Console
4.2. Editing Mobile-Network Parameters –
GSM/LTE Authentication Command
You may skip this section if your SIM card does not require authentication
(username and password).
To configure your SIM card, use the ‘authen’ command in the debug console.
To see the current configuration, use the command gsm 0authen show.

OriginIoT™ Application Kit User Guide
Page 10
Connecting The OriginIoT™ to a
Server
The following output is displayed:
Figure 12. GSM Authentication Command –Output
The OriginIoT™ is shipped without authentication settings, so these settings
are displayed as empty fields here.
The ‘authen’ command enables the operator to set the following fields:
•PIN (4 to 8-digit number provided with the SIM card)
•Username
•Password
Note: Fields that the operator does not set are shown as empty.
To set these fields use the command:
gsm 0authen enter
The operator is then prompted for each of the fields. If a field is not required,
type Enter to exit the field.
Figure 13. Setting up Authentication Credentials
Verify the fields are correct, then save them to flash using the following
command:
gsm 0authen save
The next time the system boots, these fields are used for the wireless network
connectivity.
The GSM authentication process should look like the following figure
(Figure 14):

OriginIoT™ Application Kit User Guide
Page 11
Connecting The OriginIoT™ to a
Server
Figure 14. GSM Authentication Process

OriginIoT™ Application Kit User Guide
Page 12
OriginSmart™ Web Application
5. ORIGINSMART™WEB APPLICATION
5.1. Overview
This chapter is for users who have chosen to use the OriginIoT™ evaluation
server.
The OriginIoT™ Web application server is a user-friendly GUI interface for
configuring and viewing the OriginIoT™ system with its associated interfaces,
devices, messages, and commands. Users can execute user-created and system
commands using this Web application. It is free-of-charge and a great starting
point for developing with the OriginSmart™ protocol.
5.2. Common Commands
Examples of configurations and commands that can be used by the
OriginIoT™ can be found in the OriginSmart™ Web app under the
International Mobile Equipment Identity (IMEI) 357300070607893 in the
“All Devices” tab. The commands are specified in the OriginSmart™ Web
Specifications.
5.3. User Log In
The Web application resides on Amazon Web Services at:
http://18.184.85.107.
Figure 15 displays the Login page of the OriginSmart™ Web application.
Figure 15. OriginIoT™ Web App - Login Page
Enter the credentials you received from your OriginGPS representative. To
change your password, go to the Profile tab. To go to the Home tab, click the
✓symbol.