background image

Kontron TRACe-LP1 Gateway – User Guide - SD.DT.G74.7e 

 

www.kontron.com 

 

// 2 

 

 

 

 

 

 

 

Kontron TRACe-LP1 Gateway

 - 

User Guide

 

 

 

 

 

Disclaimer   

Kontron  would  like  to  point  out  that  the  information  contained  in  this  user  guide  may  be  subject  to  alteration, 
particularly as a result of the constant upgrading of Kontron products. This document does not entail any guarantee 
on the part of Kontron with respect to technical processes described in the user guide or any product characteristics 
set  out  in  the  user  guide.  Kontron  assumes  no  responsibility  or  liability  for  the  use  of  the  described  product(s), 
conveys  no  license  or  title  under  any  patent,  copyright  or  mask  work  rights  to  these  products  and  makes  no 
representations or warranties that these products are free from patent, copyright or mask work right infringement 
unless  otherwise  specified.  Applications  that  are  described  in  this  user  guide  are  for  illustration  purposes  only. 
Kontron  makes  no  representation  or  warranty  that  such  application  will  be  suitable  for  the  specified  use  without 
further  testing  or  modification.  Kontron  expressly  informs  the  user  that  this  user  guide  only  contains  a  general 
description  of  processes  and  instructions  which  may  not  be  applicable  in  every  individual  case.  In  cases  of  doubt, 
please contact Kontron. 

This  user  guide  is  protected  by  copyright.  All  rights  are  reserved  by  Kontron.  No  part  of  this  document  may  be 
reproduced,  transmitted,  transcribed,  stored  in  a  retrieval  system,  or  translated  into  any  language  or  computer 
language, in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), without the 
express  written  permission  of  Kontron.  Kontron  points  out  that  the  information  contained  in  this  user  guide  is 
constantly being updated in line with the technical alterations and improvements made by Kontron to the products 
and thus this user guide only reflects the technical status of the products by Kontron at the time of publishing. 

Brand and product names are trademarks or registered trademarks of their respective owners. 

©2018 by Kontron S&T AG 

 

Kontron S&T AG 

Lise-Meitner-Str. 3-5 
86156 Augsburg 
Germany 

www.kontron.com

 

 

 

 

Summary of Contents for Kontron TRACe-LP1

Page 1: ...USER GUIDE www kontron com Kontron TRACe LP1 Gateway SD DT G74 7e February 2019 ...

Page 2: ...h application will be suitable for the specified use without further testing or modification Kontron expressly informs the user that this user guide only contains a general description of processes and instructions which may not be applicable in every individual case In cases of doubt please contact Kontron This user guide is protected by copyright All rights are reserved by Kontron No part of thi...

Page 3: ...way from version 1 6 4 configurable tx power from version 1 6 02 2019 6e Updated sections 1 7 Technical Information 12 2018 5e Product Name Change to TRACe LP1 previously TRACe LoRaMQTT Minor errors fixed 11 2018 4e New sections 8 1 Safety Requirements 8 2 Physical Mounting Updated sections 1 7 Technical Information 8 Installation and Cabling 8 3 DC IN Power Supply Connector 02 2018 3e Updated sec...

Page 4: ...collaborative and highly experienced support enables Kontron to provide exceptional peace of mind to build and maintain successful products For more details on Kontron s service offerings such as enhanced repair services extended warranty Kontron training academy and more visit http www kontron com support and services services Customer Comments If you have any difficulties using this user guide d...

Page 5: ...anger your life health and or result in damage to your material ESD Sensitive Device This symbol and title inform that the electronic boards and their components are sensitive to static electricity Care must therefore be taken during all handling operations and inspections of this product in order to ensure product integrity at all times HOT Surface Do NOT touch Allow to cool before servicing Lase...

Page 6: ...Kontron TRACe LP1 Gateway User Guide SD DT G74 7e www kontron com 6 ...

Page 7: ...al voltages before performing any work on this product Earth ground connection to vehicle s chassis or a central grounding point shall remain connected The earth ground cable shall be the last cable to be disconnected or the first cable to be connected when performing installation or removal procedures on this product Special Handling and Unpacking Instruction ESD Sensitive Device Electronic board...

Page 8: ...ental protection requirements where possible Many of the components used structural parts printed circuit boards connectors batteries etc are capable of being recycled Final disposition of this product after its service life must be accomplished in accordance with applicable country state or local laws or regulations Environmental protection is a high priority with Kontron Kontron follows the WEEE...

Page 9: ...14 2 Connect to the Gateway for the Configuration 16 2 1 Ethernet Cabling 16 2 2 Power Supply Cabling 16 2 3 Log into the Gateway 16 2 4 Check Running LoRa Services 17 2 5 Set the Current Date and Time 17 3 Add a LoRa Device 18 4 Configure the LoRa Agent 20 5 Packet Data Processing with Python optional 24 6 MQTT Messages Configuration 26 6 1 MQTT Messages published 26 6 2 Subscribe to MQTT Topics ...

