Skip to content

Commit

Permalink
Merge pull request #1761 from blaqone/master
Browse files Browse the repository at this point in the history 
Update Libre3.md
  • Loading branch information
@peterleimbach
peterleimbach committed Oct 29, 2023
2 parents a9694e0 + c6fbd12 commit 6f0ec74
Showing 1 changed file with 31 additions and 47 deletions.
78 changes: 31 additions & 47 deletions docs/EN/Hardware/Libre3.md
View file
Original file line number Diff line number Diff line change
@@ -1,68 +1,49 @@
# **Freestyle Libre 3**

Freestyle Libre 3 (FSL3) requires a unique setup to receive BG values in to AAPS. The below is one method for achieving this using the separate app Juggluco. This method uses Juggluco to receive raw, 1-minute interval data from the sensor which is then passed to xDrip+ to be smoothed into 5-minute interval data to be passed to AAPS. While it is possible to pass data directly from Juggluco to AAPS at 1-minute intervals, this would likely result in noisy data and additional battery drain.
Freestyle Libre 3 (FSL3) requires a unique setup to receive BG values in to AAPS. There are two possible ways of getting Freestyle Libre 3 (FSL3) values to AAPS.

New sensors can be started either with the Libre 3 App or directly in Juggluco. The guide below indicates the process for starting a sensor with the Juggluco app. For more information on directly starting a sensor within the Libre 3 app please refer to “further help” below. If the sensor has been started with a Libreview account logged in, it is also possible to switch between Juggluco and the Libre 3 app as receiver.
![FL3](https://github.com/blaqone/AndroidAPSdocs/assets/37814299/d912c1d3-06d2-4b58-ad7c-025ca1980fae)

Juggluco can also pass data to LibreView for sharing with health care providers when the sensor is started with the Libre 3 app.

Within xDrip+ the sensor can be calibrated in the range of -40 mg/dl to +20 mg/dl (-2.2 mmol/l to +1.1 mmol/l) to compensate for differences between a manual meter reading and the sensor readings.

### Current limitations
The below methods for achieving this are using the separate app Juggluco. [Link].(https://www.juggluco.nl/Juggluco/download.html)
It uses Juggluco to receive raw, 1-minute interval data from the sensor which is then passed to xDrip+ or AAPS.
New sensors can be started either with the Libre 3 App or directly in Juggluco. The guide below indicates the process for starting a sensor with the Juggluco app. If the sensor has been started with a Libreview account logged in, it is also possible to switch between Juggluco and the Libre 3 app as receiver.

- If you have a rooted system and want to use the Libre 3 app, you need to hide it. You can find instructions here: [Link](https://www.reddit.com/r/Freestylelibre/comments/s22vlr/comment/hw2p4th/?utm_source=share\&utm_medium=web2x\&context=3).
(To find out if the smartphone is rooted, there are several apps, one of them is e.g. https://root-checker.org/).
Juggluco can also pass data to LibreView for sharing with health care providers when the sensor is started with the Libre 3 app.

Within xDrip+ the sensor can be calibrated in the range of -40 mg/dl to +20 mg/dl (-2.2 mmol/l to +1.1 mmol/l) to compensate for differences between a manual meter reading and the sensor readings.

## Step 1: Setup Juggluco
## Methode 1: 1-minute-readings
While it is possible to pass data directly from Juggluco to AAPS at 1-minute intervals, this would likely in additional battery drain.
When you select a NON-Dexcom BG source, AAPS does not upload blood glucose values to Nightscout. Normally, Xdrip handles this task. However, if you are not using Xdrip, as shown here, Juggluco must upload the values to Nightscout.

### Step 1: Setup Juggluco
Download and install the Juggluco app from [here](https://www.juggluco.nl/Juggluco/download.html).
Follow the instructions [here]( https://www.juggluco.nl/Juggluco/libre3/) to start a FL3 sensor.

Now let's open the app. You will be greeted with this screen below. Just click on the "Without Sensor" button.

![Juggluco welcome screen](../images/libre3/step\_8.jpg)

After that we get a short introduction text. Click on "OK".

![Juggluco installation screen](../images/libre3/step\_9.jpg)

Ok, let's set up Juggluco! The app itself doesn't have the best interface, but it is very useful. To open the settings, click anywhere on the screen in the top left corner. Now you should see the following menu. Select "Settings."

![Juggluco settings menu](../images/libre3/step\_10.jpg)
Make sure you send the glucose calues to AAPS+: In Juggluco's settings you can configure Juggluco to send its glucose value to other apps. Juggluco can send three types of such broadcasts: The **xDrip local broadcast** was originally used by xDrip and can be used to send glucose values to AAPS.

In the settings you can configure the data connection to xDrip. Click on "Patched Libre Broadcast" and press "OK".
Make sure you also enable Nightscout uploading of glucose values: Settings ->Uploader->Enter your Nightscout URL with port and your api_secret. Enable and save!

![Juggluco settings](../images/libre3/step\_11.jpg)
### Step 2: Configure AndroidAPS

Well done!

Necessary settings for a successful sensor start:

- NFC enabled / BT enabled
- Memory and location permission enabled
- location service enabled
- automatic time and time zone setting

Please note that location service is a central setting. It is not the location authorization of the app, which must also be set!

Now start the Libre3 sensor with the Juggluco app by simply scanning the sensor. Make sure that all settings are correct.
- In AndroidAPS go to Config Builder -> BG Source and check "xDrip+"
- If AndroidAPS does not receive BG values when phone is in airplane mode, use "Identify receiver"
- Turn on Smoothing!

## Step 2 (optional): Setup Libreview
As of now, when using Libre 3 as a BG source, the "Always enable SMB" and "Enable SMB by Carbs" options cannot be enabled in the SMB algorithm. The BG values from Libre 3 are not smooth enough to use safely.

You can use a sensor that was already used with the original Libre3 app if you use the same LibreView account name. Press "Start new sensor" and scan the sensor. If you want to return to the Juggluco app, stop the Libre3 app and scan the sensor with the Juggluco app open.

You can also, for example, share your data with your doctor or print the reports from Libreview before your visit. The graphs and blood glucose reports in Libreview are usually better than those from xDrip or Juggluco.
## Methode 2: 5-minute-readings
This method uses Juggluco to receive raw, 1-minute interval data from the sensor which is then passed to xDrip+ to be smoothed into 5-minute interval data to be passed to AAPS.

1. Navigate to settings in Juggluco
2. Choose "Libreview
### Step 1: Setup Juggluco
Download and install the Juggluco app from [here](https://www.juggluco.nl/Juggluco/download.html).
Follow the instructions [here]( https://www.juggluco.nl/Juggluco/libre3/)

![Liebreview](../images/libre3/step\_12.jpg)

3. Enter the data of your Libreview account (if you don't have one yet, create one in advance)
4. Tap "Get Account ID" and wait until the Libre-ID gets visible (random number below the password input field)
5. Done!
Make sure you send the glucose calues to Xdrip+: In Juggluco's settings you can configure Juggluco to send its glucose value to other apps. Juggluco can send three types of such broadcasts: The **Librelink broadcast** was originally used by the patched Librelink app and can be used to send glucose values to xDrip+

## Step 3: Setup xDrip
### Step 2: Setup xDrip

The blood glucose values are received by the xDrip+ app on the smartphone.

Expand All @@ -75,21 +56,24 @@ The blood glucose values are received by the xDrip+ app on the smartphone.
- To allow AAPS to receive blood glucose values (from version 2.5.x) from xDrip+, please enable Settings -> Interapp Settings -> Identify Receiver "info.nightscout.androidaps".
- If you want to use AndroidAPS for calibration, go to Settings -> Interapp compatibility -> Accept calibrations in xDrip+ and select ON. It's also best to check the options under Settings -> Less General Settings -> Check Advanced Calibration Settings.

## Step 4: Start sensor within xDrip
### Step 3: Start sensor within xDrip

In xDrip+ start the sensor with "Start Sensor" and "not today". It is not necessary to hold the mobile phone onto the sensor. In fact "Start Sensor" will not physically start any Libre 3 sensor or interact with them in any case. This is simply to indicate xDrip+ that a new sensor is delivering blood sugar levels. If available, enter two bloody measured values for the initial calibration. Now the blood glucose values should be displayed in xDrip+ every 5 minutes. Skipped values, e.g. because you were too far away from your phone, will not be backfilled.

Wait at least 15-20 minutes if there is still no data.

After a sensor change xDrip+ will automatically detect the new sensor and will delete all calibration data. You may check you bloody BG after activation and make a new initial calibration.

## Step 5: Configure AndroidAPS
### Step 4: Configure AndroidAPS

- In AndroidAPS go to Config Builder -> BG Source and check "xDrip+"
- If AndroidAPS does not receive BG values when phone is in airplane mode, use "Identify receiver"
- Turn of Smoothing (done in Xdrip+ already)

As of now, when using Libre 3 as a BG source, the "Always enable SMB" and "Enable SMB by Carbs" options cannot be enabled in the SMB algorithm. The BG values from Libre 3 are not smooth enough to use safely.



## Subsequent sensor changes

1. Open Juggluco and note the serial number of the existing sensor
Expand Down

0 comments on commit 6f0ec74

Please sign in to comment.