Versions Compared

Version Old Version 1 New Version Current
Changes made by

Julie Isebaert

Julie Isebaert

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Difficulty: expert

Content

Table of Contents
minLevel1
maxLevel1

Learning Objectives

After reading this article, you’ll be able to:

  • Prepare your environment to start using FEMTO Light Indoor MerryIoT Gateway

  • Configure a FEMTO Light Indoor MerryIoT Gateway

What is

FEMTO Light Indoor

MerryIoT Gateway?

FEMTO Light Indoor MerryIoT Gateway is a LoRa gateway that can be used for any Spacewell LoRa device to connect to the Workplace Platform.

CONNECTION IMAGE

image of the gateway

FEMTO Light Indoor
Image Added

MerryIoT Gateway connects to an existing (guest) Wifi, a seperate wifi network, or to ethernet.

Info

When using WiFi: Since the data between the sensors and the hub is communicated over LoRa network, we assume the impact of this device on the WiFi network will be max 250MB/hub/month.

Unboxing - content

Image Added

  • MerryIoT Gateway

  • ‪ethernet cable

  • power cord

  • ‪DC-Adapter

Image Added

Hardware & Network Requirements

Mini hubs MerryIoT Gateways run on 2.4GHz

See below table for information on which ports to open, if they should be open for in- and/or outbound traffic etcOpen ports 22, 123, 443, 1680 and 1700 in the firewall. These ports only need an outbound connection.

Expand
titleNetwork Traffic - Whitelisting URLs & PortsIP Addresses needed for Outgoing traffic

We sync all our hubs to the same open NTP (network time protocol) servers so we have consistent timings in our data warehouse.

How to use below table

  • as mentioned above, ideally just the ports mentioned should be opened (outbound)

Note

We recommend not to use specific IP addresses or DNS destinations in the firewall as they can and probably will change in the future!

  • protocol information and AL descriptions are extra

Depending on the environment main location, Spacewell Workplace tenants are created in an EU- or US-environment. Hence, for some ports to be opened, the destination address might be a different one:

  • eu: spacewell.eu1.cloud.thethings.industries

  • usa: spacewell.nam1.cloud.thethings.industries

Destination

Port

Protocol

Direction

AL description

https://spacewell.eu1.cloud.thethings.industries/

1700

UDP

In- & outbound

Sensors Telemetry data push

1881-1887

TCP

In- & outbound

Sensors Telemetry data push

https://spacewell.nam1.cloud.thethings.industries/

1700

UDP

In- & outbound

Sensors Telemetry data push

1881-1887

TCP

In- & outbound

Sensors Telemetry data push

mh.sm.tc

[3.121.98.110]

rjs.sm.tc

[3.121.98.110]

7000

TCP

Outbound

WSS

7001

TCP

Outbound

Load Balancer

7002-7512

TCP

Outbound

Load Balancer REST API

8881-8887

TCP

Outbound

Events data- MQTT

9191, 9193

TCP

Outbound

CUPS

How to Activate the Hub

HTTP/HTTPS, Webhook

80/443

TCP

Outbound

WEBGUI

 

22

TCP

Inbound/Outbound

SSH

NTP

123

TCP

Outbound

Time Synchronization

  • eu: spacewell.eu1.cloud.thethings.industries

  • usa: spacewell.nam1.cloud.thethings.industries

443

TCP

Outbound

TTI application

1700

UDP

Outbound

Uplink & Downlink Messages

1680

TCP

Outbound

Lora Packet Forwarder

How to Activate the Gateway

Configuration needs to be done on a computer.

Info

Make sure to run through the config settings fairly quickly, else connection will time-out.

Image Added

Step 1: . Device connection

  1. plug Plug in the device to power

  2. the The device will turn up in your wifi the WiFi list on your computer

  3. connect Connect to the ifemto MerryIoT wifi; use . Use the pw password that is mentioned on the back of the device

Image Added

connect

  1. Connect in the browser to IP 192.168.4.1

Screenshot of “web services: connected” in the top right corner

Image Added

Image Added

Step 2. “set LoRa” LoRa Setting:LoRa Settings

Info

Gateway ID

will be visible

