Installatie van MerryIoT Gateway

Moeilijkheidsgraad: expert

Leerdoelen

Na het lezen van dit artikel kun je:

  • Je omgeving voorbereiden om MerryIoT Gateway te gaan gebruiken
  • Een MerryIoT Gateway configureren

Wat is MerryIoT Gateway?

MerryIoT Gateway is een LoRa-gateway die kan worden gebruikt voor elk LoRa-apparaat van Spacewell om verbinding te maken met het Workplace-platform.

 

image-20230717-145358.png

MerryIoT Gateway maakt verbinding met een bestaand (gast-)wifi-netwerk, een afzonderlijk wifi-netwerk of ethernet.

 

Info

Bij gebruik van wifi: omdat de gegevens tussen de sensoren en de hub via het LoRa-netwerk worden verzonden, gaan we ervan uit dat de impact van dit apparaat op het wifi-netwerk maximaal 250 MB/hub/maand bedraagt.

Uitpakken - inhoud

image-20230717-145923.png
  • MerryIoT Gateway
  • ‪ethernetkabel
  • netsnoer
  • ‪DC-adapter

 

image-20230717-150052.png

Hardware- en netwerkvereisten

MerryIoT Gateways werken op 2,4 GHz

Open poorten 22, 123, 443, 1680 en 1700 in de firewall. Voor deze poorten is alleen een uitgaande verbinding nodig.

IP-adressen die nodig zijn voor uitgaand verkeer

We synchroniseren al onze hubs met dezelfde openbare NTP-servers (Network Time Protocol), zodat we consistente tijdstippen in ons datawarehouse hebben.

 

De onderstaande tabel gebruiken

  • zoals hierboven vermeld, moeten idealiter alleen de genoemde poorten worden geopend (uitgaand)

Opmerking

We raden aan geen specifieke IP-adressen of DNS-bestemmingen in de firewall te gebruiken, omdat deze in de toekomst kunnen en waarschijnlijk zullen veranderen!

  • protocolinformatie en AL-beschrijvingen zijn extra

Afhankelijk van de hoofdlocatie van de omgeving worden Spacewell-Workplace-tenants aangemaakt in een EU- of US-omgeving. Daarom kan het bestemmingsadres voor sommige te openen poorten anders zijn:

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

 

Bestemming Poort Protocol Richting AL-beschrijving
HTTP/HTTPS, Webhook 80/443 TCP Uitgaand WEBGUI
22 TCP Inkomend/uitgaand SSH
NTP 123 TCP Uitgaand Tijdsynchronisatie
  • eu: spacewell.eu1.cloud.thethings.industries
  • usa: spacewell.nam1.cloud.thethings.industries
443 TCP Uitgaand TTI-applicatie
1700 UDP Uitgaand Uplink- en downlinkberichten
1680 TCP Uitgaand Lora-packet-forwarder

De gateway activeren

De configuratie moet op een computer worden uitgevoerd.

Info

Doorloop de configuratie-instellingen redelijk snel, anders treedt er een time-out van de verbinding op.

image-20230717-144148.png

Stap 1. Apparaatverbinding

  1. Sluit het apparaat aan op de voeding
  2. Het apparaat verschijnt in de wifi-lijst op je computer
  3. Maak verbinding met de wifi van MerryIoT. Gebruik het wachtwoord dat op de achterkant van het apparaat staat

image-20230717-144238.png

 

  1. Maak in de browser verbinding met IP-adres 192.168.4.1

image-20230717-144315.png

 

 

 

 

image-20230717-144338.png

 

Stap 2. LoRa-instellingen

Info

De gateway-ID is zichtbaar op dit scherm

  1. Selecteer “Set LoRa”
  2. Selecteer LoRa Packet Forwarder
  3. Vul de gatewaygegevens in zoals op de volgende afbeelding:
    1. Serveradres EU: spacewell.eu1.cloud.thethings.industries
    2. Serveradres Amerika's: spacewell.nam1.cloud.thethings.industries
  4. Klik op “Save”
  5. Ga na ontvangst van het bericht “Success” terug naar de configuratiehoofdpagina

