Skip to content

Add AP550 pump documentation #2665

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
MHDHUST wants to merge 1 commit into from
Closed

Add AP550 pump documentation #2665

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
326 changes: 326 additions & 0 deletions docs/EN/CompatiblePumps/AP550-Insulin-Pump.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,326 @@
# AP550 Insulin Pump

_Insulin Pump uAP 550S_

_These instructions are for configuring AAPS and your pump if you use uAP 550S. The driver talks to the pump over Bluetooth LE._

The pump runs on standard **AAA batteries**.

## Pairing pump

* On the AAPS homescreen press the hamburger menu on the top left corner and go to **Config Builder**.
* In the pump section select **AP550**.
![AAPS AP550 configure builder](../images/AP550/configureBuilder.jpg)
* The AP550 overview screen opens. Tap the connection card which says
**"Insulin pump not bound"**. You can also click the bottom botton **"Pair"**

![AAPS AP550 overview, not paired](../images/AP550/unbound.jpg)

* The pair wizard starts. You can find the pump in two ways:

1. **Scan** — the wizard scans for nearby pumps for 15 seconds and lists them by name and serial number(The pump serial number is on the back label.). Tap your pump in the list.
2. **QR code** — tap "QR code scan" and point the camera at the QR code on the **back of the pump**. The QR code holds the model and serial number. AAPS then scans until it finds the pump with this serial number.

![AP550 pair wizard, scan](../images/AP550/pair.jpg)

* AAPS connects to the pump ("Bluetooth is connecting...").
* **Enter the 6-digit pairing code shown on the pump.** You must also confirm the code on the pump. This works like a normal Bluetooth pairing, for example phone and car audio.
![AP550 enter the pairing code](../images/AP550/Enter_pairing_code.jpg)
* If the code is wrong you can try once more. After a second wrong code the link drops and you start again at the scan step.
* When pairing succeeds you see "Pump pair successes". Press OK to return to the overview.

## Operating the pump

The default password to enter the menu on the pump is **211**.


### Unlocking the pump

1. **Double-tap the circle on the screen** to wake the screen up.
2. Tap the **unlock button**.
3. **Swipe up** to unlock.
![AP550 unlock the pump](../images/AP550/unlock_the_pump.jpg)

### Pump buttons

The table below lists the common buttons on the AP550 pump and what each one does. A single screenshot may show several buttons at once; in that case the image spans multiple rows and each button gets its own description row.

<table>
<tr>
<th>Button</th>
<th>Description</th>
</tr>

<!-- Group 1: one screenshot containing 4 buttons -->
<tr>
<td rowspan="4"><img src="../images/AP550/page-1.jpg" alt="buttons"></td>
<td>1: Stop pump Injection</td>
</tr>
<tr><td>2: bolus</td></tr>
<tr><td>3: basal</td></tr>
<tr><td>4: Change the infusion set</td></tr>

<!-- Group 2: one screenshot containing 2 buttons -->
<tr>
<td rowspan="3"><img src="../images/AP550/page-2.jpg" alt="buttons"></td>
<td>1: Settings</td>
</tr>
<tr><td>2: History</td></tr>
<tr><td>3: Device Info</td></tr>

<tr>
<td rowspan="2"><img src="../images/AP550/page-1-3.jpg" alt="basal menu"></td>
<td>1: Normal Basal Rate</td>
</tr>
<tr><td>2: Temporary Basal Rate</td></tr>

<tr>
<td rowspan="2"><img src="../images/AP550/page-1-3-2.jpg" alt="buttons"></td>
<td>1: Set a temporary basal rate as a percentage.</td>
</tr>
<tr><td>2: Set a temporary basal rate as a rate</td></tr>

<tr>
<td rowspan="2"><img src="../images/AP550/page-1-2.jpg" alt="buttons"></td>
<td>1: Manual Bolus</td>
</tr>
<tr><td>2: Preset Bolus</td></tr>

<tr>
<td rowspan="4"><img src="../images/AP550/page-2-1.jpg" alt="buttons"></td>
<td>1: Alarm</td>
</tr>
<tr><td>2: Time</td></tr>
<tr><td>3: Infusion</td></tr>
<tr><td>4: Wireless</td></tr>

<tr>
<td rowspan="4"><img src="../images/AP550/page-2-1-3.jpg" alt="buttons"></td>
<td>1: Bolus Settings</td>
</tr>
<tr><td>2: Low Reservoir Threshold</td></tr>
<tr><td>3: Max basal</td></tr>
<tr><td>4: Max bolus</td></tr>

</table>

### Changing the reservoir and infusion set

The **Change the infusion set** button in the main menu is used whenever the delivery line has to be opened. There are two situations:

