Medtrum Nano / 300U

These instructions are for configuring the Medtrum insulin pump.

תוכנה זו היא חלק מפתרון לבלב מלאכותי DIY ואינו מוצר אך דורש ממכם לקרוא, ללמוד ולהבין את המערכת, כולל את אופן השימוש בה. האחריות על השימוש במערכת היא עליכם בלבד.

Pump capabilities with AAPS

  • All loop functionality supported (SMB, TBR etc)

  • Automatic DST and timezone handling

  • Extended bolus is not supported by AAPS driver

Hardware and Software Requirements

  • Compatible Medtrum pumpbase and reservoir patches

    • Currently supported:

      • Medtrum TouchCare Nano with pumpbase refs: MD0201 and MD8201.

      • Medtrum TouchCare 300U with pumpbase ref: MD8301.

      • If you have an unsupported model and are willing to donate hardware or assist with testing, please contact us via discord here.

  • Version 3.2.0.0 or newer of AAPS built and installed using the Build APK instructions.

  • טלפון Android תואם עם חיבור בלוטות« (BLE)

  • חיישן סוכר רציף (CGM)

Before you begin

SAFETY FIRST Do not attempt this process in an environment where you cannot recover from an error (extra patches, insulin, and pump control devices are must-haves).

The PDM and Medtrum App will not work with a patch that is activated by AAPS. Previously you may have used your PDM or Medtrum app to send commands to your pump. For security reasons you can only use the activated patch with the device or app that was used to activate it.

This does NOT mean that you should throw away your PDM. It is recommended to keep it somewhere safe as a backup in case of emergencies, for instance if your phone gets lost or AAPS is not working correctly.

Your pump will not stop delivering insulin when it is not connected to AAPS Default basal rates are programmed on the pump as defined in the current active profile. As long as AAPS is operational, it will send temporary basal rate commands that run for a maximum of 120 minutes. If for some reason the pump does not receive any new commands (for instance because communication was lost due to pump - phone distance) the pump will fall back to the default basal rate programmed on the pump once the Temporary Basal Rate ends.

פרופילי בזאלי המתחילים בשעות לא עגולות אינם נתמכים ב-AndroidAPS. פרופיל ברירת המחדל ב-AndroidAPS אינו תומך במסגרת זמן של מינון בזאלי של 30 דקות אם אתם חדשים ב-AndroidAPS ואתם מגדירים את הפרופיל הבזאלי הבסיסי שלך בפעם הראשונה, חשוב לשים לב שמינונים שמתחילים בשעה לא עגולה אינם נתמכים, ותצטרכו להתאים את פרופיל הבזאלי שלך כך שמינון יתחיל בשעה עגולה. לדוגמה, אם יש מינון בזאלי של למשל 1.1 יחידות שמתחיל בשעה 09:30 ויש לו משך של שעתיים ומסתיים בשעה 11:30, זה לא יעבוד. יהיה עליכם לעדכן את המינון של 1.1 יחידות לטווח זמן של 09:00-11:00 או 10:00-12:00. Even though the Medtrum pump hardware itself supports the 30 min basal rate profile increments, AAPS is not able to take them into account with its algorithms currently.

0U/h profile basal rates are NOT supported in AAPS While the Medtrum pump does support a zero basal rate, AAPS uses multiples of the profile basal rate to determine automated treatment and therefore cannot function with a zero basal rate. A temporary zero basal rate can be achieved through the ”Disconnect pump“ function or through a combination of Disable Loop/Temp Basal Rate or Suspend Loop/Temp Basal Rate.

תצורה

CAUTION: When activating a patch with AAPS you MUST disable all other devices that can talk to the Medtrum pumpbase. e.g. active PDM and Medtrum app. Make sure you have your pumpbase and pumpbase SN ready for activation of a new patch.

Step 1: Select Medtrum pump

אפשרות 1: התקנות חדשות

If you are installing AAPS for the first time, the Setup Wizard will guide you through installing AAPS. Select “Medtrum” when you reach Pump selection.

If in doubt you can also select “Virtual Pump” and select “Medtrum” later, after setting up AAPS (see option 2).

Setup Wizard

אפשרות 2: בונה התצורה

On an existing installation you can select the Medtrum pump from the Config Builder:

On the top-left hand corner hamburger menu select Config Builder\ ➜\ Pump\ ➜\ Medtrum\ by selecting the Enable button titled Medtrum.

Selecting the checkbox next to the Settings Gear will allow the Medtrum overview to be displayed as a tab in the AAPS interface titled Medtrum. Checking this box will facilitate your access to the Medtrum commands when using AAPS and is highly recommended.

