Medtrum Nano / 300U

These instructions are for configuring the Medtrum insulin pump. The Medtrum driver is planned but not commited for AAPS 3.2 (next version)!

This software is part of a DIY artificial pancreas solution and is not a product but requires YOU to read, learn, and understand the system, including how to use it. You alone are responsible for what you do with it.

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 pump base and reservoir patches

    • Currently supported:

      • Medtrum TouchCare Nano with pump base refs: MD0201 and MD8201.

      • Medtrum TouchCare 300U with pump base 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 or newer of AAPS built and installed using the Build APK instructions.

  • Compatible Android phone with a BLE Bluetooth connection

  • Continuous Glucose Monitor (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.

30 min Basal Rate Profiles are NOT supported in AAPS. The AAPS Profile does not support a 30 minute basal rate time frame If you are new to AAPS and are setting up your basal rate profile for the first time, please be aware that basal rates starting on a half-hour basis are not supported, and you will need to adjust your basal rate profile to start on the hour. For example, if you have a basal rate of 1.1 units which starts at 09:30 and has a duration of 2 hours ending at 11:30, this will not work. You will need to change this 1.1 unit basal rate to a time range of either 9:00-11:00 or 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 pump base. e.g. active PDM and Medtrum app. Make sure you have your pump base and pump base SN ready for activation of a new patch.

Step 1: Select Medtrum pump

Option 1: New installations

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

Option 2: The Config Builder

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.

Config Builder

Step 2: Change 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 pump base here as noted on the pump base. 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.

Patch Expiration

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.

Alarm settings

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.

Hourly Maximum Insulin

This setting changes the maximum amount of insulin that can be delivered in one hour. The default is 25U. 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

This setting changes the maximum amount of insulin that can be delivered in one day. The default is 80U. 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 3: Activate patch

Before you continue:

  • Have your Medtrum Nano pump base 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 pump base 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 pump base 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 pump base.

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.


This shows the current reservoir level.


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.


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.


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 pump base 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:

  • Level 0: Read the relevant section of this documentation to ensure you understand how the functionality with which you are experiencing difficulty is supposed to work.

  • 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.

  • Level 2: Search existing issues to see if your issue has already been reported at Issues if it exists, please confirm/comment/add information on your problem. If not, please create a new issue and attach your log files.

  • Be patient - most of the members of our community consist of good-natured volunteers, and solving issues often requires time and patience from both users and developers.