Handleiding voor probleemoplossing van sensoren

Avatar
Laura CARBO

Moeilijkheidsgraad: expert

Inhoud

Leerdoelen

Na het lezen van dit artikel kun je:

  • De basisworkflow van sensoren begrijpen
  • De verschillende fasen identificeren waarin gegevens kunnen “blijven hangen”
  • De juiste vragen stellen om te bepalen waar je sensorgegevens ontbreken
  • Weten waar je terechtkunt om het probleem op te lossen

De gegevensstroom begrijpen

In het algemeen kan Workplace Connectivity als volgt worden beschreven: sensoren sturen gegevens naar een platform/gegevenscloud (LoRa-sensoren sturen hun gegevens bijvoorbeeld via een LoRa-gateway naar de LoRa Sensor Cloud, terwijl propriëtaire sensoren hun gegevens naar het relevante platform sturen), en Workplace haalt de gegevens uit dat platform op.

image-20230325-173217.png

 

Opgesplitst in kleinere stappen (meer informatie over hoe deze workflow is ingesteld: Sensor raw data translated into timeslot data ):

  1. sensorgegevens moeten naar de gateway worden gecommuniceerd,
  2. voordat ze de gegevenscloud binnengaan,
  3. waar ze door het Workplace-platform worden opgehaald,
  4. waar de gegevens door interne Spacewell-tools worden verwerkt voordat ze in tijdvakken van 15 minuten in het datawarehouse worden opgeslagen,
  5. zodat ze kunnen worden gevisualiseerd op een Workplace-touchpoint (GO, Workplace-app, Kiosk-app, ...).
  6. Daarnaast worden de gegevens (’s nachts) door nog meer tools verwerkt voordat ze beschikbaar zijn in de Workplace-dashboards of in de Replay.

Dit betekent dat er veel fasen zijn waarin gegevens kunnen “blijven hangen” of niet kunnen worden gecommuniceerd en opgeslagen in het Workplace-platform.

 

Met de onderstaande vragen kun je bepalen in welke fase je gegevens ontbreken en wat je daaraan kunt doen.

Vragen die je moet stellen wanneer gegevens ontbreken

Vraag 1: Merk je tijdens een installatie dat er geen gegevens binnenkomen in het Workplace-platform?

Heb je de instructies voor installatie en kwaliteitscontrole gevolgd (Gateways en sensoren installeren en configureren)?

  • Is de hub geïnstalleerd en is bevestigd dat deze werkt voordat de sensor werd geactiveerd?
  • Is de sensor geactiveerd op een locatie waar de gateway kan worden bereikt?
  • Controleer of de locatietoewijzing correct is uitgevoerd
  • Controleer of er geen typefouten in de sensor-ID’s staan
  • …

 

Vraag 2: Zijn alle sensoren getroffen?

(Bekijk het hoofdstuk “Voorbeeldcases” hieronder voor enkele voorbeelden/concrete cases.)

  • Ja

    • Hub offline (als er slechts één locatie is) (controleer poorten, netwerk en switch, fysieke hub)

    • Algemeen probleem (controleer andere tenants)
  • Gedeeltelijk

    • Hub offline (controleer poorten, fysieke hub)

    • Om te bepalen of het probleem mogelijk bij de sensorleverancier ligt (komen de gegevens binnen op het sensorplatform, bijvoorbeeld het LoRa-sensorplatform, PointGrab Platform of Airthings), zie vraag 3
  • Nee

    • Specifiek voor de sensor, zie vraag 3

 

Vraag 3: Controleer in welke fase de gegevens ontbreken (volg de onderstaande workflow)
(Bekijk het hoofdstuk “Voorbeeldcases” hieronder voor enkele voorbeelden/concrete cases.)

Te volgen workflow om te bepalen waar gegevens ontbreken

1. Controleer de gegevens op het GO live-verdiepingsplan

  • Ga naar https://go.cobundu.com
  • Log in met de tenant-specifieke inloggegevens
  • Selecteer de relevante verdieping
  • (optioneel: selecteer het relevante sensortype in “Weergeven op”)
  • Controleer de status van het verdiepingsplan
  • Controleer of de kleur van de locatie overeenkomt met de kleur van de gegevenswaarden van dit sensortype (open de legenda; controleer de kleuren in Instellingen voor live-verdiepingsplan)
  • Controleer de dashboards

    • Bekijk de lijst met probleemoplossingen per dashboard onder Dashboards

Floorplan go.png

2. Controleer Hoe je Sensor Health monitort in Studio

  • Ga naar https://studio.cobundu.com/
  • Log in met je inloggegevens
  • Selecteer Apparaten
  • Zoek de getroffen sensor

    • Is de sensor-ID correct (in hexadecimaal?) en volledig? Staat er een streepje tussen elke 2 tekens?

  • Controleer de sensor-ID
  • Controleer de laatste keer gezien
  • Open de pagina met apparaatgegevens

    • Controleer het kanaal

    • Controleer het type op basis van de sensormodellen
  • Controleer de locatie

    • Controleer de toewijzing van de locatie aan Location Grouping (zones of afdelingen)

