Het upgraden van uw OpenAPS (Open Artificial Pancreas System) naar de nieuwste hardware- en softwareversies kan de lusprestaties aanzienlijk verbeteren, de veiligheidskenmerken verbeteren en nieuwe mogelijkheden ontgrendelen. Aangezien OpenAPS een community-gedreven DIY closed-loop systeem is, brengt elke update verfijningen uit ervaring en klinisch onderzoek in de praktijk. Echter, het upgradeproces vereist zorgvuldige planning om downtime- of configuratiefouten te voorkomen. Deze gids biedt praktisch, stap voor stap advies om u te helpen een soepele upgrade uit te voeren, terwijl de systeembetrouwbaarheid wordt gehandhaafd.

Voorbereiding voor de upgrade

Bespaart u tijd voordat u een hardware aanraakt of een enkele opdracht uitvoert. Een grondige pre-upgrade checklist minimaliseert risico's en zorgt ervoor dat u alles hebt wat nodig is voor een succesvolle overgang. De upgrade zelf kan een paar uur duren, maar de planningsfase kan gemakkelijk een week duren als u nieuwe componenten moet bestellen of wachten op feedback van de gemeenschap over compatibiliteitsproblemen.

Inventarisatie van uw huidige systeem

Documenteer elk onderdeel van uw huidige OpenAPS-opstelling. Let op het Raspberry Pi-model (bv. Pi 3, Pi Zero W, Pi 4, of Pi 5), het radioapparaat (bv., Explorer board, RileyLink, of mmtlm stick), het pompmodel (bv., Medtronic 722, 723, 754, of nieuwer), en de continue glucose monitor (CGM) transmitter (Dexcom G6, G7, Medtronic Guardian, Libre via bridge). Ook de softwareversienummers van het besturingssysteem (Raspbian versie, kernel), loop algoritmen (oref0 versie en release-tag) en Nightscout (cgm-remote-monitor commit) registreren. Deze inventaris helpt u de compatibiliteit met de doelopwaardering te verifiëren. Bijvoorbeeld, oudere oref0 versies (bv., 0.6.x) zijn onverenigbaar met Pi 4 zonder extra patches, en sommige radio-apparaten vereisen specifieke firmware branches.

Onderzoekscompatibiliteit en introductienotities