* the insulin in the reservoir is used up and the reservoir has to be replaced with a new one:
![AP550 change reservoir](../images/AP550/rewind_change_reservoir.jpg)

* the infusion set (tubing and cannula) has to be replaced:
![AP550 prime only](../images/AP550/prime_only.jpg)


### Pump alarms

The pump shows an alarm screen when something needs your attention. The
picture below shows the alarms as they appear on the pump, together with the
buttons you can press. Each alarm is explained in the table.


<table>
<tr>
<th>Alarm</th>
<th>Meaning / what to do</th>
</tr>
<tr>
<td rowspan="9"><img src="../images/AP550/alarm.jpg" alt="pump alarms"></td>
<td><strong>H1 Pump battery empty</strong> — the AAA batteries are empty. Replace them immediately.</td>
</tr>
<tr><td><strong>H2 Abnormal pump motor</strong> — the pump detected a motor fault. Stop using the pump and contact your supplier.</td></tr>
<tr><td><strong>H3 Insulin depleted</strong> — Insulin depleted. Unable to complete delivery.</td></tr>
<tr><td><strong>H4 Occlusion</strong> — the tubing or cannula is blocked. Check the infusion set and replace it if needed.</td></tr>
<tr><td><strong>L1 Reservoir empty</strong> — No reservoir detected.</td></tr>
<tr><td><strong>L2 Pipeline detachment</strong> — the tubing has come off. Reconnect or replace the infusion set.</td></tr>
<tr><td><strong>L3 Low battery</strong> — the batteries are almost empty. Replace them soon.</td></tr>
<tr><td><strong>L4 Insufficient insulin</strong> — The remaining insulin is below the alarm threshold.</td></tr>
</table>

### Pump prompts

Besides alarms, the pump also shows **prompts**: short screens that ask you to
confirm an action or that inform you about the state of the pump. The table
below shows each prompt screen and explains what it means.


<table>
<tr>
<th>Prompt</th><th>Meaning</th>
<th>Prompt</th><th>Meaning</th>
<th>Prompt</th><th>Meaning</th>
</tr>

<!-- Row 1: prompts 1–3 -->
<tr>
<td><img src="../images/AP550/prompt-01.jpg" width="140" alt="prompt 1"></td>
<td>The device has been powered off for too long. Please reset the time.</td>
<td><img src="../images/AP550/prompt-02.jpg" width="140" alt="prompt 2"></td>
<td>The value exceeds the maximum. Please re-enter.</td>
<td><img src="../images/AP550/prompt-03.jpg" width="140" alt="prompt 3"></td>
<td>Infused ** U ** minutes ago.</td>
</tr>

<!-- Row 2: prompts 4–6 -->
<tr>
<td><img src="../images/AP550/prompt-04.jpg" width="140" alt="prompt 4"></td>
<td>A maximum of ** U can be infused for this bolus.</td>
<td><img src="../images/AP550/prompt-05.jpg" width="140" alt="prompt 5"></td>
<td>The 4-hour bolus limit has been reached: ** U.</td>
<td><img src="../images/AP550/prompt-06.jpg" width="140" alt="prompt 6"></td>
<td>The daily bolus limit has been reached: ** U.</td>
</tr>

<!-- Row 3: prompts 7–9 -->
<tr>
<td><img src="../images/AP550/prompt-07.jpg" width="140" alt="prompt 7"></td>
<td>Bolus aborted. Please check the record.</td>
<td><img src="../images/AP550/prompt-08.jpg" width="140" alt="prompt 8"></td>
<td>Infusion cannot be resumed under the current alarm condition.</td>
<td><img src="../images/AP550/prompt-09.jpg" width="140" alt="prompt 9"></td>
<td>Bolus in progress. Changing the infusion set is not allowed.</td>
</tr>

<!-- Row 4: prompts 10–12 -->
<tr>
<td><img src="../images/AP550/prompt-10.jpg" width="140" alt="prompt 10"></td>
<td>Temporary basal rate in progress. Changing the infusion set is not allowed.</td>
<td><img src="../images/AP550/prompt-11.jpg" width="140" alt="prompt 11"></td>
<td>Bolus in progress. Editing is not allowed.</td>
<td><img src="../images/AP550/prompt-12.jpg" width="140" alt="prompt 12"></td>
<td>Temporary basal rate in progress. Editing is not allowed.</td>
</tr>

