Documentatie
Hoe je de gateway aansluit, Modbus-apparaten toevoegt en het portaal gebruikt. Stap voor stap, met de schermen erbij.
Aan de slag
Van de doos tot de eerste waarden in het portaal, in zes stappen die je op volgorde volgt.
6 pagina’s
- Zo werkt ModbusCloudDe gateway leest je Modbus-apparaten uit en stuurt de waarden via de kabel of 4G naar het portaal, waar je ze bekijkt en bewaakt.
- Inloggen en je organisatie aanmakenLog voor het eerst in op het portaal en maak je organisatie aan, of sluit je aan bij de organisatie van een collega.
- Gateway aansluitenMonteer de gateway, sluit de antenne, de RS485-kabel en de netwerkkabel aan en zet er als laatste een voeding van 9 tot 57 V DC op.
- Gateway toevoegenKoppel een nieuwe gateway met zijn serienummer aan je organisatie en aan een klant, en zie wanneer hij online komt.
- Modbus-apparaten toevoegenVoeg Modbus-apparaten toe aan de gateway met automatisch zoeken, een template uit de bibliotheek of een eigen template.
- Controleren en opleverenControleer voor je vertrekt de waarden, de bewaking, de verbinding en de alarmmail, en leg vast wat je hebt ingesteld.
Gateway
Aansluiten, monteren en instellen van de gateway, met de technische gegevens erbij.
7 pagina’s
- Aansluitingen en specificatiesDe gateway heeft RS485 voor Modbus RTU, een LAN- en WAN-poort en 4G met een back-up-SIM, en werkt op 9 tot 57 V DC.
- Monteren en voeding aansluitenMonteer de gateway met de DIN-railkit op een DIN-rail van 35 mm en sluit een voeding van 9 tot 57 V DC aan op de voedingsklem.
- RS485 aansluitenSluit Modbus RTU-apparaten met drie aders aan op de gateway, doorgelust als één lijn met een afsluitweerstand van 120 Ω op beide uiteinden.
- Netwerk aansluiten via WAN en LANSluit de WAN-poort aan op het netwerk ter plaatse voor internet en de LAN-poort op een Modbus TCP-apparaat dat direct aan de gateway hangt.
- 4G en de back-up-SIMGeeft het netwerk ter plaatse geen internet, dan verstuurt de gateway via de back-up-SIM en leest hij niet sneller uit dan het SIM-interval.
- Gateway-instellingenWijzig de naam van een gateway, het adres van zijn klant, de instellingen van de RS485-bus en het SIM-interval voor 4G.
- Gateway loskoppelen of vervangenHaal een gateway uit je organisatie of zet een nieuwe op de plek van een kapotte, en bewaar eerst zijn configuratie en metingen.
Modbus-apparaten
Modbus-apparaten toevoegen en registers zo instellen dat de waarden kloppen.
9 pagina’s
- Automatisch zoekenLaat de gateway zelf de Modbus-apparaten op zijn RS485-bus en in zijn netwerk vinden en herkennen, en voeg ze daarna toe.
- Template uit de bibliotheek kiezenZoek het type op in de templatebibliotheek en voeg het Modbus-apparaat toe met de registers die al in de template staan.
- Modbus-apparaat staat niet in de bibliotheekLaat ModbusCloud de template kosteloos maken, voeg de registers zelf toe of lees de handleiding in met ModbusCloud Diagnostics.
- Eigen template aanmakenLeg de registers van een type Modbus-apparaat één keer vast in een template, kies hem bij elk volgend Modbus-apparaat en zet hem over als JSON.
- Adres en verbinding van een Modbus-apparaat instellenVul het slaveadres voor Modbus RTU of het IP-adres, de poort en het unit-ID voor Modbus TCP in, wijzig ze later of verwijder het Modbus-apparaat.
- Uitleesinterval kiezenStel per Modbus-apparaat in hoe vaak de gateway het uitleest, vanaf 1 seconde via de kabel en op 4G nooit sneller dan het SIM-interval.
- Registers instellenVoeg registers toe aan een Modbus-apparaat met functie, adres, datatype, eenheid, schaal en toegang, en wijzig of verwijder ze later.
- Registeradres uit de handleiding invullenReken een registernummer als 40001, 30010 of 0x0010 uit de handleiding om naar het adres en de functie die het portaal verwacht.
- Byte-volgorde en schaalfactor instellenStel per register de byte-volgorde van een 32-bit waarde en de schaal in, en controleer het resultaat met een waarde die je ter plaatse afleest.
Portaal
Dagelijks werken in het portaal, van live waarden en alarmen tot rapporten en je team.
19 pagina’s
- Indeling van het portaalHet portaal opent op Overzicht, met links het menu en bovenaan een balk voor zoeken, uitleg, taal, alarmen en je profiel.
- De gatewaypaginaWat de kop, het menu, de alarmbalk en de tabbladen van een gateway tonen, wie er mail krijgt bij alarmen en welke rol welke knop ziet.
- Waarden en grafieken bekijkenBekijk de live waarden per Modbus-apparaat en zet de historie van registers in een grafiek, van het laatste uur tot 30 dagen.
- Metingen downloadenDownload de metingen van alle registers van een gateway als CSV-bestand voor Excel, over 7 dagen, 30 dagen, 12 maanden of alles.
- Waarden berekenen met variabelenMaak op het tabblad Variabelen een formule over registers van een gateway, zoals een COP of het totale vermogen van drie fasen.
- Piek- en daltarief per kWh-meter instellenVerdeel het verbruik van een kWh-meter op het tabblad Tarief over piek- en daluren, met een indicatief bedrag, een maandrapport en een CSV.
- Zo werken alarmenEen alarm komt uit een alarmregel of de automatische bewaking, krijgt een ernst en blijft staan tot het is opgelost.
- Automatische bewakingVijf vaste controles bewaken de Modbus-apparaten en registers van een gateway, zonder dat je zelf alarmregels maakt.
- Alarmregel aanmakenMaak een alarmregel voor een register of een gateway, met de conditie, de ernst, de opties tegen valse alarmen en wie de mail krijgt.
- Alarm afhandelenBevestig een alarm, leg in een notitie vast wat je deed, los het op en laat je op een gekozen moment herinneren.
- Ontvangers van alarmmail instellenBepaal wie alarmmail krijgt via de organisatie, de alarmregel en de gateway, en kies per soort alarm of je zelf mail krijgt.
- Dashboard aanmakenMaak een dashboard aan en vul het met widgets die waarden van je gateways tonen of een waarde naar een register schrijven.
- Dashboard delen via een linkMaak een publieke link naar één dashboard, zodat iemand zonder account meekijkt, met of zonder wachtwoord.
- Rapporten aanmaken en inplannenStel een rapport samen uit grafieken, tabellen en alarmen, sla het op als PDF en laat het portaal elke dag, week of maand een link mailen.
- Automatiseringen aanmakenMaak een regel die een register schrijft, een webhook stuurt of mailt zodra een registerwaarde aan je voorwaarde voldoet.
- Registers aansturenVraag aansturen aan voor een gateway en schrijf daarna vanuit het portaal een waarde naar een register van een Modbus-apparaat.
- Klanten beherenMaak klanten aan, koppel elke gateway aan de juiste klant en houd per klant contact, adres en notities bij.
- Teamleden en rollenBekijk wat elke rol mag, nodig collega's uit of laat ze toe met een join-code of toegangsverzoek en wijzig of verwijder hun toegang.
- Organisatie en profiel instellenVul bij Organisatie de gegevens en de tijdzone van je bedrijf in en stel bij Mijn profiel je naam en de taal van je accountmails in.
Integraties
Je eigen software koppelen met de REST API en webhooks, met de API-referentie als naslag.
3 pagina’s
- REST API en webhooksHaal gateways, registers, historie en alarmen op in je eigen software en ontvang gebeurtenissen als webhook op je server.
- API-sleutel aanmakenMaak een API-sleutel met alleen de rechten die je koppeling nodig heeft, test hem in het portaal en trek hem in zodra hij niet meer nodig is.
- Webhook instellenVoeg een webhook toe die bij alarmen, gateways die offline of online gaan en automatiseringen een ondertekend bericht naar je systeem stuurt.
Diagnostics
Met het gratis desktopprogramma ModbusCloud Diagnostics lees je een Modbus-apparaat uit en zoek je storingen op locatie.
7 pagina’s
- ModbusCloud Diagnostics installerenDownload het gratis programma voor Windows of macOS, installeer het en start het de eerste keer, ook als het systeem een waarschuwing toont.
- Modbus-apparaat aansluiten en vinden met DiagnosticsVerbind je laptop via een USB-RS485-adapter of het netwerk met een Modbus-apparaat en laat Diagnostics de instellingen en het adres zoeken.
- Modbus-apparaat herkennen, waarden lezen en schrijvenLaat ModbusCloud Diagnostics het type van een Modbus-apparaat herkennen, lees de waarden live met naam en eenheid en schrijf een waarde naar een register.
- Handleiding van een onbekend Modbus-apparaat inlezenHaal de registertabel uit de handleiding met ModbusCloud Diagnostics, controleer hem op het Modbus-apparaat en bewaar hem als eigen apparaattype.
- Storing zoeken met Diagnose en de consoleLees in ModbusCloud Diagnostics af hoeveel aanvragen antwoord krijgen, wat elke fout betekent en welke bytes er over de kabel gaan.
- Loggen en exporteren met DiagnosticsLeg waarden van een Modbus-apparaat vast en exporteer ze als CSV of JSON, of zet een apparaattype om voor Home Assistant, ESPHome of het portaal.
- Oefenen met de simulatorLaat ModbusCloud Diagnostics een Modbus-apparaat uit de bibliotheek nabootsen en oefen zonder hardware, of test er je eigen software mee.
Problemen oplossen
Per symptoom de meest voorkomende oorzaken en wat je controleert.
12 pagina’s
- Inloggen lukt nietLos het op als het portaal je inloggegevens weigert, je uitnodiging niet meer werkt of je na het inloggen niet in je organisatie komt.
- Gateway komt niet onlineBlijft een gateway op Wacht op verbinding staan, controleer dan de opstarttijd, het serienummer, de stroom, de kabel, 4G en de firewall.
- Gateway is offlineEen gateway staat op Offline als het portaal enkele minuten niets van hem hoort, en je vindt de oorzaak in de stroom, het netwerk of het 4G-bereik.
- Modbus-apparaat geeft geen waardenControleer bij een Modbus-apparaat zonder waarden de registers, het adres, de businstellingen, de bedrading en bij Modbus TCP het netwerk.
- Waarden kloppen nietVind aan wat je ziet de oorzaak van een verkeerde waarde, zoals de byte-volgorde, de schaal, het adres, het datatype of de CT-verhouding.
- Antwoorden op RS485 vallen weg of zijn verminktMeestal ontbreekt de signaalmassa, kloppen de afsluitweerstanden niet, zit er een tweede master op de bus of wijkt de businstelling af.
- Melding bij het toevoegen of opslaan van een Modbus-apparaatWat de meldingen over adres, businstellingen en configuratie betekenen bij het toevoegen, opslaan of verwijderen van een Modbus-apparaat, en wat je dan doet.
- Automatisch zoeken vindt niet allesControleer rol, businstellingen, adres, netwerk en melding als automatisch zoeken een Modbus-apparaat mist, niet herkent of niet kan toevoegen.
- Waarden komen minder vaak binnen dan ingesteldVia de SIM leest de gateway niet sneller uit dan het SIM-interval, en ook de RS485-bus, oudere software of de historie per minuut spelen mee.
- Alarm gaat niet af, te vaak af of blijft openControleer de regel, de metingen en de status van het alarm als een alarm niet afgaat, te vaak afgaat of open blijft staan.
- Alarmmail of rapport komt niet aanControleer het spamfilter, de ontvangers, de eigen voorkeuren en de planning als een alarmmail of een ingepland rapport niet aankomt.
- Hulp vragenNeem contact op met support per mail, telefoon of WhatsApp, of met de feedbackknop in het portaal, en stuur de gegevens mee die support nodig heeft.
Beveiliging en data
Netwerkeisen, opslag, toegang en bewaartermijnen, voor IT-afdelingen en privacyvragen.
5 pagina’s
- Netwerkeisen voor de gatewayDe gateway heeft alleen uitgaand verkeer nodig, MQTT over TLS naar poort 8883 en verder DNS, NTP en ping.
- Waar je data staat en wie erbij kanJe metingen lopen via een broker in Frankfurt naar een database in Ierland, waar elke organisatie alleen haar eigen data ziet.
- Bewaartermijnen en je data meenemenMetingen blijven 365 dagen bewaard en na het einde van je licentie heb je nog 90 dagen om je data te exporteren.
- Inloggen en je account beveiligenWijzig je wachtwoord, log overal uit als je iets vreemds ziet en geef collega's niet meer toegang dan hun werk vraagt.
- VerwerkersovereenkomstDe verwerkersovereenkomst legt vast hoe ModbusCloud persoonsgegevens voor je verwerkt, met welke subverwerkers en hoe je hem los ondertekent.
Account en licentie
Licentie, 4G-data, bestellen en facturen, garantie en opzeggen.
5 pagina’s
- De portaallicentiePer gateway kies je een jaarlicentie van €149 of een eenmalige licentie van €495, allebei met alle functies van het portaal.
- 4G-data en kostenBij een jaarlicentie zit 4G-data tot 30 MB per maand erin, bij een eenmalige licentie betaal je €1 per maand bij gebruik of €95 voor tien jaar.
- Bestellen, account en facturenBestel gateways in de webshop op modbuscloud.com en vind je bestellingen en facturen daarna terug in het portaal.
- Garantie en geld terugOp de gateway zit 24 maanden garantie, en je krijgt je geld terug als hij binnen 100 dagen geen verbinding maakt met een Modbus-apparaat uit de bibliotheek.
- Opzeggen en je account laten verwijderenZeg een jaarlicentie per mail op tegen het einde van het lopende jaar en vraag bij Mijn profiel aan om je account te verwijderen.
API-referentie
Alle endpoints en webhooks van de REST API, met een sandboxsleutel om ze meteen te proberen.
Naar de API-referentieKom je er niet uit?
Mail of bel ons. Stuur het serienummer van de gateway mee, dan kunnen we direct meekijken.
Naar support