find sensor.png

 

 

 

image2021-6-23 15:55:12.png

 

image-20221001-055726.png

 

Wat moet je doen als een sensor in Studio Health geel is?

Uitgaande van een apparaat dat op batterijen werkt:

  1. Controleer de verbinding van de gateway met de sensorcloud; zie stap 3. Controleer de gegevens in de sensorcloud (zie de onderstaande voorbeeldcases)
  2. als alle gateways verbinding maken met de sensorcloud: controleer de verbinding op locatie tussen de sensor en de gateway (zijn er veel obstakels/metaal tussen de sensor en gateway?)
  3. als de sensor naast een gateway staat of omringd is door andere sensoren die wel goed contact kunnen maken (groene status): controleer of de batterij correct is geplaatst (geen vals contact)
  4. als de batterij correct is geplaatst: vervang de batterij (rekening houdend met de regels voor het vervangen van batterijen)
  5. voor Browan-sensoren kun je in deze fase het batterijniveau controleren (zie Batterijduur van Browan-sensoren controleren (payload controleren) (intern voor SW))
  6. als het probleem na het vervangen van de batterij niet is opgelost: vervang de sensor

 

Zie voor elk ander apparaat stap 3. Controleer de gegevens in de sensorcloud

 

Wat moet je doen als een sensor in Studio Health rood is?

Uitgaande van een apparaat dat op batterijen werkt:

  1. Controleer de verbinding van de gateway met de sensorcloud; zie stap 3. Controleer de gegevens in de sensorcloud (zie de onderstaande voorbeeldcases)
  2. als alle gateways verbinding maken met de sensorcloud: controleer de verbinding op locatie tussen de sensor en de gateway (zijn er veel obstakels/metaal tussen de sensor en gateway?)
  3. als de sensor naast een gateway staat of omringd is door andere sensoren die wel goed contact kunnen maken (groene status): controleer of de batterij correct is geplaatst (geen vals contact)
  4. als de batterij correct is geplaatst: vervang de batterij (rekening houdend met de regels voor het vervangen van batterijen)
  5. als het probleem na het vervangen van de batterij niet is opgelost: vervang de sensor

 

Zie voor elk ander apparaat stap 3. Controleer de gegevens in de sensorcloud

image-20221001-055741.png

 

3. Controleer de gegevens in de sensorcloud

Alleen Spacewell Support en Spacewell-implementatieconsultants hebben toegang tot de volgende platforms.

Afhankelijk van het type apparaat dat je onderzoekt, moet je een ander platform bezoeken:

Mogelijke problemen met PointGrab

Controleer Probleemoplossing voor PointGrab

  • als de sensor niet live is op het PointGrab-platform:
  • als de sensor live is op het PointGrab-platform, maar je deze niet op het Workplace-platform kunt configureren: controleer of het apparaat live is en of het item aan de API-gebruiker is toegevoegd (dit kan enige tijd duren)
  • als de sensor live is op het PointGrab-platform, maar niet op Workplace: neem contact op met Spacewell Support
  • als je al het bovenstaande hebt gecontroleerd: neem contact op met Spacewell Support
Mogelijke problemen met Airthings

 

Mogelijke problemen met LoRa-apparaten

Controleer Handleiding voor probleemoplossing van Browan-sensoren

  • als de sensor geen verbinding maakt met het LoRa-platform:

    • controleer of de relevante gateway verbinding maakt met het LoRa-platform (zo niet: zie Handleiding voor probleemoplossing van Browan-sensoren)

    • controleer of er geen typefout staat in de sensor-ID die je opzoekt
    • controleer of de sensor is geactiveerd (plastic strip verwijderd)
    • controleer of er batterijen in de sensor zitten of dat het apparaat is aangesloten
  • als de gateway geen verbinding maakt met het LoRa-platform

    • zorg ervoor dat alle benodigde poorten openstaan op het netwerk (niet relevant voor 4G-apparaten)

    • controleer of het apparaat stroom ontvangt en verbinding heeft met internet (sluit bijvoorbeeld je laptop aan op de PoE-kabel)

Voor Browan-sensoren: een sensor die verbindingsberichten verzendt, probeert verbinding te maken met ons LoRa-netwerk. Door de manier waarop LoRa werkt, kan het behoorlijk wat pogingen kosten voordat alles is gesynchroniseerd.
Als de sensor na 1 dag nog steeds verbindingsberichten verzendt, kun je de sensor het beste resetten door de batterij een paar uur te verwijderen en deze vervolgens opnieuw te plaatsen.

