Spring til indhold
Platformen

Ikke bare en relæcontroller. Et samlet økosystem.

RelayHub består af fire dele, der er udviklet til at fungere sammen: et REST API, en central server, controllere ude ved installationerne og firmware, der håndteres centralt. Tilsammen skaber de forbindelsen mellem det digitale system og det udstyr, der fysisk skal styres.

Platformens fire dele

Arkitektur

Fra beslutning til fysisk handling

Eksisterende system, RelayHub API, RelayHub-server, RelayHub-controller, fysisk handling. Den klare opdeling betyder, at eksisterende systemer kan udvides med fysisk styring, uden at deres grundlæggende funktion ændres.

  1. Eksisterende systembeslutter hvornår og hvorfor
  2. RelayHub APImodtager kommandoen
  3. RelayHub-serverautoriserer og router
  4. RelayHub-controllerudfører fysisk
1. REST API

Forbindelsen til eksisterende software

Eksterne systemer kommunikerer med RelayHub gennem et REST API. Når en fysisk handling skal udføres, sender systemet blot en kommando: aktivér relæ 1 kortvarigt, tænd relæ 2, skift relæ 3.

Hver kommando svarer med et commandId. Med det kan I slå op, om kommandoen er udført, og hvornår. API-adgang styres med adgangsbegrænsede nøgler, så hver integration kun kan det, den skal.

  • Webapplikationer
  • Bookingsystemer
  • Adgangskontrol
  • Alarmsystemer
  • Automation
  • Digital signage
  • Overvågning
  • Node.js
  • Python
  • C#
  • Egne backend-systemer
Tre kommandoer, samme endpoint
# Aktivér relæ 1 kortvarigt (puls i 500 ms), fx en klokke eller en dørlås
POST /api/clients/{clientId}/relays/1/action
{"action": "inch", "durationMs": 500}

# Tænd relæ 2 og lad det være tændt, fx en signallampe
POST /api/clients/{clientId}/relays/2/action
{"action": "switch", "state": "on"}

# Skift relæ 3 til det modsatte af nu
POST /api/clients/{clientId}/relays/3/action
{"action": "toggle"}

# Svar
200 OK  {"status": "ok", "commandId": "cmd-4a7f2b91c3e0", "sentToClient": true}
2. Den centrale server

Knudepunktet mellem systemer og controllere

RelayHub-serveren er platformens centrale kommunikationspunkt. Den sørger for, at en kommando bliver sendt til den rigtige controller og den rigtige fysiske installation, og den håndterer:

  • Sikker kommunikation, autorisation og adgangskontrol
  • Routing og videresendelse af kommandoer
  • Overvågning, heartbeat og status på tilsluttede enheder
  • Central logning på tværs af lokationer
RH-Bot i et kontrolrum med systemstatus for alle enheder

Persistent forbindelse til controllerne

Controllerne etablerer selv en vedvarende forbindelse til serveren. Serveren behøver aldrig åbne en ny indgående forbindelse gennem kundens firewall, når et relæ skal aktiveres. Forbindelsen er der allerede. Det giver realtidskommandoer, løbende status, heartbeat og hurtig reaktion, uden port-forwarding og uden indgående forbindelser gennem lokal NAT og firewall.

3. Controllerne

Dér, hvor handlingen skal udføres

Den fysiske del af systemet er RelayHub-controllere installeret dér, hvor handlingen skal ske. Controllerens opgave er at modtage en kommando fra platformen og omsætte den til et fysisk output. Den er bygget til kontinuerlig drift og reagerer hurtigt på kommandoer fra serveren.

Set fra det eksterne system er controlleren enkel: udvikleren behøver ikke kende den elektriske installation, men sender blot kommandoen. Partneren sørger for tilslutningen.

Controllerne findes med ét eller flere relæer, med forskellige typer udgange og med indbygget lydafspiller. Se hardwaren.

  • Relæ, kort puls
  • Relæ, tænd/sluk
  • Pulserende signal
  • Signallampe
  • Klokke
  • Alarmgiver
  • Elektrisk lås
  • Portstyring
RH-Bot monterer en controller
Sikker onboarding

Voucher i stedet for passwords

Når en ny controller skal installeres, forsynes den med en engangsvoucher. Ved den lokale opsætning indtastes netværksoplysninger og voucher, hvorefter controlleren selv kontakter platformen og registrerer sig.

Voucheren bruges kun til selve registreringen. Der findes derfor ingen traditionelle brugerkodeord på controlleren, og nye enheder tilføjes på en kontrolleret måde.

RH-Bot registrerer en controller med en voucher
  1. Controlleren installeres

    Monteres og tilsluttes udstyret af partneren.

  2. Netværk og voucher

    WiFi eller kabel og engangsvoucher indtastes lokalt.

  3. Kontakt til platformen

    Controlleren kontakter selv RelayHub-serveren.

  4. Voucheren valideres

    Serveren godkender voucheren én gang.

  5. Enheden registreres

    Controlleren knyttes til jeres konto på platformen.

  6. Klar til drift

    Forbindelsen holdes åben, og kommandoer kan modtages.

Sikker kommunikation

Veldefinerede forbindelser, intet andet

Sikkerhed er en del af RelayHubs arkitektur, ikke et lag ovenpå. Kommunikationen mellem software, server og controllere foregår gennem veldefinerede forbindelser, og firmware og platform fungerer som ét samlet, kontrolleret miljø.

  • Controllerne etablerer selv deres forbindelse udad
  • Ingen åbne indgående porte til controllerne
  • Registrering med engangsvoucher, ingen credentials i firmwaren
  • API-adgang med adgangsbegrænsede API-nøgler
  • Kommunikation og enheder overvåges centralt
  • Ingen unødvendig telemetri eller skjult analyse af jeres forbrug
Cloud eller lokal

To driftsmodeller, samme principper

Cloud-baseret platform

RelayHub-serveren er det centrale knudepunkt over internettet. Controllere på alle jeres lokationer forbinder til samme platform, og jeres systemer kalder ét API, uanset hvor udstyret står.

  • Mange lokationer, én platform
  • Ingen egen serverdrift

Lokal RelayHub-installation

Controllerne taler med en RelayHub-server på det lokale netværk. Den daglige relæstyring og kommunikation foregår internt i installationen, også uden internetforbindelse.

  • Styringen bliver i bygningen
  • Samme API og samme controllere
4. Central firmware

Ensartet software på alle installationer

Controllerne kører RelayHub-firmware, udviklet specifikt til platformen, med fokus på stabil drift, sikker kommunikation, ensartet funktionalitet og kontrollerede opdateringer. Firmwaren håndteres centralt, så alle installationer kører samme kontrollerede softwareplatform.

Skalerbar tankegang

Fra én funktion til mange lokationer

I stedet for at det centrale softwaresystem skal kende den tekniske forbindelse til hver enkelt installation, er RelayHub det fælles lag. En installation kan vokse fra ét system, én controller og én funktion til flere systemer, mange controllere og mange lokationer, med samme API og samme princip hele vejen.

Samlet beskrivelse

Professionel IoT-infrastruktur til fysiske handlinger

I stedet for at hvert softwareprojekt selv skal bygge kommunikation, enhedsregistrering, fjernforbindelse og hardwarestyring, stiller RelayHub en samlet infrastruktur til rådighed. Jeres systemer kan koncentrere sig om data, regler, brugere og beslutninger.