- Check the wiki: https://wiki.aaps.app
- Everyone who's been looping with AAPS needs to fill out the form after 3 days of looping https://docs.google.com/forms/d/14KcMjlINPMJHVt28MDRupa4sz4DDIooI4SrW0P3HSN8/viewform?c=0&w=1
DEV:
This branch adds three features on top of upstream AAPS:
- Eversense CGM integration — direct BLE connection to Eversense E3 and E365 transmitters as a native AAPS BG source, with calibration, alarms, DMS portal sync, and (for E365) cloud upload.
- Afrezza inhaled insulin support — a second, independently-tracked insulin curve for logging Technosphere inhaled insulin doses.
- Omnipod 5 pump integration (Work in Progress) — a from-scratch Bluetooth driver for the Omnipod 5 pod. Still under active development — see the dedicated section below before using it.
All three are experimental, community-developed modifications. None is approved by any regulatory body. Discuss any changes to your insulin regimen or pump with your endocrinologist before use, and always keep fingerstick meter access as a backup.
- Visit your trained healthcare provider for the procedure. Only physicians who have completed the Eversense CGM Insertion and Removal Training Program may perform the insertion.
- The tiny sensor is placed just under the skin of your upper arm via a small incision, closed with Steri-Strips — usually no stitches required.
- Avoid strenuous activities that may pull at the incision or cause heavy sweating while it heals. Remove the Steri-Strips within a few days.
- After insertion, the official Eversense app will show "Warm Up Phase." The sensor must complete this period before calibration is accepted. Do not attempt to calibrate during this phase.
- After warm-up, the official Eversense app will move into an Initialization Phase. This must also be completed using the official Eversense app before proceeding.
- While still in the official Eversense app, set your Low and High BG Alert levels. These are stored on the transmitter itself, so this only needs to be done once per transmitter (or whenever you want to change them) — but it must be done through the official app; AAPS does not write these settings to the transmitter.
- Once warm-up, initialization, and alert levels are all complete, proceed to set up the AAPS plugin.
The Eversense transmitter can only maintain one active Bluetooth connection at a time. Whether the official Eversense app can safely coexist with AAPS depends on which transmitter you have.
Through real-world testing, we found that leaving the official Eversense app installed alongside AAPS on an E365 setup leads to intermittent BLE connection contention — the official app's more aggressive background reconnect behavior can "win" the race for the transmitter's single connection slot after any interruption, leaving AAPS unable to reconnect on its own until you manually intervene.
The reliable setup for E365 is:
- Complete warm-up, initialization, and on-transmitter Low/High BG alert-level setup using the official Eversense app (see "Warm-Up Phase" above) — these all happen once, before you touch AAPS.
- Once that's done, completely delete the official Eversense app from your phone (not just force-stop — a full uninstall). This removes the only thing AAPS was competing against for the connection.
- The Bluetooth connection is interrupted (e.g. Bluetooth toggled off/on, moving out of range, brief RF interference such as walking through a security/metal detector).
- The phone is restarted.
- AAPS is updated (installing a new build/APK).
In each of these cases, the official app — if still installed — can grab the transmitter's connection before AAPS gets a chance to, and you will need to manually reconnect. Fully deleting the official app removes this risk entirely.
- Now connect the E365 transmitter to AAPS (see "Transmitter & AAPS Setup" below). With no competing app, AAPS's own reconnect logic reliably recovers the connection on its own after Bluetooth interruptions, phone restarts, etc. — no manual reconnect should be needed.
- If you ever need to change your alert levels again, or check firmware updates, you'll need to temporarily reinstall the official app, make your changes, and delete it again afterward.
Unlike the E365, the E3 does not exhibit the same contention problem — it can remain connected to both the official Eversense app and AAPS simultaneously in coexistence mode. You do not need to delete the official app for E3 use.
- E365 only: confirm you've completed warm-up, initialization, and alert-level setup above, then completely delete the official Eversense app.
- E3 only: you may leave the official app installed; no disconnect step is required.
- In AAPS, go to Config Builder and select Eversense as your BG source.
- Open the Eversense plugin settings and enter your Eversense DMS account credentials (username and password). Both the E3 and E365 require credentials to authenticate with the Eversense cloud and retrieve your transmitter's security certificate at every new connection.
- Tap Connect to find your transmitter and pair it via Bluetooth.
Enter your Eversense DMS account username and password. Both the E3 and E365 require credentials to authenticate with the Eversense cloud and retrieve your transmitter's security certificate at every new connection.
Displays your current calibration phase, the date of your last calibration, and when your next calibration is due. When the transmitter is ready, the Calibrate button becomes active — tap it, enter your fingerstick reading, and the value is sent directly to the transmitter over Bluetooth. Calibration is not accepted during the warm-up or initialization phase. An alert to calibrate will be displayed each time a calibration is required.
Shows real-time signal strength between the transmitter and the sensor. Signal levels are:
- Excellent (>=75)
- Good (48-74)
- Low (30-47)
- Poor (25-29)
- Very Poor (1-24)
If the signal is poor for 3 or more consecutive readings, you will receive an urgent notification. Tap it to open the placement guide.
The plugin provides the following system notifications:
- Transmitter not placed — urgent alert with a link to the placement guide.
- Firmware version — shown once per firmware version, prompting you to check for updates in the official Eversense app.
- Transmitter alarms — high/low glucose and other transmitter alerts are relayed as AAPS notifications.
- Calibration required — an alert to calibrate is displayed each time a calibration is required.
After every glucose reading, the plugin automatically uploads your data to the Eversense DMS web portal so your care team can view it in real time. Each sync uploads your latest glucose value, trend, signal strength, and battery level; your glucose history; and device diagnostic logs.
These same uploads are also sent to the Eversense NOW app, available on the Play Store. Eversense NOW lets a follower see your live BG readings on their own device — useful for caregivers of people with T1D who want remote visibility into glucose levels.
- Apply a fresh adhesive patch each morning and wear the transmitter over the sensor site on your upper arm.
- Charge the transmitter daily — no glucose data is collected while it is charging.
- Check AAPS for your glucose reading, trend arrows, and alerts.
- Monitor placement signal in the plugin settings if readings seem inconsistent.
- Calibrate when due — tap the Calibrate button and enter your fingerstick reading.
- E3 only: if you need to switch back to the official Eversense app temporarily, go to AAPS Settings → CGM and delete the CGM source, then reconnect in the official app.
- E365 only: if you need to make on-transmitter changes (alert levels, firmware check), you will need to temporarily reinstall the official Eversense app, make your changes, then delete it again before reconnecting to AAPS (see the E365 note above).
The Afrezza plugin adds support for Technosphere inhaled insulin (Afrezza) alongside your pump insulin. It tracks Afrezza's insulin-on-board (IOB) using the correct pharmacokinetic curve — peak at ~15 minutes, duration of ~1.5 hours — instead of applying your pump insulin's longer curve to inhaled doses. This means AAPS correctly predicts when Afrezza wears off, and your pump resumes normal basal delivery on the right schedule instead of running with phantom IOB.
Safety reminders:
- Always discuss insulin changes with your endocrinologist before using Afrezza alongside your pump.
- Monitor your CGM closely, especially in your first week of use.
- Afrezza dosing is not perfectly linear across cartridge sizes — start conservative and adjust based on your own response.
- Afrezza is for meal coverage and corrections only — it does not replace your pump's basal delivery.
- This is experimental, community-developed software, not approved by any regulatory body. Use at your own risk.
- Open AAPS, navigate to Insulin Management.
- Tap + to add a new insulin, and select "Afrezza (Inhaled)" from the template list.
- The editor opens with default values: Peak 15 minutes, DIA 1.5 hours, Concentration U100 — Afrezza's actual clinical pharmacokinetics, distinct from your pump insulin's much longer curve.
- Both Peak (adjustable 10–30 minutes) and DIA (adjustable 1.0–3.0 hours) can be fine-tuned if you want to match your own response — e.g. a shorter DIA if Afrezza wears off faster for you. This range is set wider than Afrezza's published clinical peak/duration (roughly 35–45 min peak effect, 1.5–3 h duration) to leave room for person-to-person variability. Most users can leave both at their defaults.
- Tap Save. Your Insulin Management list should now show both your pump insulin (unchanged, still your active profile insulin) and "Afrezza (Inhaled)" alongside it. Afrezza does not replace your pump insulin — it exists independently for manual logging only.
If the Peak/DIA sliders show the regular non-inhaled ranges (35–120 min / 5.0–10.0 h) instead of 10–30 min / 1.0–3.0 h, the Afrezza template wasn't selected properly — go back and reselect "Afrezza (Inhaled)" from the template list.
- Open the Afrezza dialog (from the treatment sheet, or wherever it's placed in your build's navigation).
- Step 1 — Select cartridge: tap 4U, 8U, or 12U to match the cartridge you're about to inhale.
- Step 2 — Confirm: a dialog asks "Log [X]U Afrezza?" — tap Confirm.
- Step 3 — Carb prompt: a dialog asks "Enter Carbs? Open the Bolus Calculator to enter carbs for this meal?" Tap Yes to jump straight into the bolus wizard for this meal's carbs, or No to finish without logging carbs right now.
- Inhale the Afrezza cartridge.
AAPS tracks two separate IOB curves at once: your pump insulin (its normal DIA, typically 5+ hours) covering basal, SMBs, and manual pump boluses; and Afrezza IOB (peak 15min default, adjustable 10–30min; DIA 1.5h default, adjustable 1.0–3.0h) covering only doses logged through the Afrezza flow. The total IOB shown on the home screen is the sum of both, and AAPS uses the combined value for all predictions and dosing decisions.
- "Add Afrezza insulin in Insulin Management first" — you haven't completed Part 1 yet.
- Peak/DIA sliders show 35–120 min / 5.0–10.0 h instead of 10–30 min / 1.0–3.0 h — the wrong template was selected; reselect "Afrezza (Inhaled)" specifically.
- IOB seems too high after a dose — check that your Afrezza insulin's DIA is actually set to your intended value (e.g. 1.5h), not left at a pump-insulin-length default.
- Expect breaking changes between commits.
- Verify every dose and pod status against the physical pod/PDM before trusting it.
- Do not rely on this integration as your sole means of insulin delivery or monitoring.
- Check the branch's commit history for the current state of Omnipod 5 support before use.
- The Eversense connection logic is actively evolving. Check the branch's commit history for the latest state before relying on it in a real-world dosing decision.
- The E365/official-app contention issue is a platform-level Android Bluetooth limitation (only one app can hold an active GATT connection to the transmitter at a time), not a bug specific to either app. There is no way to make two apps share the connection simultaneously for the E365.
- Omnipod 5 pump support is a Work in Progress — see the dedicated section above.