Aangepaste apparaattypen

Avatar
Laura CARBO

Moeilijkheidsgraad: expert

Inhoud

Leerdoelen

Na het lezen van dit artikel kun je:

  • Identificeren welke gegevenstypen worden ondersteund door Spacewell Workplace
  • De webhook en autorisatietoken configureren om je externe gegevensbronnen te verbinden met Workplace

Stel dat er al sensoren zijn die gegevens verzamelen in het gebouw en dat je deze gegevens wilt opnemen in het IoT-platform van Workplace. Spacewell biedt een generiek eindpunt (met behulp van webhooks) voor de meeste sensorgegevenstypen, om sensorgegevens van platforms van derden te integreren, te verwerken en op te slaan.

Zodra deze verbinding tot stand is gebracht, kun je aangepaste apparaattypen maken voor een gestroomlijnder en efficiënter sensorbeheer:

  • Duidelijke en beschrijvende namen van apparaattypen helpen onderscheid te maken tussen sensoren, zodat sensoren snel en nauwkeurig kunnen worden geïdentificeerd bij het oplossen van problemen of het vervangen van sensoren
  • Aanpasbare drempelinstellingen voor elk apparaattype activeren waarschuwingen en proactieve onderhoudsacties, zodat optimale sensorprestaties worden gewaarborgd

Vereisten

De sensorleverancier moet voldoen aan de webhook, ondersteunde gegevenstypen en payload van Spacewell; zie Externe gegevensbronnen

Opmerking

Binnen je Workplace-omgeving moeten sensor-ID's uniek zijn en worden voorafgegaan door de leveranciers-ID.
Het combineren van apparaat-ID's van meerdere externe partijen in één externe gegevensbron vergroot het potentiële risico op conflicten.

Apparaattypen configureren in Workplace

Toegang

  • Ga naar https://studio.cobundu.com/
  • Log in met je inloggegevens
  • Selecteer Integrations > Device Types in de Studio 2.0-interface
  • Selecteer “Add New”

Algemeen

  1. Naam van apparaattype
  2. Apparaattype-ID wordt gebruikt als unieke identificatie voor je apparaattype, bijvoorbeeld bij het importeren van apparaten in batches

    1. Aangepaste apparaattype-ID's bevatten altijd het voorvoegsel “Generic|”

Opmerking

De apparaattype-ID mag alleen kleine alfabetische tekens, cijfers of het symbool - bevatten

Informatie

Na het opslaan kun je de apparaattype-ID niet meer bijwerken in de bewerkingsmodus

  1. Externe gegevensbron

    1. selecteer een specifieke externe gegevensbron als de gegevens voor dit apparaattype altijd vanuit één externe gegevensbron worden geleverd. Deze één-op-éénverbinding is nuttig voor het registreren van apparaten in Workplace (zie het onderstaande hoofdstuk “Apparaten configureren in Workplace“)

    2. selecteer “Elke” als de gegevens voor dit apparaattype uit verschillende externe gegevensbronnen kunnen komen. In dit geval is het registreren van apparaten in Workplace iets complexer (zie het onderstaande hoofdstuk “Apparaten configureren in Workplace“)

Informatie

Na het opslaan kun je de koppeling met de externe gegevensbron niet meer bijwerken in de bewerkingsmodus

  1. Status: inschakelen om het apparaattype te kunnen selecteren in de vervolgkeuzelijst voor apparaattype bij het configureren van apparaten in Workplace
  2. Afbeelding van apparaat: behoud de standaardafbeelding, selecteer een algemene afbeelding of upload een afbeelding van je apparaattype. Deze afbeelding wordt weergegeven op het apparaatlabel

 

image-20240522-160705.png

Sensorstatus

De sensorstatus wordt afgeleid van de laatste communicatie van de sensor met het Workplace-platform. De communicatie kan bestaan uit een sensorwaarde of een heartbeat. Omdat elk apparaattype zijn eigen heartbeatfrequentie heeft, wordt de status van het apparaat per apparaattype geëvalueerd. Zie Sensorstatus controleren voor meer informatie.

Vul numerieke waarden in die worden gebruikt om de status te wijzigen van apparaten die aan het apparaattype zijn gekoppeld:

  1. Controleren
  2. Offline

    1. de waarde moet groter zijn dan de waarde voor Controleren

image-20240523-154234.png

Sensordetails

Selecteer in de lijst met ondersteunde gegevenstypen welke kanalen relevant zijn voor het apparaattype dat je maakt. Met andere woorden: welk type sensorgegevens wordt door apparaten die volgens dit apparaattype zijn ingesteld naar Workplace verzonden?

  • CO₂
  • Teller
  • Voetgangerspuls (in)
  • Voetgangerspuls (uit)
  • Personentelling
  • Vochtigheid
  • Aanwezigheid*
  • Puls
  • Radon
  • Temperatuur
  • VOC

* Aanwezigheid

