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  13

​5​ Configure scheduler  14

​6​ Configure WWAN configuration  15


​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 MQTT TLS in the configuration.
    For CA signed or self signed certificate can be uploaded by click on the
    UPLOAD button.

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


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

The saving process:


​4.​ Configure MQTT subscribe settings

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

  1. Click on the Settings menu.
  2. Click on the MQTT Subscribe  on the left sidebar.
  3. Modify the configuration and click on the SAVE button 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/documentation


​5.​ Configure scheduler

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

  1. Click on the Settings menu.
  2. Click on the Scheduler  on the left sidebar.
  3. Modify the configuration and click on the SAVE button 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/documentation

The scheduler configuration automatically reloads on the gateway after successful save.


​6.​ Configure WWAN configuration

The 4G/LTE capable gateways can be configured by Link It!.

  1. Insert the SIM card into the slot of the gateway
  2. Click on the Settings menu in Link It!
  3. Click on the WWAN  menu on the left sidebar
  1. Modify the configuration
  1. Set the APN of your service provider
  2. Set PIN code or leave it blank if it is disabled in the SIm card
  3. To further configuration enable Advanced mode in the header
  1. Click on the SAVE button in the toolbar
  2. Reboot the gateway to apply WWAN configuration

©2018 IQHome Kft

www.iqhome.org

 /