OriginGPS OriginIoT ORG2101 User manual

- 1-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
OriginIoT ORG2101 - EVK
O r i g i n GPS. c o m
O r i g i n GPS. c o m
O r i g i n GPS. c o m
USER GUIDE

- 2-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
INDEX
1. SCOPE ........................................................................................................................................................... 5
2. DISCLAIMER ............................................................................................................................................... 5
3. SAFETY INFORMATION............................................................................................................................ 5
4. ESD SENSITIVITY ....................................................................................................................................... 5
5. CONTACT INFORMATION........................................................................................................................ 5
6. RELATED DOCUMENTATION.................................................................................................................. 5
7. REVISION HISTORY................................................................................................................................... 6
8. ABOUT ORIGINIOT™ ................................................................................................................................ 6
8.1. MODULE DESCRIPTION........................................................................................................... 6
8.2. ARCHITECTURE....................................................................................................................... 6
8.3. ORIGINIOT EVK KIT INCLUDING............................................................................................... 7
8.4. COMPONENTS ON THE EVK .................................................................................................... 7
9. GETTING STARTED ................................................................................................................................... 7
9.1. REQUIRED EQUIPMENT .......................................................................................................... 7
9.2. CONNECTING THE EVK TO PC VIA DEBUG PORT...................................................................... 8
10. CONNECTING ORIGINIOT TO A SERVER....................................................................................... 12
10.1. CELLULAR NETWORK PARAMETERS .................................................................................. 12
10.2. ATTRIBUTING ORIGINIOT TO A SERVER............................................................................. 12
10.3. ENTERING CELLULAR-NETWORK PARAMETERS –GSM/LTE AUTHENTICATION COMMAND13
11. ORIGINIOT WEB APPLICATION ....................................................................................................... 15
11.1. OVERVIEW........................................................................................................................ 15
11.2. USER LOG IN..................................................................................................................... 15
11.3. WEB HOME TAB ............................................................................................................... 15
11.4 MODULE DETAILS TAB.............................................................................................................. 16
11.5 ADDING A NEW COMMAND..................................................................................................... 18

- 3-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
11.6 ADDING A CUSTOM COMMAND............................................................................................... 18
11.7 WIDGET PREVIEW TAB ............................................................................................................. 19
11.8 WIDGET CONGIFURATION........................................................................................................ 20
11.9 PROFILE TAB ............................................................................................................................ 20
12. OPERATING THE SENSORS ON THE EVK....................................................................................... 21
12.1 PARAMETER SETUP .................................................................................................................. 21
12.2 ACTIVATING THE SENSORS ....................................................................................................... 22
12.2 WIDGET CONFIGURATION........................................................................................................ 24
13. ORDERING INFORMATION................................................................................................................ 25
APPENDIX A –PORTS AND POWER.............................................................................................................. 25
APPENDIX B –FIRMWARE UPLOAD (FLASHING) FOR ORIGINIOT MODULE.................................... 28
APPENDIX C –REGISTER MAPS FOR SENSORS.......................................................................................... 33
APPENDIX D –WORK WITH ORG2101 ADD-ONS........................................................................................ 35
D.1 Using Add-on via connectors J3 and J4....................................................................................... 36
D.2 Using Add-on via FFC connector J6............................................................................................. 37
FIGURE INDEX
Figure 1 –OriginIoT Architecture ................................................................................................................ 6
Figure 1 –connection of ORG2101 antennas and SIM card ........................................................................ 8
Figure 2 –mating ORG2101 to EVK correctly.............................................................................................. 9
Figure 3 –powering up EVK and ORG2101............................................................................................... 10
Figure 3a –Serial port in Tera Term ......................................................................................................... 11
Figure 3c –OriginIoT connected to Debug Console .................................................................................. 12
Figure 6 –OriginIoT Web Application, login page..................................................................................... 15
Figure 7 –OriginIoT Home Tab................................................................................................................. 16
Figure 8 –Module Details Tab.................................................................................................................. 16
Figure 8 –Command details .................................................................................................................... 17
Figure 9 –New Command........................................................................................................................ 18
Figure 9 –Command details .................................................................................................................... 19