Page 10: ...35 List of Figures Figure 1 DC IN Connector 33 Figure 2 LAN A LAN B Connectors 34 Figure 3 Assembly of the Grounding Point Connection 35 List of Tables Table 1 VX305x DC IN Pin Configuration 33 Table 2 LAN A LAN B Connectors Pin Configuration 34 Table 3 Gigabit Ethernet Connector Pin Assignment 34 ...

Page 11: ...in the datasheet A demo MQTT service no built in security can be used during three months at kontron lora cloudapp net The logs of the sensor messages can be displayed with any MQTT client running on a laptop or a smartphone One example of such a client is mqtt fx The dashboard and application are context dependent please consult Kontron 1 1 Your Private LoRaWAN Network ready to use Thanks to its ...

Page 12: ... TRACe gateway and the MQTT Server Optionally based on a yearly fee model a Cloud server is accessible on a public URL to retrieve the data from the TRACe Gateways Data can be easily collected from the Cloud or on premise server by MQTT subscriptions using MQTT clients Nowadays MQTT clients are widely used for IoT applications and available for various environments Linux Windows Android IOS They c...

Page 13: ...nt spreading factors on up to 8 radio channels in parallel 1 4 Wireless Connectivity Options 1x WLAN 802 11 ac abgn Wi Fi network interface supporting high transmission data rate and reliable performance ideal for demanding bandwidth applications It provides 2 stream MIMO configurations which is a suitable choice for mobile to ground communication when under a Wi Fi coverage typically with a dedic...

Page 14: ...ation LoRa Radio Frequency range 863 870MHz 868 MHz for Europe Power output 14dBm 20dBm max Reference antenna used during qualification Compotek CTA 868 2 DR SM S2 Power Supply 24 VDC optional 110 220 V AC DC adaptor Protection Class IP40 on all faces IP54 or IP65 available on request Options WWAN 4G 3G modem LTE HSPA GSM GPRS EDGE EV DO Rev A 1xRTT with GPS LTE module 4G Power output 23dBm max Ba...

Page 15: ...o 2170MHz Reference antenna used during qualification ADACTUS ADA 0040 LTE WLAN Wi Fi 802 11 ac abgn 2T2R client and hotspot modes supported LoRa 915 MHz LoRaWAN network variant for US Operating Temperatures 40 C up to 70 C external ambiant temperature Dimensions W x D x H 272 mm 300m with ears x 190 mm x 78 mm ...

Page 16: ...connector and cable 2 3 Log into the Gateway The recommended way to interact with the gateway during configuration is to use Windows Remote Desktop Connection on the laptop click on Windows start button and enter mstsc exe You can also search for Remote Desktop Connection in the native Windows language In the dialog box enter the name or IP address assigned to the gateway A login dialog box is the...

Page 17: ...nt service The response shall be they are running and should look like the following screen shots The version number of the KONTRON LoRaWAN software installed on the gateway can be displayed by entering the following linux command rpm qi trace lora 2 5 Set the Current Date and Time The gateway has no battery inside It uses a super capacitor to keep the time and date for a maximum duration of 2 day...

Page 18: ...Type type of the device It is used for the optional local message processing python language you are free to choose the string It can be unique or the same for multiple devices requiring the same message processing Process Yes to indicate that you want to perform message processing on the gateway ADR indicates that you allow the gateway to handle adaptive data rate for this device AppKey applicati...

Page 19: ... or ABP use lowercase for AppEUI DevEUI Appkey NwkSkey AppSkey DevAddr After modification of the file restart the lora agent systemctl restart trace loralora agent When a field is not used it can be omitted for example AppEUI if ABP mode is used Comments can be inserted with the syntax This is a comment or by inserting to consider the rest of the line as a comment ...

Page 20: ...imeout_ms timeout for an MQTT connection Can be increased if problems for connection are met cafile required for a secure TLS connection mqtts It is the CA Certification Authority certificate used to verify the broker server certificate The cafile shall be surrounded by double quotes Example cafile etc trace lora ca crt certfile required for a secure TLS connection mqtts if a strong mutual authent...

Page 21: ...Kontron TRACe LP1 Gateway User Guide SD DT G74 7e www kontron com 21 ...

Page 22: ...used carefuly when changed to meet regional regulation It is only available for lora software versions greater or equal to 1 6 Example of heart beat message sent Topic Kontron TRACe 1117301020010 LoRa Heartbeat Message Time 1513270596 fleet DevEUI 0e7e346433306021 FCntUp 0 FCntDown 0 RSSI 0 LSNR 0 LastMessage 0 DevEUI 0e7e3464333036be FCntUp 0 FCntDown 0 RSSI 0 LSNR 0 LastMessage 0 DevEUI 0e7e3464...

Page 23: ...DT G74 7e www kontron com 23 satellites_used Number of satellites used latitude Latitude in degrees valid if mode 2 longitude Longitude in degrees valid if mode 2 altitude Altitude in meters valid if mode 3 speed Speed over ground meters sec ...