בונה התצורה

Step 2: Change Medtrum settings

Enter the Medtrum settings by tapping the Settings Gear of the Medtrum module in the Config Builder .

Medtrum Settings

Serial Number:

Enter the serial number of your pumpbase here as noted on the pumpbase. Make sure the serial number is correct and there are no spaces added (You can either use capital or lowercase).

NOTE: This setting can only be changed when there is no patch active.

Alarm settings

Default: Beep.

This setting changes the way that the pump will alert you when there is a warning or error.

  • Beep > The patch will beep on alarms and warnings

  • Silent > The patch will not alert you on alarms and warnings

Note: In silent mode AAPS will still sound the alarm depending on your phone’s volume settings. If you do not respond to the alarm, the patch will eventually beep.

Notification on pump warning

Default: Enabled.

This settings changes the way AAPS will show notification on non ciritical pump warnings. When enabled a Notification will be shown on the phone when a pump warning occurs, including: - Low battery - Low reservoir (20 Units) - Patch expiration warning

In either case these warnings are also shown on the Medtrum overview screen under Active alarms.

Patch Expiration

Default: Enabled.

This setting changes the behavior of the patch. When enabled the patch will expire after 3 days and give an audible warning if you have sound enabled. After 3 days and 8 hours the patch will stop working.

If this setting is disabled, the patch will not warn you and will continue running until the patch battery or reservoir runs out.

Pump expiry warning

Default: 72 hours.

This setting changes the time of the expiration warning, when Patch Expiration is enabled, AAPS will give a notification on the set hour after activation.

Hourly Maximum Insulin

Default: 25U.

This setting changes the maximum amount of insulin that can be delivered in one hour. If this limit is exceeded the patch will suspend and give an alarm. The alarm can be reset by pressing the reset button on in the overview menu see Reset alarms.

Set this to a sensible value for your insulin requirements.

Daily Maximum Insulin

Default: 80U.

This setting changes the maximum amount of insulin that can be delivered in one day. If this limit is exceeded the patch will suspend and give an alarm. The alarm can be reset by pressing the reset button on in the overview menu see Reset alarms.

Set this to a sensible value for your insulin requirements.

Step 2b: AAPS Alerts settings

Go to preferences

Pump:

BT Watchdog

Go to preferences and select Pump:

BT Watchdog

BT Watchdog

This setting will try to work around any BLE issues. It will try to reconnect to the pump when the connection is lost. It will also try to reconnect to the pump when the pump is unreachable for a certain amount of time.

Enable this setting if you experience frequent connection issues with your pump.

Local Alerts:

Go to preferences and select Local Alerts:

Local Alerts

Alert if pump is unreachable

Default: Enabled.

This setting is forced to enabled when the Medtrum driver is enabled. It will alert you when the pump is unreachable. This can happen when the pump is out of range or when the pump is not responding due to a defective patch or pumpbase, for example when water leaks between the pumpbase and the patch.

For safety reasons this setting cannot be disabled.

Pump unreachable threshold [min]

Default: 30 min.

This setting changes the time after which AAPS will alert you when the pump is unreachable. This can happen when the pump is out of range or when the pump is not responding due to a defective patch or pumpbase, for example when water leaks between the pumpbase and the patch.

This setting can be changed when using Medtrum pump but it is recommended to set it at 30 minutes for safety reasons.

Step 3: Activate patch

Before you continue:

  • Have your Medtrum Nano pumpbase and a reservoir patch ready.

  • Make sure that AAPS is properly set up and a profile is activated.

  • Other devices that can talk to the Medtrum pump are disabled (PDM and Medtrum app)

Activate patch from the Medtrum overview Tab

Navigate to the Medtrum TAB in the AAPS interface and press the Change Patch button in the bottom right corner.

If a patch is already active, you will be prompted to deactivate this patch first. see Deactivate Patch.

Follow the prompts to fill and activate a new patch. Please note - it is important to only connect the pumpbase to the reservoir patch at the step when you are prompted to do so. You must only put the pump on your body and insert the cannula when prompted to during the activation process (after priming is complete).

Start Activation

Start Activation

At this step, double check your serial number and make sure the pumpbase is not connected to the patch yet.

Press Next to continue.

Fill the patch

Fill the patch

Once the patch is detected and filled with a minimum of 70Units of insulin, press Next will appear.

Prime the patch

Half press

Do not remove the safety lock and press the needle button on the patch.

Press Next to start prime

Prime progress

Prime complete

Once the prime is complete, press Next to continue.

Attach Patch

Attach patch

