DECODE DG100 User Manual

Multi-service iot gateway

Hide thumbs

Table Of Contents

Table of Contents

Quick Links

Download this manual

User's Manual

DG100

Multi-service IoT Gateway

Table of Contents

Need help?

Do you have a question about the DG100 and is the answer not in the manual?

Questions and answers

Summary of Contents for DECODE DG100

Page 1 User's Manual DG100 Multi-service IoT Gateway...
Page 2 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 product and makes no warranty, representation or guarantee regarding the suitability of the products for any particular purpose or the continuing production of any product.
Page 3: Table Of Contents
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 Linux time....................19 4.2.3 Save Linux time in RTC....................19 4.2.4 Check RTC time.........................19 4.2.5 Check installed TTY ports....................19 4.2.6 Stop DG100 program.......................19 4.2.7 Reboot..........................20...
Page 4 User's Manual DG100 IoT Gateway 4.2.8 Changing network settings.....................20 5 Web user interface....................22 5.1 Console............................24 5.2 Bundle management.......................25 5.2.1 View bundles info......................25 5.2.2 Starting, stopping, upgrading and uninstalling bundles..........26 5.2.3 Installing new bundles.....................26 5.3 System Information.........................27 5.4 Settings............................28 5.5 Sensors & Devices........................29 5.6 Playground..........................30...
Page 5: Preface
User's Manual DG100 IoT Gateway Preface Preface 1.1 Symbols WARNING – Safety notice, which must be followed, may have influence on the user’s safety or the function of the device. IMPORTANT – Notice, which must be followed to avoid possible problems, which can arise in specific cases.
Page 6: Document Versions
User's Manual DG100 IoT Gateway Preface 1.3 Document versions Document Date Note version 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: Overview
Overview Overview DECODE DG100 IoT Gateway is a compact and efficient Multi-service IoT Edge Gateway for home, office and industrial applications. Powered by NXP i.MX6 CPU at 400MHz, with 256MB of SDRAM memory and 4GB of eMMC, it offers great performance for great variety of next generation solutions.
Page 8: Ordering Information
Modbus, MQTT, BtLE, GNSS or SensorTag. Built-in web server provides UI for device management and parameterization. The DG100 enclosure is made of durable ABS plastic for desktop or wall mounting in home, office or industrial environment. The side and top panels features connectors for power supply, USB, Ethernet and serial communication, push buttons as well as LED indicators.
Page 9: Device Description
User's Manual DG100 IoT Gateway Overview CON-RJ45F-DB9M Adapter RJ45 Plug - DB9 Male Device Description Block diagram depicts internal structure of a device. Fig. 1: Block diagram www.decode.rs 9/31...
Page 10: External Connectors
User's Manual DG100 IoT Gateway Device Description 3.1 External connectors On the front side panel there are connectors for a power supply and communication interfaces. Fig. 2: External connectors on front side panel 3.1.1 Serial1 and Serial2 These two RJ45 connectors have same pinout and function. They serve as RS232 and RS485 interfaces for i.MX6ULL UARTs.
Page 11: Usb Debug Connector
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. 3.1.4 USB Host connector USB Host is type A connector serving as host type. It is used as standard Linux Host USB with 500mA power supply capacity.
Page 12: Power Connector
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 transceivers click boards with UART interface can be easily connected to DG100. For compatibility and support please contact Decode.
Page 13: Indications And Push Buttons
There are two push buttons on the back side panel. Short press on Reset button performs hard reset of device, equivalent to power cycling. User button is used for as Linux gpio84 input found in /sys/class/gpio/. For further information please contact Decode. Fig. 5: Push buttons on back side plate 3.3.2 LED indicators...
Page 14: Wall Or Plate Mounting
User's Manual DG100 IoT Gateway Device Description 3.4 Wall or plate mounting 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.
Page 15: Operation Description
User's Manual DG100 IoT Gateway Operation description Operation description DG100 gateway may be accessed over several interfaces, but in common use two of them are typical: "Command line" on USB Debug COM port or using SSH protocol over TCP network and web user interface using HTTP access over TCP network.
Page 16 Power on device by connecting power supply. Fig. 10: DG100 is booting 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.
Page 17: Access Over Ssh
User's Manual DG100 IoT Gateway Operation description 4.1.2 Access over SSH To access DG100 device using "Command line", in local network or remotely, SSH protocol is used. Fig. 11: SSH connection Enter the default IP address and default port 22 and click Open button. Login parameters are root for username and root for password.
Page 18: Basic Commands
4.2 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 Fig. 13: Network parameters www.decode.rs...
Page 19: Checking Network Parameters
MMIO 0x21f4000 (irq = 54, base_baud = 5000000) is a IMX 4.2.6 Stop DG100 program DG100 program is started as a process. To stop it, first of all process number must be found. # ps Response contains a list of all processes. Find lines with two DG100 processes and memorize its numbers.
Page 20: 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 Fig.
Page 21 User's Manual DG100 IoT Gateway Operation description To exit editor 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.
Page 22: Web User Interface
User's Manual DG100 IoT Gateway Web user interface Web user interface Web user interface is implemented using built-in web server. It is accessed 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.
Page 23 Fig. 17: Bundle Life Cycle Management For every bundle that is found on DG100 the initial state is installed. Once all bundles have been found, OSP tries to resolve each bundle. Resolving a bundle means checking whether all required bundles of a bundle are available.
Page 24: Console
User's Manual DG100 IoT Gateway Web user interface 5.1 Console By clicking on Console icon "Console" program is started. Fig. 18: Console App icon "Console" application provides a way for the applications to output 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.
Page 25: Bundle Management
User's Manual DG100 IoT Gateway Web user interface 5.2 Bundle management By clicking on Bundles icon, "Bundles" program is started. Several operation on bundles may be performed using this program: starting, stoping, installation, uninstalling, upgrading and viewing information. Fig. 20: Bundles App icon 5.2.1 View bundles info...
Page 26: Starting, Stopping, Upgrading And Uninstalling Bundles
User's Manual DG100 IoT Gateway Web user interface 5.2.2 Starting, stopping, upgrading and uninstalling bundles Click on specific bundle name opens more detailed bundle information with additional controls. Active bundles can be stopped, resolved bundles can be started, upgraded or uninstalled by clicking to coresponding icons.
Page 27: System Information
5.3 System Information By clicking on System Information icon "System Information" program is started. Fig. 23: System Information App icon This application provides many useful informations about DG100 device, operating system and memory resources. Fig. 24: System Information Navigation is possible using tabs System Information, Processes and Memory Usage.
Page 28: Settings
User's Manual DG100 IoT Gateway Web user interface 5.4 Settings By clicking on Settings icon, "Settings" program is started. Fig. 25: Settings App icon It provides a user interface for macchina.io properties configuration in a form of editable tree view structure.
Page 29: Sensors & Devices
User's Manual DG100 IoT Gateway Web user interface 5.5 Sensors & Devices By clicking on Sensors & Devices icon "Sensors & Devices" program is started. Fig. 27: Sensors & Devices App icon It provides a overview of all sensors and devices registered in OSP Service Registry with physical quantities automatically updated at one second interval.
Page 30: Playground
In general, all JavaScript code executed within DG100 must be contained in bundles. There are different ways to create a bundle and deploy it into a DG100 server. The easiest way is to use the Playground app in the web user interface by clicking on Playground icon.
Page 31: Writing Javascript Programs
Already started bundle can be Restarted or Stopped by clicking to respective icon. DG100 is based on OSP (Open Service Platform) and Service Registry enabling user to write JavaScript applications that use a services provided by other bundles. A JavaScript program can discover a certain service by using a simple query language to query the Service Registry for a service with certain properties.
Page 32: Saving Javascript Program
5.6.2 Saving JavaScript program To Save the content of JavaScript editor on the filesystem, click on Save. Saved content will not be lost after DG100 power down. 5.6.3 Exporting JavaScript program to bundle The Playground can also be used to pack JavaScript program to bundle and download a complete bundle containing the script.
Page 33: Technical Specifications
User's Manual DG100 IoT Gateway Technical specifications Technical specifications 6.1 Processor board Central processor 32-Bit MCU Single Core, ARM A7, i.MX6ULL, 400MHz (max. 900MHz) Memory 256MB DDR3 SDRAM (up to 512MB factory option) Storage eMMC 4GB Flash (up to 32GB factory option) 1 x USB2.0 Host type A, 1 x USB2.0 Device type microAB...
Page 34: Product Label
Decode office or return it to Decode. Contact Please contact a Decode office if you have any questions regarding the information contained in this manual or Decode products, or if you have any other inquiries.