[NL] DOBISS NXT

Quick-start gids

Installatie van de NXT-server

Inloggen op de NXT-server

Surf naar http://dobiss.local en log in met: Username: dobiss     Paswoord: dobiss

Indien je via ‘dobiss.local’ geen verbinding krijgt met de NXT, zoek deze dan met een ip-scanner (vb. Advanced IP scanner). In de lijst met verbonden toestellen kan je op basis van de geselecteerde component/fabrikant van de netwerkverbinding het Ip-adres en/of Mac-adres van de NXT terugvinden.

Zoek naar : taskit GmbH

Mac-adres: beginnend met 8C:8E: …

Surf dan naar het gevonden ip-adres.

Na succesvolle login kom je op volgende pagina. Hier krijg je een overzicht van de verschillende menu’s. Het is aangewezen om meteen het paswoord aan te passen. Zolang dit niet gebeurd is, blijft de melding in het rood.                                                             

Onderaan elke pagina heb je enkele icoontjes staan:

NXT voorzien van laatste firmware-versie

Enkel mogelijk indien de NXT reeds verbonden is met internet!

Bij opstarten van de NXT is het aangeraden om eerst na te gaan of er een nieuwe firmware-versie beschikbaar is.

Ga naar ‘Modules’, indien er naast ‘NXT Server’ ‘Upgrade naar…’ staat dan dient deze upgrade eerst uitgevoerd worden alvorens verder te gaan.

Elke nacht of na iedere heropstart zal er gecheckt worden naar updates en indien beschikbaar wordt dit aangegeven.

Via de blauwe ‘Download firmware’ – knop kan men ook instant updates opvragen.

Algemene configuratie – instellingen

Algemene instellingen

Gebruikers

Aanmaken van gepersonaliseerde logins met elk zijn toegangsrechten (profielen).

Logging

Alle acties worden hier gelogd en kunnen geraadpleegd worden.

Configuratie modules

Bestaande PRO naar NXT

Een PRO-installatie kan makkelijk ge-upgraded worden naar NXT.

Indien een upgrade wordt uitgevoerd van een EVOLUTION PRO moet de Master Max200 verbonden blijven met de installatie en minstens firmware-versie 10 aan boord hebben. Indien dit niet zo is, moet deze eerst ge-upgraded worden via de Ambiance PRO-tool met een Can-programmer. Indien een upgrade van een AMBIANCE PRO, mag de Can-programmer verwijderd worden.

Bij ‘Algemene instellingen’  (4.1) kan men de import van Dobiss PRO starten. Na een import van een PRO-installatie worden alle modules automatisch ge-upgraded met de meest recente NXT-firmware (v100 of hoger) en ziet men deze bij ‘Modules’ verschijnen.

Alle modules, groepen, namen en configuratie van uitgangen, namen en configuratie van knoppen en sferen worden overgenomen uit PRO.

Indien Evolution PRO met temperatuursturing worden ook alle temperatuurinstellingen op uitzondering van de kalenders mee overgenomen. Programmaties, condities, statusleds en audio worden niet overgenomen.

Opstart van een nieuwe installatie

Bij de opstart van een nieuwe installatie begint men met het adresseren van de modules via

‘Start adressering’. Alle modules die verbonden zijn met de Canbus gaan nu trager knipperen.

Eén voor één moet dan eenmalig op de ‘Service’- knop van de modules worden gedrukt en per soort komen de diverse modules in volgorde van drukken in de lijst.

modules_addressing.gif

Modules die reeds voorzien zijn van de NXT-firmware komen binnen met v100 (of hoger). Modules met de PRO-firmware komen binnen met v21 (of lager).

PRO-modules die door de NXT worden geadresseerd worden automatisch ge-upgraded naar de

NXT-versie. Onderaan de pagina wordt in het rood de status van de firmware-upgrade weergegeven.

Overzicht verdere configuratie

  1. Uit/In: configuratie van in-en uitgangen, benamingen, groepen aanmaken,…
  2. Drukknoppen: scannen van drukknoppen, acties aan knoppen toekennen,…
  3. Scenarios: configuratie van sferen.
  4. Automatisaties: programmaties aanmaken op basis van uur, zonsopgang en –ondergang,…
  5. Logische condities: aanmaken van condities om aan knoppen, sferen, enz. toe te kennen.
  6. Temperatuur: configureren van temperatuurvoelers en bijhorende temperatuur kalenders.
  7. Sensors: configuratie van statusleds.
  8. Audio: koppeling met audiosystemen Sonos en/of Apart.

Alle wijzigingen worden steeds automatisch verstuurd naar de modules, status van de export vind je onderaan op elke pagina in het rood!

