S&T Kontron TRACe-LP1 Manual de usuario

 USER GUIDE

www.kontron.com

Kontron TRACe-LP1 Gateway

SD.DT.G74.7e - February 2019

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

www.kontron.com // 2

 Kontron TRACe-LP1 Gateway - User Gu de

Disclaimer

Kontron would l ke to po nt out that the nformat on conta ned n th s user gu de may be subject to alterat on,

part cularly as a result of the constant upgrad ng of Kontron products. Th s document does not enta l any guarantee

on the part of Kontron w th respect to techn cal processes descr bed n the user gu de or any product character st cs

set out n the user gu de. Kontron assumes no respons b l ty or l ab l ty for the use of the descr bed product(s),

conveys no l cense or t tle under any patent, copyr ght or mask work r ghts to these products and makes no

representat ons or warrant es that these products are free from patent, copyr ght or mask work r ght nfr ngement

unless otherw se spec f ed. Appl cat ons that are descr bed n th s user gu de are for llustrat on purposes only.

Kontron makes no representat on or warranty that such appl cat on w ll be su table for the spec f ed use w thout

further test ng or mod f cat on. Kontron expressly nforms the user that th s user gu de only conta ns a general

descr pt on of processes and nstruct ons wh ch may not be appl cable n every nd v dual case. In cases of doubt,

please contact Kontron.

Th s user gu de s protected by copyr ght. All r ghts are reserved by Kontron. No part of th s document may be

reproduced, transm tted, transcr bed, stored n a retr eval system, or translated nto any language or computer

language, n any form or by any means (electron c, mechan cal, photocopy ng, record ng, or otherw se), w thout the

express wr tten perm ss on of Kontron. Kontron po nts out that the nformat on conta ned n th s user gu de s

constantly be ng updated n l ne w th the techn cal alterat ons and mprovements made by Kontron to the products

and thus th s user gu de only reflects the techn cal status of the products by Kontron at the t me of publ sh ng.

Brand and product names are trademarks or reg stered trademarks of the r respect ve owners.

Kontron S&T AG

L se-Me tner-Str. 3-5

86156 Augsburg

Germany

www.kontron.com

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

www.kontron.com // 3

Revision History

Publication Title:

Kontron TRACe-LP1 Gateway User Gui e

Doc. ID:

SD.DT.G74-7e

Revision

Brief Description of Changes

Date of Issue

Updated sect ons:

- 2.4 descr be command to v ew lora software rev s on

- Uppercase n crypto keys no longer requ red from vers on 1.6

- 4 Conf gure the LoRa Agent w th root top c from vers on 1.6

- 4 Report GPS pos t on of the gateway from vers on 1.6

- 4 conf gurable tx-power from vers on 1.6

2019

Updated sect ons:

-1.7 Techn cal Informat on

2018

Product Name Change to TRACe

LP1 (prev ously

TRACe

LoRaMQTT)

M nor errors f xed

2018

New sect ons:

- 8.1 Safety Requ rements

- 8.2 Phys cal Mount ng

Updated sect ons:

- 1.7 Techn cal Informat on

- 8/ Installat on and Cabl ng

- 8.3 DC IN Power Supply Connector

2018

Updated sect ons:

- 1/ TRACe LoRa-MQTT Overv ew

- 1.7 Techn cal Informat on

- 3/ Add a LoRa Dev ce

- 5/ Packet Data Process ng w th Python (opt onal)

2018

Complete rework ng of the document

2017

Updated sect on:

- 1.1 Log n

2017

In t al Issue

2017

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

www.kontron.com // 4

Customer Support

Please contact our support team at [email protected]

Customer Service

As a trusted technology nnovator and global solut ons prov der, Kontron extends ts embedded market strengths nto

a serv ces portfol o allow ng compan es to break the barr ers of trad t onal product l fecycles. Proven product

expert se coupled w th collaborat ve and h ghly-exper enced support enables Kontron to prov de except onal peace of

m nd to bu ld and ma nta n successful products.

For more deta ls on Kontron’s serv ce offer ngs such as: enhanced repa r serv ces, extended warranty, Kontron

tra n ng academy, and more v s t http://www.kontron.com/support-and-serv ces/serv ces.

Customer Comments

If you have any d ff cult es us ng th s user gu de, d scover an error, or just want to prov de some feedback, contact

Kontron support. Deta l any errors you f nd. We w ll correct the errors or problems as soon as poss ble and post the

rev sed user gu de on our webs te.

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

www.kontron.com // 5

Symbols

The follow ng symbols may be used n th s user gu de

DANGER in icates a hazar ous situation which, if not avoi e ,

will result in eath or serious injury.

WARNING in icates a hazar ous situation which, if not avoi e ,

coul result in eath or serious injury.

CAUTION in icates a hazar ous situation which, if not avoi e ,

may result in minor or mo erate injury.

NOTICE in icates a property amage message.

Electric Shock!

