Wat is een Domox Gateway?

Een Domox gateway heeft enkel communicatie tussen de verbonden apparaten en heeft geen visualisatie via de Domox App.

Voorwaarden om een KNX Gateway te kunnen configureren

Om een Domox controller (Intel NUC/19inch) als Gateway te kunnen configureren zijn er een aantal voorbereidingen nodig, namelijk:

• De controller moet zijn voorzien van spanning en aan staan (beeldscherm, toetsenbord en muis zijn normaal niet nodig, enkel om te kijken of de Domox een IP verbinding heeft en bekijken van ID óf voor ons vie teamviewer om in te loggen als die niet online komt).
• Een netwerkverbinding naar internet én naar het lokale netwerk waar het alarm paneel ook bereikbaar op is (later om te testen ook de KNX IP interface, maar voor configuratie niet nodig).
• ATS paneel moet voorzien zijn van een configuratie (gebieden, ingangen/zones en gebruikers)
• Gebruikers account aangemaakt op het portal.domox.com, die door ons gekoppeld is aan het installateurs account.

Domox ATS – KNX Gateway configureren

Maak een nieuwe klant aan en koppel de Domox Controller aan de nieuwe klant

• Log in op https://portal.domox.com en klik op Start
• Klik op Add Customer:
  </li
• Voer de naam/id/projectcode van uw klant in waar de Domox komt te staan:

• Klik op save en close (je komt weer terug in de lijst van alle klanten die onder jullie instalalteursaccount aangemaakt zijn).
• Klik op de klant die je hebt aangemaakt.
  Je komt nu op de sites pagina. Een site is een adres waar een woning/kantoor/pand waar de Domox in komt én waar eventueel meerdere Domox systemen in komen, zoals hoofdgebouw, demo ruimte, etc.)
• Klik op Add new site:
  
• Voer de velden in voor New Site (alleen de velden met een * zijn verplicht):
  
• Name kan zijn Woning, Kantoor Noord, Demoruimte etc.
• Adres is het adres van het pand/gebouw, maar mag vrij ingevuld worden (het is bedoeld om het het systeem snel te herkennen)
• Description is een vrij in te voeren veld, maar niet verplicht (project code, naam etc)
• Latitude en Longitude (GPS locatie van de site wat gebruikt kan worden voor logica in de KNX, maar niet verplicht)
• Klik op Save en Close.
• Je komt nu weer op de sites pagina en klik op de site die je net hebt aangemaakt.
  Je komt nu op de Controllers pagina. Hier staan alle Domox controllers die gekoppeld zijn aan deze geselecteerde site.
• Klik op Add new Controller:
  
• Voer de velden in voor New Controller (alleen de velden met een * zijn verplicht):
  
• Controller name is de naam van het Domox systeem wat je zit staan in het hoofdmenu/kruimelpad van het portaal.
• Mac is het fysieke netwerk adres van de Domox die gekoppeld wordt aan deze klant (het Mac adres is uniek per Domox en is makkelijk te vinden aan de onderkant van een NUC of in de DHCP server).
  Om het Mac adres zichtbaar te krijgen in deze lijst, moeten wij een Domox hebben gekoppeld aan het installateurs account én het Mac adres mag niet in gebruik zijn voor een andere klant.
  Na het koppelen zal een Domox een unieke GUID krijgen en zal een Mac adres enkel een verwijzing zijn (om beveiliging technische redenen).
• Description is vrij in te vullen, is de naam van het Domox systeem wat je zit staan in het hoofdmenu/kruimelpad van het portaal.
• Timezone is waar de Domox zich bevindt (er staat nu enkel Amsterdam/Europe, maar kan door ons op een andere tijdzone worden gezet).
  De log in het portaal is altijd in Zulu tijd: UTC+0000, maar in de lokale controller is het de geconfigureerde tijdzone.
• Language is de taal voor de Domox App, maar ook voor specifieke teksten in het portaal (zone/ingang beschrijvingen van het paneel).
• Email Addresses is bedoeld voor notificaties wanneer het systeem 30min niet meer is verbonden met de Domox Cloud.
  De Domox hoeft niet met internet verbonden te zijn nadat die is geconfigureerd, maar wel voor configuratie/beheer/updates en voor een externe App bediening (de app werkt zonder internet wel via de lokale Wifi).

