Schrijf zelf een Modbus-apparaatintegratie voor SmartgridOne. Een praktische handleiding voor het maken van drivers, met video, het toewijzen van metingen, besturingslogica en testen.
Deze gids is bedoeld voor installateurs en integrators die op basis van de Modbus-registerkaart van een fabrikant zelf een apparaatintegratie willen schrijven. De gids behandelt het maken van een driver, het toewijzen van metingen, het implementeren van besturingsopdrachten en het valideren van het resultaat.
en uw zon deden voor u.Aangepaste Modbus-driversMet de module Aangepaste Modbus-drivers kun je zelf een Modbus-apparaat integreren met SmartgridOne, zonder dat een Eniris-programmeur nodig is om de integratie op te bouwen. In de commissioning-interface van een controller beschrijf je hoe je het apparaat herkent, de metingen uitleest en het bedient. Deze gids gebruikt een praktische voorbeeld: de ingebouwde Playground-hybride omvormer.
Bekijk de volledige walkthrough hierboven: ongeveer 30 minuten, met Nederlandse ondertiteling en hoofdstukken. Het volgt de commissioning-interface van het aanmaken van een driver tot testen, opslaan en hergebruiken.
In de SmartgridX, open de SmartgridOne-weergave, ga naar Instellingen, kies uw controller en open Controllerconfiguratie toe te wijzen. Zie Toegang tot de commissioninginterface voor de volledige toegangsinstructies.
In de commissioning-interface selecteer je Apparaten → Aangepaste Modbus-drivers → Beheer aangepaste drivers.
Eerst controleer of er een geschikte bestaande driver beschikbaar is. Om er zelf een te bouwen, verkrijg de Modbus-handleiding of registerkaart van de fabrikant voor het exacte model en firmware. Het moet de registeradressen, gegevenstypen, eenheden, schaal en toegestane lees/schrijfbewerkingen toelichten. Voor controle heb je ook de benodigde volgorde voor het inschakelen van externe bediening, het schrijven van setpoints en terugkeren naar automatische bediening.
Je hebt de verbindingsgegevens van het apparaat nodig: een IP-adres, TCP-poort en Modbus-adres, of de RS485-poort van de controller en de seriële instellingen van het apparaat. De Playground laat je de workflow leren voordat je fysieke apparatuur aansluit.
Klik op Nieuwe driver, geef een herkenbare naam, kies het merk en selecteer de Playground-hybride omvormervoorbeeld. Dit levert een werkende driver om te verkennen. Je kunt ook starten met een leeg ondersteund apparaattype wanneer je je eigen integratie bouwt.
Open Test, kies Playground-hybride omvormer onder Verbinding om op te testen, en klik op Verbind. Controleer Herkenning, en inspecteer vervolgens de metingen en de gesimuleerde installatie. Registerlijst opent naast de editor de registerkaart van het voorbeeld.
De Playground simuleert een 10 kW driefasen-omvormer met 8 kW PV, een 10 kWh batterij, een netmeter en een back-up-uitgang. Zonlicht en belastingen veranderen zodat je de metingen en het bedieningsgedrag kunt observeren. Dit zijn gesimuleerde apparaten binnen de controller; de adressen en instellingen van het voorbeeld gelden specifiek voor hen.
De editor is als volgt georganiseerd:
| Tab | Wat u hier doet |
|---|---|
| Driver | Beschrijf de driver, documentatie, standaardverbindingen en installatievragen. |
| Apparaatsstructuur | Definieer het apparaat en zijn componenten, metingen, identificatie en bedieningsopties. |
| Commando-logica | Vertaal commando's naar de vereiste registerbewerkingen van het apparaat. |
| Test | Probeer de huidige driver en bekijk de metingen en commando's. |
| Live | Volg apparaten die de driver al gebruiken. |
| Historiek | Vergelijk en haal opgeslagen versies op. |
In de Driver, voer de ondersteunde modelinformatie in en geef aan welk protocoldocument de driver volgt. Een duidelijke naam, modelslijst en documentversie helpen een andere installateur bepalen of de driver bij hun apparatuur past.
Stel de verbindingsstandaardwaarden van de fabrikant in. Voor Modbus TCP onderscheid je de netwerkpoort van het Modbus-adres, ook wel de unit ID genoemd. Voor RS485 moeten de baud-rate, pariteit, data bits en stop bits overeenkomen met het apparaat. Aanvullende zoekinstellingen kunnen helpen apparatuur met andere configuraties te vinden, maar extra combinaties laten een zoekactie langer duren.
DrivergebruikersinvoerLaat de installateur vragen beantwoorden bij het toevoegen van een apparaat. Bijvoorbeeld, de Playground vraagt of de omvormer-energieteller is aangesloten en of de batterij vanuit het net mag opladen. Gebruik deze invoer wanneer één driver meerdere installatieconfiguraties moet ondersteunen.
In de Apparaatsstructuur, maak de componenten aan die het apparaat daadwerkelijk blootlegt. Een hybride omvormer kan een PV-totaal, MPPT-ingangen, strings, een totaal aan batterijen en individuele batterijen bevatten. Voeg een energiemeter of back-upondersteuning toe wanneer het apparaat die metingen levert.
Selecteer een component en wijs de registers toe. Elke rij identificeert wat wordt gemeten, het adres, het registertype, het datatype, de schaalfactor en de eenheid. Geef voor vermogen en stroom ook aan wat een positieve registerwaarde betekent. Plaats batterijmetingen op de batterij en PV-metingen op het juiste PV-component.
Begin met herkenning en enkele metingen die u kunt controleren. Voor de voorbeeldomvormer zorgen spanning L1-N en frequentie voor plausibele herkenningswaarden. Voeg vervolgens vermogen, laadstatus van de batterij, energietellers en andere nuttige waarden toe. Bestuurde componenten hebben de bijbehorende vermogensmetingen nodig, hetzij rechtstreeks, hetzij afgeleid van geschikte metingen.
Houd identificatie en nominale waarden gescheiden van live metingen. Fabrikant, model, serienummer en nominaal vermogen beschrijven het apparaat; metingen geven de huidige werking ervan weer. Wijs statuswaarden zoals Running of Standby afzonderlijk toe van alarmcodes of -bits. Geef alarmen een duidelijke tekst en de juiste ernst, zodat een installateur het probleem kan begrijpen.
Kies de besturingsoptie die overeenkomt met de registers in het protocol van de fabrikant. Dit bepaalt welke setpoints en limieten SmartgridOne aan de commandologica levert.
De Playground gebruikt Batterijsetpoint en PV-limiet. SmartgridOne kan een laad- of ontlaadvermogen voor de batterij aanvragen en de PV-productie onafhankelijk begrenzen. Andere apparaten ondersteunen mogelijk alleen een batterijsetpoint, alleen een PV-limiet, een AC-setpoint voor de omvormer of alleen monitoring zonder besturing.
Een setpoint vraagt een doelwaarde aan; een limiet bepaalt een maximum. De PV beperken tot 4 kW betekent niet dat er 4 kW wordt geproduceerd wanneer er onvoldoende zonlicht beschikbaar is. Maak ook onderscheid tussen de AC-aansluitingen van de omvormer en het netaansluitpunt van de installatie: een register dat het ene aanstuurt, stuurt niet automatisch ook het andere aan.
Configureer de watchdog vanuit het protocol. Hiermee kan apparatuur terugvallen op de eigen werking als er geen opdrachten meer binnenkomen. Het Playground-voorbeeld schrijft 300 seconden naar countdown-register 1005 en herhaalt de opdrachten elke 20 seconden. Andere apparaten vereisen een veranderende teller, afwisselende waarden of het omschakelen van een bit. De reset van de watchdog en de instelling voor de time-out kunnen afzonderlijke registers zijn.
In de Commando-logica, volg de ononderbroken grijze lijnen tussen de driehoekige poorten om de volgorde van de acties te zien. Gekleurde stippellijnen tussen ronde poorten dragen waarden over. Deze twee verbindingen verklaren zowel wat er gebeurt als welke waarde wordt gebruikt.
De Playground demonstreert de volgende conversies:
| Actie | Voorbeeldimplementatie |
|---|---|
| Afstandsbediening inschakelen | Schrijf 1 te schrijven naar register 1000, een waarde zonder teken van 16 bits, met functie 6. |
| Schrijf het batterijsetpoint | Keer het teken om met Negate, en schrijf vervolgens een waarde met teken van 32 bits vanaf 1001, waarbij functie 16 wordt gebruikt voor de twee registers. |
| Schrijf de PV-limiet | Converteer het aangevraagde vermogen naar een percentage van de PV-capaciteit van 8 kW van het voorbeeld en schrijf dat percentage vervolgens naar 1003. |
| Geef het apparaat vrij | In de Vrijgave-logica, schrijf 0 op 1000 om automatisch eigenverbruik te herstellen. |
SmartgridOne gebruikt positief batterijvermogen voor het laden. Het voorbeeldapparaat gebruikt positief vermogen voor het ontladen. Een laatste verzoek om met +3.000 W te laden wordt in het register daarom −3.000. Het volledige voorbeeld beperkt wijzigingen bovendien tot 2 kW per volgende opdracht, waardoor tussenwaarden kunnen verschillen terwijl het gevraagde vermogen wordt bereikt.
Voor PV geeft 4 kW gedeeld door 8 kW 50%. Gebruik de juiste referentie: de PV-capaciteit van het voorbeeld is 8 kW, terwijl het nominale AC-vermogen van de omvormer 10 kW bedraagt. Een echt apparaat kan een andere referentie of schaal gebruiken.
Controleer naast het normale verloop ook de foutafhandeling. Als het inschakelen van de afstandsbediening bijvoorbeeld mislukt, is het mogelijk niet geschikt om daarna het setpoint te schrijven. De On exception-uitgang kan een mislukte bewerking afhandelen; zonder een verbonden vervolg stopt die uitzondering de opdracht. Beëindig normale paden met Return from command.
De Test-tabblad voert de driver uit die momenteel in de editor wordt weergegeven, inclusief niet-opgeslagen wijzigingen. Begin met de Playground en herhaal de controles vervolgens op de beoogde apparatuur.
Bij een fysiek apparaat hebben testopdrachten en handmatige schrijfbewerkingen echte gevolgen. Selecteer apparatuur die tijdens de test mag worden aangestuurd. De interface identificeert ook verbindingen die niet gelijktijdig met een geïnstalleerd apparaat kunnen worden gebruikt.
Gebruik voor diagnose handmatige registeruitlezingen en Ruwe frames. Een ongeldige functie duidt op een niet-ondersteunde bewerking; een ongeldig data-adres wijst op een ongeldig of ontoegankelijk register; een ongeldige datawaarde betekent dat de gevraagde waarde niet wordt geaccepteerd. Controleer dit aan de hand van het protocol voordat u de driver wijzigt.
Los de problemen in de lijst op en controleer uw testresultaten. Klik vervolgens op Opslaan. Een concept met blokkerende problemen kan worden opgeslagen, maar kan niet worden gebruikt om een nieuw apparaat toe te voegen. Als er een bestaande laatste geldige driverversie beschikbaar is, blijft die actief.
Een apparaat toevoegen opent de normale wizard met deze driver geselecteerd. De opgeslagen versie wordt gebruikt, dus sla eerst op. Kies de daadwerkelijke verbinding en beantwoord de vragen voor de installateur. Controleer na het toevoegen van het apparaat opnieuw de herkenning, metingen en werking. Het opslaan van een driverdefinitie en het toevoegen van apparatuur aan de installatie zijn afzonderlijke stappen.
Gebruik Live om geïnstalleerde apparaten, hun metingen en de meest recente opdrachten te bekijken. Drivers die al door apparaten worden gebruikt, worden alleen-lezen geopend. Na Bewerken ontgrendelen kunnen wijzigingen gevolgen hebben voor die apparaten. Het tijdelijk toepassen van commandologic op één apparaat verschilt van Opslaan, waarmee de opgeslagen driver wordt bijgewerkt die door al zijn apparaten wordt gebruikt. Volg de meldingen in de editor wanneer een structurele of identificatiewijziging extra actie vereist.
Historiek Hiermee kunt u versies vergelijken en een benoemde momentopname vastzetten. Teruggaan naar deze versie herstelt deze als niet-opgeslagen wijzigingen; sla op om vanaf deze versie verder te gaan. Export downloadt de opgeslagen driver als JSON, zonder niet-opgeslagen wijzigingen. Gebruik Een driver importeren op een andere controller om deze opnieuw te gebruiken. Controleer of u een afzonderlijke kopie importeert of een bestaande driver vervangt. Voor een driver die een nieuwere engine vereist, is compatibele controllersoftware nodig. Distributie via de driverstore staat los van het opslaan op deze controller.
Gebruik het zero-based adres dat over de bus wordt verzonden. Als een handleiding de notatie voor holding-registers in de stijl van 40001 gebruikt, komt 40101 overeen met adres 100; trek deze basiswaarde niet af wanneer de handleiding al busadressen opgeeft.
Stem het datatype, de schaal, de eenheid en de woord-/bytevolgorde op elkaar af. Voor een register met stappen van 0.1 V betekent de ruwe waarde 2301: 230.1 V. Waarden met teken kunnen negatief zijn; waarden zonder teken niet. Configureer Geen waarde wanneer alleen voor speciale codes die door de fabrikant zijn gedocumenteerd.
Berekende metingen kunnen fasevermogens optellen of de DC-spanning vermenigvuldigen met de DC-stroom. Voor AC levert spanning maal stroom schijnbaar vermogen op, niet automatisch actief vermogen. Wiskunde- en logica-blokken passen opdrachten aan met conversies, voorwaarden, limieten of timing. Variabelen onthouden waarden tussen opdrachten; hun updates zijn beschikbaar voor de volgende opdracht en worden na een herstart van de controller gereset. Functies groeperen logica die u opnieuw wilt gebruiken.
Gebruik de (?)-knoppen voor uitleg over velden en blokken, en Help → Tutorial voor een begeleid voorbeeld. Help mij met AI een nieuwe driver te schrijven kan helpen een driver op basis van de handleiding voor te bereiden met Ask Niri. Controleer de resulterende adressen, conversies en besturingssequentie aan de hand van de documentatie van de fabrikant en uw testresultaten.