Als je de batterijstatus van Browan-sensoren wilt weten, kun je deze pagina bekijken: Batterijduur van Browan-sensoren controleren (payload controleren) (intern voor SW)

Mogelijke problemen met VergeSense

Bekijk de handleiding voor probleemoplossing van VergeSense

  • als de sensor niet live is op het VergeSense-platform:
  • als de sensor live is op het VergeSense-platform, maar je deze niet op het Workplace-platform kunt configureren: zorg ervoor dat het apparaat live is en dat Spacewell het item aan de API-gebruiker heeft toegevoegd
  • als de sensor live is op het VergeSense-platform, maar niet op Workplace: controleer of de VergeSense Space-referentie-ID wordt vermeld in de Workplace-apparaat-ID (zoals hier beschreven)
  • als je al het bovenstaande hebt gecontroleerd: neem contact op met Spacewell Support

 

 

4. Controleer de fysieke installatie op locatie

Probleemoplossing op locatie

Wat je moet meenemen naar de locatie (afhankelijk van het apparaat)

  • plastic kaart/bankpas/schroevendraaier om de sensor te openen (bekijk Installatiehandleidingen voor Browan-sensoren voor informatie over het verwijderen/vervangen van een batterij)
  • reservebatterijen (1/2 AA 3,6V-lithiumbatterij voor Browan-sensoren)
  • reservekapjes (indien nodig voor Browan-sensoren)
  • tape en schaar (zie Installatiehandleidingen voor Browan-sensoren voor best practices voor tape)
  • computer met internettoegang: Studio-backend (informatie over status) + documentatie (bijvoorbeeld gateway-leds, installatie-instructies)
  • paperclip (optioneel)
  • microvezeldoek om het oppervlak schoon te maken

Als niets anders werkt…

Als je alle bovenstaande instellingen en configuraties hebt gecontroleerd, maar er nog steeds geen gegevens naar de Workplace-omgeving stromen: neem dan contact op met het Spacewell Support-team.

Voorbeeldcases

Hieronder vind je enkele cases die we bij onze klanten zijn tegengekomen. De vragen die de consultant moet stellen, zijn een combinatie van de bovenstaande Connectivity Guide en de Handleiding voor probleemoplossing van Browan-sensoren

 

Voorbeeldcase A: Sensor Health geel bij afwisselende sensoren → Hub offline door wijzigingen aan de switch

image2022-2-23 17:5:55.png

Op het Sensor Health-verdiepingsplan merkten we op verschillende dagen dat verschillende sensoren geel werden.

Analyse
  • Vraag 1: Merk je tijdens een installatie dat er geen gegevens binnenkomen in het Workplace-platform? N.v.t./opgemerkt na installatie
  • Vraag 2: Zijn alle sensoren getroffen? Slechts gedeeltelijk
  • Vraag 3: In welke fase ontbreken de gegevens? Sensoren maken minder vaak verbinding met het sensorplatform/Workplace-platform dan gewenst
Oplossing

Nadat we hadden gecontroleerd of de hubs nog online waren op het LoRa-sensorplatform, bleken sommige offline te zijn.

We moesten dus controleren of er wijzigingen waren aangebracht aan de fysieke apparaten of het netwerk:

  • Stonden alle hubs nog op hun plaats en waren ze aangesloten?
  • Waren er wijzigingen aan de switch? (We wisten dat de poorten nog openstonden op het netwerk, omdat andere hubs op dezelfde locatie wel verbinding konden maken met de sensorcloud/nog online waren.)

Na een fysieke controle werd bevestigd dat een van de hubs offline was door wijzigingen aan de switch. Dit betekende dat de sensoren moeite hadden om de andere hub te bereiken en daarom niet offline (rood) waren, maar af en toe verbinding konden maken met de overgebleven hub (vandaar de gele status Controleren).

De switch werd aangepast, de hub werkte weer en de sensoren konden opnieuw verbinding maken met de dichtstbijzijnde hub.

 

Voorbeeldcase B: Sensor Health geel bij afwisselende sensoren → Hubs moesten opnieuw worden opgestart

image2022-2-28 15:25:32.png

Op het Sensor Health-verdiepingsplan merkten we op verschillende dagen dat verschillende sensoren geel werden.

Analyse
  • Vraag 1: Merk je tijdens een installatie dat er geen gegevens binnenkomen in het Workplace-platform? N.v.t./opgemerkt na installatie
  • Vraag 2: Zijn alle sensoren getroffen? Slechts gedeeltelijk
  • Vraag 3: In welke fase ontbreken de gegevens? Sensoren maken minder vaak verbinding met het sensorplatform/Workplace-platform dan gewenst
Oplossing