Stap 3. Connectiviteit instellen

Configureer de connectiviteit via ethernet of wifi, of configureer beide als fail-overmechanisme voor het geval een van de verbindingstypen problemen ondervindt:

Ethernetconnectiviteit

image-20230717-144510.png

  1. Zorg ervoor dat een ethernetkabel die met het juiste netwerk is verbonden, op de gateway is aangesloten
  2. Selecteer “WAN”
  3. Selecteer DHCP in Ethernet Settings
  4. Klik op de knop Save
  5. Het apparaat wordt opnieuw opgestart en de pagina lijkt vast te lopen (door de herstart heeft de “web service” (in de rechterbovenhoek) de status disconnected)
  6. De led op het apparaat geeft het volgende aan
    1. voeding = aan/blauw
    2. ethernet-led blauw
    3. LoRa-led blauw

 

Wifi-connectiviteit

image-20230717-144720.png

  1. Verwijder alle LAN-kabels; alleen de voeding mag aangesloten zijn
  2. Selecteer “Wi-Fi”
  3. Alle beschikbare netwerken zijn zichtbaar op het configuratiescherm
  4. Selecteer het netwerk waarmee je verbinding wilt maken en voer het wachtwoord in
  5. Klik op de knop Save
  6. Het apparaat wordt opnieuw opgestart en de pagina lijkt vast te lopen (door de herstart heeft de “web service” (in de rechterbovenhoek) de status disconnected)
  7. De led op het apparaat geeft het volgende aan
    1. voeding = aan/blauw
    2. wifi-led blauw
    3. LoRa-led blauw

image-20230717-144800.png

 

Ethernet en wifi - fail-overmechanisme / schakelfunctie

Deze functie is beschikbaar vanaf firmwareversie 1.0.22. Zie Installatie van MerryIoT Gateway om de huidige firmwareversie te controleren en te weten wanneer en hoe je moet upgraden.

