Pompe Accu-Chek Combo

Ce logiciel est un système “Do it yourself” (faire soi-même), et ce n’est pas un produit fini destiné à la mise sur le marché. Vous devez obligatoirement lire, apprendre et comprendre ce système, y compris la façon de l’utiliser. Ce logiciel ne fait pas toute la gestion de votre diabète pour vous, mais il peut améliorer votre diabète et votre qualité de vie si vous êtes prêt à y consacrer le temps nécessaire. Ne vous précipitez pas, mais laissez vous le temps d’apprendre. Attention, vous êtes le seul responsable de ce que vous faite avec ce système.

Configuration matérielle requise

  • Une pompe Roche Accu-Chek Combo (avec n’importe quel firmware, ils fonctionnent tous)
  • Un dispositif Accu-Chek Smartpix V1 ou Accu-Chek Realtyme, ainsi que le logiciel de configuration Accu-Chek 360. Sur demande Roche envoie gratuitement ces dispositifs Smartpix et la configuration logiciel à leurs clients (sauf en France, voir avec le prestataire).
  • Un téléphone compatible : un smarphone Android avec comme système LineageOS 14.1 (anciennement CyanogenMod) ou Android 8.1 (Oreo). LineageOS 14.1 (ou plus) doit être une version récente d’au moins juin 2017 car les changements nécessaires pour se connecter à la pompe Combo ont été mis en œuvre seulement à ce moment-là. Une liste de téléphones compatibles se trouvent dans le document AAPS Phones. Cette liste n’est pas une liste complète. Elle reflète l’expérience personnelle de quelques utilisateurs. Nous vous encourageons à partager également votre expérience et ainsi aider les autres.
  • Sachez que même si Android 8.1 permet de communiquer avec le Combo, des problèmes subsistent encore avec AAPS. Pour les utilisateurs avancés, il est possible d’effectuer l’appairage sur un téléphone rooté et de le transférer vers un autre téléphone rooté en utilisant ruffy/AAPS, qui doit aussi être rooté. Cela permet d’utiliser des téléphones avec un OS Android inférieure à 8.1 mais ça n’a pas été largement testé : https://github.com/gregorybel/combo-pairing/blob/master/README.md

Limitations

  • Les bolus étendus et les bolus mixtes ne sont pas pris en charge (voir Glucides étendus à la place)
  • Seulement un profil de basal est pris en charge.
  • Sélectionner un profil de basal autre que ‘Basal1’ sur la pompe, ou délivrer via la pompe des bolus ‘carré’ et ‘mixte’, interfère avec les DBT et force la boucle en mode ‘AGB’ pendant 6 heures car la boucle ne peut pas fonctionner en toute sécurité dans ces conditions.
  • Actuellement, il n’est pas possible de régler l’heure et la date de la pompe, donc les changements d’horaire doivent être effectués manuellement (vous pouvez désactiver la mise à jour automatique de l’heure du téléphone la veille au soir, puis changer l’heure le matin du téléphone et de la pompe pour éviter une alarme pendant la nuit).
  • Actuellement, seuls les débits de basals de 0,05 à 10 U/h sont supportés. Ceci s’applique également lors de la modification du profil, par exemple, lorsqu’il augmente à 200%, le taux basal le plus élevé ne doit pas dépasser 5 U/h car il sera doublé. De même, en réduisant à 50%, le taux basal le plus bas doit être au moins 0,10 U/h.
  • Si la boucle demande l’annulation d’un DBT en cours, le Combo fixera un DBT de 90% ou 110% pendant 15 minutes à la place. C’est parce que l’annulation d’un DBT provoque une alerte sur la pompe qui cause beaucoup de vibrations.
  • Occasionnellement (tous les deux jours ou plus), AndroidAPS risque de ne pas annuler automatiquement une alerte ‘TBR CANCELLED’, donc l’utilisateur doit s’en occuper (en appuyant sur le bouton actualiser dans AndroidAPS afin de transférer l’alarme à AAPS, ou en confirmant l’alerte sur la pompe).
  • La stabilité de la connexion Bluetooth varie en fonction du téléphones utilisés. La perte de connection provoque des alertes “pompe injoignable”. Si cette erreur survient, assurez-vous que Bluetooth est activé, puis appuyez sur le bouton Rafraichir dans l’onglet Combo pour voir si cela a été causé par un problème intermittent. Si aucune connexion n’est encore établie, le redémarrage du téléphone devrait normalement corriger cela. Il y a une autre solution si le redémarrage du téléphone n’a pas aidé. Il s’agit de presser un bouton sur la pompe (pour réinitialiser le Bluetooth de la pompe) afin que celle-ci accepte de nouveau les connexions du téléphone. A ce stade, il n’y a plus de solution pour remédier à la perte de connections. Donc, si vous voyez souvent ces erreurs, votre seule option est d’acquérir un autre téléphone connu pour fonctionner correctement avec AndroidAPS et le Combo (voir ci-dessus).
  • Un bolus délivré à partir de la pompe ne sera pas toujours détecté à temps (il faut vérifier à chaque fois que AndroidAPS est bien connecté à la pompe), et cela peut prendre jusqu’à 20 minutes dans le pire des cas. Les bolus sur la pompe sont toujours vérifiés avant un DBT élevé ou un bolus délivré par AAPS, mais en raison des limitations, AAPS refusera ensuite de délivrer le DBT/Bolus comme il a été calculé sous de fausses prédictions. (-> La solution est de ne pas délivrer de bolus via la pompe! Voir le chapitre Usage)
  • Le paramétrage d’un DBT sur la pompe doit être évité puisque la boucle assure le contrôle des DBT. La détection d’un nouveau DBT sur la pompe peut prendre jusqu’à 20 minutes et l’effet du DBT est seulement comptabilisé à l’instant où il est détecté, donc dans le pire des cas, il peut y avoir 20 minutes d’un DBT qui n’est pas pris en compte dans l’IA.