Na invoer van de verplichte velden, klik op save en close.
Je komt nu weer op de controllers pagina en als de Domox goed gekoppeld is met het juiste mac adres, aan staat en een internet verbinding heeft (na het aanzetten van de Domox duurt het ongeveer 30-60sec om een online verbinding te maken):

Klik op de controller die je wilt configureren als gateway.

Je komt nu op de hoofd pagina voor configuratie van een Domox controller:

• Controls Export – hiermee exporteer je de configuratie naar de Domox toe (je kan dus alles aan de configuratie in het portaal wijzigen zonder dat het invloed heeft op de Domox controller, pas na export start de Domox opnieuw met de nieuwe configuratie)
  Stappen tijdens export:
  1: De Domox “service” wordt op de Domox controller gestopt, niet het Linux OS.
  2: Er wordt een backup gemaakt van de database op de Domox controller (wij kunnen deze backup indien nodig terug zetten).
  3: De database met de nieuwe configuratie wordt vanaf het portaal geëxporteerd naar de Domox controller.
  4: De Domox service op de Domox controller start weer op en leest alle gekoppelde apparaten uit
  – Alarm: is identiek aan ATS 8500 uitlezen paneel met installateurs account, daarna logt de Domox uit met het installateurs account en maakt dan een verbinding met het hoofdgebruikers account om te monitoren.
  – KNX: alle groepsadressen die een “sending” object hebben én de “read flag” aan hebben staan in het ETS project (ETS project wat in het portaal is geïmporteerd).
• Controls Start –  Hiermee herstart de Domox service (niet het Linux OS, Domox blijft online in het portaal).
• Controls Stop – Hiermee stopt de Domox Service waardoor de Domox geen verbinding meer heeft met de apparaten (niet het Linux OS, Domox blijft online in het portaal).
• Controls Reboot – Hiermee reboot de Domox Controller (het Linux OS start opnieuw).
• Controls Log – Hier is een uitgebreide log te zien wat de Domox verwerkt (technische log met Zulu tijdszone, waarmee je kan zien wat de Domox verstuurt en ontvangt en wij kunnen hiermee beter assisteren).
• Buildings – Hier configureer je één of meerdere gebouwen, etages per gebouw en de ruimtes per etage waar vervolgens de alarm ingangen/zones aan gekoppeld worden.
• Devices – Hier configureer je de apparaten die verbonden zijn met de Domox en waardoor de Domox zorgt voor onderlinge communicatie tussen de apparaten.

Apps – Hier configureer je de Domox App gerelateerde zaken: Toegang voor apps/devices iPhone/iPad, in- uitschakel knoppen (macro), notificatie groepen en klant specifieke knoppen zoals poort, deur die via het alarm bediend moeten worden (trigger, gebied).

Configureer het ATS advanced alarm paneel

• Klik op Devices
  Hier zie je het overzichtspagina van alle gekoppelde apparaten.
• klik op Add Device:
  
• Selecteer bij Device “ATS Advanced“:
  
• Description is vrij in te voeren veld voor een beschrijving van het alarm paneel
• Klik op Save en er verschijnt een pagina met de overige configuratie velden voor het alarm paneel:
  
• Host – IP adres van het alarm paneel (zorg ervoor dat het alarm een vast IP heeft, of via het mac-binding via de router aan een vast ip adres is gekoppeld)
• Port – Poort van het alarm paneel (standaard poort van ATS Advanced is 32000).
• Encryption Code – 24 cijferige encryptie code van het paneel (standaard is 24x 0 en is al ingevoerd, maar kan worden gewijzigd).
• Pincode Installer – Installateurs code van het paneel voor het uitlezen van de configuratie van het paneel door de Domox
  Vanaf ATS firmware mr4.5 is het mogelijk om via het bedienddeel van het alarm een 2e installateur te activeren. Na accepteren van meerdere installateurs  in het bediendeel moet het paneel met de 8500 software worden gedownload zodat in de 8500 software een 2e installateur aanmaakt kan worden (voor de Domox).