Video tutorials

Klik bovenaan rechts op de video om alle tutorials te zien.

Download

Archief met alle video's voor offline gebruik.

Online bekijken

Dobiss NXT webinar: online opleiding over de opbouw van een NXT-installatie

  1. Communicatie met de NXT
    1. Inloggen op NXT server
  2. Modules
    1. Adresseren van modules
    2. Vervangen van een defecte module
  3. Uitgangen
    1. Benoemen van uitgangen en groepen
    2. Configuratie RGB(W)
    3. Configuratie rolluiken en screens
    4. Configuratie ventilator WC
    5. Diminstellingen per dimuitgang
  4. Drukknoppen
    1. Scannen en configuratie van drukknoppen
    2. Configuratie van een PIR detector
    3. PIR detector met donker conditie
    4. Configuratie drukknop met tijdsvertraging
  5. Scenario's
    1. Configuratie van een 'alles uit' scenario
    2. Configuratie van een 'paniek' scenario
    3. Scenario nachthal 's nachts gedimd
  6. Automatisaties
    1. Buitenverlichting
    2. Rolluiken
  7. Verwarming/koeling
    1. Scannen van temperatuursensoren
    2. Sturing van verwarming/koeling met ventielen gestuurd via relais (AAN/UIT)
    3. Sturing van verwarming/koeling met ventielen gestuurd via 0-10V
    4. Kalender voor verwarming/koeling
  8. Audio
    1. Integratie van Bose of Sonos
  9. Vlaggen
    1. Vlag die aangeeft dat een deur open is
    2. PIR detector met Alarm-scenario met behulp van een vlag
  10. Meldingen
    1. Melding via contact van het alarmsysteem
    2. Melding via PIR-detector met behulp van een vlag
  11. Algemene instellingen
    1. Standaard login en wachtwoord aanpassen
    2. Aanmaken van een cloud account
    3. Nieuwe gebruiker en profiel aanmaken
    4. Backup en andere projectinstellingen
  12. Stembediening
    1. Koppeling met Google Home/Assistant
  13. IFTTT
    1. Integratie van een "Smart plug" via IFTTT
  14. FERMAX MEET
    1. Koppelen Fermax MEET met Dobiss NXT
  15. Energie
    1. Koppeling met digitale meter Fluvius
  16. Nanotouch
    1. Koppelen van een Nanotouch met een Dobiss NXT

Integraties

Ontdek hier hoe u DOBISS NXT kan koppelen aan externe systemen.

Integraties

Dobiss VEO-XS videofoon

Voorbereiding

Gebruik uit de U/FTP kabel 2 paartjes om de Can-bus aan te sluiten op de respectievelijk klemmen CH – CL en M op de muurplaat van de Veo XS.  Plaats de Can-bus afsluiter (120Ω weerstand) tussen CH en CL op de laatste module/muurplaat.

In de kast sluit je eveneens de CH – CL en M aan op het meegeleverde overgangsblokje naar RJ12.

Met behulp van een Can-patch kabel kan je de Can-bus doorverbinden met de laatste Dobiss module in de kast. Kijk waar nog een zwarte Can-bus patch RJ12 vrij is.

Opstarten Dobiss VEO XS

Zet de spanning op van de Fermax DUOX installatie. Na een 20tal seconden is de monitor opgestart en zal een rode led oplichten.    

U kan nu het Touchscreen aanraken. Bij de 1ste aanraking zal automatisch de procedure ‘importing’ gestart worden. Alle gegevens worden spontaan uit de aanwezige en geconfigureerde Dobiss modules gehaald.

In geval van Ambiance PRO moet er zeker een module als master worden aangevinkt tijdens de configuratie met de Ambiance Tool. Eveneens noodzakelijk voor het gebruik van sferen of wanneer u wil gebruik maken van de gratis Dobiss app.

U kan nu het aanraakscherm gebruiken.

Weergave op de VEO XS

Na de automatische import zullen alle namen van uitgangen relais en dimmers, automatisaties  zoals rolluik – screens, en de sferen onder hun respectievelijke iconen worden ondergebracht.

Als de uitgangen van verlichting in meerdere groepen worden onderverdeeld dan zullen deze groepen op het startscherm eveneens worden weergegeven.

Selecteer een groep naar keuze en vervolgens worden alle uitgangen die onder deze groep werden geconfigureerd zichtbaar en klaar voor bediening.

Als u ervoor kiest alle uitgangen van verlichting onder slechts 1 groep onder te brengen dan zullen op het startscherm alle uitgangen ook dadelijk worden weergeven. Er kunnen per scherm 6 items weergegeven worden. Swipe naar links of rechts (of gebruik de pijltjes) om naar eventueel volgende pagina’s te gaan.