is visible in this screen

  1. Select “Set LoRa”

  2. Select LoRa Packet Forwarder

  3. Fill the Gateway-Info as in the following picture:

    1. Server address

: TTN

  • Radio Frequencies (different for EU, US etc)

  • Save button

    • After Success message: Go

      1. EU: spacewell.eu1.cloud.thethings.industries

      2. Server address Americas: spacewell.nam1.cloud.thethings.industries

    2. Click “Save”

    3. After receiving the “Success” message, go back to the main

    config

    1. configuration page

    Step 3.

    Select EITHER Ethernet OR wifi Select

    Set up Connectivity

    Configure connectivity through Ethernet or WiFi, or configure both as a fail-over mechanism in case one of the connectivity types experiences issues:

    Expand
    titleEthernet connectivity
    Image Added

    1. Make sure an ethernet cable, connected to the right network, is plugged in to the gateway

    2. Select “WAN”

    3. In Ethernet Settings, select DHCP

    4. Click on the Save button

    the

    1. The device will reboot

    (

    1. and the page will look as if it’s stuck

    =

    1. (because of the reboot, the “web service” (in the top right corner)

    =

    1. will actually be in status disconnected)

    2. The LED on the device

    :

    1. will show

      1. power = on/

    orange;

      1. blue

      2. Ethernet LED blue

    ;

      2. LoRa LED blue

    Select “Wi-Fi” (make

    Expand
    titleWiFi connectivity
    Image Added

    1. Make sure to remove any LAN cable; only power supply should be plugged in

    )

    2. Select “Wi-Fi”

    3. All

    possible

    1. available networks are visible on the config screen

    2. Select the network you want to connect to and provide the password

    3. Click on the Save button

    the

    1. The device will reboot

    (

    1. and the page will look as if it’s stuck

    =

    1. (because of the reboot, the “web service” (in the top right corner)

    =

    1. will actually be in status disconnected)

    2. The LED on the device will show

      1. power = on/

    orange; wifi

      1. blue

      2. WiFi LED blue

    ;

      2. LoRa LED blue

    If your configuration was successful:

    the device will no longer show up in the WiFi scanning list of your computer

    Image Added

    Expand
    titleEthernet & Wifi - failover mechanism / switching feature

    This feature is available from firmware version 1.0.22. See https://spacewell.atlassian.net/wiki/spaces/KB/pages/270172272/MerryIoT+Gateway+installation#Upgrade-the-firmware-version to check the current firmware version and know when and how to upgrade.

    Image Added

    1. Make sure an ethernet cable, connected to the right network, is plugged in to the gateway

    2. Select the Dual WAN option

    3. Provide a Connection check address by entering any website URL or IP address for internal network failure status checks. Fill in Connection Check Address 1 as 8.8.8.8. (technically, this could be http://www.google.com, but if there is any mistake in the URL then the failover mechanism won’t work because of the typo)

    4. In DUAL WAN Configuration 1/3, choose the network priority, selecting either Ethernet or WIFI as the first priority. In this workflow, we suggest to select ethernet first

    5. In DUAL WAN Configuration 2/3, select the Ethernet setting as DHCP. Click next and wait for the “successful” message. Click “next”

    Image Added

    		Image Added

    1. In DUAL WAN Configuration 3/3, All available networks are visible on the config screen. Select the network you want to connect to and provide the password. Click on the Save button.

    2. The device will reboot and the page will look as if it’s stuck (because of the reboot, the “web service” (in the top right corner) will actually be in status disconnected)

    3. The LED on the device will show

      1. power = on/blue

      2. Ethernet LED blue (because ethernet connectivity has the priority according to the above workflow)

      3. LoRa LED blue

    Info

    In case of any issues with the ethernet connectivity, it takes 3-5 minutes for the device to switch to WiFi.

    Info

    The LED on the device will indicate which connectivity type is being used: either ethernet LED is blue or WiFi LED.

    If your configuration was successful (power = on/

    orange

    blue;

    wifi

    WiFi or Ethernet LED blue; LoRa LED blue):

    • the device will no longer show up in the WiFi scanning list of your computer,

    • the gateway is connected to the LoRaWAN network and is ready to handle packets.

    Your Spacewell Implementation Consultant can confirm if the gateway is connecting to the Workplace platform (see /wiki/spaces/KB/pages/492072 ).

    Image Removed
    Image Added

    Additional Information

    Operating Modes

    1. Configuration Mode (CONF)

      1. In this mode, the device acts as a WiFi AP to which users can connect and configure a WiFi
        network(s) to which the gateway will connect to during normal operation. The device cannot
        route LoRaWAN packets in this mode.

    2. Gateway Mode (GW)

      1. In this mode, the device acts as a gateway to route traffic between the LoRaWAN Device
        and the Network. The WiFi AP for configuration is not available in this mode.

    LED States

    Image Removed

    Button Actions

    There are three possible button actions on the the Tabs Mini Hub

    1. SETUP Button pressed for 10s:

      1. Switch to CONF mode if in GW mode.

    2. SETUP Button pressed for 5s:

      1. Reboot if in CONF mode, do nothing in GW mode

    3. RESET Button pressed for 5s:

      1. Factory reset (wipe out WiFi and LNS credentials, though CUPS credentials are retained).

    Troubleshooting

    LED Indicators

    • LED Sequence: Power (System), WAN, Wireless, LoRa

    • Connection through WiFi or WAN, the LED colors should always be: 3 blue lights

      • power on LED: blue

      • WiFi or LAN LED: blue

      • LoRa LED: blue

    • Solid LED indicates a static condition, the blinking LED indicates the system is in upgrading status, or activating the device to link to the corresponding ports

    Solid On

    Blinking

    Off

    Power System (blue)

    Power ON

    Booting

    (ignore bootloader)

    Power Off

    WAN (blue)

    Ethernet plug & got IP address

    Connecting

    Unplugged

    Wireless (blue)

    WiFi station mode & got IP address

    Connecting

    Wireless disabled

    LoRa (blue)

    LoRa is working

    Connecting

    LoRa is not working

    Button Actions

    There is only one button (Reset Button) on the back: upon Reset, all the configurations will be gone and you have to do all the configuration settings again.

    Assigned MAC addresses

    The MAC address that is visible for the device on the local network depends on the connection mode.

    The MAC address referenced on the back of the device, is the Wi-Fi MAC address.

    Interface

    MAC address

    Wi-Fi station

    base_mac

    Wi-Fi SoftAP

    base_mac, +1 to the last octet

    Ethernet

    base_mac, +3 to the last octet

    Upgrade the firmware version

    Info

    Only upgrade the firmware version after confirmation by the Spacewell Hardware team.

    1. To check the current firmware version, select Configure OTA mode

    2. To obtain the latest firmware:

      1. configure your device to make sure it’s connected to the internet

      2. enable the OTA Server Daily Check to ensure timely updates.

    Image Added
    Info

    The OTA daily check will execute every 24 hours starting from the gateway boot-up. This means you likely will need to wait until the next day to get the latest version update.

    Troubleshooting

    Steps to troubleshoot an offline device:

    1. Are you sure the correct ports were opened on the network?

    2. Check the LED lights

    3. Make sure there are not typos in the hub board ID (ask customer to take a picture of the sticker at the back of the device)

    4. Check if the hub gateway is connected to the correct network (on the switch)

    5. Check if there is network connectivity on the patch in the switch (aka: connect the cable of the patch to your pc)

    6. Replace a non-working hub with one that is confirmed working

      1. If the non-working one is connected to the patch of the working one and this works: there is an issue with the patch/switch

      2. If the working one is connected to the patch of the non-working one and this works: there is an issue with the hub

    If you don’t recognize the MAC address of the device on the network, refer to the different MAC addresses described above (see https://spacewell.atlassian.net/wiki/spaces/KB/pages/edit-v2/270172272#Assigned-MAC-addresses).

    Hub provisioning

    If your hub is not showing up on /wiki/spaces/KB/pages/492072, make sure to communicate both the device EUI and the "WiFi password" (authentication code; that is printed on the sticker on the back of the device) to the Spacewell support team.

    The Device EUI is the first number (58A0…) mentioned on the sticker.

    Info

    Ideally just send a picture of the information on the back to Spacewell Support.

    Image RemovedImage Added

    Search

    Live Search