Clean the skin, remove stickers and attach the patch to your body. Remove safety lock and press the needle button on the patch to insert the cannula.

Press Next to activate the patch.

Activate Patch

Activate patch

When activation is complete, the following screen will appear

Activation complete

Press OK to return to main screen.

Deactivate patch

To deactivate a currently active patch, go to the Medtrum TAB in the AAPS interface and press the Change Patch button.

Deactivate patch

You will be asked to confirm that you wish to deactivate the current patch. Please note that this action is not reversable. When deactivation is completed, you can press Next to continue the process to activate a new patch. If you are not ready to activate a new patch, press Cancel to return to the main screen.

Deactivate progress

If Android APS in unable to deactivate the patch (For instance because the pumpbase has already been removed from the reservoir patch), you may press Discard to forget the current patch session and make it possible to activate a new patch.

Deactivate complete

Once deactivation is complete, press OK to return to main screen or press Next to continue the process to activate a new patch.

Resume interrupted activation

If a patch activation is interrupted, for instance because the phone battery runs out, you can resume the activation process by going to the Medtrum TAB in the AAPS interface and press the Change Patch button.

Resume interrupted activation

Press Next to continue the activation process. Press Discard to discard the current patch session and make it possible to activate a new patch.

Reading activation status

The driver will try to determine the current status of the patch activation. If this was successful it will go into the activation progress at the current step.

סקירה כללית

The overview contains the current status of the Medtrum patch. It also contains buttons to change the patch, reset alarms and refresh the status.

Medtrum Overview

BLE Status:

This shows the current status of the Bluetooth connection to the pumpbase.

Last connected:

This shows the last time the pump was connected to AAPS.

Pump state:

This shows the current state of the pump. For example: - ACTIVE : The pump is activated and running normally - STOPPED: The patch is not activated

Basal type:

This shows the current basal type.

Basal rate:

This shows the current basal rate.

Last bolus:

This shows the last bolus that was delivered.

Active bolus:

This shows the active bolus that is currently being delivered.

Active alarms:

This shows any active alarms that are currently active.

Reservoir:

This shows the current reservoir level.

Battery:

This shows the current battery voltage of the patch.

Pump type:

This shows the current pump type number.

FW version:

This shows the current firmware version of the patch.

Patch no:

This shows the sequence number of the activated patch. This number is incremented every time a new patch is activated.

Patch expires:

This shows the date and time when the patch will expire.

Refresh:

This button will refresh the status of the patch.

Change patch:

This button will start the process to change the patch. See Activate patch for more information.

Reset alarms

The alarm button will appear on the overview screen when there is an active alarm that can be reset. Pressing this button will reset the alarms and resume insulin delivery if the patch has been suspended due to the alarm. E.g. when suspended due to a maximum daily insulin delivery alarm.

Reset alarms

Press the Reset Alarms button to reset the alarms and resume normal operation.

פתרון בעיות

Connection issues

If you are experiencing connection timeouts or other connection issues:

  • In Android application settings for AAPS: Set location permission to ”Allow all the time“.

Activation interrupted

If the activation process is interrupted for example by and empty phone battery or phone crash. The activation process can be resumed by going to the change patch screen and follow the steps to resume the activation as outlined here: Resume interrupted activation

Preventing patch faults

The patch can give a variety of errors. To prevent frequent errors:

  • Make sure the pumpbase is properly seated in the patch and no gaps are visible.

  • When filling the patch do not apply excessive force to the plunger. Do not try to fill the patch beyond the maximum that applies to your model.

Where to get help

All of the development work for the Medtrum driver is done by the community on a volunteer basis; we ask that you to remember that fact and use the following guidelines before requesting assistance:

  • רמה 0 קראו את הסעיף הרלוונטי בתיעוד זה כדי להבטיח שאתם מבינים כיצד להשתמש במה שאתם מתקשים איתו.

  • Level 1: If you are still encountering problems that you are not able to resolve by using this document, then please go to the #Medtrum channel on Discord by using this invite link.

  • רמה 2: חפשו בעיות קיימות כדי לראות אם הבעיה שלכם כבר דווחה ב-בעיות אם היא קיימת, אנא אשרו/הגיבו/הוסיפו מידע על הבעיה שלכם. אם לא, צרו בעיה חדשה וצרפו את קובצי היומן (Log) שלכם.

  • היו סבלניים - רוב חברי הקהילה שלנו מורכבים ממתנדבים בעלי אופי טוב, ופתרון בעיות דורש לעתים קרובות זמן וסבלנות מצד המשתמשים והמפתחים כאחד.