• Pincode User (Domox Superuser) – Domox hoofdgebruiker van het paneel voor het monitoren van het alarm paneel door de Domox.
  Advies is om voor de Domox een aparte (hoofd)gebruikersgroep aan te maken met toegang voor alle gebieden(ook de niet gebruikte gebieden, externe toegang aan (hetzelfde als de ATS App), rapportages aan én eventueel toegang om triggers te activeren en deactiveren).
• Version – Heeft betrekking op de App, maar versie 1 correct.
• Timesync – Als deze optie aan staat, zet de Domox iedere 24uur de tijd van het paneel met de Domox (Domox synchroniseert via de Google timeserver en kan zo zorgen dat de tijd van het alarm paneel gelijk is aan de Domox)
• Klik op save en daarna op close

Gebouw, etage en ruimte configureren

• We hebben nu de mogelijkheid om de configuratie te exporteren naar de Domox Controller en daarmee het paneel kunnen uitlezen/importeren, maar bij het importeren van de ingangen/zones is er minimaal één ruimte nodig waar de zones aan gekoppeld kunnen worden voor het importeren.
• Klik op Buildings > Add Buildings:
  
  Er verschijnt nu een pagina voor het configureren van een gebouw:
  
• Name – Naam van het gebouw (zoals Woning, Kantoor, Schuur, etc.).
• Description – Aanvullende info over het gebouw zoals het gebouw nummer (niet verplicht veld).
• Image – Foto van het gebouw (niet verplicht en bedoeld voor de Domox App visualisatie).
• Klik op Save en daarna op Close.
  Je komt nu terug op de overzichtspagina van Buildings en daar staat nu het gebouw die je net hebt toegevoegd.
• Klik op het gebouw die je net hebt toegevoegd (op de tekst, niet op het tandwiel. want dat is het gebouw editen).Er verschijnt nu een pagina Floors (van het gebouw die je net hebt aangeklikt):
  
• Klik op Add Floor.

  Er verschijnt nu een pagina New Floor (deze etage wordt aangemaakt onder het gebouw die je hiervoor hebt aangeklikt):

   

  

• Name – Naam van de etage zoals (beganegrond, kelder, verdieping, etc.).
• Level – Niveau van de etage (kelder is -1, beganegrond is 0, verdieping is 1, etc.).
• Description – aanvullende info over de etage zoals het etage nummer/id (niet verplicht veld).
• Floormap image –  PDF, PNG van de etage tekening (ideale tekening is transparante achtergrond met witte lijnen van de ruimtes  met een formaat van 2000px breed en 1500px hoog).
  Bedoeld voor de Domox App visualisatie en niet verplicht voor een gateway.
• Klik op Save en Close
  Je komt nu terug op de overzichtspagina van Floors en daar staat nu de etage die je net hebt toegevoegd.
• Klik op de etage die je net hebt toegevoegd (op de tekst, niet op het tandwiel. want dat is editen van de etage).
  Er verschijnt nu een overzichtspagina van de kamers die onder de etage vallen die je net hebt aangeklikt:
  
• Klik op Add Room.Er verschijnt nu een pagina New Room(deze kamer wordt aangemaakt onder het de etage die je hiervoor hebt aangeklikt):
  
  
• Name – Naam van de ruimte/kamer zoals (woonkamer, keuken, receptie, etc.)
• Description – aanvullende info over de ruimte/kamer zoals het kamer nummer/id (niet verplicht veld).
• App Group – Als hier een groep wordt geselecteerd (die is aangemaakt onder het hoofdmenu Apps), dan kunnen alleen de Apps deze ruimte bekijken/bedienen die gekoppeld zijn aan de geselecteerde groep.
  Bedoeld voor de Domox Visualisatie App en niet verplicht voor de Domox Gateway.
• Room photo – Foto van de ruimte die bedoeld is voor de Domox Visualisatie App (overzichtpagina met de foto’s van de ruimtes zijn tevens knoppen om naar die ruimtes te gaan voor KNX bediening).
  Bedoeld voor de Domox Visualisatie App en niet verplicht voor de Domox Gateway.
  
• Room filling Image – Edit floor map opent een plugin waarmee je de vloer van de ruimte uit de tekening van de etage kan halen (ruimte vloer en zone indicator van bijvoorbeeld een PIR lichten op bij verstoring, alarm, storing, overbrugging).
  Bedoeld voor de Domox Visualisatie App en niet verplicht voor de Domox Gateway.
  Ter info: De tool werk als volgt; Zet een groen streepje in de ruimte die je eruit wilt halen (raak niet de witte lijnen), klik met het toverstafje in dezelfde ruimte van het groene streepje en zet een rood streepje buiten de ruimte die je wilt en klik op export.
