S&T Kontron TRACe-LP1, User Manual

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...