Nadat we hadden gecontroleerd of de hubs nog online waren op het sensorplatform TTN, bleken sommige offline te zijn.

We moesten dus controleren of er wijzigingen waren aangebracht aan de fysieke apparaten of het netwerk:

  • Stonden alle hubs nog op hun plaats en waren ze aangesloten?
  • Waren er wijzigingen aan de switch? (We wisten dat de poorten nog openstonden op het netwerk, omdat andere hubs op dezelfde locatie wel verbinding konden maken met de sensorcloud/nog online waren.)

Na een fysieke controle werd vastgesteld dat de lampjes op de offline hubs anders waren dan de lampjes op de online hubs... Het opnieuw opstarten van deze hubs bood de oplossing: de hubs kwamen weer online en de sensoren konden opnieuw verbinding maken met de dichtstbijzijnde hub.

 

Voorbeeldcase C: Sensor Health rood bij alle sensoren → Wijziging van internetprovider

In deze case merkten we dat alle sensoren rood waren op het Sensor Health-plan van het Workplace-platform.

Analyse
  • Vraag 1: Merk je tijdens een installatie dat er geen gegevens binnenkomen in het Workplace-platform? N.v.t.
  • Vraag 2: Zijn alle sensoren getroffen? Alle
  • Vraag 3: In welke fase ontbreken de gegevens? Sensoren maken geen verbinding met het sensorplatform
Oplossing

Nadat we hadden gecontroleerd of er gegevens binnenkwamen op het LoRa-sensorplatform (er kwamen geen gegevens binnen) en of de hubs nog online waren, merkten we dat alle hubs offline waren.

We moesten dus controleren of er wijzigingen waren aangebracht aan de fysieke apparaten of het netwerk:

  • Stonden alle hubs nog op hun plaats en waren ze aangesloten?
  • Waren er wijzigingen aan de switch?
  • Was er een wijziging aan het netwerk? Stonden alle benodigde poorten nog open?

Na een fysieke controle leken de hubs en de switch in orde. Ze gaven aan dat ze geen verbinding konden maken met het sensorplatform.

In gesprekken met IT realiseerden we ons dat er rond het moment waarop er geen gegevens meer binnenkwamen in het Workplace-platform, een wijziging van internetprovider had plaatsgevonden en dat de benodigde te openen poorten niet waren gecommuniceerd.

Nadat de poorten waren doorgegeven en de nieuwe internetprovider actie had ondernomen, kwamen de hubs en sensoren weer online.

 

Voorbeeldcase D: Sensor Health rood bij veel sensoren → Batterij vervangen

We merkten dat veel sensoren rood werden op het Sensor Health-plan van het Workplace-platform.

Analyse
  • Vraag 1: Merk je tijdens een installatie dat er geen gegevens binnenkomen in het Workplace-platform? N.v.t./opgemerkt na installatie
  • Vraag 2: Zijn alle sensoren getroffen? Veel
  • Vraag 3: In welke fase ontbreken de gegevens? Sensoren maken geen verbinding met het sensorplatform
Oplossing

Nadat we hadden gecontroleerd of er gegevens binnenkwamen op het sensorplatform TTN (er kwamen geen gegevens binnen) en of de hubs nog online waren (wat het geval was), wisten we dat we de sensoren nader moesten onderzoeken.

We voerden een Batterijduur van Browan-sensoren controleren (payload controleren) (intern voor SW) uit en merkten dat de batterijen van alle relevante sensoren leeg waren.

Na het volgen van de instructies voor het vervangen van de batterij (Installatiehandleidingen voor Browan-sensoren) kwamen de sensoren weer online.

 

Voorbeeldcase E: Sensor Health rood bij sommige sensoren → Configuratiefout / typefout in sensor-ID

image2022-2-28 15:35:47.png

We merkten dat sommige sensoren na de installatie rood bleven / niet groen werden op het Sensor Health-plan van het Workplace-platform.

Analyse
  • Vraag 1: Merk je tijdens een installatie dat er geen gegevens binnenkomen in het Workplace-platform? Ja, dit is zichtbaar omdat de datum Laatst gezien “nooit” is
  • Vraag 2: Zijn alle sensoren getroffen? Slechts enkele
  • Vraag 3: In welke fase ontbreken de gegevens? Sensoren maken verbinding met het sensorplatform, maar niet met Studio
Oplossing

In de sensor-ID’s die rood waren, stonden typefouten (bijvoorbeeld één streepje - te veel in de ID of een verkeerd cijfer).

Nadat de typefout op deze apparaten was verwijderd, begonnen de sensoren gegevens naar het Workplace-platform te sturen.

Volgende stappen

Als de bovenstaande instructies je probleem niet hebben opgelost, neem dan contact op met Spacewell Support en vermeld de resultaten van de uitgevoerde tests.

 

 

 

Artikelen in deze sectie