image-20231218-170607.png

  1. Zorg ervoor dat een ethernetkabel die met het juiste netwerk is verbonden, op de gateway is aangesloten
  2. Selecteer de optie Dual WAN
  3. Geef een verbindingscontroleadres op door een URL van een website of een IP-adres in te voeren voor interne controles van de netwerkstoringsstatus. Vul bij Connection Check Address 1 8.8.8.8 in. (Technisch gezien kan dit http://www.google.com zijn, maar als er een fout in de URL staat, werkt het fail-overmechanisme niet vanwege de typefout)
  4. Kies bij DUAL WAN Configuration 1/3 de netwerkprioriteit door Ethernet of WIFI als eerste prioriteit te selecteren. In deze workflow raden we aan ethernet als eerste te selecteren
  5. Selecteer bij DUAL WAN Configuration 2/3 de ethernetinstelling als DHCP. Klik op next en wacht op het bericht “successful”. Klik op “next”

image-20231218-171203.png

 

image-20231218-171304.png

 

  1. Bij DUAL WAN Configuration 3/3 zijn alle beschikbare netwerken zichtbaar op het configuratiescherm. Selecteer het netwerk waarmee je verbinding wilt maken en voer het wachtwoord in. Klik op de knop Save.
  2. Het apparaat wordt opnieuw opgestart en de pagina lijkt vast te lopen (door de herstart heeft de “web service” (in de rechterbovenhoek) de status disconnected)
  3. De led op het apparaat geeft het volgende aan
    1. voeding = aan/blauw
    2. ethernet-led blauw (omdat ethernetconnectiviteit volgens de bovenstaande workflow prioriteit heeft)
    3. LoRa-led blauw

 

Info

Bij problemen met de ethernetconnectiviteit duurt het 3-5 minuten voordat het apparaat overschakelt naar wifi.

De led op het apparaat geeft aan welk connectiviteitstype wordt gebruikt: de ethernet-led is blauw of de wifi-led is blauw.

 

Als je configuratie succesvol was (voeding = aan/blauw; wifi- of ethernet-led blauw; LoRa-led blauw):

  • verschijnt het apparaat niet meer in de wifi-scanlijst van je computer,
  • is de gateway verbonden met het LoRaWAN-netwerk en klaar om pakketten te verwerken.

Je Spacewell Implementation Consultant kan bevestigen of de gateway verbinding maakt met het Workplace-platform (zie The Things Network (LoRa platform) (SW internal) ).

image-20230717-145358.png

Aanvullende informatie

Led-indicatoren

  • Ledvolgorde: voeding (systeem), WAN, draadloos, LoRa
  • Bij verbinding via wifi of WAN moeten de ledkleuren altijd als volgt zijn: 3 blauwe lampjes
    • led voeding aan: blauw
    • wifi- of LAN-led: blauw
    • LoRa-led: blauw
  • Een continu brandende led geeft een statische toestand aan; een knipperende led geeft aan dat het systeem wordt geüpgraded of dat het apparaat wordt geactiveerd om verbinding te maken met de betreffende poorten
  Continu aan Knipperend Uit
Voedingssysteem (blauw) Voeding AAN

Opstarten

(bootloader negeren)

Voeding uit
WAN (blauw) Ethernet aangesloten en IP-adres ontvangen Verbinding maken Niet aangesloten
Draadloos (blauw) Wifi-stationmodus en IP-adres ontvangen Verbinding maken Draadloos uitgeschakeld
LoRa (blauw) LoRa werkt Verbinding maken LoRa werkt niet

Knopacties

Er is maar één knop (resetknop) aan de achterkant: bij een reset gaan alle configuraties verloren en moet je alle configuratie-instellingen opnieuw uitvoeren.

Toegewezen MAC-adressen

Het MAC-adres dat voor het apparaat zichtbaar is op het lokale netwerk, hangt af van de verbindingsmodus.

Het MAC-adres dat op de achterkant van het apparaat staat, is het wifi-MAC-adres.

Interface MAC-adres
Wifi-station base_mac
Wifi-SoftAP base_mac, +1 bij het laatste octet
Ethernet base_mac, +3 bij het laatste octet

De firmwareversie upgraden

Info

Upgrade de firmwareversie alleen na bevestiging door het Spacewell Hardware-team.

  1. Selecteer Configure OTA mode om de huidige firmwareversie te controleren
  2. De nieuwste firmware verkrijgen:
    1. configureer je apparaat zodat het verbinding heeft met internet
    2. schakel OTA Server Daily Check in om tijdige updates te garanderen.
image-20231218-165503.png

Info

De dagelijkse OTA-controle wordt elke 24 uur uitgevoerd vanaf het opstarten van de gateway. Dit betekent dat je waarschijnlijk tot de volgende dag moet wachten om de nieuwste versie-update te ontvangen.

Probleemoplossing

Stappen voor het oplossen van problemen met een offline apparaat:

  1. Weet je zeker dat de juiste poorten op het netwerk zijn geopend?
  2. Controleer de ledlampjes
  3. Controleer of de gateway met het juiste netwerk is verbonden (op de switch)
  4. Controleer of er netwerkconnectiviteit is op de patch in de switch (oftewel: sluit de kabel van de patch aan op je pc)
  5. Vervang een niet-werkende hub door een hub waarvan is bevestigd dat deze werkt
    1. Als de niet-werkende hub wordt aangesloten op de patch van de werkende hub en dit werkt: er is een probleem met de patch/switch
    2. Als de werkende hub wordt aangesloten op de patch van de niet-werkende hub en dit werkt: er is een probleem met de hub

Als je het MAC-adres van het apparaat op het netwerk niet herkent, raadpleeg dan de verschillende hierboven beschreven MAC-adressen (zie Installatie van MerryIoT Gateway).

Hub-provisioning

Als je hub niet wordt weergegeven op The Things Network (LoRa platform) (SW internal), zorg er dan voor dat je de apparaat-EUI doorgeeft aan het ondersteuningsteam van Spacewell.

image-20231123-095306.png