OpenAPS ontwikkelt zich snel. Bezoek de officiële oref0 GitHub repository[ en de OpenAPS website[] om de release notes voor de versie te lezen die u van plan bent te installeren. Let goed op eventuele deprecatiemeldingen, nieuwe hardwarevereisten of configuratiewijzigingen. Bijvoorbeeld, nieuwere oref versies (beginnend met 0.7.x) introduceerde geavanceerde maaltijdhulp, wat het inschakelen van voorkeuren vereist. Ook de verschuiving van Node.js 10 naar Node.js 14 kan oudere scripts breken. Controleer community forums op ]Discourse[ voor gebruikerservaringen met uw exacte hardwarecombinatie. Bekijk ook de GitHub problemen voor bekende bugs in de doelversie .

Alles back-uppen

Maak een volledige back-up van uw huidige systeem. Dit omvat:

  • Configuratiebestanden: Kopieer voorkeuren.json, autosens.json, pompinstellingen en eventuele aangepaste profielen. Sla ze op naar een veilige locatie buiten het apparaat, zoals een cloudopslagmap of een USB-stick.
  • SD kaartafbeelding: Gebruik tools zoals Win32 Disk Imager (Windows), dd (Linux/Mac), of Raspberry Pi Imager back-upfunctie om een exacte afbeelding van uw Raspberry Pi
  • Nightscoutgegevens: Zorg ervoor dat uw Nachtscout-site volledig gesynchroniseerd en geback-upt is. Exporteer database records indien mogelijk met behulp van MongoDB's commando. Bevestig ten minste dat de laatste dagen van glucose- en behandelingsgegevens zichtbaar zijn op uw Nachtscout-pagina.
  • Pump- en CGM-instellingen: Let op uw huidige basale tarieven, insuline-koolratio's, gevoeligheidsfactoren en actieve insulineduur. Hoewel deze onveranderd blijven door software-upgrades, voorkomt een schriftelijke verwijzing dat er toevallig een verkeerde configuratie ontstaat bij het opnieuw invoeren van profielen.

Hulpmiddelen en middelen verzamelen

Voor hardware-upgrades, assembleer de benodigde gereedschappen: een kleine Phillips schroevendraaier, anti-statische polsband, pincet voor truien, en een betrouwbare voeding die voldoende ampère kan leveren (bijv. 5V/3A voor Pi 4, 5V/2.5A voor Pi 3). Voor software-upgrades, zorg ervoor dat u SSH-toegangsreferenties, een stabiele internetverbinding en een secundair apparaat (laptop of telefoon) met een terminalemulator (zoals PuTTY of de ingebouwde terminal op macOS/Linux). Download alle firmware-bestanden of upgradescripts van tevoren om onderbrekingen te voorkomen . Openbare Wi-Fi verbindingen zijn niet betrouwbaar voor grote downloads. Bereid ook een microSD-kaartschrijver en een reservekaart als u van plan bent om een nieuwe installatie te testen voordat u zich inzet op uw productiesysteem.

Berekenen van hardware-upgrade

Het upgraden van hardwarecomponenten kan de levensduur van uw systeem verlengen en de verwerkingssnelheid, batterijduur en connectiviteit verbeteren. Echter, elke componentverandering introduceert potentiële storingspunten en vereist vaak het herconfigureren van radiocommunicatie, stroombeheer en fysieke behuizingen. Plan hardware-upgrades gedurende een periode waarin u een dag handmatig diabetesbeheer kunt betalen, omdat u mogelijk terug moet keren als er problemen met de compatibiliteit optreden.

De Raspberry Pi upgraden

De Pi 4 is een extra functie, zoals een Night. De pinout en de power requirements (Pi Zero, Pi 3) naar een Pi 4 of Pi Zero 2 W zijn geschikt voor een betere processorsnelheid en een beter geheugen, waardoor de lusberekeningslatentie wordt verminderd. Als u overschakelt naar een Pi 4, heeft u mogelijk een nieuwe case nodig, een USB-C voedingsadapter en mogelijk een ander radioapparaat als uw huidige pinout gebruikt op de Pi pinout (bijv. Explorer HAT gebruikt GPIO0 en GPIO1 op de Pi 3 maar vereist een remapping op Pi 4). Gebruik de officiële Raspberry Pi documentatie[] voor bedradingsdiagrammen. Controleer of alle randverbindingen (radio, CGM ontvanger, display) correct zitten voordat u de motor aandoet. Als u een display gebruikt (zoals een PiTFT), dan zorgen de bestuurders voor de compatibiliteit met de nieuwe Pi's kernversie. Veel gebruikers vinden dat de Pi Zero 2 W een goede balans van een laag energieverbruik en voldoende stroomverbruik biedt, terwijl de

Radioapparaat upgrades

De radio-installatie communiceert met uw insulinepomp. De populaire opties zijn het Explorerbord, RileyLink en de mmtlm-stick. Bij het upgraden naar een nieuwer model, zorgt ervoor dat het uw pompfrequentie ondersteunt (bijv. 916 MHz voor US Medtronic pompen, 868 MHz voor EU). Controleer het apparaat ..firmware compatibiliteit . Sommige vereisen specifieke versies van de Subg Rfspy firmware. Volg de fabrikant knipperinstructies zorgvuldig. Bijvoorbeeld, het Explorer board verwacht een firmware update via het ] script. Na de installatie, voer de opdracht om communicatie te verifiëren. Als u upgraden van een RileyLink naar de nieuwere RileyLink 433, let erop dat de radioband alleen kan verschillen .

CGM en sensorupdates

Als u uw CGM-zender (bijv. van een Dexcom G6 naar G7 of van een Medtronic Enlite naar Guardian 4) upgrade, controleer dan of de OpenAPS-lus het nieuwe dataformaat kan interpreteren. Sommige nieuwere CGM's kunnen een bijgewerkte brugsoftware of aangepaste plugins nodig hebben. De Dexcom G7 gebruikt bijvoorbeeld Bluetooth Low Energy (BLE) en een ander dataprotocol dan de G6, die een eigen 916 MHz-radio gebruikt. De OpenAPS-gemeenschap biedt vaak ondersteuning voor nieuwe hardware binnen weken na release, maar u moet mogelijk een apart bridgescript uitvoeren (zoals )) en uw Nightscout-uploaderconfiguratie aanpassen. Test altijd de CGM-gegevensstroom in Nightscout voordat u de automatische modus › opnieuw gebruikt, controleer dan dat de glucosewaarden elke 5 minuten en de voorspelde pijlen correct worden gegenereerd. Als u een libre-sensor gebruikt met een brug, controleer dan of de MiaoMiao of Bubble-firmware uploader up-date is.

