Gateway

Quick Start Guide

Gateway

Quick Start Guide


Contents

​1​ Setup  3

​1.1​ Connecting Ethernet cable  3

​1.2​ Power on  3

​2​ Gateway configuration  3

​2.1​ Download Link It!  3

​2.2​ Connect to gateway with Link It!  4

​2.3​ IQRF IDE  6

​3​ Configure MQTT settings  9

​4​ Configure MQTT subscribe settings  12

​5​ Configure scheduler  13


​1​ Setup

​1.1​ Connecting Ethernet cable

For network communication, use a patch cable to connect the gateway to 10/100Mbps capable Ethernet switch or router. Connect the gateway to the same local network with your computer.

CAUTION!

This guide is assumes that you can connect the gateway to the same local network with your computer!

​1.2​ Power on

The gateway works with 9V-16V DC power supply. The device has no power switch. It can be turned on by connecting the power source to it. After the gateway successfully powered on and get a DHCP address the ACT status LED started blinking and the system gateway service is running.

​2​ Gateway configuration

The configuration of the gateway is possible via the Link It! management tool.

With Link It! Management tool the user is able to configure:

 

​2.1​ Download Link It!

To setup and manage the gateways remotely at first you have to download the IQ Home LinkIt! application from the IQ Home website according version to your operating system: https://www.iqhome.org/downloads#link-it!

Extract the downloaded package and run the application from the extracted folder:


​2.2​ Connect to gateway with Link It!

  1. Click on the LAN network

  1. On the LAN network screen the Link It! will list the available gateways on the local network. Click on the gateway that should be configured

  1. Enter username and password

  1. After connected to the gateway the general gateway status information displayed on the  Dashboard 

​2.3​ IQRF IDE

The configuration of the gateway’s  IQRF coordinator and the IQRF network with IQRF IDE is possible via the Link It! management tool. The IQRF IDE can connect to the gateways via Link It!. At first you should connect to the gateway with Link It! Described in section 2.2. After that you can connect to the IQRF coordinator with IQRF IDE as described in section 2.3.

System architecture of how can connect and configure IQ Home gateways

CAUTION!

The IQRF IDE can connect to the gateway only via the Link It! by default for security reasons!
For development and/or debugging you can enable in gateway configuration but it is not recommended in production use!

Follow the few steps below to connect to the IQ Home Gateway:

  1. Open the IQRF IDE, open a project and choose “IQRF Device Manager” from the “Tools” menu or press F9
  2. Select Add UDP device icon   in  “IQRF Device Manager” (or press Shift+Ctrl+D)
  3. Select Mode: IQRF gateway
  4. Click on the „Search” button
  5. Select your gateway from the list. If the list still empty check your network settings
  6. Click on the Add button

  1. After add gateway click on the Connect  button and close the “IQRF Device Manager” window

  1. The connection indicator displays the status in the left bottom corner

  1. In the bottom status bar of the Link It! now you can see the IQRF IDE status. If you connected to a selected gateway the IQRF IDE Forwarding status should be Active.

 

  1. Now you can use IQRF IDE to configure the IQRF coordinator and the IQRF network.

​3​ Configure MQTT settings

  1. At first connect to the gateway as describe in section ​2.2
  2. Click on the Settings menu

  1. Modify MQTT settings


  1. To setup MQTT TLS settings Enable TLS in the configuration
    For CA signed or self signed certificate can be uploaded by click on the
    ADD button

  1. Open or Drag and Drop certificate and/or key files in the Add New TLS Files popup window and click on the ADD button


  1. After modified the configuration scroll down to the end of the screen and click on the SAVE button


​4​ Configure MQTT subscribe settings

The MQTT subscribe configuration can be done in the Files menu.

  1. Click on the Files menu
  2. Click on the subscribe.conf  in  Gateway > static > subscribe.conf
  3. Modify the configuration and click on the save icon in the toolbar

The documentation of the subscribe configuration can be found in the Reference Manual on the IQ Home web site: https://www.iqhome.org/documentations


​5​ Configure scheduler

The MQTT scheduler configuration can be done in the Files menu.

  1. Click on the Files menu
  2. Click on the subscribe.conf  in  Gateway > dynamic > scheduler.conf
  3. Modify the configuration and click on the save icon in the toolbar

The documentation of the scheduler configuration can be found in the Reference Manual on the IQ Home web site: https://www.iqhome.org/documentations

©2018 IQHome Kft

www.iqhome.org

 /