Paramètres

  • Configurez la pompe en utilisant le logiciel de configuration Accu-Chek 360. Si vous n’avez pas le logiciel, veuillez contacter votre prestataire en france ou la hotline Accu-Chek dans les autres pays. Ils envoient généralement aux utilisateurs enregistrés un CD ou une clé USB avec le logiciel de configuration de la pompe et un périphérique de connexion infrarouge USB SmartPix (le périphérique Realtyme fonctionne aussi si vous en avez). Ou cherchez sur un forum de votre pays.
    • Nécessaire (Encadré en vert dans les captures d’écran) :
      • Choisissez ou laissez la configuration du menu sur “Standard”, cela affichera uniquement les menus et actions pris en charge sur la pompe, et masquera ceux qui ne sont pas supportés par AAPS (bolus duo/carré, débits de base multiples) et qui entraînent une limitation du fonctionnement de la boucle lors de leurs utilisation, et donc ne permet pas une exécution sécurisée de la boucle.
      • Vérifiez le Quick Info Text est défini à “QUICK INFO” (sans les guillemets, trouvés sous Insulin Pump Options).
      • Paramétrez le DBT Maximum Adjustment à 500%
      • Désactivez Signal End of Temporary Basal Rate
      • Paramétrez le DBT Duration increment à 15min
      • Activez le Bluetooth
    • Recommandé (Encadré en bleu dans les captures d’écran)
      • Définissez une alarme de cartouche basse à votre goût
      • Configurez un bolus max adapté à votre thérapie afin de se protéger contre les bugs logiciel et matériel
      • De même, configurez une durée maximale de débit de basal temporaire DBT en tant que protection. Autorisez au moins 3 heures, puisque l’option de déconnecter la pompe pendant 3 heures défini un DBT à 0% pendant 3 heures.
      • Activez le verrouillage des touches sur la pompe pour empêcher les bolus via la pompe, surtout si la pompe a déjà été utilisée et que vous aviez l’habitude d’utiliser les bolus rapides.
      • Définissez un délai d’affichage et de menu aux valeurs minimales respectivement de 5,5s et 5s. Cela permet à AAPS de récupérer plus rapidement de situations d’erreur et réduit la quantité de vibrations qui peuvent se produire pendant ces erreurs.

Capture d’écran de réglages du menu utilisateur

Capture d'écran des paramètres DBT

Capture d'écran des paramètres de bolus