Perifere verbeteringen

Overweeg het upgraden van uw stroombron (bijvoorbeeld een batterijpakket met een hogere capaciteit, zoals een 10.000 mAh Anker PowerCore), het toevoegen van een real-time klokmodule (zoals de DS3231) voor betrouwbare tijdwaarneming, of het vervangen van een oudere SD-kaart door een snellere, duurzamere (bijv. SanDisk Extreme Pro A2). Deze niet-essentiële upgrades kunnen gegevenscorruptie voorkomen en reboottijden verminderen. Een real-time klok is vooral belangrijk als uw Pi soms verliest internetconnectiviteit . zonder NTP, klokdrift veroorzaakt door stroomonderbrekingen kan leiden tot onjuiste lus berekeningen. Evenzo, een SD-kaart met hogere IOPS (input/output operaties per seconde) vermindert de kans op corruptie tijdens frequente schrijf om bestanden in te loggen. Als u een Pi Zero 2 W, overwegen een USB-C stroomvoorziening met een spanning gladmakende capacitor om bruinouts tijdens radiotransmissie te voorkomen.

Software en firmware upgrades

Software-updates brengen verbeterde algoritmen, beveiligingspatches en nieuwe functies zoals geavanceerde maaltijd-assist of hybride gesloten-lus modes. Het proces varieert afhankelijk van uw huidige setup. Voer altijd software-upgrades tijdens een venster wanneer u het systeem kunt controleren voor ten minste een uur om onverwacht gedrag te vangen.

Bijwerken van het lusalgoritme (Oref0)

De kern van OpenAPS is de software voor oref (open referentie) . Om te updaten, SSH in uw Raspberry Pi en navigeren naar de map oref0. Voer om de nieuwste code op te halen, vervolgens uit te voeren om afhankelijkheden te updaten. Na de update, moet u mogelijk opnieuw uitvoeren om eventuele nieuwe configuratieopties toe te passen. Het script zal vragen stellen over uw hardware en voorkeuren . Houd uw back-up configuratie bestand handig om consequent te antwoorden. Let op vragen over nieuwe functies . Bijvoorbeeld, het inschakelen [[FLT:]] vereist een compatibele versie en geschikte insuline gevoeligheidsinstellingen. Na het opnieuw opstarten van setup, reboot het apparaat en controleer de lus op fouten. Als u afhankelijkheidsconflicten tegenkomt, probeer dan de npm cache met [[FLT:]] te verwijderen. Voor retrying springen (e.g., 0.7.x naar 0.7.x), is het vaak veiliger om een nieuwe installatie uit te voeren op een nieuwe kaart, dan

Nachtscout-integratie bijwerken

Als uw Nightscout site zelf wordt gehost, update dan de componenten ervan (MongoDB, Node.js, en de cgm-remote-monitor code) naar de laatste stabiele versies. Gebruik het commando op uw Nightscout server en voer ]. Controleer of de API-tekens geldig blijven en dat het uploader script (vaak op de Pi) gegevens correct verzendt. Test door tijdelijk de functie

Radio-firmware knipperen

Uw radioapparaat moet de firmware van OpenAPS aanpassen. Voor de Explorer board is de standaard firmware Subg Rfspy. Download het laatste uit het officiële repository[. Gebruik een knipperende tool zoals (op Pi) of het [] script. Zorg ervoor dat het apparaat wordt aangedreven en de juiste pin verbindingen worden gemaakt. Als u een RileyLink gebruikt, kunt u het via het gereedschap op macOS of Windows laten knipperen. Na het knipperen, draaien om de radiomodule te bevestigen. Als u fouten over onjuiste baud rate of apparaat niet vindt, controleer dan het seriële pad (bijv. voor Explorer, voor mmtlm) om het bestand in uw te bevestigen. Sommige nieuwe Pi-modellen kunnen door te

Aangepaste configuratieoverdracht

Bij het upgraden van software, uw aangepaste voorkeuren (doelbereik, ISF, basale tarieven) overleefden het algemeen omdat ze in afzonderlijke JSON-bestanden worden opgeslagen. Echter, soms verandert het bestand schema. Vergelijk uw oude ] met de standaard template die in de nieuwe release wordt verstrekt. Voeg eventuele nieuwe instellingen die geavanceerde functies regelen (bijv. ). Gebruik een JSON validator zoals of een online hulpmiddel om syntaxfouten te voorkomen. Wees vooral voorzichtig met komma's en aanhalingstekens .Een ontbrekende komma kan ervoor zorgen dat de gehele OpenAPS-service niet start. OpenAPS-service opnieuw starten na het bewerken door te draaien . Als u een aangepaste gebruikt, controleer dan de insuline-actiecurvewaarden (bijv., DIA) zijn nog steeds binnen het verwachte bereik .