• Klik op Save en daarna op Close

Alarm gebieden en zones/ingangen importeren

We hebben nu een alarm paneel geconfigureerd en een gebouw geconfigureerd met een ruimte waar de alarm zones/ingangen aan gekoppeld kunnen worden (voor een gateway mogen alle zones aan één ruimte worden gekoppeld).
Nu moeten we eerst een export doen om de configuratie op de Domox controller te zetten, zodat die het alarm paneel gaat uitlezen.

• • Klik op Controls in het hoofdmenu.
  • Klik op Exporteren en vervolgens op Export onderin de balk.
    De export loopt en er verschijnt een melding dat de export is uitgevoerd.
  • Wacht nu +/-30 seconden en klik daarna op Devices
  • Klik op Alarm Areas (gebieden)
  • Klik op Alarm Area Discover (om de gebieden in het portaal te tonen)Er verschijnt nu een overzichtspagina met alle gebieden die zijn geconfigureerd in het paneel:

 

• Selecteer import van de gewenste gebieden (bovenste is selectie voor alle gebieden).
• Klik op Save en je komt terug op de pagina Alarm areas waar nu alle geïmporteerde gebieden bij staan.
  De knop Details geeft een live status van de configuratie (links) en de status (rechts) van het geselecteerde gebied.

Importeren van Zones:

• Ga nu naar het hoofdmenu en klik op Devices, of gelijk op devices als die zichtbaar is
• Klik op Alarm Zones (ingangen)
• Klik op Alarm Zone Discover (om de gebieden in het portaal te tonen):
  
  Er verschijnt nu een overzichtspagina met alle zones die zijn geconfigureerd in het paneel:
  
• 1: Selecteer eerst voor iedere zone/ingang de ruimte waaraan die gekoppeld moet worden (voor de Gateway mag dit één ruimte voor alle zones zijn)
• 2: Selecteer alle zones die moeten worden geïmporteerd
  De gele teksten zijn enkel zichtbaar wanneer de text in het paneel anders is dan de text in het portaal (meer ter info dat er een wijziging is)
  De knop Details geeft een live status van de configuratie (links) en de status (rechts) van de geselecteerde zone.
• Klik op Save en je komt terug op de pagina Alarm zones waar nu alle geïmporteerde zones bij staan.

KNX interface configureren

Om te zorgen dat de Domox de status van het alarm doorgeeft aan KNX, zal er eerst een KNX IP interface geconfigureerd moeten worden.

• Klik op Devices en Add device
  
• Selecteer bij “Select Device” KNX.
• Description is vrij in te vullen, zoals (KNX IP interface).
  
• Klik op Save en er verschijnt een configuratie pagina voor de KNX IP Interface:
  
• IP address – IP adres van het KNX IP Interface apparaat (niet verplicht als die op hetzelfde subnet zit als de Domox).
• Mac address – Mac adres van het KNX IP Interface apparaat (niet verplicht als die op hetzelfde subnet zit als de Domox).
• Physical address ETS KNX Domox dummy device – Zet in het KNX project een dummy apparaat van Theben/Gira etc. en noem die Domox).
• Physical address KNX IP Interface device – Het fysieke KNX adres van het KNX IP apparaat, zoals (1.0.250).
• Acknowledge outgoing L_Data.req requests – bedoeld voor sommige KNX interfaces die een bevestiging nodig hebben voor een goede werking (normaal mag deze uit blijven).
• Klik op Save en daarna op Close

Om alarm zones te koppelen aan groepsadressen, zal er een KNX project (ETS 5/6 met of zonder wachtwoord) geïmporteerd moeten worden.
Omdat er nu een KNX IP interface is geconfigureerd verschijnen er extra knoppen in het portaal onder devices.

Ga naar Devices en klik op KNX Configuration – Import ETS Project:

Vervolgens verschijnt er een KNX Import pagina:

• Selecteer Kies bestand en selecteer het ETS project op uw lokale pc.
• Voer een wachtwoord in die in ETS op het project is gezet (veld mag leeg zijn als er geen wachtwoord op zit).
• Klik op Export onderin de balk
  Tijdens het importeren verschijnt er een overzicht en voortang van de import (deels om voortgang te tonen, maar deels ook om te zien of er fouten optreden en om waarschuwingen te tonen.
  Een warning kan zijn dat een KNX groepsadres geen koppeling met een object heeft, of geen DPT heeft (dit groepsadres zal dan niet beschikbaar zijn in het portaal).
  Wij adviseren om groepsadressen aan te maken voor zones, waarin een DPT 1.001 switch object (On, Off), or  van de Domox dummy gekoppeld is met de vlaggen read, write, transmit, update aan.
  Dit object van het Domox dummy device hoeft niet “zendend” te zijn en mag in alle groepsadressen dezelfde zijn.
  
• Klik op reload om het eindresultaat te zien. Je ziet 2 tabbaden (devices en group addresses).

We hebben nu een alarm paneel en een KNX configuratie in het Domox Portaal opgevoerd, waarvan de KNX nog niet is doorgevoerd naar de Domox controller.

• Klik op Controls > Export > Export om de configuratie van de KNX te testen.
• Klik op Controls > Log om te kijken of er KNX data voorbij komt en of er geen fouten zijn.
  Als de KNX configuratie correct is, zie je op de KNX monitor in ETS dat de Domox alle groepsadressen uitleest waarin een object zit zie zendend is én de read vlag aan heeft staan (behalve de groepsadressen waar enkel de dummy van Domox in staan).

Koppeling tussen ATS en KNX configureren

Als de KNX en het Alarm met de Domox werken, kunnen we het ATS paneel met de KNX laten communiceren door de koppelingen te configureren:

ATS alarm zone/ingang naar KNX

• Klik op Devices > Alarm Zone to KNX
  
  Er verschijnt nu een overzichtspagina met alle geconfigureerde ATS > KNX koppelingen:
  
• Klik op Add Zone to KNX
  
  Er verschijnt nu een pagina waar een status van een alarm zone kan worden gekoppeld aan een KNX groepsadres:
  
• 1:Selecteer een alarm zone/ingang waarvan je een status wil doorsturen naar KNX (het nummer voor de zone is ook het ingang nummer in het paneel).
• 2:Selecteer optioneel extra zone statussen die je wilt doorsturen naar KNX. Normaal zijn de statussen Active (verstoord) en Alarm al geselecteerd omdat die het vaakst gebruikt worden.
• 3:Selecteer een groepsadres bij de gewenste status.
• 4:Selecteer de waarde die naar het groepsadres wordt gestuurd wanneer de zone naar die status gaat (voorbeeld: een zone verstoord een “aan” en wanneer die zone weer in rust komt een “uit”).
• 5:Selecteer of je de waarde van de geselecteerde status ook wilt sturen bij het opstarten (init) van de Domox (deze handig als je de KNX meteen de juiste statussen bij starten wil doorgeven én het zorgt ervoor dat je ze ook kan uitlezen met een read opdracht op het KNX groepsadres.

ATS alarm area/gebied naar KNX

Om een gebied status door te sturen naar KNX, ga dan naar Devices > Alarm Areas > Alarm Area to KNX. (Dit werkt verder hetzelfde als Alarm Zone to KNX wat hierboven beschreven staat).

KNX naar ATS alarm area/gebied

Om via KNX een gebied te schakelen, ga dan naar Devices > Alarm Areas > KNX to Alarm Area. (Dit werkt verder hetzelfde als Alarm Zone to KNX wat hierboven beschreven staat).

KNX naar ATS alarm trigger

Om Alarm triggers te kunnen gebruiken, zullen die eerst moeten worden geïmporteerd.

• • Ga naar Devices > Alarm Triggers:
    
  • Klik op Discover alarm triggers:
    
    Er verschijnt nu een pagina met alle alarm triggers die in het portaal zijn geconfigureerd.

 

• Selecteer de gewenste triggers voor import en klik op save
  

 

Om via KNX een trigger aan te sturen, ga dan naar Devices > Alarm Trigger > KNX to Alarm Trigger. (Dit werkt verder hetzelfde als KNX to Alarm Area).

Zijn er verder nog vragen, stuur dan een mail naar info@domox.com.