Capture d'écran des paramètres de cartouche d'insuline

  • Installez AndroidAPS comme décrit à la page wiki AndroidAPS.
  • Lisez bien le wiki pour comprendre comment configurer AndroidAPS.
  • Sélectionnez le plugin MDI dans AndroidAPS, surtout pas le plugin Combo à ce stade afin d’éviter que le plugin Combo n’interfère avec la Ruffy pendant le processus d’appairage.
  • Suivez le lien http://ruffy.AndroidAPS.org et clonez ruffy via git.
  • Installez la Ruffy et utilisez le pour appairer la pompe. Si elle ne fonctionne pas après plusieurs tentatives, passez à la branche pairing, appairez la pompe puis reprenez le fil de cette page. Notez que l’appairage doit seulement être lancé une fois, le traitement est un peu fragile et long car il peut y avoir plusieurs tentatives; Acquittez rapidement les notifications et si vous recommencez, supprimez de la liste Bluetooth du téléphone le dispositif pompe au préalable. Une autre option à essayer est d’aller dans le menu Bluetooth après l’initialisation du processus d’appairage (cela permet de maintenir le Bluetooth du téléphone détectable tant que le menu est affiché) et à revenir à Ruffy après la confirmation de l’appairage sur la pompe, lorsque la pompe affiche le code d’autorisation. Si vous n’avez pas réussi l’appairage de la pompe (disons après 10 tentatives), essayez d’attendre jusqu’à 10s avant de confirmer l’appairage sur la pompe (lorsque le nom du téléphone est affiché sur la pompe). If you have configured the menu timeout to be 5s above, you need to increase it again. Some users reported they needed to do this. Lastly, consider moving from one room to another in case of local radio interference. At least one user immediately overcame pairing problems by simply changing rooms.
  • When AAPS is using ruffy, the ruffy app can’t be used. The easiest way is to just reboot the phone after the pairing process and let AAPS start ruffy in the background.
  • If the pump is completely new, you need to do one bolus on the pump, so the pump creates a first history entry.
  • Before enabling the Combo plugin in AAPS make sure your profile is set up correctly and activated(!) and your basal profile is up to date as AAPS will sync the basal profile to the pump. Then activate the Combo plugin. Press the Refresh button on the Combo tab to initialize the pump.
  • To verify your setup, with the pump disconnected, use AAPS to set a TBR of 500% for 15 min and issue a bolus. The pump should now have a TBR running and the bolus in the history. AAPS should also show the active TBR and delivered bolus.

Why does pairing with the pump does not work with the app “ruffy”?

There are serveral possible reasons. Try the following steps:

  1. Insert a fresh or full battery into the pump. Look at the battery section for details. Make sure that the pump is very close to the smartphone.