Validatie na upgrade

Na de upgrade, neem niet alles werkt. Voer systematische controles om de veiligheid en prestaties te controleren voordat u op het systeem voor ongemonitord gebruik. Reserveer ten minste twee uur voor validatie, en houd een log van eventuele afwijkingen.

Systeemdiagnose en -logs

Controleer de OpenAPS loop log door het uitvoeren van . Kijk naar foutmeldingen, waarschuwingen, of ongebruikelijke vermeldingen zoals

Functionele test

Handmatig testen van elk subsysteem:

  • Pump control: Gebruik het commando ,9]] met een zeer kleine dosis (0,05 U) om een nauwkeurige levering en reactie te bevestigen. Controleer of het pompscherm binnen één minuut correct wordt bijgewerkt en dat de bolus in de nachtscout verschijnt. Ook de testpomp wordt opgeschort via (suspen gedurende 30 minuten) en vervolgens .
  • CGM-waarden: Controleer of er binnen 5 minuten na een sensortransmissie nieuwe CGM-waarden in Nightscout verschijnen. Controleer met de CGM-ontvangers native display. Als u Dexcom gebruikt, test de brug dan door een dummy-vingerstokbehandeling te plaatsen om te zien of deze uploadt.
  • Loopstatus: Observeer de lus. Het systeem moet een temp basaal binnen 4-5 minuten na het ontvangen van een nieuwe glucose-lezing genereren. Gebruik ] om de huidige aanbevolen dosis te zien. Bevestig dat de voorgestelde basale snelheid overeenkomt met uw verwachtingen gezien de huidige glucosetrend.
  • Alarmeringen en waarschuwingen: Simuleer een laag voorspelde glucose-gebeurtenis door tijdelijk je huidige glucosewaarde te verhogen (via de Nachtscout-behandeling) of je gevoeligheidsinstellingen aan te passen. Zorg ervoor dat pompschors- en gebruikersmeldingen werken (bijv. via Nightscout pushover of SMS). Test het hoorbare alarm op de Pi als je een zoemer hebt ingesteld.

Veiligheidscontrole

Controleer of uw noodbeveiligingen operationeel zijn. Controleer de waakhondtimer (indien geconfigureerd) herstart het systeem na een crash door handmatig het proces op te hangen met (voorzichtig). Bevestig dat de .max basale en ..max break breaks in voorkeuren nog steeds correct zijn ingesteld . . Opwaardering herstart deze soms naar standaard (bijv., max basale kan gaan van 2.0 U/h terug naar 0,5 U/h). Bekijk de instelling .disable loop . Als u wilt handmatig te controleren insuline voor een tijdje na upgrades. Houd een handmatig back-upplan (syringes, insulinepen) toegankelijk tijdens de eerste tests. Controleer ook of uw CGM laag-glucose alarmdrempels nog steeds actief zijn in Nightscout .

Problemen oplossen van gemeenschappelijke problemen

Zelfs met zorgvuldige planning, kunnen problemen ontstaan. Hier zijn oplossingen voor frequente upgrade horden, getrokken uit de gemeenschap ervaring en officiële probleemoplossing gidsen.

Opstartfouten of SSH-timeout

Als de Raspberry Pi niet opstart na hardwarewijzigingen, controleer dan de voeding (5V/3A aanbevolen voor Pi 4, 5V/2.5A voor Pi 3). Zorg ervoor dat de SD-kaart volledig wordt ingevoegd. Als SSH uitvalt, sluit u een monitor en toetsenbord om te controleren op foutmeldingen. Veel voorkomende oorzaken: beschadigde SD-kaart (herbeeldd vereist via de back-up afbeelding), onjuiste GPIO-bedrading (korte circuit), of incompatibele hardware revisie (bijv., Pi 4 rev 1.1 vs 1.2 kunnen verschillende GPIO pull-up weerstanden vereisen). Start vanaf uw back-up afbeelding om functionaliteit te herstellen. Als de groene LED knippert, kan de kernel worden gemist .