- 4-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
Figure 10 –Widget preview tab ............................................................................................................... 19
Figure 10 –Widget configuration window................................................................................................ 20
Figure 11 –Profile Tab............................................................................................................................. 20
Table 4 –Configuration for I2C Messages ................................................................................................ 22
Table 5 –Configuration for UART Messages............................................................................................. 23
Table 7: list of orderable parts ................................................................................................................. 25
Figure 32 –J5 connector........................................................................................................................... 27
Figure 33: ST-Link plug orientation........................................................................................................... 28
Figure 34: Wire Colors on J7 connector pins ............................................................................................ 29
Figure 35: Power set up for FW upload .................................................................................................... 30
Figure 36: STM32 ST-Link Utility............................................................................................................... 31
Figure 37: Connecting to module in STM32 ST-Link Utility........................................................................ 31
Figure 38: Program & Verify in STM32 ST-Link Utility ............................................................................... 32
Figure 40: Successful Firmware Download ............................................................................................... 33
Figure 41 –mating Add-on to EVK correctly............................................................................................. 36
Figure 42 –mating Add-on to ORG2101 correctly .................................................................................... 37
Figure 43 –attaching FFC cable to add-on................................................................................................ 38
Figure 43 –attaching FFC cable to EVK..................................................................................................... 39

- 5-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
1. SCOPE
This document is a user guide for miniature cellular IoT system evaluation kit (OriginIoT-EVK).
2. 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.
3. SAFETY INFORMATION
Improper handling and use can cause permanent damage to the product.
4. ESD SENSITIVITY
This product is ESD sensitive device and must be handled with care.
5. CONTACT INFORMATION
Support - [email protected] or Online Form
Marketing and sales - [e-mail]
Web –www.origingps.com
www.origin-iot.com
6. RELATED DOCUMENTATION
№
DOCUMENT NAME
1
ORG2101 Datasheet
2
OriginSmart™ API specifications
3
OriginIoT debug console user guide
4
Spider and Hornet - NMEA Protocol Reference Manual
5
Spider and Hornet - One Socket Protocol Reference Manual
6
Spider and Hornet –OSP GNSS Extension Reference Manual
TABLE 1 –RELATED DOCUMENTATION

- 6-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
7. REVISION HISTORY
REVISION
DATE
CHANGE DESCRIPTION
1.0
March 26, 2018
First Edition –Preliminary
1.1
May 13, 2018
New web application guidance. Mating cycles of connectors. Change in
P/n. Minor corrections and clarifications
TABLE 2 –REVISION HISTORY
8. ABOUT ORIGINIOT™
8.1. MODULE DESCRIPTION
The OriginIoT module ORG2101 is a miniature generic cellular IoT system with GNSS tracker and
interfaces to peripheral sensors and devices. The data is transferred via cellular communication, stored
in a remote server (cloud), and displayed on a web GUI.
The module is communicating through GSM or LTE interface with a cloud-based application.
The multi-purpose IoT sensor platform can accommodate sensors and other peripheral devices via
UART, SPI, I2C, USB, ADC or GPIO, with superior positional accuracy of stand-alone GNSS. Data is
configured over a web interface, eliminating additional embedded FW efforts. The ease and flexibility of
adding the mini+mighty OriginIoT to a vast array of applications quickens time to market while
minimizing the size of your IoT sensor device.
8.2. ARCHITECTURE
Figure 1 –OriginIoT Architecture