Le Combo doit être proche du téléphone

  1. Turn off or remove any other bluetooth devices so they will not be able to establish a connection to the phone while pairing is in progress. Any parallel bluetooth communication or prompt to establish connections might disturb the pairing process.

  2. Delete already connected devices in the Bluetooth menu of the pump: **BLUETOOTH SETTINGS / CONNECTION / REMOVE** until 
    

    NO DEVICE is shown.

  1. Delete a pump already connected to the phone via Bluetooth: Under Settings / Bluetooth, remove the paired device “SpiritCombo

  2. Make sure, that AAPS not running in background the loop. Deaktivate Loop in AAPS.

  3. Now start ruffy on the phone. You may press Reset! and remove old Bonding. Then hit Connect!.

  4. In the Bluetooth menu of the pump, go to ADD DEVICE / ADD CONNECTION. Press CONNECT!* * Step 5 and 6 have to be in a short timing.

  5. Now the Pump should show up the BT Name of phone to select for pairing. Here it is importand to whait at least 5s 
    

    bevore you hit the select button on Pump. Otherwise the Pumpe will not send the Paring request to the Phone proberly.

    • If Combo Pump is set to 5s Screentime out, you may test it with 40s (original setting). From experiance the time between pump is showing up in phone until select phone is around 5-10s. In many other cases pairing just times out without successfully Pair. Later you should set it back to 5s, to meet AAPS Combo settings.
    • If the pump does not show the phone as a pairing device at all, your phone’s Bluetooth stack is probably not compatible with the pump. Make sure you are running a new LineageOS ≥ 14.1 or Android ≥ 8.1 (Oreo). If possible, try another smartphone. You can find a list of already successfully used smartphones under [AAPS Phones] (https://docs.google.com/spreadsheets/d/1gZAsN6f0gv6tkgy9EBsYl0BQNhna0RDqA9QGycAqCQc/edit#gid=698881435).
  1. At next Pump should show up a 10 digit security code. And Ruffy a screen to enter it. So enter it in Ruffy and you 
    

    should be ready to go.

  1. Reboot the phone.
  2. Now you can restart AAPS loop.

Utilisation

  • Keep in mind that this is not a product, esp. in the beginning the user needs to monitor and understand the system, its limitations and how it can fail. It is strongly advised NOT to use this system when the person using it is not able to fully understand the system.
  • Read the OpenAPS documentation https://openaps.org to understand the loop algorithm AndroidAPS is based upon.
  • Read the wiki to learn about and understand AndroidAPS http://wiki.AndroidAPS.org
  • This integration uses the same functionality which the meter provides that comes with the Combo. The meter allows to mirror the pump screen and forwards button presses to the pump. The connection to the pump and this forwarding is what the ruffy app does. A scripter components reads the screen and automates entering boluses, TBRs etc and making sure inputs are processed correctly. AAPS then interacts with the scripter to apply loop commands and to administer boluses. This mode has some restrictions: it’s comparatively slow (but well fast enough for what it is used for), and setting a TBR or giving a bolus causes the pump to vibrate.
  • The integration of the Combo with AndroidAPS is designed with the assumption that all inputs are made via AndroidAPS. Boluses entered on the pump directly will be detected by AAPS, but it can take up to 20 min before AndroidAPS becomes aware of such a bolus. Reading boluses delivered directly on the pump is a safety feature and not meant to be regularly used (the loop requires knowledge of carbs consumed, which can’t be entered on the pump, which is another reason why all inputs should be done in AndroidAPS).
  • Don’t set or cancel a TBR on the pump. The loop assumes control of TBR and cannot work reliably otherwise, since it’s not possible to determine the start time of a TBR that was set by the user on the pump.
  • The pump’s first basal rate profile is read on application start and is updated by AAPS. The basal rate should not be manually changed on the pump, but will be detected and corrected as a safety measure (don’t rely on safety measures by default, this is meant to detect an unintended change on the pump).
  • It’s recommended to enable key lock on the pump to prevent bolusing from the pump, esp. when the pump was used before and using the “quick bolus” feature was a habit. Also, with keylock enabled, accidentally pressing a key will NOT interrupt active communication between AAPS and pump.
  • When a BOLUS/TBR CANCELLED alert starts on the pump during bolusing or setting a TBR, this is caused by a disconnect between pump and phone, which happens from time to time. AAPS will try to reconnect and confirm the alert and then retry the last action (boluses are NOT retried for safety reasons). Therefore, such an alarm can be ignored as AAPS will confirm it automatically, usually within 30s (cancelling it is not problem, but will lead to the currently active action to have to wait till the pump’s display turns off before it can reconnect to the pump). If the pump’s alarm continues, automatic corfirmation failed, in which case the user needs to confirm the alarm manually.
  • When a low cartridge or low battery alarm is raised during a bolus, they are confirmed and shown as a notification in AAPS. If they occur while no connection is open to the pump, going to the Combo tab and hitting the Refresh button will take over those alerts by confirming them and show a notification in AAPS.
  • When AAPS fails to confirm a TBR CANCELLED alert, or one is raised for a different reason, hitting Refresh in the Combo tab establishes a connection, confirms the alert and shows a notification for it in AAPS. This can safely be done, since those alerts are benign - an appropriate TBR will be set again during the next loop iteration.
  • For all other alerts raised by the pump: connecting to the pump will show the alert message in the Combo tab, e.g. “State: E4: Occlusion” as well as showing a notification on the main screen. An error will raise an urgent notification. AAPS never confirms serious errors on the pump, but let’s the pump vibrate and ring to make sure the user is informed of a critical situation that needs action.
  • After pairing, ruffy should not be used directly (AAPS will start in the background as needed), since using ruffy at AAPS at the same time is not supported.
  • If AAPS crashes (or is stopped from the debugger) while AAPS and the pump were communicating (using ruffy), it might be necessary to force close ruffy. Restarting AAPS will start ruffy again. Restarting the phone is also an easy way to resolve this if you don’t know how to force kill an app.
  • Don’t press any buttons on the pump while AAPS communicates with the pump (Bluetooth logo is shown on the pump).