Versions Compared

Version Old Version 3 New Version 4
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 Gateway

  • Configure a FEMTO Light Indoor Gateway

What is FEMTO Light Indoor Gateway?

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

CONNECTION IMAGE

picture of the gateway

FEMTO Light Indoor 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.

Hardware & Network Requirements

Mini hubs 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 etc.

Expand
titleNetwork Traffic - Whitelisting URLs & Ports

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

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

Configuration needs to be done on a computer.

Info

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

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

Step 1. Device connection

  1. Plug in the device to power

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

  3. Connect to the ifemto wifi. Use the password that is mentioned on the back of the device

  4. Connect in the browser to IP 192.168.4.1

Step 2. LoRa Settings

Info

Gateway ID 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 EU: spacewell.eu1.cloud.thethings.industries

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

  4. Radio Frequencies

    1. (different for EU, US etc)

  5. Click “Save”

  6. After receiving the “Success” message, go back to the main configuration page

Step 3. Select EITHER Ethernet OR wifi

Expand
titleFor Ethernet Selectionselection

  1. Select “WAN”

  2. In Ethernet Settings, select DHCP

  3. Click on the Save button

  4. 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)

  5. The LED on the device will show

    1. power = on/orange

    2. Ethernet LED blue

    3. LoRa LED blue

Expand
titleFor WiFi selection

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

  2. Select “Wi-Fi”

  3. All possible networks are visible on the config screen

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

  5. Click on the Save button

  6. 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)

  7. The LED on the device will show

    1. power = on/orange

    2. WiFi LED blue

    3. LoRa LED blue

If your configuration was successful:

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

  • If your configuration was successful (power = on/orange; WiFi or Ethernet LED blue; LoRa LED blue) 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 ).

picture of the gateway

Additional Information

LED Indicators

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

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

  • 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 (orange)

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 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

  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 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

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 of device sticker

Search

Live Search