- 7-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
8.3. ORIGINIOT EVK KIT INCLUDING
•OriginIoT ORG2101 module and EVK
•GNSS antenna 12x12x4.3 mm with W.FL connector
•Penta-band GSM antenna with SMA connector (designed to support of all frequency bands, may
be varied upon customer application)
•SMA to U.FL connector cable
•Power adapter
•Micro USB cable
•OriginIoT add-on with EVK sensors, DC/DC and charging circuit (optional)
8.4. COMPONENTS ON THE EVK
•Sensors:
oAccelerometer- ADXL345, U1, by Analog Devices.
Datasheet: http://www.analog.com/media/en/technical-documentation/data-
sheets/ADXL345.pdf
oGyroscope- DM00168691, U5, by STMicro Electronics.
Datasheet:http://www.st.com/content/ccc/resource/technical/document/datasheet/e4
/b1/d1/62/1a/e6/44/2f/DM00168691.pdf/files/DM00168691.pdf/jcr:content/translatio
ns/en.DM00168691.pdf
oElectronic Compass- IST8304, U3, by iSentek.
Datasheet: http://www.isentek.com/cn/dlf.php?file=../ISENTEK/%28201703-
13%29IST8304%20Datasheet%20v2.3_brief.pdf
oDigital Temperature- TMP104, U4, by Texas Instruments. Datasheet:
http://www.ti.com/lit/ds/symlink/tmp104.pdf
•FTDI to USB serial chip: FT232RQ, U21.
•Voltage Translator 4bit bi-directional: LSF0204PWR, U2.
•Common mode filter for USB/HDMI: ACM2010-900-2p-T002, U23.
•Buck-Boost Switching Regulator IC Positive Adjustable 1.8V 1 Output 3A: LTC3113IDHD#PBF,
U24
•Power Switch ICs- Power Distribution Single 1A Current-Limited, TPS2051B, U25
•1A Low Noise Fast Transient Response Low Dropout Regulator, TPS3801DCQR
9. GETTING STARTED
9.1. REQUIRED EQUIPMENT
Items needed:
•OriginIoT EVK
•Nano SIM card with data package
•Server with a fixed IP.

- 8-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
OriginIoT module allows the user to communicate with GNSS receiver and sensors through web
GUI on a cloud. The communication between OriginIoT and the cloud server is done through
cellular network via data sim card. OriginGPS provides a cloud server for evaluation:
http://18.184.85.107*
* Server IP can be changed in the future. Please make sure you downloaded the latest
publication of this document from www.origingps.com
•PC with a terminal emulator (such as free –open source Tera-Term)
Tera Term can be downloaded here:
http://download.cnet.com/Tera-Term/3000-20432_4-75766675.html
•Micro USB cable (included in the EVK kit)
9.2. CONNECTING THE EVK TO PC VIA DEBUG PORT
In order to configure the OriginIoT to connect to GSM/LTE Network and web server, it is needed to
configure the module using DEBUG port connection to PC (J22).
Please follow these steps:
1. Insert nano SIM card to its slot. See figure 1.
Note: skip this step if using ORG2101-XXXX-E (embedded SIM)
2. Connect GSM/LTE antenna to the U.Fl connector OriginIoT, See figure 1.
3. Connect GNSS antenna to the W.Fl connector on OriginIoT, See figure 1. (Required only if user wants
to evaluate GNSS functionality)
Figure 1 –connection of ORG2101 antennas and SIM card
Cellular Antenna
Nano SIM Card
Slot
GNSS Antenna

- 9-
OriginIoT EVK User Guide Rev. 1.1 5.13.18
4. The OriginIoT module should be connected to EVK board up-side down (components’ side down) to
the area near the OriginIoT logo on the EVK, see figure 2.
Please notice: connection of OriginIoT to EVK is unidirectional –J1 of the module (closer to MCU) should
connect to J1 on the EVK.
Note: Extra precaution is required upon insertion / withdrawal of ORG2101 to EVK. Incautious handling
can alter the performance of the connectors.
You know that you are connected correctly if:
1. J4 for U.FL antenna fits inside its socket on the EVK
2. OriginIoT fits in white outlines drawn on the EVK (silk screen)
Figure 2 –mating ORG2101 to EVK correctly
5. Connect USB Power/Console of the EVK to PC via micro USB cable (J22). See figure 3.
6. Supply power to EVK - Connect the power adapter to the EVK (J26). See figure 3.
ORG2101 drawn
outline on silk
screen
J4 with GSM
antenna fits in its
socket
USB cable
connected to J22