Bovenaan het scherm zullen het aantal bolletjes het aantal pagina’s weergeven.

Gebruik van de Fermax/Dobiss functies

Druk lang (10sec) op een willekeurig basis icoon onderaan.

U komt spontaan in een achterliggend scherm waar u een actie kan koppelen aan 5 verschillende Fermax functies.

U kan achter elke functie (event)  een sfeer naar keuze selecteren.

Druk meervoudig op de desbetreffende functietoets op het scherm en je scrolt door alle beschikbare sferen die eerder werden aangemaakt via de Ambiance of Evolution Tool.

Vb: afbeelding boven ziet u bij de F1 toets dat Sfeer 1 van de 14 beschikbare (1/14) sferen geselecteerd werd.

  F1 toets à Dobiss Functie werkt altijd. Ook als het scherm NIET is opgelicht.

 Incoming Call

 Camera Pop-Up

 Camera Pop-Down

Deurslot bediening  à Dobiss functie wordt enkel opgeroepen als het scherm opgelicht is

Instellingen

Bij de onder spanning zetten en eerste aanraking van het scherm worden alle gegevens automatisch uit de Dobiss installatie geïmporteerd.

Stel dat u nadien nog uitgangen of sferen heeft toegevoegd, namen gewijzigd,…. dan kan u al deze nieuwe gegevens ook op de Veo XS importeren.

Druk lang (10sec) op een willekeurig basis icoon onderaan.

U komt hiermee spontaan in het scherm van de functietoetsen.

Klik Import om de configuratie uit de Dobiss installatie opnieuw op te halen.

Stel hier uw screensaver in. Klik meervoudig op het icoon om door de timer te scrollen. Tijd (1 à 15 min) waarna het scherm in slaapstand over gaat.

Klik ter afsluiting op een willekeurig basis icoon om terug te keren naar de standaard bedieningen van uitgangen, rolluiken of sferen.

Integraties

Dakramen Velux

Je kan met DOBISS NXT je VELUX dakramen gaan aansturen en de status visualiseren door gebruik te maken van de VELUX KLF200 interface.

Deze interface kan maximaal 5 motoren aansturen en heeft hiervoor 10 inputs (2 per motor; 1 voor elke draairichting van de motor).

Sturing

Verbind de uitgangen van een DOBISS relaismodule (DO5411) met de 10 inputs van de KLF200, waarbij de 'L-klem' gebruikt wordt als gemeenschappelijke (massa symbool op de KLF200).

Selecteer het juiste symbool (op/neer) voor iedere uitgang en automatisch zullen de beide uitgangen met elkaar vergrendeld worden, zodat ze nooit samen bediend kunnen worden.

Bij het bedienen van de DOBISS uitgang, zal de VELUX motor in de overeenkomstige richting draaien.

Status

Om de status van de ramen in DOBISS te visualiseren, kunnen de 5 outputs van de KLF200 verbonden worden met een DOBISS universele inputmodule (DO5480).

Deze KLF200 outputs geven een puls van 2 seconden bij het sluiten van het raam. In DOBISS NXT kan deze status opgeslagen worden in een vlag.

Voor de configuratie van de KLF200 verwijzen wij graag door naar de handleiding van VELUX.

Integraties

Stembediening via Google Home

Uw Dobiss – installatie koppelen met Google Home

NXT-server moet v0.16 of hoger hebben

  1. Nadat u uw verbonden Google-apparaat heeft ingesteld, opent u de Google Home-app
  2. Ga naar de startpagina van de applicatie en druk op de knop « Toevoegen » :

  3. Selecteer « Apparaat instellen » :
  4. Selecteer « Heb je al iets ingesteld ? » :

  5. Kies « Dobiss Domotics » uit de lijst :

  6. Voer je cloudnaam in, de  « API key » code en druk op « Connect » :


    U vindt de unieke « API key » code van uw installatie op de startpagina van het configuratiegedeelte van de NXT Server.:


    Om eenvoudig de sleutel over te nemen, klik op « Kopiëren » om vervolgens te « Plakken » in het  « API key » veld van de Google Home applicatie.

Belangrijkste spraakopdrachten die worden ondersteund door Google Home:

Onderstaande opdrachten moeten worden voorafgegaan door « OK Google » of « Hé Google » of door op   te drukken:

Gewenste acties

Spraakcommando’s

Verlichting & stopcontacten

Aan-/uitzetten van een lichtpunt of stopcontact.

"Zet <naam van de uitgang> aan/uit."

Aan-/uitzetten van alle lichtpunten in een groep.

"Zet lichten aan/uit in <naam van de groep>." 

Aan-/uitzetten van de stopcontacten in een groep.

"Zet stopcontacten aan/uit in <naam van de groep>." 

Aan-/uitzetten van de stopcontacten en lichtpunten in een groep.

"Zet <naam van de groep> aan/uit." 

Aan-/uitzetten van alle verlichting in een woning.

"Zet alle lichten aan/uit."

Aan-/uitzetten van alle stopcontacten in een woning.

"Zet alle stopcontacten aan/uit."

Een lichtpunt aanzetten op een bepaald percentage (dimming).

"Zet <naam van de uitgang> aan op XX %."

De intensiteit van een lichtpunt verlagen/verhogen (dimming).

"Zet <naam van de uitgang> zachter/harder."

Verander de dimwaarde van een lichtpunt (dimming).

"Zet <naam van de uitgang> op XX %."

Screens/gordijnen/rolluiken

Openen/sluiten van een screen (gordijn of rolluik).

"Open/sluit <naam van de uitgang>."

Openen/sluiten van alles screens (gordijnen of rolluiken) in een groep.

"Open/sluit gordijnen/rolluiken <naam van de groep>." 

Openen/sluiten van alle screens (gordijnen of rolluiken) in een woning.

"Open/sluit alle gordijnen/rolluiken" 

Ventilatie

Aan-/uitzetten van ventilatie.

"Zet <naam van de uitgang> aan/uit."

Scenarios

Een scenario oproepen.

"Start <naam van het scenario>."

Temperatuur

De temperatuur vragen in een zone (en zijn gevraagde waarde indien deze anders is).

"Wat is de temperatuur in <naam van de zone>?"

Verlaag/verhoog de temperatuur in een zone.

"Verlaag/verhoog  de temperatuur in <naam van de zone> met XX graden."

Verlaag/verhoog de temperatuur in alles zones.

"Verlaag/verhoog de temperatuur met XX graden."

Temperatuur instellen in een zone.

"Zet de temperatuur in <naam van de zone> op XX graden."

Temperatuur instellen in alle zones.

"Zet de temperatuur op XX graden"

Audio

Aan-/uitzetten van een zone.

"Zet <naam van de zone> aan/uit."

Aan-/uitzetten van alle zones.

"Zet audio aan/uit in." 

Opmerkingen

  1. Als u later wijzigingen aanbrengt in de configuratie van de domotica, moet u DOBISS loskoppelen van Google Home en opnieuw koppelen om de nieuwste instellingen van kracht te laten worden.
  2. Een temperatuurwijziging via Google Home is 1 uur actief.
  3. DOBISS beheert temperaturen in stappen van 0,1 ° terwijl Google Home in stappen van 0,5 ° werkt.
Integraties

IFTTT

Versie 2.20 of hoger is vereist van de DOBISS NXT server.

Wat is IFTTT?

IFTTT staat voor "If This Then That", wat zo veel betekent als "Eerst Dit Dan Dat", een heel eenvoudige actie-reactie logica dus. Het is een online dienst die toelaat om verschillende systemen, toestellen, apps, online diensten met elkaar te koppelen met eenvoudige automatisaties ("Applets" genoemd). Zo'n IFTTT Applet kan je zelf aanmaken en bevat altijd 1 trigger (IF) en 1 actie (THEN) die dan uitgevoerd zal worden.

DOBISS service activeren op IFTTT

  1. Ga naar https://ifttt.com en log in met je IFTTT account of registreer voor een nieuwe account
  2. Ga naar https://ifttt.com/dobiss 
  3. Klik op de Connect knop
  4. Vul uw domein en API key in (u vindt de API key terug op de configuratie homepagina van uw NXT)
  5. Klik op Connect
  6. Als de verbinding gemaakt is, krijgt u een melding bovenaan: "Service connected successfully!"

Applets maken met DOBISS

  1. Klik rechtsboven op uw avatar
  2. In het dropdown menu klik je op Create
  3. Klik op de + naast This om een trigger in te stellen

  4. Hier kan u DOBISS NXT combineren met andere IFTTT compatibele toestellen in uw woning (Somfy, Daikin, Philips Hue, Fibaro, Logitech Harmony, Honeywell, TP-Link, ...)

DOBISS NXT: Triggers (IF)

  1. Scenario is launched: zodra het gekozen DOBISS scenario geactiveerd wordt, zal deze IFTTT applet gestart worden
    1. Bij scenario 'Woning verlaten', zet ik mijn Daikin AC units uit
    2. Bij scenario 'Gaan slapen', zet ik mijn TV uit via Logitech Harmony
    3. Bij scenario 'Te warm binnen', doe ik mijn Somfy zonnewering dicht
    4. Bij scenario 'Verlichting uit', zet ik al mijn Philips Hue lampen uit
  2. Flag has changed: een vlag in uw DOBISS installatie werd gewijzigd naar ON of OFF en zal op dat moment de IFTTT applet starten
    1. Integratie van een draadloos stopcontact via 2 IFTTT applets: (1) Als de vlag 'Stopcontact TV' UIT staat, schakel dan de TP-link draadloze plug UIT. (2) Als de vlag wijzigt naar AAN, schakel de draadloze plug dan AAN.

DOBISS NXT: Actions (THEN)

  1. Execute scenario: voor het gekozen DOBISS scenario uit
    1. Indien mijn Netatmo alarm activeert, start dan mijn DOBISS scenario 'Paniek'
    2. Indien het raam in de living open gaat (detectie via Fibaro Raamsensor), activeer dan 'Verwarming living UIT'
  2. Turn flag ON or OFF: zet een vlag in uw DOBISS installatie AAN of UIT
    1. Monitor en gebruik de status van raam- en/of deursensoren door een vlag aan te zetten bij het openen en uit bij het sluiten (2 IFTTT applets).
  3. Turn output ON or OFF: zet 1 uitgang van een DOBISS module AAN of UIT
Integraties

Developer API

Doel

De API van de NXT server is gecreëerd om integraties vanuit andere systemen mogelijk te maken.

Technologie

Activeren

De API is standaard uitgeschakeld.

Om de API te activeren, log je in op de NXT als administrator en ga je naar de 'Algemene instellingen'. Onder 'API' kan je de API activeren en de geheime gedeelde sleutel terugvinden voor het coderen van de JWT (JSON Web Token), nodig om verbinding te maken met de API.

Domein

De API is zowel lokaal (http://dobiss.local of http://[ip-adres]) bereikbaar als via de cloud naam van je NXT server (https://[mijndomein].mydobiss.com).

Indien je via de cloud werkt, is het gebruik van een beveiligde verbinding verplicht (HTTPS en WSS).

Authenticatie

De authenticatie gebeurt door het uitwisselen van een JWT (JSON Web Token) die gecodeerd moet worden met de gedeelde geheime sleutel die je terugvindt in de instellingen van je NXT server.

Door de geldigheid van de JWT te beperken in de tijd, kan je ervoor zorgen dat - zelfs al wordt de JWT onderschept - hij slechts beperkte tijd gebruikt zal kunnen worden. Zodra de geldigheid van de JWT verstreken is, zal de toegang geweigerd worden.

Het is uiteraard belangrijk om de geheime gedeelde sleutel (JWT secret key) nooit te delen of zichtbaar te maken.

Voorbeelden: Node.js

REST API

var jwt = require('jsonwebtoken');
var secret = 'sdfsljdflsjefolz496879846879sf7z6e8f4z9';
var token = jwt.sign({name:'my_application'}, secret, {expiresIn: "24h" });

var https = require('https');
var options = {
  host: 'my_domain.mydobiss.com',
  path: '/api/local/discover',
  headers: {'Authorization': 'Bearer ' + token }
};

callback = function(response) {
  var str = '';
  //another chunk of data has been received, so append it to `str`
  response.on('data', function (chunk) {
    str += chunk;
  });

  //the whole response has been received, so we just print it out here
  response.on('end', function () {
    console.log(str);
  });
}

https.request(options, callback).end();

WebSockets API

const WebSocket = require('ws');
var jwt = require('jsonwebtoken');
var secret = 'sdfsljdflsjefolz496879846879sf7z6e8f4z9/8e7f6z8e74f';
var token = jwt.sign({name:'my_application'}, secret, {expiresIn: "24h" });

const ws = new WebSocket('wss://my_domain.mydobiss.com/sockets/api', {headers : { "Authorization": "Bearer " + token}});

REST API

GET /api/local/discover

Geeft de lijst terug van alle uitgangen, scenario's, automatisaties, logische condities, temperatuurzones, audio zones en vlaggen.
De uitgangen zijn ingedeeld in logische groepen (cfr. touch layout), alle andere zijn gegroepeerd per type.

Request
Response

Structuur

Voorbeeld

{
    "groups": [
        {
            "group": {
                "id": 0,
                "name": "No group"
            },
            "subjects": [
                {
                    "name": "Input  1.10",
                    "address": "1",
                    "channel": "9",
                    "type": "1",
                    "tags": "1.10",
                    "icons_id": "100",
                    "dimmable": false
                }
            ]
        },
        {
            "group": {
                "id": "1",
                "name": "Gelijkvloers",
                "icons_id": "0",
                "color": null,
                "image": null,
                "weight": "0"
            },
            "subjects": [
                {
                    "name": "Eetkamer",
                    "address": "4",
                    "channel": "0",
                    "type": "16",
                    "tags": "4.1",
                    "icons_id": "0",
                    "dimmable": true
                },
                {
                    "name": "Living",
                    "address": "4",
                    "channel": "1",
                    "type": "16",
                    "tags": "4.2",
                    "icons_id": "0",
                    "dimmable": true
                }
            ]
        },
        {
            "group": {
                "id": 201,
                "name": "Scenarios"
            },
            "subjects": [
                {
                    "name": "Paniek",
                    "address": 201,
                    "channel": "2",
                    "type": 201,
                    "tags": "2",
                    "icons_id": 201,
                    "dimmable": false
                },
                {
                    "name": "Woning verlaten",
                    "address": 201,
                    "channel": "1",
                    "type": 201,
                    "tags": "1",
                    "icons_id": 201,
                    "dimmable": false
                }
            ]
        },
        {
            "group": {
                "id": 202,
                "name": "Automations"
            },
            "subjects": [
                {
                    "name": "Afwezigheid",
                    "address": 202,
                    "channel": "2",
                    "type": 202,
                    "tags": "2",
                    "icons_id": 202,
                    "dimmable": false
                },
                {
                    "name": "Gordijnen",
                    "address": 202,
                    "channel": "3",
                    "type": 202,
                    "tags": "3",
                    "icons_id": 202,
                    "dimmable": false
                }
            ]
        },
        {
            "group": {
                "id": 203,
                "name": "Logical conditions"
            },
            "subjects": [
                {
                    "name": "Afwezigheid AAN",
                    "address": 203,
                    "channel": "1",
                    "type": 203,
                    "tags": "1",
                    "icons_id": 203,
                    "dimmable": false
                },
                {
                    "name": "Donker buiten",
                    "address": 203,
                    "channel": "2",
                    "type": 203,
                    "tags": "2",
                    "icons_id": 203,
                    "dimmable": false
                }
            ]
        },
        {
            "group": {
                "id": 204,
                "name": "Temperature"
            },
            "subjects": [
                {
                    "name": "All zones",
                    "address": 204,
                    "channel": 255,
                    "type": 204,
                    "tags": "*",
                    "icons_id": 204
                },
                {
                    "name": "Badkamer",
                    "address": 204,
                    "channel": "4",
                    "type": 204,
                    "tags": "4",
                    "icons_id": 204,
                    "dimmable": false
                },
                {
                    "name": "Living",
                    "address": 204,
                    "channel": "3",
                    "type": 204,
                    "tags": "3",
                    "icons_id": 204,
                    "dimmable": false
                }
            ]
        },
        {
            "group": {
                "id": 205,
                "name": "Audio"
            },
            "subjects": [
                {
                    "name": "Keuken",
                    "address": 205,
                    "channel": "4",
                    "type": 205,
                    "tags": "4",
                    "icons_id": 205,
                    "dimmable": false
                },
                {
                    "name": "Living",
                    "address": 205,
                    "channel": "3",
                    "type": 205,
                    "tags": "3",
                    "icons_id": 205,
                    "dimmable": false
                }
            ]
        },
        {
            "group": {
                "id": 206,
                "name": "Flags"
            },
            "subjects": [
                {
                    "name": "Alarm",
                    "address": 206,
                    "channel": "2",
                    "type": 206,
                    "tags": "2",
                    "icons_id": 206,
                    "dimmable": false
                }
            ]
        }
    ],
    "temp_calendars": [
        {
            "id": "1",
            "enabled": null,
            "name": "Thuis",
            "created": "2007-01-01 02:41:59"
        },
        {
            "id": "2",
            "enabled": null,
            "name": "Minimum",
            "created": "2007-01-06 01:39:05"
        }
    ],
    "audio_sources": {
        "4": {
            "1": "Radio 1",
            "2": "Studio Brussel"
        },
        "3": {
            "1": "Radio 1",
            "2": "Studio Brussel"
        }
    }
}
GET /api/local/status

Geeft de status terug van het volledige systeem, 1 module of 1 uitgang.

Request
{
     "address"   : OPTIONEEL, adres van de module of het NXT actie adres (>200),
     "channel"   : OPTIONEEL, module uitgang (start bij 0) of NXT uitgang nummer (start op 1)
}
Response

Structuur

De gevraagde status als een array (zie Websockets API) of een waarde (indien address en channel meegestuurd werden).

POST /api/local/action

Om een actie uit te voeren in je DOBISS domotica systeem, post je de actie als een Json object in de body van je request naar dit eindpunt.

Request
{
     "address"   : VERPLICHT, adres van de module of het NXT actie adres (>200),
     "channel"   : VERPLICHT, module uitgang (start bij 0) of NXT uitgang nummer (start op 1),
     "action"    : VERPLICHT, actie id (0 = uit, 1 = aan, 2 = schakelen) // zie lijst van acties
     "option1"   : dimmer: waarde (0-100) / audio: volume (0-100) / temperatuur: stel temperatuur (0 = 5.0°C - 250 = 30.0°C) in of kalender (ID)
     "option2"   : dimmer: soft start/stop (0-254) / audio: bron / temperatuur: periode (0xFE = altijd / 0 = tot volgende actie / X = X x 15 minuten)
     "delayon"   : 
     	{
     	   "value" : 0..120	,	1..90	,	120/150/180..900	,	960/720/780..1440
           "unit"  : "s"	, 	"min"	,	"min"				,	"min"
        }
     "delayoff"  :
        {
           "value" : 0..120	,	1..90	,	120/150/180..900	,	960/720/780..1440
           "unit"  : "s"	, 	"min"	,	"min"				,	"min"
        }
     "condition" : 
        {   
           "id"    : ID van de logische conditie die nagekeken moet worden voor de uitvoering,
           "operator": 'true' or 'false'
     }
}
Response

Status van het element na het uitvoeren van de actie (bij vertraagd uitvoeren van de actie, zal deze status niet kloppen).

{
    "new_status": 0
}

Websockets API

Eenmaal verbonden met de Websockets API, zal deze elke status update in real-time doorsturen naar alle verbonden clients (push).
Structuur

De status bestaat uit 2 delen:

1. Status van alle verbonden uitgangsmodules (relais, dimmers, enz)

Per module een array met de status voor elk kanaal

{
  "2":[0,0,0,0,0,0,0,0,0,0,0,0],
  "3":[0,0,0,0,0,0,0,0,0,0,0,0]
}

2. Status van alle NXT elementen (temperatuur, audio, vlaggen, enz)

Een object met als "key" het kanaal en als "value" de status van dit element (dit kan een getal of een object zijn.

{
  "202":{"2":"0","3":"1","8":"1","5":"1","4":"0","7":"0","9":"0","1":"1","6":"0","10":"0"},
  "0":{"0":255,"1":255,"2":255,"10":0,"11":0,"12":0,"13":0,"14":0,"15":0,"16":0,"17":0,"18":0,"19":0,"20":0,"21":0,"22":0,"23":0,"30":0},
  "205":{
    "1":{"status":0,"volume":13,"source":0,"extra":"","system":"sonos"},
    "2":{"status":0,"volume":29,"source":3,"extra":"","system":"sonos"}
  },
  "204":{
    "4":{"status":0,"temp":"25.9","asked":"15.0","time":-30,"calendar":"2","cooling_status":null,"cooling_asked":null,"cooling_time":null},
    "3":{"status":0,"temp":"26.7","asked":"15.0","time":-30,"calendar":"2","cooling_status":null,"cooling_asked":null,"cooling_time":null}
  },
  "206":{"1":"0","2":0,"3":"0","4":0,"5":"0","6":"0","7":"0","8":"0","9":"0","10":"0","11":"0","12":"0"}
}

Soms worden deze 2 delen samen doorgestuurd, maar meestal worden ze apart verstuurd.

Lijsten

Subject types
0 NXT server DO5520
1 Inputmodule DO5480
4 DALI module DO5460
8 Relaismodule DO5411 / DO5475
16 Universele dimmodule DO5450
24 0-10V module DO5470
     
201 Scenario's  
202 Automatisaties  
203 Logische condities  
204 Temperatuur  
205 Audio  
206 Vlaggen  
207 RGB sturing  
208 Meldingen  
Acties
0

Uit

1 Aan
2 Schakelen aan/uit
3 Start dimmen
4 Stop dimmen
5 Knipperen en AAN (delayOn = interval / delayOff = totale duur)
6 Knipperen en UIT (delayOn = interval / delayOff = totale duur)
7 Knipperen en starttoestand (delayOn = interval / delayOff = totale duur)
8 -
9 Aan via PIR
10 Aan (ms)
104 Skip bron (alleen voor audio)
110 Activeer kalender (alleen voor temperatuur)
Integraties

Koppeling met digitale meter Fluvius

Om de koppeling te maken tussen uw DOBISS NXT server en de digitale meter van Fluvius heeft u een P1-interface nodig.

U moet de P1 poort van uw digitale meter eerst activeren via de website van uw netbeheerder (https://www.fluvius.be/nl/thema/meters-en-meterstanden/digitale-meter/maak-je-meter-slim)

Aansluiten interface

  1. Sluit de interface aan op de bijgeleverde usb voeding en steek deze in een stopcontact in de meterkast.
  2. Verbind de interface met uw lokaal netwerk met behulp van de bijgeleverde netwerkkabel.
  3. Sluit de interface met de bijgeleverde 'telefoonkabel' aan op de P1 poort van de slimme meter.
  4. Zoek het IP adres van de interface op met een netwerk scan app zoals Advanced IP Scanner of Fing (Android - iOS). De interface is herkenbaar aan zijn hardware MAC-adres dat begint met 72:b8:ad:14.

Instellen DOBISS NXT

  1. Log in op je DOBISS NXT server en ga naar de configuratiepagina's.
  2. Ga verder naar 'Algemene instellingen' te vinden in het menu onder
  3. Klap de titel 'Energie' open en vul daar het IP adres in van de interface.
  4. Vanaf nu zal uw DOBISS NXT server continu de data van uw digitale meter uitlezen en bijhouden.

Consulteren energie data

Zodra u het IP adres heeft toegevoegd in de instellingen, zal in de touch interface van uw DOBISS NXT (na het vernieuwen van de pagina) een nieuwe groep zichtbaar zijn: "Energie".

Hier vindt u de volgende waarden terug (zodra er voldoende data beschikbaar is):

Automatisaties op basis van afname/injectie

De nieuwe groep 'Energie' vindt u ook terug bij het instellen van een 'voorwaarde' bij zowel automatisaties als logische condities.

Voor zowel de afname als de injectie kan de huidige waarde vergeleken worden (< of >) met een waarde tussen 0 en 20000.

Deze waarden zijn uitgedrukt in Watt.

Voorbeeld automatisatie

Bij het maken van een automatisatie dient men er rekening mee te houden dat de injectie beïnvloed wordt door het in- of uitschakelen van extra verbruikers. Bijvoorbeeld, indien er 1200W injectie is en men schakelt een verbruiker in van 1000W, zal de injectie bij de volgende update terugvallen tot 200W.

Indien men meerdere toestellen wil inschakelen, kan men daarom best met vertraagde acties en logische condities werken om ervoor te zorgen dat de verbruikers één voor één worden ingeschakeld op voorwaarde dat er genoeg productie beschikbaar is:

Zodra de injectie vermindert of er zelfs afname ontstaat, moet men de verbruikers opnieuw één voor één gaan uitschakelen:

Tips & Tricks

Korte artikels over hoe je veel gevraagde instellingen best kan integreren in de NXT server.

Tips & Tricks

Automatisatie buitenverlichting

Van zonsondergang tot zonsopgang

's Ochtends en 's avonds

Vast start uur en eind uur

Tips & Tricks

Automatisatie voor rolluiken e.d.

Met zonsopgang en -ondergang

Omhoog met lichtcel en tijdsperiode

Tips & Tricks

Scenario voor jaloezieën met kantelen

Scenario: naar beneden en gekanteld
  1. Maak een scenario "Open kantelen" met 1 actie:
    1. Lamellen omhoog: AAN voor 500 milliseconden

  2. Maak een scenario "Jaloezieën beneden en open gekanteld" met 2 acties:
    1. Lamellen omlaag: AAN
    2. Vertraagd aan van scenario "Lamellen open kantelen" (23 seconden vertraagd om zeker te zijn dat de jaloezïeën helemaal beneden zijn eerst)

Timers hangen uiteraard af van uw specifieke situatie en moeten per installatie bepaald worden.

FAQ

Hierin vind je de meest voorkomende Dobiss-vragen met hun antwoorden.

FAQ

Module vervangen

Heb je een defecte module in je installatie die je wil vervangen door een nieuw exemplaar. Volg deze stappen om de nieuwe module toe te voegen zonder dat je alles opnieuw moet configureren:

  1. Backup downloaden!!!
  2. Module die je wil vervangen verwijderen via de configuratie

  3. Pagina vernieuwen (F5 of knopje in je browser)
  4. Nieuwe module adresseren (deze zal het eerste vrije adres krijgen: hoogste adres + 1)

  5. Adres wijzigen van de nieuwe module naar het adres van de te vervangen module


    1. als je stap 3 niet hebt uitgevoerd, zal je origineel adres niet in deze dropdown lijst staan, dus dan moet je eerst even de pagina vernieuwen
  6. Wachten tot de export gedaan is
  7. Algemene instellingen > Project herstellen

  8. De NXT server zal alle configuratie opnieuw beginnen te exporteren