<!-- Row 5: prompts 13–15 -->
<tr>
<td><img src="../images/AP550/prompt-13.jpg" width="140" alt="prompt 13"></td>
<td>Dose is 0. Unable to set.</td>
<td><img src="../images/AP550/prompt-14.jpg" width="140" alt="prompt 14"></td>
<td>Infusion paused. Please go to the home screen to resume infusion.</td>
<td><img src="../images/AP550/prompt-15.jpg" width="140" alt="prompt 15"></td>
<td>All infusions are paused. Editing is not allowed.</td>
</tr>

<!-- Row 6: prompts 16–18 -->
<tr>
<td><img src="../images/AP550/prompt-16.jpg" width="140" alt="prompt 16"></td>
<td>Not a new battery.</td>
<td><img src="../images/AP550/prompt-17.jpg" width="140" alt="prompt 17"></td>
<td>Please replace the battery.</td>
<td><img src="../images/AP550/prompt-18.jpg" width="140" alt="prompt 18"></td>
<td>Please reset the time.</td>
</tr>

<!-- Row 7: prompts 19–21 -->
<tr>
<td><img src="../images/AP550/prompt-19.jpg" width="140" alt="prompt 19"></td>
<td>Please reset the insulin pump parameters.</td>
<td><img src="../images/AP550/prompt-20.jpg" width="140" alt="prompt 20"></td>
<td>There is an unfinished operation.</td>
</tr>
</table>

## Overview screen

The AP550 overview screen shows the state of the pump:

* Connection card at the top: tap it to **connect** or **disconnect**.
* Info rows: serial number, battery, last connection, daily units,
reservoir, base basal rate, basal step, bolus step, firmware, max bolus, max basal.
* **Pump History** — boluses, temp basals, alarms, refills and more. This history comes from the pump itself and stays on the phone.
* **Stop pump Injection / Resume pump Injection** — suspend or resume the
pump. AAPS asks you to confirm first.
* **Connect Status** — a list of past connect and disconnect events.
* **Turn pump sound on/off** — mute or unmute the pump. AAPS asks you to
confirm first.

## Settings

Open the pump settings through Config Builder (gear wheel next to AP550):

* **Visualize basal as percentage** — the pump uses percent temp basals
(10 % – 300 %). When this is on, AAPS sends and shows temp basals as a
percent instead of U/h.
* **Hypoglycemia risk alert** — the pump warns when a low glucose is likely in
the near future. AAPS checks the risk once a day and after every bolus.
* **Unpair** — forgets the pump.

## Bolus limits

The pump and the driver limit how much insulin can be given:

* Maximum single bolus — set on the pump.
* **4-hour total bolus limit** — 2× the pump max bolus.
* **Daily total bolus limit** — 4× the pump max bolus.

AAPS blocks a bolus which would go over one of these limits.

## Errors and alarms

### Errors during insulin delivery

If the connection is lost while a bolus is running (for example you walk away
from the phone), AAPS shows a message that it lost communication with the pump
and asks you to **check on the pump how much bolus was actually delivered**.
The real amount is read from the pump on the next connection.

### Delivery error codes

When a delivery fails, the pump reports a code. The most important ones:

| Code | Meaning |
|------|---------|
| 01 | Manually paused injection |
| 03 | Abnormal pump motor |
| 04 | Pump battery empty |
| 05 | Daily dose limit reached |
| 06 | Occlusion (pump pipeline blockage) |
| 07 | Reservoir empty |
| 08 | Pipeline detachment |
| 09 | Bolus over the pump maximum |
| 10 | Low battery — or a bolus / temp basal is already running on the pump |
| 12 | Communication error, please reconnect the pump |

### Connection problems

While AAPS tries to reach the pump it reminds you every few minutes:

1. Please confirm that the pump is within searchable range.
2. Please confirm that the pump and phone bluetooth are enabled.

If AAPS receives no blood glucose data for over 10 minutes it shows a
notification ("AAPS blood glucose data lost") so you can check the connection.

### Basal profile mismatch

