Summary of Contents for OriginGPS OriginIoT ORG2101
- Page 1 OriginIoT ORG2101 - EVK USER GUIDE O r i g i n G P S . c o m O r i g i n G P S . c o m - 1 - OriginIoT EVK User Guide Rev. 1.1 5.13.18...
-
Page 2: Table Of Contents
INDEX SCOPE ................................5 DISCLAIMER ............................... 5 SAFETY INFORMATION ..........................5 ESD SENSITIVITY ............................5 CONTACT INFORMATION ........................5 RELATED DOCUMENTATION ........................5 REVISION HISTORY ........................... 6 ABOUT ORIGINIOT™ ..........................6 8.1. MODULE DESCRIPTION ......................6 8.2. ARCHITECTURE ........................6 8.3. - Page 3 11.6 ADDING A CUSTOM COMMAND ....................18 11.7 WIDGET PREVIEW TAB ......................19 11.8 WIDGET CONGIFURATION ......................20 11.9 PROFILE TAB ..........................20 OPERATING THE SENSORS ON THE EVK ..................21 12.1 PARAMETER SETUP ........................21 12.2 ACTIVATING THE SENSORS ....................... 22 12.2 WIDGET CONFIGURATION ......................
- Page 4 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 .........................
-
Page 5: Scope
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. -
Page 6: Revision History
7. REVISION HISTORY REVISION DATE CHANGE DESCRIPTION March 26, 2018 First Edition – Preliminary New web application guidance. Mating cycles of connectors. Change in May 13, 2018 P/n. Minor corrections and clarifications TABLE 2 – REVISION HISTORY 8. ABOUT ORIGINIOT™ 8.1. -
Page 7: Originiot Evk Kit Including
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) •... -
Page 8: Connecting The Evk To Pc Via Debug Port
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. -
Page 9: Figure 2 – Mating Org2101 To Evk Correctly
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. -
Page 10: Figure 3 – Powering Up Evk And Org2101
Jumper J24 selection of ORG2101 power by 6V plug USB connector to PC via J22 EVK powered by external 6V power supply 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. -
Page 11: Figure 3A – Serial Port In Tera Term
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 –... -
Page 12: Connecting Originiot To A Server
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 iot@origingps.com 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. -
Page 13: Entering Cellular-Network Parameters - Gsm/Lte Authentication Command
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”... - Page 14 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.
-
Page 15: Originiot Web Application
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. -
Page 16: Module Details Tab
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. -
Page 17: Figure 8 – Command Details
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. -
Page 18: Adding A New Command
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. -
Page 19: Widget Preview Tab
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 •... -
Page 20: Widget Congifuration
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. -
Page 21: Operating The Sensors On The Evk
12. OPERATING THE SENSORS ON THE EVK The EVK has 5 sensors (including the GNSS sensor on the OriginIoT module) connected via 3 interfaces: GNSS and temperature sensors connected via two UART interfaces (IF_20 and IF_03 respectively) Accelerometer, Compass and Gyroscope connected via I2C (IF_05). 12.1 PARAMETER SETUP All sensors must to be configured (“Committed”) on the device using an IF_PARAM_SET message has specified in the API spec document. -
Page 22: Activating The Sensors
12.2 ACTIVATING THE SENSORS To understand what messages shall be sent to achieve a certain functionality for a specific device one can refer to the datasheets of the devices. Usually under “Register map” you will find the description of the functionality each register address is responsible for and what kind of data to set in it to achieve this functionality. -
Page 23: Table 5 – Configuration For Uart Messages
Table 5 – Configuration for UART Messages If you are using a serial debug console you will be able to see the commands received on the module and the responses issued by the module. For example, this is what you will receive on the console after successful dataFormat SET message, measureMode SET message and readData GET messages for the accelerometer: (i2cProcessSetMsg:759): Set message... -
Page 24: Widget Configuration
00260504 [DEBUG] (i2cProcessSetMsg():764): the Ack flag: 0x20 the RSP Flag: 0x41 00260505 [DEBUG] (i2cProcessSetMsg():769): Device Address: 0x53 00260520 [DEBUG] (i2cProcessSetMsg():784): The Start Reg: 0x31 00260532 [DEBUG] (i2cProcessSetMsg():797): Number of bytes: 1 (i2cProcessSetMsg:834): Outgoing Set msg Response... 0x000000: 00 09 05 80 10 20 53 31 01 .. -
Page 25: Ordering Information
GL=Global US = North America JA = Japan CH = China 3. Selection of SIM type T = Traditional plastic SIM card holder E = Embedded SIM * Please contact iot@origingps.com List of orderable parts ORG2101-2GEU-T-EVK ORG2101-3GEU-T-EVK ORG2101-C1US-T-EVK ORG2101-2GEU-E-EVK ORG2101-3GEU-E-EVK... - Page 26 USB 2.0 for input from external devices – J25. MCU cold restart button – SW1 [Note: push the restart button for at list one second to allow GNSS module to fully restart] Disconnect EVK sensors – Jumper J28 Auxiliary mezzanine connector - J5: NAME FUNCTION DIRECTION...
-
Page 27: Figure 32 –J5 Connector
Battery Power Input Power EVK Power Supply Power Battery Power Input Power EVK Power Supply Power VCC3V3AUX 3.3V Power Supply Power EVK Power Supply Power VCC3V3AUX 3.3V Power Supply Power System Ground Power System Ground Power System Ground Power System Ground Power System Ground Power... -
Page 28: Appendix B - Firmware Upload (Flashing) For Originiot Module
APPENDIX B – FIRMWARE UPLOAD (FLASHING) FOR ORIGINIOT MODULE OriginIoT module in the EVK is supplied with the company proprietary OriginSmart™ FW, designed to allow codeless configuration of the remote module without any FW changes. If for any reason there is a need to upload firmware, this section explains how this is done. Required equipment for FW upload: - ST-Link/v2 ISOL STM8 &... -
Page 29: Figure 34: Wire Colors On J7 Connector Pins
Black Ground Orange JTAG / Firmware Loading Plug Yellow JTAG / Firmware Loading Plug Black – Separate wire on top right Ground pin of controller Table 8 – Wires Connection to EVK board Figure 34: Wire Colors on J7 connector pins All the other wires in the plug (green, blue, white) are not relevant and should not be connected. -
Page 30: Figure 35: Power Set Up For Fw Upload
Connection of ST- Link to Auxiliary connector J5 Led Indicating power OK to J26 EVK power OriginIoT module J24 Jumper choosing J26 as power supply to Origin IoT Figure 35: Power set up for FW upload module 4. Open STM32 ST-LINK Utility. Press Target ->... -
Page 31: Figure 36: Stm32 St-Link Utility
Figure 36: STM32 ST-Link Utility 5. In case the connection is fine, you should see the following screen, with message: ”Connected via SWD”. See figure 37. In case you get an error and cannot connect – please check your wires connection. Figure 37: Connecting to module in STM32 ST-Link Utility - 31 - OriginIoT EVK User Guide... -
Page 32: Figure 38: Program & Verify In Stm32 St-Link Utility
6. Click on “Target->Program & Verify”. See figure 38. Figure 38: Program & Verify in STM32 ST-Link Utility Open file dialog will open. Select your firmware file. This should be a .hex /.bin file. 7. After selecting the file, you will see “download” window. See figure 39. Press Start. Figure 39: Download window 8. -
Page 33: Appendix C -Register Maps For Sensors
Figure 40: Successful Firmware Download 9. Press “Target-> Disconnect” to disconnect the module. APPENDIX C –REGISTER MAPS FOR SENSORS Accelerometer - TABLE 9– Accelerometer Register Map - 33 - OriginIoT EVK User Guide Rev. 1.1 5.13.18... - Page 34 eCompass - TABLE 10– eCompass Register Map - 34 - OriginIoT EVK User Guide Rev. 1.1 5.13.18...
-
Page 35: Appendix D - Work With Org2101 Add-Ons
Gyroscope TABLE 11– Gyroscope Register Map APPENDIX D – WORK WITH ORG2101 ADD-ONS ORG2101 EVK allows developers to test their add-ons (or add-ons purchased directly from OriginGPS) in two manners: 1. Dedicated connectors on EVK - J3 and J4 2. Flat Flexible Cable (FFC) connector – J6... -
Page 36: Using Add-On Via Connectors J3 And J4
1. Add-on developed according to guidelines in ORG2101 Datasheet document, or purchased directly from OriginGPS (For FCC option it shall have FFC connector compatible with Molex 150150451) 2. Flat Cable connector Molex 150150451 or compatible (only for FFC connection option) 3. -
Page 37: Using Add-On Via Ffc Connector J6
D.2 Using Add-on via FFC connector J6 Using add-on via FFC connector is the closest simulation for the real-life functionality of the add-on in a product. In this mode the addon and the ORG2101 module are powered by a battery (and not from the EVK). -
Page 38: Figure 43 – Attaching Ffc Cable To Add-On
Figure 43 – attaching FFC cable to add-on 5. In the same manner, connect FFC to FFC connector on the EVK (J6), see figure 44. Pay close attention to the direction of the FCC. Note: repeated insertion of FFC, closing and open of actuator can be harmful to the performance of connector J6. -
Page 39: Figure 43 – Attaching Ffc Cable To Evk
USB cable LEDs indicating connected to J22 USB power and Jumper J24 in EVK power USB position ORG2101, Addon and antennas assembly FCC Molex 150150451 Figure 43 – attaching FFC cable to EVK 7. Open terminal on your PC and connect to corresponding COM port of the OriginIoT with a baud rate of 57600 bps. - Page 40 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. Note: you can choose to operate or disconnect the sensors on the EVK using Jumper J28. - 40 - OriginIoT EVK User Guide Rev.
Need help?
Do you have a question about the OriginIoT ORG2101 and is the answer not in the manual?
Questions and answers