- 10 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
Figure 3 –powering up EVK and ORG2101
7. Open terminal on your PC and connect to corresponding COM port of the OriginIoT with a baud rate
of 460800 bps.
In Tera Term –go to Setup - > Serial Port (See figure 3a), select the COM port and set baud rate to
460800 bps. Press “OK”. See figure 3b.
Full communication parameters:
•Baud Rate: 460800
•Data Bits: 8
•Stop Bits: 1
•Flow Control: None
•Parity: None
USB connector to
PC via J22
EVK powered by
external 6V
power supply
Jumper J24 selection of
ORG2101 power by 6V plug

- 11 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
Figure 3a –Serial port in Tera Term
Figure 3b –COM settings in Tera Term
8. Supply power to OriginIoT via DC/DC circuit by placing jumper J24. See figure 3.
Note: the EVK can be powered by USB (J22) or Plug (J26) determined by jumper J24.
Note: you can choose one of two DC/DC circuits provided on the EVK –one by Texas Instruments
TPS63070 or one by Linear Technology LTC3113. To switch between them use slide switch J30
After supplying power to OriginIoT you should see a welcome message and GSM/LTE start-up messages.
8. While connected, press Enter key in the terminal.
You should see the command line “ORG>” in the terminal window. See Figure 3c.

- 12 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
Figure 3c –OriginIoT connected to Debug Console
Now the module can be accessed via the debug console. Please refer to document “OriginIoT debug
console user guide” for the complete list of functions available via the debug console.
10. CONNECTING ORIGINIOT TO A SERVER
10.1. CELLULAR NETWORK PARAMETERS
In order to allow OriginIoT sending data via cellular network, initial cellular configuration should be
defined. This is done one time only for your specific SIM card, and includes several parameters of your
SIM network:
•APN –Access Point Network
•Username**
•Password**
**Username and Password are required only by several cellular providers and sometimes they are not
needed at all.
This data can be found on the cellular providers’ website or with the SIM card you received from your
operator.
10.2. ATTRIBUTING ORIGINIOT TO A SERVER
OriginIoT™ comes preconfigured to connect to OriginGPS’s evaluation server at http://18.184.85.107.
Please contact our support team at i[email protected] if you need your products preconfigured with a
different server and network configuration.
In order to attribute the OriginIoT to this server or a different server, please follow these steps:
1. To see current OriginIoT network configuration, enter the following command:
gsm 0 network
See figure 4 for output example.

- 13 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
Figure 4 –OriginIoT Configuration example
2. The “Access Portal” is the APN of your SIM card provider’s network.
The “Hostname” is the hostname or IP address of the Cloud based Application –the server to which the
module is connecting to.
The “Port” is the port used by the Cloud Application to receive all messages from the module.
The “Connected” line is set to “true” if the GSM/LTE has successfully connected to the Access Portal.
Otherwise it is set to “false”.
3. To set these fields use the command:
gsm <instance> set <portal|hostname|port> ...
For example, the command to change the APN is:
gsm 0 set portal
The operator will be prompted with a “→” and must fill in the string that is the new portal setting. The
same must be done for each of the other network settings if required to be changed. The same method
applies if changing the server address or the port is required.
4. Once the changes are made, the operator must save them to flash using the command:
gsm 0 save
See figure 5 for example.
Figure 5 –Setting OriginIoT network configuration and saving to flash
10.3. ENTERING CELLULAR-NETWORK PARAMETERS –GSM/LTE AUTHENTICATION
COMMAND
In order to configure your SIM card, use in the debug console the “authen” command. To see current
configuration, input:
gsm 0 authen show
You will receive the following output:

