>>>> Medtronic pump driver is not part of AndroidAPS master yet. It will be available in next master version. <<<<
Works only with older Medtronic pumps (details see below). Does not work with Medtronic 640G or 670G.
While Medtronic driver was tested with good test group, it is still considered a beta software, which means that until bigger audience tests it for a longer period of time, you will need to enable Engineering mode, to be able to see driver in AndroidAPS.
Hardware and software requirements¶
- Phone: Medtronic driver should work with any phone supporting BLE. IMPORTANT: While driver works correctly on all phones, enabling/disabling Bluetooth doesn’t (this is required when you loose connection to RileyLink and system can’t recover automatically - happens from time to time). So you need to get device with Android 6.0 - 8.1, in worst case scenario you can install LinegaeOS 15.1 (required 15.1 or lower) on your phone. We are looking into problem with Android 9, but so far we haven’t found resolution (it seems to work on some models and not on others, and on also works sometimes on some models).
- RileyLink/Gnarl: For communication with Pump you need device that converts BT commands from Phone into RF commands that Pump understands. Device that does is called RileyLink (you can get it here getrileylink.org). You need stable version of device, which is for older models firmware 0.9 (older versions might not work correctly) or for newer models 2.2 (there are options to upgrade available on RL site). If you are feeling adventurous you can also try Gnarl (here), which is sort-of RileyLink-clone.
- Pump: Driver works only with following models and firmware versions:
- 523/723 (firmware 2.4A or lower)
- 554/754 EU release (firmware 2.6A or lower)
- 554/754 Canada release (firmware 2.7A or lower)
Configuration of the pump¶
- Enable remote mode on Pump (Utilities -> Remote Options, Select Yes, and on next screen do Add ID and add dummy id (111111 or something). You need to at least one ID on that Remote IDs list. This options might look differently on different model of pump. This step is important, because when set, Pump will listen more often for remote communication.
- Set Max Basal on your Pump to your “max basal entry in your STD profile” * 4 (if you want to have 400% TBR as max). This number must be under 35 (as you can see in pump).
- Set Max Bolus on your Pump (max is 25)
- Set profile to STD. This will be the only profile we will use. You can also disable.
- Set TBR type to Absolute (not Percent)
Configuration of Phone/AndroidAPS¶
- Do not pair RileyLink with your Phone. If you paired your RileyLink, then AndroidAPS won’t be able to find it in configuration.
- Disable Auto-rotate on your phone (on some devices Auto-rotate restarts BT sessions, which is not something we would want).
- You can configure pump in AndroidAPS two ways:
- Use of Wizard (on new install)
- Directly in Config tab (Cog icon on Medtronic driver)
If you do new install you will be thrown directly into wizard. Sometimes if your BT connection is not working fully (unable to connect to pump), you might not be able to complete configuration. In such case select virtual pump and after wizard is finished, you can go with option 2, which will bypass pump detection.
You need to set following items: (see picture above)
- Pump Serial Number: You can find that on back side, entry SN. You need to get only number, your serial is 6 numbers.
- Pump Type: Which pump type you have (i.e. 522).
- Pump Frequency: According to pump frequency there were two versions of Medtronic pump made (if you are not sure what frequency your pump uses, look at FAQ):
- for US & Canada, frequency used is 916 Mhz
- for Worldwide, frequency used is 868 Mhz
- Max Bolus on Pump (U) (in an hour): This needs to be set to same as on the pump. It limits how much insulin you can Bolus. If you go over this, Bolus won’t be set and error will be returned. Max that can be used is 25, please set correct value for yourself here so that you don’t overdose.
- Max Basal on Pump (U/h): This needs to be set to same as on the pump. It limits how much basal you can get in an hour. So for example, if you want to have max TBR set to 500% and highest of your Basal patterns is 1.5 U, then you would need to set Max Basal to at least 7.5. If this setting is wrong (for example, if one of your basal pattern would go over this value, pump would return error).
- Delay before Bolus is started (s): This is delay before bolus is sent to pump, so that if you change your mind you can cancel it. Canceling bolus when bolus is running is not supported by pump (if you want to stop bolus when running, you have to suspend pump and then resume).
- Medtronic Encoding: This is setting which determines, if 4b6b encoding that Medtronic devices do will be done in AndroidAPS or on RileyLink. If you have a RileyLink with 2.x firmware, default value will be to use Hardware encoding (= done by RileyLink), if you have 0.x firmware this setting will be ignored.
- Battery Type (Power View): If you want to see battery power in your pump, you need to select type of battery you use (currently supported Lithium or Alkaline), this will in turn change display to display calculated percent and volts.
- RileyLink Configuration: This will find your RileyLink/GNARL device.
MEDTRONIC (MDT) Tab¶
On pump tab you can see several lines that are showing pumps (and connections) current status.
- RileyLink Status: It shows status of RileyLink connection. Phone should be connected to RileyLink all the time.
- Pump Status: Status of pump connection, this can have several values, but mostly we will see sleep icon (when pump connection is not active), when command is beeing executed, we might see “Waking Up”, which is AAPS trying to make connection to your pump or description of any command that might be running on pump (ex.: Get Time, Set TBR, etc.).
- Battery: Shows battery status depening on your configuration. This can be simple icon showing if battery is empty or full (red if battery is getting critical, under 20%), or percent and voltage.
- Last connection: Time when last connection to pump was successful.
- Last Bolus: When last bolus was given.
- Base Basal Rate: This is the base basal rate that runs on pump at this hour.
- Temp basal: Temp basal that is running or empty.
- Reservoir: How much insulin is in reservoir (updated at least every hour).
- Errors: Error string if there is problem (mostly shows if there is error in configuration).
On lower end we have 3 buttons:
- Refresh is for refreshing state. This should be used only after connection was not present for long time, as this action will reset data about pump (retrieve history, get/set time, get profile, get battery status, etc).
- Pump History: Shows pump history (see bellow)
- RL Stats: Show RL Stats (see bellow)
Pump history is retrieved every 5 minutes and stored localy. We keep history only for last 24 hours, so older entries are removed when new are added. This is simple way to see the pump history (some entries from pump might not be displayed, because they are not relevant - for example configuration of functions that are not used by AndroidAPS).
When Medtronic driver is selected, 3 possible actions can be added to Actions Tab:
- Wake and Tune Up - If you see that your AndroidAPS hasn’t contacted your pump in a while (it should contact it every 5 minutes), you can force Tune Up. This will try to contact your pump, by searching all sub frequencies on which Pump can be contacted. If it finds one it will set it as your default frequency.
- Reset RileyLink Config - If you reset your RileyLink/GNARL, you need to use this action, so that device can be reconfigured (frequency set, frequency type set, encoding configured).
- Clear Bolus Block - When you start bolus, we set Bolus Block, which prevents any commands to be issued to pump. If you suspend your pump and resume (to cancel bolus), you can then remove that block. Option is only there when bolus is running...
Since Medtronic driver is very new, you need to enable logging, so that we can debug and fix problems, if they should arise. Click on icon on upper left corner, select Maintainance and Log Settings. Options Pump, PumpComm, PumpBTComm need to be checked.
Medtronic CGMS is currently NOT supported.
Manual use of pump¶
You should avoid manually doing treatments things on your pump. All commands (bolus, TBR) should go through AndroidAPS, but if it happens that you will do manual commands, do NOT run commands with frequency less than 3 minutes (so if you do 2 boluses (for whatever reason), second should be started at least 3 minutes after first one).
Timezone changes and DST (Daylight Saving Time) or Traveling with Medtronic Pump and AndroidAPS¶
Important thing to remember is that you should never disable loop when you are traveling (unless your CGMS can’t do offline mode). AAPS will automatically detect Timezone changes and will send command to Pump to change time, when time on Phone is changed.
Now if you travel to East and your TZ changes with adding hours (ex. from GMT+0 to GMT+2), pump history won’t have problem and you don’t have to worry... but if you travel to West and your TZ changes by removing hours (GMT+2 to GMT-0), then sychronization might be little iffy. In clear text, that means that for next x hours you will have to be careful, because your IOB, might be little weird.
We are aware of this problem, and we are already looking into possible solution (see https://github.com/andyrozman/RileyLinkAAPS/issues/145), but for now, have that info in mind when traveling.
How to determine what Frequency my pump uses¶
If you turn your pump around in first line on right side you will see special 3 letter code. First two letters determine frequency type and last one determines color. Here are possible values for Frequency:
- NA - North America (in frequency selection you need to select “US & Canada (916 MHz)”)
- CA - Canada (in frequency selection you need to select “US & Canada (916 MHz)”)
- WW - Worldwide (in frequency selection you need to select “Worldwide (868 Mhz)”)