xDrip Documentation

website·Indexed 30 days ago

https://navid200.github.io/

User guides and technical documentation for xDrip, focusing on integration with Dexcom G6, G7, One+, and Stelo sensors. Includes setup instructions for xDrip sync, Nightscout uploads, battery optimization, and troubleshooting for transmitter connectivity and sensor errors.

Tokens
28.1K
Snippets
29
Records
247
Agent score
74%

What's inside xDrip

  1. Overview of xDrip CGM system

    xDrip is an open-source Android application (compatible with Android versions 8 through 17) designed to turn a mobile device into a continuous glucose monitoring (CGM) system. It allows users to interact with various CGM devices, customize alerts, monitor other users (such as children or partners), and perform statistical analysis on glucose data.
  2. Understand Dexcom G7 session management in xDrip

    Unlike the Dexcom G6, the G7 integrates the sensor and transmitter into a single disposable device. A G7 session starts automatically upon insertion via the applicator; therefore, no manual start function is required. Because a G7 session cannot be restarted once stopped, xDrip has removed the manual stop function to prevent users from accidentally and permanently disabling a functional sensor. Additionally, stopping a session does not stop the transmitter from sending Bluetooth signals, as the transmitter continues to broadcast every five minutes until the battery is exhausted.
  3. Understand Dexcom sample-and-hold connectivity behavior

    Dexcom uses a sample-and-hold system where data updates occur every 5 minutes. xDrip reflects these reports on the same 5-minute cycle. Commands (such as 'Stop Sensor') are queued and sent to the transmitter during the next reading cycle; however, the transmitter will not acknowledge the command until the subsequent 5-minute update. Consequently, changes may take up to 10 minutes to be confirmed on the status page.
  4. Use Nightscout as a data repository for xDrip

    Nightscout acts as a remote repository for xDrip glucose readings. Using Nightscout provides three primary benefits: it enables the creation of comprehensive reports for endocrinologists, allows for long-term tracking of glucose control, and serves as a backup to prevent data loss if the mobile device is lost or damaged. Additionally, Nightscout can be used as a server to share real-time data with followers.
  5. Understand xDrip and Dexcom Clarity compatibility

    xDrip can collect data directly from Dexcom G6, Dexcom One, G7, One+, and Stelo sensors. However, xDrip cannot upload data to Dexcom Clarity. Additionally, xDrip and the official Dexcom app cannot both act as collectors from the same sensor device simultaneously.
  6. Configure xDrip update channels

    xDrip offers four update channels that determine which releases you are notified about. You can configure this in Main Settings -> xDrip Update Settings. Enabling Automatic update check will trigger notifications when a new release in your chosen channel becomes available.

    ChannelDescriptionAverage Frequency
    NightlyMost up-to-date but least tested~30 times/year
    AlphaEarlier release than betaTwice a year
    Beta / StableMost tested (default)Twice a year

    Note: To enable the 'Nightly' option, you must first select the 'Alpha' channel, return to the main screen, and then return to the Update Settings page.

  7. Understand CGM calibration in xDrip

    Calibration is the process of providing a CGM sensor with blood glucose readings from a glucose meter to establish a correlation between interstitial fluid glucose and estimated blood glucose. Accuracy is influenced by the blood glucose meter's precision, sensor sensitivity, the correlation formula, and a typical 10-minute physiological delay between blood and interstitial fluid glucose levels.
  8. Understand Dexcom sample-and-hold connectivity timing

    Dexcom uses a sample-and-hold system where data updates occur every 5 minutes. xDrip reflects these reports on the same 5-minute cycle. Commands (such as 'Stop Sensor') are queued and only processed by the transmitter during the next reading cycle. Confirmation of these commands will only appear on the status page after the transmitter acknowledges the request in the subsequent 5-minute update.
  9. Manage Glucose Level Alerts in xDrip

    Glucose Level Alerts are configured via the path Settings -> Alarms and Alerts -> Glucose Level Alerts List. From this menu, you can create new alerts by tapping 'Create Low Alert' or 'Create High Alert', and modify existing alerts by performing a long press on the alert entry.
  10. Enable xDrip Engineering Mode

    Engineering mode provides access to functions that are not fully tested, intended for specific conditions, or not meant for regular use. To enable it:

    1. Tap the dropper (syringe) symbol on the main screen.
    2. Tap the microphone symbol at the bottom right corner of the form.
    3. Use the voice command: Enable engineering mode.

    If the voice command fails, long-press the microphone symbol, type enable engineering mode into the form that appears, and press enter.

  11. Prepare Dexcom G6 or Dexcom ONE hardware

    Before starting the sensor in xDrip, ensure you have the following hardware and information:

    1. Transmitter: Locate the serial number on the bottom of the transmitter or on the box. If the serial number ends in -1, omit the -1 and use only the first six characters.
    2. Sensor: Locate the 4-digit calibration code on the sensor adhesive cover. Do not open the sensor container until you are ready for insertion.
    3. Android Phone: Ensure the Dexcom app is uninstalled, as xDrip and the Dexcom app cannot both act as collectors simultaneously.