- 14 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
Since the module is shipped without authentication settings, they are shown as empty fields here. The
“authen” sub-command lets the operator set 3 fields: PIN, Username and Password. The PIN is a 4-8
digit number provided with the SIM card, if required by the operator. If Username and Password are
required (see section 9.3) then the values of these fields are provided by the network operator as well. If
there is no requirement for them then these fields can remain blank.
To set these fields use the command:
gsm 0 authen enter
The operator will be prompted for each of the 3 fields. If the field is not required, exit the field by typing
the “Enter” key.
Once completed, the operator can once again use the command “ gsm 0 authen show” to check that the
values entered are correct. If they values are correct, they must be saved to flash using the following
command:
gsm 0 authen save
The next time the system boots these fields will be used in the wireless network connectivity.
5. In the end of the process, while the EVK is successfully connected to a server, the output should look
like this:
ORG> gsm 0 network
Access Portal: internet.com
Hostname: 80.178.110.20
Port: 31000
Connected: true

- 15 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
IP Address: 25.48.187.64 (the IP is dynamic)
The last entry “IP Address” is the GSM/LTE’s IP address given to the module by the Internet providers
DHCP servers and is not a configurable item.
11. ORIGINIOT WEB APPLICATION
11.1. OVERVIEW
This chapter applies to users who choose to use OriginIoT evaluation server. The OriginIoT™web
application server is an interface to configure and view modules with associated interfaces, devices,
messages, and commands. User-created and System commands can be executed via user friendly GUI
interfaces.
11.2. USER LOG IN
Website address of the web application is: http://18.184.85.170 (resides on Amazon Web Services
cloud).
When entering this address, you will be automatically redirected to the login page. See figure 6.
Figure 6 –OriginIoT Web Application, login page
Please enter the credentials you received from your OriginGPS representative. You will be able to change
the password from the Profile tab. Clicking the ✓symbol will redirect you to the Home tab.
11.3. WEB HOME TAB
Each OriginIoT module has an ID number associated to it by this specific server. The unique ID in the
server is associated with the module upon its first registration to the server. The unique ID is linked to
the module’s IMEI (International Mobile Station Equipment Identity). The modules that you purchased

- 16 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
are added by us to your profile and will appear once you are logged in.
Figure 7 –OriginIoT Home Tab
Clicking the row of the module will forward you to the device details page. Red link symbol in the status
column shows the connection status of your OriginIoT. Red symbol means no connection, green means
good connection between module and server. Note you will need to refresh the page to get the latest
connectivity status from the modules.
11.4 MODULE DETAILS TAB
Figure 8 –Module Details Tab
There are 4 windows in the module details tab: Log, Commands, Tools and Details.
•Log –showing data sent and received to/from the module. The log is saved locally, it will be
deleted if page is refreshed.
•Commands –showing all commands that were entered in the system. Clicking on the command
row will open up the command details line that shows the byte string that will be sent to the
module upon execution of the command (see figure 8). Clicking on the yellow copy button will
copy the command byte string to the clipboard as a string (00 0b 80 05 04…).