Page 24: ...306021 28 Message 010011 With Python processing Topic Kontron TRACe 123456789 LoRa PB868LRH 0e7e346433306021 Event Message Button Pushed 17 At processing time if the Python processing is activated for this device the lora agent will call the function process in the file klora py with 3 arguments the type of the device as specified in fleet json file the port the payload The following example illus...

Page 25: ...3456789 LoRa PB868LRH e7e34643330602 Event Message Button Pushed 2 Topic Kontron TRACe 123456789 LoRa PB868LRH e7e34643330602 NbTimesPushed Message 1070 Topics can be on multiple levels Event Type Button Pushed 1 Topic Kontron TRACe 123456789 LoRa PB868LRH e7e34643330602 Event Type Message Button Pushed If there is something wrong the process for this device type is not implemented the payload is ...

Page 26: ...le level topic Example Kontron TRACe GATEWAY_ID Lora DEVTYPE DEVEUI Event Kontron TRACe GATEWAY_ID Lora DEVTYPE DEVEUI Temperature Value For more detail about process refer to chapter 5 Packet Data Processing with Python optional chapter GATEWAY_ID ID of the gateway DEVEUI Device ID identifies uniquely the device DEVTYPE The type of the device device_type_X in lora agent conf FPORT Correspond to t...

Page 27: ...utton received by the gateway 123456789 Kontron TRACe LoRa Subscribe to all LoRa messages sent by all the TRACe gateways Kontron LoRa PB868LRH Subscribe to all LoRaWAN messages sent by all push buttons type PB868LRH For more details refer to https mosquitto org man mosquitto_sub 1 html You can create easily a message logger with a timestamp using the command mosquitto_sub mosquitto_sub v h kdev fr...

Page 28: ...mitted the downlink message over the LoRa radio and the downlink message is purged Checking if the device actually received the message can be done by looking at next uplink messages from the device device dependent Topic example for a downlink message Kontron TRACe 1117301020010 Lora DEVICE_TYPE DEVICE_EUI downlinkack It is possible to purge a downlink message which has not been acknowledged so f...

Page 29: ...Kontron TRACe LP1 Gateway User Guide SD DT G74 7e www kontron com 29 ...

Page 30: ...ode Uplink unconfirmed messages Uplink confirmed messages Downlink messages and acknowledge Possibility to use devives in OTAA and ABP mode on the same gateway in the same time Send data of LoRaWAN devices in MQTT packets to a broker Possibility to process data received from LoRaWAN devices using Python and send personalized MQTT packets Send heartbeat in MQTT packets with status of LoRaWAN device...

Page 31: ...ng the boot of the system systemctl enable trace lora lora pkt fwd service systemctl enable trace lora lora agent service 7 2 5 Logs Full logs of the package forwarder and the lora agent services can be listed by entering the following commands journalctl _SYSTEMD_UNIT trace lora lora pkt fwd service journalctl _SYSTEMD_UNIT trace lora lora agent service ...

Page 32: ... be mounted by its lateral mounting brackets one on each side before cabling The product shall be powered through an external protective device 7 A rated Kontron TRACe LP1 contains electrostatically sensitive devices Whenever possible unpack or pack this product only at EOS ESD safe work stations Where a safe work station is not guaranteed it is important for the user to be electrically discharged...

Page 33: ...ays on when VDC is applied or connected to VDC through a switch to power the system on off with VDC kept applied The Kontron TRACe LP1 system has been designed for ultra wide range input voltage The input nominal voltage Vnom can be selected from among the following values Vnom 24 VDC or 48 VDC or 72 VDC or 96 VDC or 110 VDC Vin Input voltage must then comply with the following rules INPUT VOLTAGE...

Page 34: ...a transmission Auto Negotiation The Ethernet transmission should operate using a CATe cable with a maximum length of 100 m Figure 2 LAN A LAN B Connectors Table 2 LAN A LAN B Connectors Pin Configuration PIN PIN NAME 1 DA 2 DA 3 DB 4 DB 5 DD 6 DD 7 DC 8 DC Table 3 Gigabit Ethernet Connector Pin Assignment PIN 10BASE T 100BASE TX 1000BASE T I O SIGNAL I O SIGNAL I O SIGNAL 1 O TX O TX I O BI_DA 2 O...

Page 35: ...s a threaded blind stud which accepts an M4 screw or bolt for attaching external ground cabling to the Kontron TRACe LP1 This grounding wire must be connected to the vehicle s chassis or a central grounding point Maximum permissible ingress of a screw into the blind nut is 8 mm Figure 3 Assembly of the Grounding Point Connection Screw the M4 nut with the recommended torque 1N m 0 1 Grounding Recom...

Page 36: ...efit from accelerated time to market reduced total cost of ownership product longevity and the best fully integrated applications overall For more information please visit www kontron com CORPORATE OFFICES FRANCE GLOBAL HEADQUARTERS NORTH AMERICA ASIA PACIFIC 150 rue Marcelin Berthelot ZI de Toulon Est BP 244 83078 Toulon Cedex 9 France Tel 33 4 98 16 34 00 Fax 33 4 98 16 34 01 sales KFR kontron c...

Reviews: