MHB CERBO GX - USB INSTALLATIE ============================= Veilige voorbereiding --------------------- 1. Maak de USB-stick leeg en formatteer hem als FAT32. 2. Gebruik op de Cerbo GX een actuele stabiele Venus OS-versie. Venus OS Large en Node-RED zijn NIET nodig. 3. Laat alle bestaande Victron- en BMS-beveiligingen ingeschakeld. Installeren ----------- 1. Kopieer deze drie bestanden naar de hoofdmap van de USB-stick: - venus-data-40-mhb-cerbo-agent-v1.tgz - venus-data-40-mhb-cerbo-agent-v1.tgz.sha256 - mhb-installatie.json Maak mhb-installatie.json voor iedere nieuwe Cerbo apart via de knop 'Nieuwe installatie' in MHB Beheer. Daarmee worden de installatienaam en de medewerker van de eerste installatie veilig vastgelegd. 2. Steek de USB-stick in de uitgeschakelde Cerbo. 3. Start de Cerbo en wacht totdat hij volledig is opgestart en de installatie gereedmelding heeft gegeven. 4. Verwijder de USB-stick en herstart de Cerbo. 5. De MHB-agent start automatisch. Een bestaande Node-RED blijft actief totdat de beheerder de nieuwe agent in MHB Beheer aan de juiste klant koppelt. Wat de installatie doet ----------------------- - De agent leest Victron D-Bus rechtstreeks en gebruikt veel minder geheugen en processortijd dan Node-RED. - De Cerbo maakt zelf een unieke sleutel aan. Er staat geen klantwachtwoord op de USB-stick. - Bij de eerste aanmelding stuurt de agent zijn VRM Portal-ID mee. MHB Beheer zoekt daarbij de numerieke VRM Site-ID en de gekoppelde WeFact-klant op. - De koppeling is eerst alleen-lezen. In MHB Beheer moet een beheerder de Cerbo bewust aan de voorgestelde installatie en WeFact-klant koppelen. - Pas nadat die koppeling is bevestigd stopt de agent de lokale Venus OS Node-RED-service. De flowbestanden worden niet verwijderd en de Victron- beveiligingen blijven actief. - Spanning, stroom, vermogen, SOC, cellen, temperaturen en alarmstatus van de JK-BMS'en worden in ongeveer 3 tot 4 seconden uitgelezen en verzonden. De volledige veilige D-Bus-inventaris wordt iedere minuut opnieuw opgebouwd. - Een Waveshare USB Quad RS485 wordt automatisch als vier poorten herkend. Alle vier poorten worden gelezen; een lege vierde poort is geen fout. - Accu's op verschillende Waveshare-poorten mogen hetzelfde Modbus-adres hebben; de combinatie van fysieke poort en adres blijft in MHB Beheer uniek. - Vanaf agent 1.2.0 kunnen volgende agentversies door een admin op afstand vanuit MHB Beheer worden geïnstalleerd. Iedere update wordt via HTTPS opgehaald, gecontroleerd met SHA-256 en automatisch teruggedraaid als de nieuwe agent niet binnen twee minuten online komt. - Alle ondersteunde JK-BMS-instellingen worden via de Cerbo uitgelezen. Een wijziging wordt alleen na een opdracht uit MHB Beheer geschreven en altijd direct uit hetzelfde register teruggelezen. - Vanaf agent 1.4.28 blijven bekende accu's bij een nieuwe scan gekoppeld aan hun fysieke RS485-poort en adres. "Alle adressen opnieuw scannen" vernieuwt ook de BMS-identificatie, bijvoorbeeld na vervanging van een BMS. Tot een serienummer opnieuw is bevestigd, wordt geen oud serienummer hergebruikt. - Vanaf agent 1.4.33 is de gecontroleerde firmwareprocedure niet meer aan een specifieke klant of een specifiek serienummer gebonden. Ondersteund is de bewezen combinatie JK-PB2A16S20P, hardware 19A, firmwarebestand 19.34. Andere modellen, hardwarefamilies en bestanden zijn hiermee niet automatisch getest of vrijgegeven. De Pi-firmwareprocedure staat los van deze Cerbo-uitbreiding. - De beheerder kiest en bevestigt steeds precies een accu. MHB legt apparaat, serienummer, fysieke poort, Modbus-adres, huidige versie en bestand vast. Master en slaves op adres 0 t/m 15 worden op dezelfde manier behandeld; andere uniek geadresseerde accu's mogen op dezelfde RS485-bus blijven zitten. Tijdens de procedure wachten andere MHB-uitlezingen en opdrachten. Gebruik tegelijk geen ander programma op de geselecteerde RS485-poort. - De parallelle accu's en RS485-kabels mogen aangesloten blijven. Zorg wel voor stabiele voeding en maximaal 2 A stroom op de gekozen accu; MHB pauzeert alle andere communicatie op die RS485-poort tijdens de onderhoudsopdracht. Na toestemming bewaart MHB de oorspronkelijke laad- en ontlaadschakelaars, schakelt beide uit en leest ze terug. Pas met bevestigde identiteit, geldig firmwarebestand en veilige actuele metingen begint de firmwareoverdracht. - Na overdracht controleert MHB dezelfde accu en de nieuwe firmwareversie. Alleen na geslaagde controles worden de oorspronkelijke schakelstanden hersteld en opnieuw teruggelezen. Een schakelaar die vooraf UIT stond blijft UIT. MHB toont afzonderlijk voorbereiding, overdracht, controle en herstel. - Een fout geeft geen nieuwe firmwareflash of blind herinschakelen. Bij een vertraagde teruglezing houdt de accu beide schakelaars veilig Uit. MHB biedt dan een afzonderlijke herstelopdracht aan die eerst accu, serienummer, poort en firmware controleert en alleen de opgeslagen schakelstanden terugzet. - Dezelfde versie opnieuw installeren vereist een aparte, bewuste bevestiging. Een downgrade wordt niet automatisch toegestaan. - Lokale BMS- en Victron-beveiligingen worden niet uitgeschakeld of vervangen. Controle -------- De installatiestatus staat op de Cerbo in: /data/mhb-cerbo/install-status.json De actuele verbindingsstatus staat in: /data/mhb-cerbo/agent-status.json De kleine service heet /service/mhb-cerbo-agent. Een storing in de agent wijzigt geen Victron- of BMS-beveiliging; het systeem blijft lokaal zelfstandig veilig.