- 17 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
Figure 8 –Command details
Each command has three buttons in its line: play, edit and delete. Play takes the form of a blue
airplane symbol when a mutli_GET or Multi_BUF command is entered. The green play symbol
executes the command, you will see the sent command in the log. The blue airplane button will
route the user to the preview tab, where he can see the data in the widgets. The yellow edit
button will open the new message windows pre-loaded with the data of the edited message.
The red delete button remove the command from the list and from the database.
•Tools –allows the user to choose from 3
available options (red reset button not
implemented yet).
•The green “+” button opens a new message
window and allows the user to add a new
command.
•The “>_” button allows the user to write a custom message, bypassing the new message
window restrictions.
•The blue “loopback” button initiates a loopback test to test the link status of the module
to the server. By executing a loopback test you can ping the module in order to check its
connectivity status (this test only checks the connectivity of the module to the server, not
the link state or status of peripheral sensors/devices). The structure of the loopback test
message is described in API specifications document. The created sent message and the
message received from the module will show up on the log area. If unsuccessful, you will not
receive any response.
Note: you will not receive a success notification if the module is not yet connected to the
server.
If you are connected to debug console, please wait until you receive:
00021788 [INFO] (MCU_ProcessAdminMsg:1086) Module is registered with
host application.
In the debug console, successful loopback message will print:
ORG> (MCU_ProcessSetMsg:1027): Received App Loopback message
0x000000: 00 0d 80 00 04 20 41 00 64 01 02 03 04 .....
A.d....
(MCU_ProcessSetMsg:1043): Outgoing message...
0x000000: 00 0c 00 80 10 20 00 65 01 02 03 04 .....
.e....
•Module Details –shows the IMEI and the link state of the module, with place holder for future
HW and SW versions, last connection time, MAC address and module serial number.

- 18 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
11.5 ADDING A NEW COMMAND
For the user convenience, the New Command window allows to easily define a message via online form.
There are no format constraints for the inputs so user has to make sure data is inserted correctly, two
characters for bytes (Hexadecimal) with space between bytes. The count field is updated automatically
when new bytes are added/removed.
Please consult the OriginSmart API Specification document to learn what inputs are required in Type,
Source, Destination, ExpAck, ExpRsp, Device Header and Device Data.
The result command is the actual string that will be sent to the module.
Figure 9 –New Command
11.6 ADDING A CUSTOM COMMAND
The user can send any string he wants to the device using this custom command feature. If the
command cannot be interpreted by the OriginIoT module, no response will be issued. If the first two
bytes in the system, which are dedicated for message length, are not correct, the message will not be
sent to the module.
The user can reach the custom command window by clicking on the “>_” button in the Tools section.
Clicking on Close will close the window without sending. Clicking on Send will send the message and
close the window.

- 19 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
Figure 9 –Command details
11.7 WIDGET PREVIEW TAB
Figure 10 –Widget preview tab
OriginGPS has developed some sample widgets to demonstrate the functionality of the module. These
widgets include:
•3D Preview of the module+addon1 assembly, controllable by accelerometer
•Google maps preview, showing GNSS locations
•Sensors preview, showing temperature, compass, and gyro data.
•Logs, showing raw data transferred to and from the module. The log widget allows you to filter
some of the messages (GNSS, Registration, Loop Back, Multi_Get). The log widget also allows
you to download the data of the log as a .log file.
•Operations, allowing the user to select which device to operate according to IMEI; start/stop
listening to selected device, and start/stop Multi_Get and Multi_Buf messages.

- 20 -
OriginIoT EVK User Guide Rev. 1.1 5.13.18
11.8 WIDGET CONGIFURATION
Figure 10 –Widget configuration window
Each widget can be configured by clicking the button in its corner. In order for the widget to present
the required information, the user needs to set the type of message to listen to. The fields name, type,
source, destination and pattern are common to all widgets. Widgets that are planed to be used with 3
dimensional data have invert axis function that adds a (-) sign to all raw data (in case your sensor is
physically oriented in negative direction).
In “name” you can put any string as input. “type” allows you to choose from a drop-down menu. Under
“source” and “destination” you should choose the hexadecimal interface ID from which and to where
your message is sent (the message you want to present with the widget).
“Pattern” allows you to choose which of the messages from the chosen interface to listen to. The
pattern should be in Hexadecimal byte sting (not a string). For example, if you look for a $GNRMC NMEA
message, you should enter 24 47 4e 52 4d 43.
11.9 PROFILE TAB
Figure 11 –Profile Tab
The profile tab allows the user to see its info: ID, Name, Username, role (user or admin), company, email
and phone number. This tab also allows the user to change his password.