Bij aanwezigheids-/bewegingssensoren bestaat er verschil in de manier waarop sommige sensoren de afwezigheid van aanwezigheid bevestigen of juist niet bevestigen:

  • Selecteer "Nee" als het apparaat aanwezigheidsgegevens verzendt om bezetting te bevestigen en mogelijk gegevens verzendt om leegstand te bevestigen, maar deze bevestiging van leegstand niet verzendt zodra de locatie beschikbaar is (~ niet betrouwbaar in het bevestigen van leegstand)
  • Selecteer "Ja" als het apparaat aanwezigheidsgegevens verzendt om bezetting te bevestigen en ook gegevens verzendt om leegstand te bevestigen zodra de locatie weer beschikbaar is

 

Opmerking

Dit heeft niets te maken met de nauwkeurigheid van de sensor of met “de sensor zelf die betrouwbaar gegevens verzendt”. Het gaat om de betrouwbaarheid van de verklaring “bezet” nadat er gedurende enige tijd geen aanwezigheid is gedetecteerd.

 

Wanneer een sensor niet betrouwbaar is in het bevestigen van leegstand, wat betekent dat we niet 100% zeker weten wanneer de locatie weer beschikbaar is, kun je het vervagen van pictogrammen op de live plattegrond configureren via Instellingen voor plattegronden.

 

Voorbeelden van (on)betrouwbare communicatie van afwezigheid

Voorbeeld 1. PIR-bewegingssensor

De PIR-bewegingssensor in dit voorbeeld verzendt gegevens ter bevestiging van “aanwezigheid gedetecteerd” zodra deze wordt geactiveerd. In die zin is de sensor betrouwbaar in het doorgeven van bevestigingen van bezetting.

Als de gebruiker zich echter van de sensor verwijdert en de ruimte objectief gezien leeg is, verzendt de sensor niet onmiddellijk een statuswijziging. De sensor is dus niet betrouwbaar in het doorgeven van bevestigingen van leegstand.

Selecteer “onbetrouwbaar” bij het aanmaken van dit apparaattype.

 

Voorbeeld 2. Personentelsensor die bezettingsgegevens levert

De personentelsensor in dit voorbeeld verzendt elke minuut gegevens:

  • De gegevens kunnen 1 of hoger zijn, wat betekent dat er ten minste 1 persoon wordt gedetecteerd. Dit kan worden geïnterpreteerd als “aanwezigheid gedetecteerd”, omdat de locatie bezet is.
  • De gegevens kunnen de waarde “0” zijn, wat betekent dat er geen personen zijn geteld. Dit kan feitelijk worden vertaald naar “geen aanwezigheid gedetecteerd” of “deze locatie is leeg”.

In dit geval wordt Workplace uiterlijk na 2 minuten bijgewerkt met de informatie dat er geen bezetting (meer) wordt gedetecteerd op die locatie, zelfs als iemand een ruimte binnenloopt om iets te pakken en de ruimte direct weer verlaat.

Selecteer “betrouwbaar” bij het aanmaken van dit apparaattype.

Apparaten configureren in Workplace

Vereisten

  • bevestiging hebben dat de verbinding van de externe gegevensbron met Workplace geslaagd is; zie Externe gegevensbronnen
  • bevestiging hebben welk gegevenstype wordt gebruikt om de gegevens door te geven
  • de lijst hebben met apparaat-ID's die gegevens vanuit de externe gegevensbron naar het Workplace-platform verzenden

 

Afhankelijk van de (bekende) verbinding tussen het apparaattype en een specifieke externe gegevensbron is verschillende informatie vereist om apparaten te configureren in Workplace:

1. Als het apparaattype is ingesteld om verbinding te maken met een specifieke externe gegevensbron

Het instellen van een één-op-éénverbinding tussen apparaattype en externe gegevensbron is nuttig voor het registreren van apparaten in Workplace Studio:

image-20230901-154411.png
  1. Ga naar je omgeving (https://studio.cobundu.com ) en log in
  2. Selecteer de locatie en voeg handmatig een sensor toe via "Add New Device"
  3. Selecteer het relevante Device Type in de vervolgkeuzelijst. Op basis van het gekozen apparaattype wordt een standaardset kanalen ingeschakeld
  4. Vul de Device ID in die in de payload wordt gebruikt om over dit datapunt te rapporteren*
  5. Geef het apparaat een betekenisvolle naam (bijv. klant_verdiepingsnummer_gebied) in Device Name.
  6. Location wordt ingevuld op basis van je voorafgaande selectie in de locatiestructuur

 

Informatie

* In Workplace wordt een voorvoegsel dat verwijst naar de tenant-ID en de ID van de externe gegevensbron toegevoegd aan de apparaat-ID. Dit is zichtbaar in Devices Export.

Zie Apparaten configureren (toevoegen, verwijderen, importeren en exporteren) voor meer informatie over het toevoegen van meerdere nieuwe apparaten aan Studio.

Informatie

Zorg ervoor dat je de tenant- en source-ID opneemt (in de indeling “<tenant_id>-<source_id>”) als je apparaten maakt via de functie Device Import. Zie hieronder voor meer informatie.

 

Opmerking

Binnen één leveranciers-ID moeten sensor-ID's uniek zijn en worden voorafgegaan door de leveranciers-ID.
Het combineren van apparaat-ID's van meerdere externe partijen in één externe gegevensbron vergroot het potentiële risico op conflicten.

 

2. Als het apparaattype is ingesteld om verbinding te maken met “Elke” externe gegevensbron

Selecteer “Elke” als de gegevens voor dit apparaattype uit verschillende externe gegevensbronnen kunnen komen. In dit geval is het registreren van apparaten in Workplace iets complexer:

image-20230901-154411.png
  1. Ga naar je omgeving (https://studio.cobundu.com ) en log in
  2. Selecteer de locatie en voeg handmatig een sensor toe via "Add New Device"
  3. Selecteer het relevante Device Type in de vervolgkeuzelijst. Op basis van het gekozen apparaattype wordt een standaardset kanalen ingeschakeld
  4. Vul de Device ID in met de tenant-ID en source-ID die beschikbaar zijn in Settings > External Data Sources. Gebruik de indeling <tenant_id>-<source_id>|<device_id>
Voorbeeld van apparaat-ID

bijvoorbeeld

  • als je een sensor wilt configureren met ID “123” (unique_device_id die wordt vermeld in de payload; bij een externe leverancier moet deze door de externe partij worden verstrekt)
  • in een omgeving met tenant-ID “spacewell”
  • waar een externe gegevensbron met source-ID “testgeneric” is ingesteld

dan is de apparaat-ID van Spacewell

“spacewell-testgeneric|123"

  1. Geef het apparaat een betekenisvolle naam (bijv. klant_verdiepingsnummer_gebied) in Device Name.
  2. Location wordt ingevuld op basis van je voorafgaande selectie in de locatiestructuur

Zie Apparaten configureren (toevoegen, verwijderen, importeren en exporteren) voor meer informatie over het toevoegen van meerdere nieuwe apparaten aan Studio.

Opmerking

Binnen één leveranciers-ID moeten sensor-ID's uniek zijn en worden voorafgegaan door de leveranciers-ID.
Het combineren van apparaat-ID's van meerdere externe partijen in één externe gegevensbron vergroot het potentiële risico op conflicten.

 

Veelgestelde vragen

Wat als de sensor niet regelmatig gegevens verzendt? Kun je gegevens naar tijdsblokken kopiëren?

Afhankelijk van het type sensor verzenden deze mogelijk niet regelmatig heartbeats of gegevens. Als ze gegevens verzenden en daarna alleen een bericht verzenden wanneer de waarde verandert, krijg je mogelijk losse stukjes gegevens (bijv. één tijdsblok van 15 minuten met temperatuurgegevens en de rest van de dag niets), wat verwarrend kan zijn wanneer je de dashboards probeert te lezen.

Om dit te omzeilen, kun je ervoor kiezen om Spacewell de gegevens te laten kopiëren per generiek eindpunt-/apparaattypeniveau voor een gewenste periode.

Voor het sensortype "Generic PIR" kunnen we bijvoorbeeld "kopiëren naar volgende tijdsblokken" instellen. Deze waarde is dan geldig voor alle waarden van Generic PIR-sensoren die voor jouw tenant bij ons binnenkomen. De gegevens worden uiteraard alleen gekopieerd totdat er nieuwe gegevens binnenkomen. Als er dus op maandag om 9.00 uur een waarde binnenkomt, de configuratie aangeeft "kopiëren gedurende 7 dagen" en er op woensdag om 8.00 uur een nieuwe waarde binnenkomt, wordt de nieuwe waarde vanaf woensdag 8.00 uur gedurende 7 dagen gebruikt, of totdat er een nieuwe waarde binnenkomt.

Informatie

Workplace visualiseert of rapporteert bijgevolg alleen dat een sensor GEEN gegevens verzendt nadat de geconfigureerde tijd is verstreken (in het vorige voorbeeld: na 7 dagen).

Neem contact op met je Account Manager om dit in te stellen.

Kun je een apparaattype verwijderen?

In Workplace kun je een apparaattype uitschakelen, maar niet verwijderen. Verwijdering zou gevolgen hebben voor apparaten die met dit apparaattype zijn gemaakt.

Problemen oplossen

Melding dat de verbinding is geslaagd, maar de sensor laadt geen gegevens

Zorg ervoor dat de volgende configuratie aanwezig is:

  • de sensor-ID die in Workplace is gemaakt, voldoet aan de beschreven logica en het volgende bevat:

    • Tenant-ID van de omgeving

    • ID van de externe gegevensbron
    • Unique_device_id die in de payload wordt vermeld (bij een externe leverancier moet deze door de externe partij worden verstrekt)
  • sensorgegevens worden verzonden volgens de vereiste Externe gegevensbronnen
  • relevante sensorgegevenskanalen zijn ingeschakeld voor het apparaat op het Spacewell-platform
Een apparaattype gemaakt, maar het wordt niet weergegeven in de vervolgkeuzelijst Add New Device

Als je een apparaattype hebt gemaakt, maar het niet wordt weergegeven in de vervolgkeuzelijst “Add New Device”, controleer dan of de status van je apparaattype is ingeschakeld.

 

 

 

Artikelen in deze sectie