If the basal profile on the pump does not match the profile in AAPS, the pump
reports its own rate (for example "pump basal rate: 0.80 U/h, please reset
profile"). Re-send your profile from AAPS.

## Unpair and switching phone

* **Unpair** — in the pump settings press "Unpair" and confirm. The driver
forgets the pump address and serial number. The pump stays paired in the
Android Bluetooth settings; you can remove it there too if you want.
* **Pair a different pump** — simply start the pair wizard again. Pairing a new
pump replaces the old registration, and the history of the old pump is not
merged.
* **Switching phone** — unpair on the old phone (or just pair again), then
[export settings](../Maintenance/ExportImportSettings.md) on the old phone,
install AAPS on the new phone, and
[import settings](../Maintenance/ExportImportSettings.md). If the connection
does not come back, pair the pump again as described
[above](#AP550-Insulin-Pump-pairing-pump).

## Timezone traveling with AP550

The AP550 does not support time changes over 24 hours. If you travel across
time zones, AAPS updates the pump time on the next connection after the phone
time has changed. If the difference is over 24 hours, AAPS asks you to check
the time on the phone and the pump first.

Keep in mind that time shifts on the pump can cause wrong basal records in the
pump history. See also [Timezone traveling with pumps](#timezone-traveling).
1 change: 1 addition & 0 deletions docs/EN/Getting-Started/CompatiblePumps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ AAPS works with a number of insulin pumps. The following list shows the currentl
- [Diaconn G8](../CompatiblePumps/DiaconnG8.md) (Bluetooth)
- [EOPatch2](../CompatiblePumps/EOPatch2.md) (Bluetooth)
- [Equil 5.3](../CompatiblePumps/Equil5.3.md) (Bluetooth)
- [AP550](../CompatiblePumps/AP550-Insulin-Pump.md) (Bluetooth)
- Certain older [Medtronic](../CompatiblePumps/MedtronicPump.md) ([additional communication device](#CompatiblePumps-additional-communication-device) needed)
- [Medtrum Nano 200U](../CompatiblePumps/MedtrumNano.md) (Bluetooth)
- [Medtrum 300U](../CompatiblePumps/MedtrumNano.md) (Bluetooth)
Expand Down
1 change: 1 addition & 0 deletions docs/EN/Getting-Started/Introduction.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -170,6 +170,7 @@ As of June 25 2023, there are four major open source closed loop systems availab
| PUMP | [Older Medtronic](../CompatiblePumps/MedtronicPump.md) | ![available](../images/available.png) | ![available](../images/available.png) | ![available](../images/available.png) | ![available](../images/available.png) |
| PUMP | [Equil 5.3](../CompatiblePumps/Equil5.3.md) | ![available](../images/available.png) | ![unavailable](../images/unavailable.png) | ![unavailable](../images/unavailable.png) | ![unavailable](../images/unavailable.png) |
| PUMP | [CareLevo](../CompatiblePumps/CareLevo.md) | ![available](../images/available.png) | ![unavailable](../images/unavailable.png) | ![unavailable](../images/unavailable.png) | ![unavailable](../images/unavailable.png) |
| PUMP | [AP550](../CompatiblePumps/AP550-Insulin-Pump.md) | ![available](../images/available.png) | ![unavailable](../images/unavailable.png) | ![unavailable](../images/unavailable.png) | ![unavailable](../images/unavailable.png) |
| CGM | [Dexcom G7/One+/Stelo](../CompatibleCgms/DexcomG7.md) | ![available](../images/available.png) | ![available](../images/available.png) | ![unavailable](../images/unavailable.png) | ![available](../images/available.png) |
| CGM | [Dexcom One](../CompatibleCgms/DexcomG6.md) | ![available](../images/available.png) | ![available](../images/available.png) | ![unavailable](../images/unavailable.png) | ![available](../images/available.png) |
| CGM | [Dexcom G6](../CompatibleCgms/DexcomG6.md) | ![available](../images/available.png) | ![available](../images/available.png) | ![available](../images/available.png) | ![available](../images/available.png) |
Expand Down
1 change: 1 addition & 0 deletions docs/EN/SettingUpAaps/ConfigBuilder.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -313,6 +313,7 @@ When you select another pump, **AAPS** asks you to confirm the change:
* [Medtrum](../CompatiblePumps/MedtrumNano.md)
* [Equil 5.3](../CompatiblePumps/Equil5.3.md)
* [Carelevo](../CompatiblePumps/CareLevo.md)
* [AP550](../CompatiblePumps/AP550-Insulin-Pump.md)
* Virtual pump: open loop - **AAPS** suggestions only
* as you make your first steps with **AAPS**, during the first [objectives](../SettingUpAaps/CompletingTheObjectives.md)
* for pump which doesn't have any driver yet
Expand Down
Binary file added docs/EN/images/AP550/Enter_pairing_code.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/alarm.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/configureBuilder.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/page-1-2.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/page-1-3-2.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/page-1-3.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/page-1.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/page-2-1-3.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/page-2-1.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/page-2.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/pair.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prime_only.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-01.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-02.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-03.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-04.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-05.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-06.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-07.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-08.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-09.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-10.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-11.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-12.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-13.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/EN/images/AP550/prompt-14.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/prompt-15.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/prompt-16.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/prompt-17.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/prompt-18.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/prompt-19.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/prompt-20.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/rewind_change_reservoir.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/unbound.jpg
View file
Open in desktop
Binary file added docs/EN/images/AP550/unlock_the_pump.jpg
View file
Open in desktop