www.dragino.com LGT-92 LoRaWAN GPS Tracker User Manual Document Version: 1.5.5 Image Version: v1.5.3 Version Description Date 1.0 Release 2018-Dec-12 1.0.1 Correct GPS payload format in TTN 2019-Jan-23 1.0.2 Add more info for 8-Channel Mode Description 2019-Feb-21 1.0.3 Add LED description, Buttons, correct accelerometer payload info 2019-Mar-29 1.4.0 Add LGT-92-AA board description and photo 2019-May-11 Add Software/hardware change log Change Payload to add Alarm flag 1.4.
www.dragino.com Change power voltage. Add trouble shooting for empty payload. 1.5.0 Firmware update to v1.5. Add related manual for v1.5. V1.5 firmware has a big 2019-Nov-15 change compare to previous one. Please read chapter 2 for detail. 1.5.1 Add work flow for v1.5 , LED status. 2019-Nov-28 1.5.2 Fix work flow error. Add new downlink payload in 1.5 2019-Nov-29 1.5.3 Modify description of Alarm Button 2019-Dec-12 1.5.4 Add hardware change v1.5. Firmware update to v1.5.3 2020-Jan-18 1.5.
www.dragino.com 1. 2. 3. Introduction .............................................................................................................................. 5 1.1 What is LGT-92 LoRa GPS Tracker .............................................................................................. 5 1.2 Specifications.............................................................................................................................. 6 1.3 Features ...........................................
www.dragino.com 6. FAQ ......................................................................................................................................... 32 6.1 What is the lifetime for battery? .............................................................................................. 32 6.2 Why there is 433/868/915 version? ......................................................................................... 32 6.3 How can I tell the firmware version on LGT92? ........................
www.dragino.com 1. Introduction 1.1 What is LGT-92 LoRa GPS Tracker LGT-92 is a Long Range / low power consumption LoRaWAN GPS tracker. LGT-92 gets user’s location info via GPS and sends it to IoT server via LoRaWAN wireless network. Compare to traditional GPS trackers (base on GPRS or Cellular network), LGT-92 use much lower power consumption hence can last for longer time.
www.dragino.com 1.2 Specifications Micro Controller: STM32L072CZT6 MCU MCU: STM32L072CZT6 Flash:192KB RAM:20KB EEPROM: 6KB Clock Speed: 32Mhz Common DC Characteristics: Supply Voltage: LGT92-LI: 5V via USB port or Internal li-on battery LGT92-AA v1.3/v1.4: 2.84v ~ 3.6v via screw terminal. Operating Temperature: -40 ~ 85°C LoRa Spec: Frequency Range, Band 1 (HF): 862 ~ 1020 Mhz 168 dB maximum link budget. +20 dBm - 100 mW constant RF output vs.
www.dragino.com 1.3 1.4 1.5 LoRa Transmit Mode: 125mA @ 20dBm 44mA @ 14dBm Tracking: max: 38mA Features LoRaWAN 1.0.2 Class A,Class C STM32L072CZT6 MCU SX1276/78 Wireless Chip Pre-load bootloader on USART1/USART2 MDK-ARM Version 5.
www.dragino.
www.dragino.com 1.6 Variants Part Number Photo LGT-92-LI Hardware Difference Target Application --With Enclosure --Real time tracking --With 1000mA li-on battery --Short tracking period --Enable charge circuit --Rechargeable --FPC internal LoRa Antenna --Can power by USB port LGT-92-AA --Without Enclosure --Asset tracking --With (1.5v) AA type battery --Long tracking period holder, no battery.
www.dragino.com 2. Use LGT-92 with stock LoRaWAN firmware 2.1 How it works? The LGT-92 is pre-loaded with a firmware and is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, user just need to input the OTAA keys in the LoRaWAN IoT server and power on the LGT-92. It will auto join the network via OTAA. In case user can’t set the OTAA keys in the LoRaWAN OTAA server and has to use the keys from the server.
www.dragino.com The LG308 is already set to connect to TTN network . What the rest need to is register this device in TTN: Step 1: Create a device in TTN with the OTAA keys from LGT-92.
www.dragino.com Input these keys to their LoRaWAN Server portal.
www.dragino.com Step 2: Power on LGT-92 LoRaWAN GPS Tracker by using the on board switch. For LGT-92-LI, user can power it by USB cable no matter if the power switch is on or off. For LGT-92-AA, the USB port is only used for debug or upload firmware, USB port can’t power the device. Step 3: LGT-92 will auto join to the TTN network. After join success, LGT92 will start to upload message to IoT server. For firmware v1.4: By default, the upload period is 5 minutes.
www.dragino.com 2.3 Uplink Payload The uplink payload here is for v1.5 version firmware. For v1.4 firmware version, please check the user manual: v1.4 firmware user manual. 2.3.1 Payload Analyze The default uplink payload includes totally 11 bytes. (User can use AT+SGM=0 to enable the motion sensor to roll/pitch info from accelerometer. When accelerometer info is enable, total payload will be 15 bytes, please note 15 bytes won’t work on DR0 on US915/AU915 frequency band.
www.dragino.com Location info: Latitude: 02863D68⇒ if (0x02863D68& 0x80000000 = 0 ): value = 02863D68 /1000000 = 42.351976 Longitude: FAC29BAF ⇒ if (0xFAC29BAF & 0x80000000 = 1 ): value = (0xFAC29BAF – 0x 100000000)/1000000 =-87.909457 Important note: a) When power is low (<2.84v), GPS won’t be able to get location info and GPS feature will be disabled and the location field will be filled with 0x0FFFFFFF, 0x0FFFFFFF. b) In firmware version v1.5, Roll & Pitch is disabled by default.
www.dragino.com -- 0x01: Enable movement detect mode. LGT92 will have a short uplink interval (TDC) when move and will have a long uplink interval (KAT: Keep Alive Time) when not move. This is the default states in firmware v1.5 -- 0x10: Set movement detection to collision detect, Same operation as 0x01 mode but it has a higher thread hold to enable enter the short uplink interval. -- 0x11: Manual set the movement detection thread hold and frequency so can customized the movement detect thread hold.
www.dragino.
www.dragino.com 2.
www.dragino.com Fixed and uplink BLUE blinks twice (200ms per blink) Yes N/A Fail Fix and uplink RED blinks twice (200ms per blink) Yes N/A Enter Alarm mode RED on five seconds N/A N/A Uplink under Alarm RED on one second Yes N/A Exit Alarm BLUE on one second Yes N/A Downlink Modify GREEN led on 1 second Yes N/A RED on 500ms N/A Yes TDC Movement Detect 2.6 Button Function RESET button: Press this button will reboot the device.
www.dragino.com 3. Use AT Command 3.1 Access AT Command LGT-92 supports AT Command set in stock firmware. User can use a USB to TTL adapter to connect to LGT-92 for using AT command, as below. In PC, User needs to set serial tool baud rate to 9600 to access serial console for LGT-92.
www.dragino.
www.dragino.
www.dragino.
www.dragino.com 4. Upload Firmware User can use the LGT-92’s USB port to upgrade firmware into it. The hardware connection for upgrade firmware is as below: Connection: ST-LINK v2 5.0v <--> Dupont red pin ST-LINK v2 GND <--> Dupont black pin ST-LINK v2 SWCLK <--> Dupont green pin ST-LINK v2 SWDIO <--> Dupont white pin LGT-92 power can be on or off. Video Instruction is here: https://youtu.
www.dragino.com Step5: The led on the ST-LINK adapter will now blinking, once see it blinks; release the reset button on the LGT-92. Step6: The led on the ST-LINK adapter will now blinking, once see it blinks; release the reset button on the LGT-92. The ST-Link utility will pop up a download window. Click the start button to download the image to LGT-92.
www.dragino.com 5. Developer Guide 5.1 Source Code Software Source Code Download Link. Hardware Source Code Download Link 5.2 Compile Source Code 5.2.1 Set up Keil compile environment Assume you already have Keil uVision5 installed. Below step shows how to install MDK support and get license. 1: Open the web: http://www2.keil.com/stmicroelectronics-stm32/mdk 2: Download the keil: 3: Login with an account that has administration rights. 4: Right-click the µVision icon and select Run as Administrator..
www.dragino.com 7: Enter the Product Serial Number 4PPFW-QBEHZ-M0D5M along with your contact information and click the button Submit. An e-mail is sent back with the License ID Code (LIC) within a few minutes.
www.dragino.com 8:To activate the Software Product, enter the LIC in the field New License ID Code (LIC) of the dialog License Management... and click Add LIC.
www.dragino.com 5.2.2 Install STM32L0 Series Device 1:Open the web: https://www.keil.com/dd2/pack/#/eula-container ; 2:Find the STMicroelectronics STM32L0 Series Device and download it; 3:Find the Software Pack and installs it; 4:Add the Device ,then you can rebuild the project.
www.dragino.com Notice: If without add the Device, the keil would report this error. 5.2.3 Compile Source Code 1. Download the source code from Software Source Code Download Link. 2. Use Keil to open the project file: STM32CubeExpansion_LRWAN/Projects/Multi/Applications/LoRa/DRAGINO-LRWAN(AT)/MD K-ARM/STM32L072CZ-Nucleo/Lora.uvprojx 3. In Keil, you can see what frequency band the code support.
www.dragino.com 4. If you want to change frequency, modify the Preprocessor Symbols. For example, change EU868 to US915 5.
www.dragino.com 6. FAQ 6.1 What is the lifetime for battery? It is hard to get an exact lifetime for the battery, the actually lifetime for battery depends on the battery type, GPS signal strength, upload periodically, use environment (indoor/outdoor). For example, if the lgt-92 is placed in indoor environment, it will take 150 seconds to try to get GPS fix and final it will fix fail. If the lgt-92 is placed outdoor, it will normally take less than 10 seconds after the first fix.
www.dragino.com 6.4 How to change the LoRa Frequency Bands/Region? User can follow the introduction for how to upgrade image. When download the images, choose the required image file for download. 6.5 Can I use Private LoRa protocol? The stock firmware is based on LoRaWAN protocol. User can use a private LoRa protocol in LGT-92, this section describe an example for base LoRa transfer. It is a reference/demo and we didn’t provide further software develop support on this topic.
www.dragino.com 6.6 How to set up LGT-92 to work in 8 channel mode in US915, AU915, CN470 bands? By default, the frequency bands US915, AU915, CN470 works in 72 frequencies. Many gateways are 8 channel gateways, in such case, the OTAA joined time and uplink schedule is long and unpredictable while the end node hopping in 72 frequencies. User can configure the end node to work in 8 channel models by using the AT+CHE command, the 500kHz channels are always includes for OTAA.
www.dragino.com to set the end node to work in 8 channel mode. The device will work in Channel 8-15 & 64-71 for OTAA, and channel 8-15 for Uplink. AU915 is similar. Below is the AU915 Uplink Channels. CHE AU915 Uplink Channels(125KHz,4/5,Unit:MHz,CHS=0) 0 ENABLE Channel 0-63 1 915.2 915.4 915.6 915.8 916 916.2 916.4 916.6 Channel 0-7 2 916.8 917 917.2 917.4 917.6 917.8 918 918.2 Channel 8-15 3 918.4 918.6 918.8 919 919.2 919.4 919.6 919.8 Channel 16-23 4 920 920.2 920.4 920.6 920.8 921 921.2 921.
www.dragino.com 6.8 How to set up LGT-92 to work with Single Channel Gateway such as LG01/LG02? In this case, users need to set LGT-92 to work in ABP mode & transmit in only one frequency. Assume we have a LG02 working in the frequency 868400000 now, below is the steps. (Video Instruction: https://youtu.be/32eLnlYoLoI ) Step1: Log in TTN, Create an ABP device in the application and input the network session key (NETSKEY), app session key (APPSKEY) from the device.
www.dragino.com 7. Trouble Shooting 7.1 Why I can’t join TTN in US915 /AU915 bands? It is about the channels mapping. Please see this link for detail. 7.2 I see AT_ERROR when I type commands? When you type command, it is possible that the GPS communication conflict with TTL input so you see AT_ERROR. Especially the TDC time is short while GPS fix in a short period.
www.dragino.com 7.4 I can’t upload firmware via my ST-Link v2. ? Make sure you follow exactly the steps and double check wire connection as per how to upgrade firmware. Note: 1) There are different version ST-Link v2. The white one as below is the most stable and recommended one. 2) The white version ST-Link v2 such as below photo has different hardware version. The original one doesn’t have 3.3v on pin 1/2 and the clone one has 3.3v on pin 1/2. User has to short pin19 (VDD 3.
www.dragino.com 8. Order Info See variants first: Part Number: LGT-92-XX-YYY XX: Major variant model LI: Li-on battery version DE: AA battery version YYY: The default frequency band AS923: LoRaWAN AS923 band AU915: LoRaWAN AU915 band EU433: LoRaWAN EU433 band EU868: LoRaWAN EU868 band KR920: LoRaWAN KR920 band US915: LoRaWAN US915 band IN865: LoRaWAN IN865 band CN470: LoRaWAN CN470 band 9.
www.dragino.com 11.