This symbol an title warn of hazar s ue to electrical shocks (> 60 V) when touching

pro ucts or parts of pro ucts. Failure to observe the precautions in icate an /or

prescribe by the law may en anger your life/health an /or result in amage to your

material.

ESD Sensitive Device!

This symbol an title inform that the electronic boar s an their components are sensitive

to static electricity. Care must therefore be taken uring all han ling operations an

inspections of this pro uct in or er to ensure pro uct integrity at all times.

HOT Surface!

Do NOT touch! Allow to cool before servicing.

Laser!

This symbol inform of the risk of exposure to laser beam an light emitting evices (LEDs)

from an electrical evice. Eye protection per manufacturer notice shall review before

servicing.

This symbol in icates general information about the pro uct an the user gui e.

This symbol also in icates etail information about the specific pro uct configuration.

This symbol in icates important information which must be rea carefully.

This symbol prece es helpful hints an tips for aily use.

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

www.kontron.com // 6

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

www.kontron.com // 7

For Your Safety

Your new Kontron product was developed and tested carefully to prov de all features necessary to ensure ts

compl ance w th electr cal safety requ rements. It was also des gned for a long fault-free l fe. However, the l fe

expectancy of your product can be drast cally reduced by mproper treatment dur ng unpack ng and nstallat on.

Therefore, n the nterest of your own safety and of the correct operat on of your new Kontron product, you are

requested to conform w th the follow ng gu del nes.

High Voltage Safety Instructions

As a precaut on and n case of danger, the power connector must be eas ly access ble. The power connector s the

product’s ma n d sconnect dev ce.

Warning

All operations on this pro uct must be carrie out by sufficiently skille personnel only.

Electric Shock!

Before installing a non hot-swappable Kontron pro uct into a system always ensure that

your mains power is switche off. This also applies to the installation of piggybacks. Serious

electrical shock hazar s can exist uring all installation, repair, an maintenance operations

on this pro uct. Therefore, always unplug the power cable an any other cables which

provi e external voltages before performing any work on this pro uct.

Earth groun connection to vehicle’s chassis or a central groun ing point shall remain

connecte . The earth groun cable shall be the last cable to be isconnecte or the first

cable to be connecte when performing installation or removal proce ures on this pro uct.

Special Han ling an Unpacking Instruction

ESD Sensitive Device!

Electronic boar s an their components are sensitive to static electricity. Therefore, care

must be taken uring all han ling operations an inspections of this pro uct, in or er to

ensure pro uct integrity at all times.

Do not handle th s product out of ts protect ve enclosure wh le t s not used for operat onal purposes unless t s

otherw se protected.

Whenever poss ble, unpack or pack th s product only at EOS/ESD safe work stat ons. Where a safe work stat on s not

guaranteed, t s mportant for the user to be electr cally d scharged before touch ng the product w th h s/her hands

or tools. Th s s most eas ly done by touch ng a metal part of your system hous ng.

It s part cularly mportant to observe standard ant -stat c precaut ons when chang ng p ggybacks, ROM dev ces,

jumper sett ngs etc. If the product conta ns batter es for RTC or memory backup, ensure that the product s not placed

on conduct ve surfaces, nclud ng ant -stat c plast cs or sponges. They can cause short c rcu ts and damage the

batter es or conduct ve c rcu ts on the product.

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

www.kontron.com // 8

General Instructions on Usage

In order to ma nta n Kontron’s product warranty and CE compl ance, th s product must not be altered or mod f ed n

any way. Changes or mod f cat ons to the product, that are not expl c tly approved by Kontron and descr bed n th s

user gu de or rece ved from Kontron Support as a spec al handl ng nstruct on, w ll vo d your warranty and CE

compl ance.

Th s product should only be nstalled n or connected to systems that fulf ll all necessary techn cal and spec f c

env ronmental requ rements. Th s also appl es to the operat onal temperature range of the spec f c board vers on

that must not be exceeded. If batter es are present, the r temperature restr ct ons must be taken nto account.

In perform ng all necessary nstallat on and appl cat on operat ons, only follow the nstruct ons suppl ed by the

present user gu de.

Keep all the or g nal packag ng mater al for future storage or warranty sh pments. If t s necessary to store or sh p

the product then re-pack t n the same manner as t was del vered.

Spec al care s necessary when handl ng or unpack ng the product. See Spec al Handl ng and Unpack ng Instruct on.

Environmental Protection Statement

Th s product has been manufactured to sat sfy env ronmental protect on requ rements where poss ble. Many of the

components used (structural parts, pr nted c rcu t boards, connectors, batter es, etc.) are capable of be ng recycled.

F nal d spos t on of th s product after ts serv ce l fe must be accompl shed n accordance w th appl cable country,

state, or local laws or regulat ons.

Environmental protection is a high priority with Kontron.

Kontron follows the WEEE irective

You are encourage to return our pro ucts for proper isposal.

The Waste Electr cal and Electron c Equ pment (WEEE) D rect ve a ms to:

