DECODE DG100, User Manual

Page 1: ...DG100 Multi service IoT Gateway User s Manual ...

Page 2: ...datasheet or in any other disclosure relating to any product In the interest of continuous product development the Decode reserves the right to make improvements to this manual and the products described in it at any time and without prior notification or obligation The use of the product is at sole discretion of the user Decode cannot be held responsible for any damages arising due to use of this...

Page 3: ... 11 3 1 6 Power connector 12 3 2 Internal mikroBUSTM connector 12 3 2 1 RTC Battery 12 3 3 Indications and push buttons 13 3 3 1 Push buttons 13 3 3 2 LED indicators 13 3 4 Wall or plate mounting 14 4 Operation description 15 4 1 Command line interface 15 4 1 1 Access over USB Debug port 15 4 1 2 Access over SSH 17 4 2 Basic commands 18 4 2 1 Checking network parameters 19 4 2 2 Adjusting the Linu...

Page 4: ...ing new bundles 26 5 3 System Information 27 5 4 Settings 28 5 5 Sensors Devices 29 5 6 Playground 30 5 6 1 Writing JavaScript programs 31 5 6 2 Saving JavaScript program 32 5 6 3 Exporting JavaScript program to bundle 32 6 Technical specifications 33 6 1 Processor board 33 6 2 Serial ports 33 6 3 Wireless 33 6 4 Common characteristics 33 6 5 Software 33 7 Product label 34 8 Disposal and Recycling...

Page 5: ...mendations so as to avoid any damage to person or property All the associated interconnected equipment PC and power supply units PSU shell comply with requirements of standard IEC 60950 1 2005 A1 2009 A2 2013 Power supply must have SELV output and for security reasons connection must include series 1A fuse protection Installation and technical support of the device can be performed only by a quali...

Page 6: ...ual DG100 IoT Gateway Preface 1 3 Document versions Document version Date Note v1 0 16 10 2020 First release v1 1 26 10 2020 Typo correction and correction of serial port names in 3 1 1 section www decode rs 6 31 ...

Page 7: ... M2M and IoT to connect sensors actuators and other devices to cloud services Two protected and isolated serial ports both with RS 232 and RS 485 interfaces offers connection to serial enabled devices such as PLC s pump controllers HMI s or remote I O devices Embedded wireless connectivity with Wi Fi and Bluetooth three USB and one Ethernet port fulfill the needs for local and remote connectivity ...

Page 8: ...ensors and devices can be connected to Cloud services Typical applications are industrial applications PLCs HMIs SCADA remote process monitoring temperature flow pressure real time indoor location hospitals shopping centers smart meter reading heat meters electricity gas water vending machine monitoring smart city IoT applications light evironment traffic agriculture sensing wireless sensors pump ...

Page 9: ...User s Manual DG100 IoT Gateway Overview CON RJ45F DB9M Adapter RJ45 Plug DB9 Male 3 Device Description Block diagram depicts internal structure of a device www decode rs 9 31 Fig 1 Block diagram ...

Page 10: ...board and power supply Serial1 is connected to ttymxc3 and Serial2 is connected to ttymxc4 Both interfaces RS232 and RS485 are operational at the same time Data is sent on both interfaces but receiving is possible only from one interface at the time needing some protocol discipline The connector has light indications for transmit left position yellow color LED and receive data right position red c...

Page 11: ...and no handshaking Examples in this manual are referenced to Putty terminal It is an open source software and can be downloaded free of charge at https www putty org Driver can be found at http www ftdichip com Drivers VCP htm 3 1 3 USB Device connector USB Device is microAB connector type serving as device type It is used for Linux Bootloader recovery For further information please contact Decode...

Page 12: ... expansions One i MX6ULL UART ttymxc1 is routed to mikroBUS Specifications of mikroBUSTM standard can be downloaded from following link https download mikroe com documents standards mikrobus mikrobus standard specification v200 pdf This expansion have up to 5V 2A sourcing capability and can be used for GSM GPRS 3G LTE and BT BLE click boards from Mikroelektronika Also GPS GNSS and sub 1GHz transce...

Page 13: ... 2 LED indicators Three LEDs on the top panel indicate the presence of the power supply voltage and activity of the device LED L2 used as Linux LED2 found in sys class leds Following table describes device status depending on LED presentation Name Device state Presentation Description Pwr green Device is OFF Continuously OFF Device power is ON Continuously ON L1 green Device is OFF or is not initi...

Page 14: ...g Wall or plate mounting can be realized with two 3mm screws separated by 80mm Screew head must be approx 7mm in diameter and when fastened head must be 4mm away from the wall or plate www decode rs 14 31 Fig 6 Enclosure mounting dimensions Fig 7 Wall mounting screews position ...

Page 15: ...e terminal program such as PuTTY It is an open source software and can be downloaded free of charge at https www putty org It may be used for both COM port and SSH access 4 1 1 Access over USB Debug port Install VCP drivers on computer already explained in 3 1 2 USB Debug connector section and connect DG100 USB Debug port to computer USB port using appropriate USB cable To find COM or TTY port ins...

Page 16: ...ity bit 1 stop bit and no RTS CTS control Power on device by connecting power supply Device starts booting and after aproximately 30 seconds DG100 is operational User may see booting process in terminal window To use web user interface connect DG100 to LAN network with RJ45 patch cable and go directly to 5 Web interface section www decode rs 16 31 Fig 9 Settings serial parameters Fig 10 DG100 is b...

Page 17: ... access DG100 device using Command line in local network or remotely SSH protocol is used Enter the default IP address and default port 22 and click Open button Login parameters are root for username and root for password www decode rs 17 31 Fig 11 SSH connection Fig 12 SSH login ...

