update for v3.8.1 (#941)

marionbarker · web-flow · commit 19d0e9b06bc7 · 2025-09-23T23:11:58.000-07:00
diff --git a/docs/build/pump.md b/docs/build/pump.md
@@ -27,7 +27,7 @@ These types of pumps are compatible with the *Loop* app.
 * [Omnipod Eros pumps](pump.md#omnipod-pumps)
 * [Omnipod DASH pumps](#omnipod-dash)
     * See caveat about [iPhone 16](phone.md#compatible-device){: target="_blank" }
-* [Dana-i / DanaRS-v3](#sooil-dana-pumps) (dev branch only, v3.7.5 or newer)
+* [Dana-i / DanaRS-v3](#sooil-dana-pumps) (v3.7.5 or newer)
 * [Medtrum Touchcare Nano](#medtrum-nano) (feat/dev-medtrum branch only, v3.9.0 or newer)
 
 ## Check Medtronic Pump Version
@@ -192,16 +192,23 @@ Loop does not support Omnipod 5 pods.
 
 ## Sooil Dana pumps
 
-!!! warning "You must build dev branch to use Dana pumps"
-    The Dana pump is in dev (as of version v3.7.5) and will be in the next release. Follow the [Zulipchat Dana Pump discusion](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/DanaKit.20support.20for.20Loop) if you choose to run the *Loop* app with a Dana pump.
+!!! warning "Dana pumps support is new - pay attention"
+    The Dana pump is supported with the released *Loop* app, v3.8.0 or newer.
+    
+    Follow the [Zulipchat Dana Pump discusion](https://loop.zulipchat.com/#narrow/channel/144182-development/topic/DanaKit.20support.20for.20Loop) if you need additional support for the Dana pump.
+
+    Read these pages in LoopDocs:
+
+    * [Add a Dana Pump](../loop-3/add-pump.md#dana-i-danars-v3){: target="_blank" }
+    * [Dana Troubleshooting](../troubleshooting/dana-faq.md){: target="_blank" }
 
 **Every Dana pump has built-in BLE communications. Therefore, no RileyLink-compatible device is needed to use Dana-i / DanaRS-v3 with the *Loop* app.**
 
 ### Dana-i
 
 The Dana-i is the latest and greatest from the Korean pump manufacturer Sooil, released in 2020.
 
-> The *Loop* app v3.7.5 or newer (built with dev branch of `LoopWorkspace`) supports the Dana-i. 
+> The *Loop* app v3.7.5 or newer supports the Dana-i. 
 
 ![Dana-i](img/dana-i.png){width="250"}
 {align="center"}
@@ -211,7 +218,7 @@ The Dana-i is the latest and greatest from the Korean pump manufacturer Sooil, r
 The DanaRS was first released in 2002, with firmware version v1 which is not supported at this time. Only firmware version v3 and onwards are supported with the *Loop* app.
 [Check here](../loop-3/add-pump.md#dana-i-danars-v3) to see how to check your firmware version.
 
-> The *Loop* app v3.7.5 or newer (built with dev branch of `LoopWorkspace`) supports the DanaRS-v3. 
+> The *Loop* app v3.7.5 or newer supports the DanaRS-v3. 
 
 ![DanaRS-v3](img/danars.png){width="250"}
 {align="center"}
diff --git a/docs/loop-3/add-pump.md b/docs/loop-3/add-pump.md
@@ -17,8 +17,7 @@ Loopers can choose from 5 pumps and a simulator:
     * Please refer to [Compatible Pump](../build/pump.md#check-medtronic-pump-version) for additional details
 * Omnipod
 * Omnipod DASH
-* Dana-i / DanaRS-v3 (dev branch only)
-    * Some Dana pumps are currently supported with the [dev branch](../version/build-dev.md#build-loop-dev){: target="_blank" }
+* Dana-i / DanaRS-v3 (v3.7.5 or newer)
     * Note: DanaRS-v1 or any Dana Korean versions are not supported
 * Medtrum Nano patch pump
 * Insulin Pump Simulator
@@ -56,7 +55,7 @@ Here is an overview of the different steps for adding each pump.  Before changin
 
 #### Steps for [Dana-i / DanaRS-v3](#dana-i-danars-v3)
 
-> Requires dev branch, v3.7.5 or newer
+> Requires v3.7.5 or newer
 
 1. [Select Dana-i/DanaRS-v3](#select-dana-idanars-v3)
 1. [Insulin Type](#insulin-type)
@@ -239,9 +238,6 @@ The Medtronic status and commands available are shown in the [Pump Settings](med
 
 ## Dana-i / DanaRS-v3
 
-!!! important "Dana Support requires dev branch"
-    The Dana pump is not part of the released code but is included in the dev branch for v3.7.5 and newer.
-
 !!! info "Support for Dana-i"
     All versions of the Dana-i are supported at the moment!
 
@@ -355,7 +351,7 @@ Some pumps can also provide a heartbeat if the CGM you choose cannot provide one
 
 DanaKit doesn't provide a heartbeat by default.
 
-Therefore, it is important to check if your CGM provides a heartbeat. If it does not, there are battery-intensive work-around methods for Dana pump. See [Dana Heartbeat Modes](../troubleshooting/dana-faq.md).
+Therefore, it is important to check if your CGM provides a heartbeat. If it does not, there are battery-intensive work-around methods for Dana pump. See [Dana Heartbeat Modes](../troubleshooting/dana-faq.md#heartbeat-modes){: target="_blank" }.
 
 ## Medtrum Nano
 
diff --git a/docs/troubleshooting/dana-faq.md b/docs/troubleshooting/dana-faq.md
@@ -64,15 +64,16 @@ You will get a full wizard based on the type of refill you want to do!
 
 ### Background sound
 
-An extra feature available for the Dana pumps is the background sound.
-This feature was developed in order to keep the *Loop* app running in the background.
+An optional feature for Dana, useful when using a CGM without a heartbeat, is to play a silent audio to keep the *Loop* app active when in the background or the phone is locked.
 
-Normally, your CGM will have an active Bluetooth connection, which prevent the *Loop* app from being put into a suspended state.
-But when you are planning on using a CGM, like [NightScout remote CGM](../loop-3/add-cgm.md#nightscout-remote-cgm), [Dexcom Share](../loop-3/add-cgm.md#dexcom-share-as-a-cgm), etc, you rely on a active internet connection, and not on an active Bluetooth connection.
+Normally, your CGM will have an active Bluetooth connection, which prevents the *Loop* app from being put into a suspended state.
+But when you use a CGM like [NightScout remote CGM](../loop-3/add-cgm.md#nightscout-remote-cgm), [Dexcom Share](../loop-3/add-cgm.md#dexcom-share-as-a-cgm), etc, you rely on a active internet connection, and not on an active Bluetooth connection.
 
-In order to activate, follow these steps:
+??? abstract "Versions older than 3.8.1 or 3.9.1 (click to open)"
+    This modification is not required for code newer than version 3.8.1 (main) or 3.9.1 (dev). It was required for v3.8.0/v3.9.0 and older versions.
+
+    Activate the [UIBackgroundMode - audio](https://developer.apple.com/documentation/bundleresources/information_property_list/uibackgroundmodes):
 
-1. Activate the [UIBackgroundMode - audio](https://developer.apple.com/documentation/bundleresources/information_property_list/uibackgroundmodes):
     * When [building with Mac](../build/overview.md), go to the LoopWorkspace Xcode project and select the Loop project.
     Go to "Targets" -> "Loop" -> "Signing & Capabilities" and scroll down to "Background modes".
     Enable the checkbox for "Audio, AirPlay, and Picture in Picture".
@@ -88,25 +89,29 @@ In order to activate, follow these steps:
 
     ```
     - name: Update entitlement background sound
-      run: sed -i -e 's/<string>bluetooth-central<\/string>/<string>bluetooth-central<\/string><string>audio<\/string>/g' Loop/Loop/Info.plist
+    run: sed -i -e 's/<string>bluetooth-central<\/string>/<string>bluetooth-central<\/string><string>audio<\/string>/g' Loop/Loop/Info.plist
     ```
 
     * To save your changes to the "build_loop.yml", go to the Source Control tab on the left (should show up with a blue 1, see image below).
     Enter a message and press the green "Commit & Push"-button.
     By pressing this button, GitHub will automatically make a new browser build for you and push it to TestFlight
     ![Github web ide example](./img/background-sound-web-ide.png)
 
-2. After you have done the onboarding of the pump (see steps above), go to the pump settings.
-    Scroll down the "Pump name" and long-press this row.
-    A modal should pop-up with the question, whether you want to toggle Silent tones.
-    
-    In order to activate this feature, the modal should say something like: `Yes, Enable silent tones`.
-    When it says: `Yes, Disable silent tones`, it will disable the background sounds.
-    ![Loop example background sound](./img/background-sound-loop.jpeg){width="250"}
+> If you have older code, before main v3.8.1 or dev v3.9.1, open the box above for instructions on a required modification.
+
+After you have onboarded the Dana pump, go to the pump settings.
+
+* Scroll down to the "Pump name" and long-press this row.
+    * A modal should pop-up with the question, whether you want to toggle Silent tones.
+    * In order to activate this feature, the modal should say something like: `Yes, Enable silent tones`.
+    * When it says: `Yes, Disable silent tones`, it will disable the background sounds.
+
+    > ![Loop example background sound](./img/background-sound-loop.jpeg){width="250"}
     {align="center"}
 
-3. Done!
-    Every time you put the *Loop* app in the background, it will play a toneless sound, which prevents it from suspending the *Loop* app
+* Done!
+    Every time you put the *Loop* app in the background or lock the phone, it will play a toneless sound, which prevents it from suspending the *Loop* app
+* Warning - this will affect your phone battery life
         
 ### Continuous bluetooth mode
 
diff --git a/docs/version/build-time-flag.md b/docs/version/build-time-flag.md
@@ -54,7 +54,7 @@ SWIFT_ACTIVE_COMPILATION_CONDITIONS = $(SWIFT_ACTIVE_COMPILATION_CONDITIONS) SIR
 |OBSERVE_HEALTH_KIT_CARB_SAMPLES_FROM_OTHER_APPS_ENABLED|Turns on ability for Loop to read third party carb entries. You must also make sure Health permissions allow Loop to read carbs from Health. Be vigilant if you select this; added carbs lead to added insulin dosing when closed loop is enabled|
 |SHOW_EVENTUAL_BLOOD_GLUCOSE_ON_WATCH_DISABLED|The Apple Watch screens show current glucose, trend arrow and eventual glucose by default. This flag disables the display of eventual glucose on the watch if you find the display distracting.|
 |PREDICTED_GLUCOSE_CHART_CLAMP_ENABLED|[Chart Clamp](#chart-clamp)|
-|ALLOW_ALGORITHM_EXPERIMENTS|**dev branch only**<br><br>This is enabled by default to show Algorithm Experiments below the Therapy Settings row. This enables the user to separately enable or disable Glucose Based Partial Application and Integral Retrospective Correction|
+|ALLOW_ALGORITHM_EXPERIMENTS|This is enabled by default to show Algorithm Experiments below the Therapy Settings row. This enables the user to separately enable or disable Glucose Based Partial Application and Integral Retrospective Correction|
 
 ### Chart Clamp
 
diff --git a/docs/version/releases.md b/docs/version/releases.md
@@ -8,9 +8,11 @@ For information about version 2 releases and compatibility between version 2 and
 
 ## Current Release
 
-The current released version for the *Loop* app is v3.8.0 and is built from the `main` branch of LoopWorkspace. The dates and contents for releases are summarized below in reverse chronological order (so newest release information comes first).
+The current released version for the *Loop* app is v3.8.1 and is built from the `main` branch of LoopWorkspace. The dates and contents for releases are summarized below in reverse chronological order (so newest release information comes first).
 
-> The current development version for the *Loop* app is v3.9.0 and is built from the `dev` branch of LoopWorkspace. See [Updates in `dev`](development.md#updates-in-dev){: target="_blank" } for a summary of difference, if any, between `main` and `dev`.
+> When main is updated to v3.8.1 for a hotfix, the same hotfix is applied to the `dev` branch. It may take a day before the hotfix/dev_3.9.1 PR is merged.
+
+> See [Updates in `dev`](development.md#updates-in-dev){: target="_blank" } for a summary of difference, if any, between `main` and `dev`.
 
 ### What Version Do I Have?
 
@@ -33,6 +35,26 @@ Releases from `Loop v3.4.4` and older are reported at [*GitHub*&nbsp;_<span tran
 
 ## Loop v3.8.x
 
+### Loop v3.8.1
+
+[*Loop* v3.8.1](https://github.com/LoopKit/LoopWorkspace/releases/tag/v3.8.1) was released on 23 September 2025.
+
+This was released as a hotfix:
+
+* the designed behavior of tapping on the bolus line should automatically replace the recommended value with zero
+* this stopped working after changes were made to this interface to accommodate iOS 26
+
+When putting together the hotfix, the following additional updates were included:
+
+* Bring in updates from DanaKit
+* Restore expected behavior for G6 of going to CGM Manager screen, instead of the Dexcom app, when tapping on glucose in the HUD
+* Update Gemfile and Gemfile.lock to fix a security warning
+* Add audio capability to Loop to support DanaKit optional behavior and possible OmniBLE InPlay/iPhone 16 work-around later
+    * Dana users no longer need to modify the code to use [Background Sound](../troubleshooting/dana-faq.md#background-sound){: target="_blank" } if their CGM does not have a heartbeat
+* Update some translations
+
+> When main is updated to v3.8.1 for a hotfix, the same hotfix is applied to the `dev` branch. It may take a day before the hotfix/dev_3.9.1 PR is merged.
+
 ### Loop v3.8.0
 
 [*Loop* v3.8.0](https://github.com/LoopKit/LoopWorkspace/releases/tag/v3.8.0) was released on 14 September 2025.
