Difficulty: expert

Content

1 What is Tabs Mini Hub?
2 Hardware & Network Requirements
3 How to Activate the Hub
4 Additional Information
5 Troubleshooting
6 Hub provisioning

Learning Objectives

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

Prepare your environment to start using Tabs Mini Hub
Configure a Tabs Mini Hub

What is Tabs Mini Hub?

Tabs Mini Hub is a LoRa gateway that can be used for any Spacewell LoRa device to connect to the Workplace Platform.

Tabs Mini hubs connect to an existing (guest) Wifi or seperate wifi network, analog to ethernet and VLANs.

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.

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

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

Destination	Port	Protocol	Direction	AL description
https://spacewell.eu1.cloud.thethings.industries/	1700	UDP	In- & outbound	Sensors Telemetry data push
https://spacewell.eu1.cloud.thethings.industries/	1881-1887	TCP	In- & outbound	Sensors Telemetry data push
https://spacewell.nam1.cloud.thethings.industries/	1700	UDP	In- & outbound	Sensors Telemetry data push
https://spacewell.nam1.cloud.thethings.industries/	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

When using 4G

If you work with a 4G router (hotspot), no ports need to be opened on the network, as they will be open on the router. This way, you can set up a system that is completely disconnected from the existing IT infrastructure.

How to Activate the Hub

Press the reset button (small button at the back of the gateway next to the USB-C port) for 5 seconds until the LED blinks rapidly GREEN<->RED for a couple of times.
Hold the SETUP (button at the top of the gateway, next to the LED) for 10 seconds until the LED blinks rapidly in RED.
The gateway now exposes a WiFi AP whose SSID is MINIHUB-xxxxxx where xxxxxx is the last 6 digits of the gateway ID.
The password for this network is printed on the back panel of the device under WiFi PW.
After connecting to this network go to 192.168.4.1 using a web browser to access the WiFi config page:
Select the WiFi network and enter the password if it’s a closed network.
Select the “Save and Reboot” option.
If your config is right, the gateway will blink GREEN for a few seconds while it connects to this network.
Then, it will blink GREEN<->RED for a few seconds while it connects to the CUPS endpoint and fetches the necessary information to connect to the LNS traffic endpoint.
If your configuration was successful, the LED will be solid GREEN which means that 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 https://spacewell.atlassian.net/wiki/spaces/KB/pages/492072 ).

Additional Information

Operating Modes

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

Button Actions

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

SETUP Button pressed for 10s:
1. Switch to CONF mode if in GW mode.
SETUP Button pressed for 5s:
1. Reboot if in CONF mode, do nothing in GW mode
RESET Button pressed for 5s:
1. Factory reset (wipe out WiFi and LNS credentials, though CUPS credentials are retained).

Troubleshooting

Are you sure the correct ports were opened on the network?
Check the LED lights
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)
Check if the hub is connected to the correct network (on the switch)
Check if there is network connectivity on the patch in the switch (aka: connect the cable of the patch to your pc)
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 https://spacewell.atlassian.net/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.

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

Search

Workplace Knowledge Base (support.spacewell.com)

Tabs Mini Hub (WiFi) installation

Analytics