Reduce waste ar s ng from electr cal and electron c equ pment (EEE)

Make producers of EEE respons ble for the env ronmental mpact of the r products, espec ally when the product

become waste

Encourage separate collect on and subsequent treatment, reuse, recovery, recycl ng and sound env ronmental

d sposal of EEE

Improve the env ronmental performance of all those nvolved dur ng the l fecycle of EEE

Terms an Con itions

Kontron warrants products n accordance w th def ned reg onal warranty per ods. For more nformat on about

warranty compl ance and conform ty, and the warranty per od n your reg on, v s t http://www.kontron.com/terms-

and-cond t ons.

Kontron sells products worldw de and declares reg onal General Terms & Cond t ons of Sale, and Purchase Order

Terms & Cond t ons. V s t http://www.kontron.com/terms-and-cond t ons.

For contact nformat on, refer to the corporate off ces contact nformat on on the last page of th s user gu de or v s t

our webs te CONTACT US.

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

www.kontron.com // 9

Table of Contents

Symbols ................................................................................................................................................................................................................. 5

For Your Safety ................................................................................................................................................................................................... 7

H gh Voltage Safety Instruct ons .................................................................................................................................................................. 7

Spec al Handl ng and Unpack ng Instruct on ............................................................................................................................................ 7

General Instructions on Usage ..................................................................................................................................................................... 8

Environmental Protection Statement ....................................................................................................................................................... 8

Terms an Con itions ..................................................................................................................................................................................... 8

Table of Contents............................................................................................................................................................................................... 9

List of Figures .................................................................................................................................................................................................... 10

List of Tables ..................................................................................................................................................................................................... 10

Kontron TRACe-LP1 Overview ........................................................................................................................................................ 11

1.1. Your Pr vate LoRaWAN Network ready to use .................................................................................................................................. 11

1.2. LoRaWAN™ Network Operat on .......................................................................................................................................................... 12

1.3. Default Connect v ty ................................................................................................................................................................................. 13

1.4. W reless Connect v ty Opt ons ............................................................................................................................................................. 13

1.5. Tools .............................................................................................................................................................................................................. 13

1.6. Typ cal Appl cat on ................................................................................................................................................................................... 14

1.7. Techn cal Informat on .............................................................................................................................................................................. 14

Connect to the Gateway for the Configuration ....................................................................................................................... 16

2.1. Ethernet Cabl ng ........................................................................................................................................................................................ 16

2.2. Power Supply Cabl ng ............................................................................................................................................................................. 16

2.3. Log nto the Gateway .............................................................................................................................................................................. 16

2.4. Check Runn ng LoRa Serv ces............................................................................................................................................................... 17

2.5. Set the Current Date and T me ............................................................................................................................................................. 17

A a LoRa Device .............................................................................................................................................................................. 18

Configure the LoRa Agent .............................................................................................................................................................. 20

Packet Data Processing with Python (optional) .................................................................................................................... 24

MQTT Messages Configuration ................................................................................................................................................... 26

6.1. MQTT Messages publ shed ................................................................................................................................................................... 26

6.2. Subscr be to MQTT Top cs .................................................................................................................................................................... 27

6.3. In t at ng LoRaWAN Downl nk Traff c ............................................................................................................................................... 27

6.4. MQTT Cl ents ............................................................................................................................................................................................. 28

Firmware Architecture an Troubleshooting ......................................................................................................................... 30

7.1. Arch tecture ................................................................................................................................................................................................ 30

7.2. Bas c Software Control .......................................................................................................................................................................... 30

7.2.1. Status ........................................................................................................................................................................................................ 30

7.2.2. Start .......................................................................................................................................................................................................... 30

7.2.3. Stop ........................................................................................................................................................................................................... 30

7.2.4. Enable ....................................................................................................................................................................................................... 31

7.2.5. Logs ............................................................................................................................................................................................................ 31

Installation an Cabling .................................................................................................................................................................. 32

8.1. Safety Requ rements .............................................................................................................................................................................. 32

8.2. Phys cal Mount ng................................................................................................................................................................................... 32

8.3. DC IN Power Supply Connector ........................................................................................................................................................... 33

8.4. G gab t Ethernet Connectors ............................................................................................................................................................... 34

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

www.kontron.com // 10

8.5. Ground ng Po nt Cabl ng ........................................................................................................................................................................ 35

List of Figures

F gure 1: DC IN Connector ............................................................................................................................................................................. 33

F gure 2: LAN A, LAN B Connectors ........................................................................................................................................................... 34

F gure 3: Assembly of the Ground ng Po nt Connect on .................................................................................................................... 35

List of Tables

Table 1: VX305x DC IN P n Conf gurat on................................................................................................................................................. 33

Table 2: LAN A, LAN B Connectors P n Conf gurat on .......................................................................................................................... 34

Table 3: G gab t Ethernet Connector P n Ass gnment ......................................................................................................................... 34