Page 18: ...Basic commands Press Enter on a computer keyboard and type root for username and root for password when asked Press press Enter to confirm each entry Welcome to DECODE Gateway DG100 decode login root Password root www decode rs 18 31 Fig 13 Network parameters ...

Page 19: ...nsole ttymxc0 enabled 1 383594 21e8000 serial ttymxc1 at MMIO 0x21e8000 irq 51 base_baud 5000000 is a IMX 1 396235 21ec000 serial ttymxc2 at MMIO 0x21ec000 irq 52 base_baud 5000000 is a IMX 1 408944 21f0000 serial ttymxc3 at MMIO 0x21f0000 irq 53 base_baud 5000000 is a IMX 1 421721 21f4000 serial ttymxc4 at MMIO 0x21f4000 irq 54 base_baud 5000000 is a IMX 4 2 6 Stop DG100 program DG100 program is ...

Page 20: ...e message 2020 09 03 12 22 21 153 Information Application 0 Shutdown complete 4 2 7 Reboot reboot Reboot can be done also by power cycling or pressing Reset button but this method is recommended and more secure 4 2 8 Changing network settings To change network settings first stop DG100 program and start nano editor to edit configuration file nano etc network interfaces www decode rs 20 31 Fig 14 E...

Page 21: ...or click Ctrl X buttons on keyboard and then restart LAN by issuing following commands ifdown eth0 ifup eth0 Rebooting device also makes changes active Be aware that when changing the network settings always remember last working parameter settings www decode rs 21 31 ...

Page 22: ...cessed via a web browser by entering the device IP address in browser address bar Default IP address is 192 168 0 1 and server default port is 80 On the starting page enter username and password and click on Login button Default username is admin and default password is admin www decode rs 22 31 Fig 15 Login screen Fig 16 Application icons ...

Page 23: ...means checking whether all required bundles of a bundle are available Every bundle that has been successfully resolved enters the resolved state A resolved bundle will eventually be started A bundle that is started is first put into starting state Then all required bundles are started as well Once all required bundles have entered active state the bundle s activator is invoked When the activator c...

Page 24: ...text based messages to the user Every line in console starts with timestamp and holds other useful informations such as message type and application name To clear Console window click on Clear icon and to move to last line of scrolled window click on Follow icon Several separate Console windows can be opened at the same time www decode rs 24 31 Fig 19 Console Fig 18 Console App icon ...

Page 25: ...program starting stoping installation uninstalling upgrading and viewing information 5 2 1 View bundles info When Bundles program is started list view is shown with short info of installed bundles ID name version symbolic name and state By clicking on column name sorting is performed on rows in ascending descending order www decode rs 25 31 Fig 20 Bundles App icon Fig 21 Bundles info ...

Page 26: ...led by clicking to coresponding icons Click on to return to list view 5 2 3 Installing new bundles Clicking on Install icon from bundles list view opens the Install bundle view New bundle can be uploaded and installed by draging and dropping bundle file in framed rectangle or by clicking framed rectangle to open file search dialog window Only bundle files with bndl extension can be uploaded and in...

Page 27: ...con System Information program is started This application provides many useful informations about DG100 device operating system and memory resources Navigation is possible using tabs System Information Processes and Memory Usage www decode rs 27 31 Fig 24 System Information Fig 23 System Information App icon ...

Page 28: ...for macchina io properties configuration in a form of editable tree view structure By clicking on icons user can save configuration add duplicate and rename items and expand and collapse the tree view Clicking on green icon at the begining of each row tree item can be expanded and collapsed www decode rs 28 31 Fig 25 Settings App icon Fig 26 Settings ...

Page 29: ... Sensors Devices icon Sensors Devices program is started It provides a overview of all sensors and devices registered in OSP Service Registry with physical quantities automatically updated at one second interval www decode rs 29 31 Fig 27 Sensors Devices App icon Fig 28 Sensors Devices ...

Page 30: ...Playground icon It provides a browser based editor that allows you to create and edit JavaScript scripts as well as to execute them in DG100 This is great for trying out things very quickly Although JavaScript is intuitive and beginner friendly some basic JavaScript language concepts and knowledge must be learned for effective programming of DG100 To better understand JavaScript programming on DG1...

Page 31: ...d to web Console window Following script is version which additionally outputs the Error message No Error to show possibility to output different types of messages in different colors using logger function Playground Hello World Script This script will print Hello World message in Console window in white color and No Error message in red color var message Hello World logger information message log...

Page 32: ...gram to bundle The Playground can also be used to pack JavaScript program to bundle and download a complete bundle containing the script This bundle can then be deployed to a device either by placing it on the filesystem in one of the directories configured as bundle repositories or by installing them using the web based Bundle utility Begin with a click on Export Bundle Modal window is opened Use...

Page 33: ...ery 6 2 Serial ports Serial ports 2 x RS 232C TD RD RTS CTS signals and RS 485 A B Galvanically isolated to 1kV with send and receive LED indicators 6 3 Wireless WiFi Single band 2 4 GHz IEEE 802 11b g n Bluetooth BT 4 1 Low Energy compatible 6 4 Common characteristics Power supply 8 30V DC Power consumption 1W Typical 15W Max Enclosure protection IP40 Temperature range from 0 C to 55 C and from 0...

Page 34: ...operly according to local laws and regulations Because this product contains electronic components it must be disposed of separately from household waste When this product reaches its end of life contact local authorities to learn about disposal and recycling options or simply drop it off at your local Decode office or return it to Decode 9 Contact Please contact a Decode office if you have any qu...