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.
What's inside xDrip
- 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.
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.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.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.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.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. EnablingAutomatic update checkwill trigger notifications when a new release in your chosen channel becomes available.Channel Description Average Frequency Nightly Most up-to-date but least tested ~30 times/year Alpha Earlier release than beta Twice a year Beta / Stable Most 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.
Follow glucose readings using xDrip Sync
xDrip Sync Follower is an available scheme for displaying someone else's readings in real time. It is noted as being easy to set up.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.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.Manage Glucose Level Alerts in xDrip
Glucose Level Alerts are configured via the pathSettings->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.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:
- Tap the dropper (syringe) symbol on the main screen.
- Tap the microphone symbol at the bottom right corner of the form.
- Use the voice command:
Enable engineering mode.
If the voice command fails, long-press the microphone symbol, type
enable engineering modeinto the form that appears, and press enter.Prepare Dexcom G6 or Dexcom ONE hardware
Before starting the sensor in xDrip, ensure you have the following hardware and information:
- Transmitter: Locate the serial number on the bottom of the transmitter or on the box. If the serial number ends in
-1, omit the-1and use only the first six characters. - Sensor: Locate the 4-digit calibration code on the sensor adhesive cover. Do not open the sensor container until you are ready for insertion.
- Android Phone: Ensure the Dexcom app is uninstalled, as xDrip and the Dexcom app cannot both act as collectors simultaneously.
- Transmitter: Locate the serial number on the bottom of the transmitter or on the box. If the serial number ends in