Radiocommunicatiefouten

Als het luslog een aanhoudende

Gegevensonverenigbaarheid in Nachtscout

Dubbele ingangen of ontbrekende gegevens zijn vaak afkomstig van klokdrift. Na een hardware-upgrade, hersynchroniseer de Pi

Terugzetten naar een vorige versie

Als de upgrade kritieke problemen introduceert, keer dan terug naar uw back-up. Herstel de SD-kaart afbeelding met dezelfde tool die gebruikt wordt voor back-up (bijv. Win32 Disk Imager of ). Als alternatief, als software-alleen problemen bestaan, kunt u terugrollen oref0 via git: dan opnieuw uitvoeren . Test altijd het teruggedraaide systeem voor ten minste 24 uur voordat u het stabiel acht. Als u niet kunt terugdraaien, voer een nieuwe installatie van de vorige versie op een nieuwe SD-kaart, overdracht van uw voorkeuren, en test opnieuw.

Communautaire steun en middelen

De OpenAPS-community is een van de grootste troeven van de gemeenschap. Ga samen met andere gebruikers op de hoogte blijven en hulp krijgen wanneer nodig. De collectieve ervaring van duizenden gebruikers heeft het upgradeproces gevormd, en de meeste valkuilen zijn goed gedocumenteerd.

Officiële documentatie en GitHub

De OpenAPS documentatie repository bevat setup guides, tips voor het oplossen van problemen en gedetailleerde uitleg van elk algoritme. Lees de ..hoe te upgraden .. pagina en de release-specifieke migratie notities. De GitHub problemen tracker is ook een goede plek om te zoeken naar soortgelijke upgrade problemen. Bijvoorbeeld, veel gebruikers ondervonden de ..oref0-setup: geen pomp gevonden fout na het upgraden naar 0.7.1, en een fix werd gedocumenteerd in probleem #2345. Bookmark de repository en controleer op nieuwe problemen voordat u startte met uw upgrade.

Forums en chatplatforms

Doe mee met het OpenAPS Discourse forum om vragen te stellen en ervaringen te delen. De community is actief en responsief. Voor real-time hulp biedt het #openaps kanaal op de Looped Discord server onmiddellijk advies voor probleemoplossing. Bij het plaatsen, inclusief uw hardwaremodel, softwareversie en relevante log-knippets. Veel gebruikers onderhouden ook persoonlijke blogs met gedetailleerde upgrade walkthroughs . . Zoek naar

Blijft geïnformeerd over updates

Abonneer u op de OpenAPS-nieuwsbrief of volg de blog op de officiële website. Bekijk de GitHub repositories voor .Laat de meldingen vrij door te klikken op de knop .Watch . Voorraadberichten voor oref0 en gerelateerde repositories. Proactief zijn over aankondigingen helpt u bij het plannen van upgrades tijdens periodes waarin u zich een paar uur van hands-on aandacht kunt veroorloven. De gemeenschap post vaak vroege waarschuwingen over grote veranderingen, zoals de overgang van Python 2 naar Python 3 of de deprecatie van bepaalde radio hardware. Planning rond deze aankondigingen kan u redden van gedwongen te worden in een upgrade op een ongemakkelijke tijd.

Laatste gedachten

Het upgraden van uw OpenAPS-systeem is een lonend proces dat uw DIY-closed-loop op de snijkant van diabetes management technologie houdt. Door een gestructureerde aanpak . grondige voorbereiding, zorgvuldige hardware en software-updates, systematische validatie en het benutten van community kennis .U minimaliseert risico's en maximaliseert u de voordelen. Onthoud dat veiligheid komt eerst: altijd testen upgrades gedurende een tijd waarin u uw glucose nauwkeurig kunt controleren, en nooit aarzelen om terug te keren als iets voelt off. Met elke upgrade, uw systeem wordt robuuster, nauwkeurig en afgestemd op uw unieke behoeften. De OpenAPS-gemeenschap begrijpt dat perfectie niet het doel is; veerkracht en veiligheid zijn. Neem uw tijd, documenteer elke stap, en u zal een systeem bouwen dat groeit met u.