xDrip Software Installation Video – Android App, by Dietrich Lehr

NOTE: xDrip used to be called DexDrip so you might find some references to the old name in this article.

 

xDrip logoOnce the software has been loaded on the Wixel (see video on previous post) you will need to install the software on your Android phone/tablet which will read the data from the xDrip device.

UPDATE:
Since writing this page everything has been simplified and you no longer have to follow the steps in the video. Now you can just download the application here.

In this excellent video Dietrich Lehr takes us through each part of the installation, from the downloading of software, the installation of software, the creation of keys and finally loading that software onto your phone. Below the video are the links used in the video as well as the link to Android Studio’s download page as you will also need that app.

httpv://www.youtube.com/watch?v=Xv0PuM7dnYo

Links
Android Studio download home page (Android Studio installation video)
GitHub repository for xdrip Android app
xDrip Android app ZIP file

Thanks to Dieter Lehr for making and sharing this video.

xDrip Software Installation Video – Wixel, by Andrew Abramowicz

NOTE: xDrip used to be called DexDrip so you might find some references to the old name in this article.

 

xDrip logoOne of the key components of the xDrip device is the Wixel chip by Polollu, it’s the part which reads the data from the Dexcom transmitter. To get it up and running you need to load Stephen Black’s free software on it, a process which can seem daunting at first but really is simple.

In this excellent video Andrew Abramowicz takes us through each part of the installation, from the downloading of software, the installation of software, the configuration for your Dexcom transmitter and finally loading that software onto your Wixel. Below the video are the links used in the video.

httpv://www.youtube.com/watch?v=YVGqzYRQXkk

Links
GitHub repository for wixel-xdrip
wixel-xDrip ZIP file
Wixel drivers and software from Pollolu
Wixel Development Bundle

Thanks to Andew Abramowicz for letting me put this video up on my blog.

Interested in further posts about this subject? Why not like this blog’s Facebook page and get notified of updates, or click ‘Follow’ using the button at the bottom-right of this page.

PLEASE READ THIS ADVISORY

a) Never make a medical decision based on a reading from any CGM device, whether certified (eg Dexcom) or not (eg xDrip). Always perform a fingerstick blood glucose check first.
b) xDrip is a DIY product, decide for yourself if you wish to use it. Build it, test it, test it again and use (if you want to) in conjunction with a certified receiver.
c) The fact that it is working for us does not mean it’s right for you.
d) Never build a xDrip for anyone else and never sell one.
e) The blogs are provided for information only. We are not endorsing it for use by others, nor promoting it, just merely publishing our information as well as answering questions from previous blog articles.

Dexcom, Nightscout and xDrip – how does it all work together?

NOTE: xDrip used to be called DexDrip so you might find some references to the old name in this article.

 

xDrip Nightscout diagram v5My last three xDrip posts (introduction, components and building) have generated a few questions of which device, phone, cable or application goes where, so I thought I’d create a graphic of how I see it all working (well) together.

Scroll down for the large version of the graphic…don’t try and read that one on the right 🙂

Here’s a key to the graphic to help you see what comes from where:
Dexcom G4 CGM system
The Dexcom G4 continuous glucose monitoring system which Nightscout and xDrip are currently based on.
Nightscout
A full system of interfaces, cables, phones and applications to pull Dexcom glucose values from the Dexcom receiver, upload the data to the Internet and allow remote CGM monitoring via websites, phones, smartwatches. Designed and developed by people within the collective of Diabetes Parents who now front the Nightscout Foundation
xDrip
A do-it-yourself device and applications to retrieve data from the Dexcom CGM, using an independent algorithm to calculate the glucose reading, upload values to the same Internet database as used by Nightscout, to allow remote CGM monitoring. There is also a separate app (Nightwatch) which retrieves information from the Nightscout web site and relays info on to a smart watch. Designed and developed by Stephen Black.
Mongolabs.com
A cloud-based database solution, used to store the CGM readings uploaded by either the Nightscout Uploader application or the xDrip application.
xDrip Nightscout diagram v2
 
Interested in further posts about this subject? Why not like this blog’s Facebook page and get notified of updates, or click ‘Follow’ using the button at the bottom-right of this page.

PLEASE READ THIS ADVISORY

a) Never make a medical decision based on a reading from any CGM device, whether certified (eg Dexcom) or not (eg xDrip). Always perform a fingerstick blood glucose check first.
b) xDrip is a DIY product, decide for yourself if you wish to use it. Build it, test it, test it again and use (if you want to) in conjunction with a certified receiver.
c) The fact that it is working for us does not mean it’s right for you.
d) Never build a xDrip for anyone else and never sell one.
e) The blogs are provided for information only. We are not endorsing it for use by others, nor promoting it, just merely publishing our information as well as answering questions from previous blog articles.

A Dummy’s Guide to Building an #xDrip – #WeAreNotWaiting

NOTE: xDrip used to be called DexDrip so you might find some references to the old name in this article.

 

If you don’t know what a xDrip device is take a look at this page.

AdaFruit charger magnifiedI was tickled by someone on Reddit who linked to yesterday’s blog about the components required for a xDrip which was entitled “An “Amateur” builds a module for DexDrip”. So here it is, this amateur’s guide to building an xDrip/DexDrip. (The article actually referred to DexDrip as that what xDrip was called at the time.)

Interested in further posts about this subject? Why not like this blog’s Facebook page and get notified of updates, or click ‘Follow’ using the button at the bottom-right of this page.

PLEASE READ THIS ADVISORY

a) Never make a medical decision based on a reading from any CGM device, whether certified (eg Dexcom) or not (eg xDrip). Always perform a fingerstick blood glucose check first.
b) xDrip is a DIY product, decide for yourself if you wish to use it. Build it, test it, test it again and use (if you want to) in conjunction with a certified receiver.
c) The fact that it is working for us does not mean it’s right for you.
d) Never build a xDrip for anyone else and never sell one.
e) The blogs are provided for information only. We are not endorsing it for use by others, nor promoting it, just merely publishing our information as well as answering questions from previous blog articles.

A baptism of fire heat
Although I received lots of offers of help to solder the components together the guys at work told me I’d have no trouble doing it myself, so I decided to try.
First I ordered the soldering kit (iron, solder, stand, helping hands, solder sucker) from eBay and a practice board to train myself with. The ‘helping hands‘ turned out to be worth their weight in gold.
I soldered my first pin, inspected it and then soldered three more, choosing to solder them right next to each other as it seems that a common problem for amateurs is putting too much solder on. With four pins soldered I tested everything for continuity issues, to make sure no excess solder had spilled on to the adjacent contacts and shorted anything out.

practice board face uppractice board face down
So far, so good.
AdaFruit LiPo charger and batteryAttach LiPo-charger connector to battery
My AdaFruit LiPo-charger came with a connector, my battery came with a connector; they weren’t the same.
First job then was to cut the wires from each and solder the battery wires to the LiPo-charger connector.
NOTE: some people remove the connector terminal on the LiPo-charger and solder directly onto the charger board, I didn’t fancy this as I like to be able to disconnect batteries and swap them easily.
DO NOT connect battery to LiPo-charger.
AdaFruit charger magnifiedSolder wires to AdaFruit charger
The AdaFruit Li-Po battery charger then needed a power (red) and ground (black) wiring up.
For my first try I soldered a four-piece-header-pin to the board and used jumper wires to connect to it, but within a week I removed the header pins & soldered the wires directly onto the PCB.
1. Red wire, solder on to 3.3v (marked as BAT on mine), first on the left as we look at that board. Make sure you don’t solder on to the 5v connector.
2. Black wire, solder on to one of the GND connectors, for ease I chose the 3rd from the left.
WIXEL bluetooth wiresConnect wires for bluetooth module to WIXELWIXEL face down
Prepare four wires (red, black, green, blue) with one female header pin at one end and bare wire for soldering at the other.
1. Black, solder to GND
2. Red, solder to 3V3
3. Blue, solder to P1_6
4. Green, solder to P1_7

Other possible options: The header pin option is the simplest way to connect from WIXEL to HM-10.
The hardest (but not too bad) option is to desolder the HM-10’s header pins, then solder wires with two bare ends onto the WIXEL and to the HM-10.
The middle option is to solder wires with two bare ends, one end onto the WIXEL and one bare end onto the relevant header pin on the HM-10. Whilst this might seem easy I think it’s simpler to desolder the HM-10s header pins as above.

WIXEL and BLEConnecting the HM-10 Bluetooth moduleBLE face down
What you do next depends on what you chose to do on the ‘Connect wires for bluetooth module to WIXEL’ step:
If you soldered wires with female header connector at one end when you did the step above then all you need to do next is to slide the correct colour wire’s connector onto the correct HM-10 pin as per the diagram here.
If you soldered wires with two bare ends and left the header pins on the HM-10 then you need to solder the bare wire ends to the correct HM-10 header pin as per the diagram here. This is tricky to do (for me) but not impossible as I found when I made a second xDrip. I choose to wrap electrical tape around each soldered pin/wire afterwards.
If you soldered wires with two bare ends and removed the HM-10 header pins then just solder the bare ends onto the HM-10 as per the diagram here.
WIXEL power wiresSolder LiPo-charger wires to WIXELWIXEL face down
With the LiPo-charger disconnected from the battery (and micro-USB power) you now need to solder its wires to the WIXEL.
Red, solder to VIN
Black, solder to GND
 
The finished product
Hopefully by the end of it you’ll have something that looks like this:
20150109_205710
Note: the picture shows header pin connections for the AdaFruit Li-Po charger but I’ve now soldered the wires directly to the board, it now has a much smaller footprint.
 
Interested in further posts about this subject? Why not like this blog’s Facebook page and get notified of updates, or click ‘Follow’ using the button at the bottom-right of this page.

#WeAreNotWaiting thanks to #xDrip – Components Required

NOTE: xDrip used to be called DexDrip so you might find some references to the old name in this article.

 

If you don’t know what a xDrip device is take a look at this page.

partially made up xDripSince the release of my first comment about xDrip on Sunday morning my Facebook and Twitter notifications have gone crazy: ‘like’s everywhere, comments everywhere, questions everywhere. At stages I’ve been overwhelmed with my phone buzzing with notifications ten to the dozen and me not getting the time to answer the questions. This just goes to prove the level of interest in a set up like this.

By far the biggest questions I have been asked are:
    1. can I really build this myself as I’ve never soldered before?
    2. what components do I need?
    3. where can I buy these components?

The answer to 1 is easy: Yes, you probably can, I had never soldered anything electrical before starting this project, in fact I had to buy a soldering iron/kit just for this.

The rest of this blog should answer questions 2 and 3.

Interested in further posts about this subject? Why not like this blog’s Facebook page and get notified of updates, or click ‘Follow’ using the button at the bottom-right of this page.

PLEASE READ THIS ADVISORY

a) Never make a medical decision based on a reading from any CGM device, whether certified (eg Dexcom) or not (eg xDrip). Always perform a fingerstick blood glucose check first.
b) xDrip is a DIY product, decide for yourself if you wish to use it. Build it, test it, test it again and use (if you want to) in conjunction with a certified receiver.
c) The fact that it is working for us does not mean it’s right for you.
d) Never build a xDrip for anyone else and never sell one.
e) The blogs are provided for information only. We are not endorsing it for use by others, nor promoting it, just merely publishing our information as well as answering questions from previous blog articles.

Components you’ll need to buy, borrow or steal
(Okay, don’t steal, that’s not good.)
Thank you to Johan Lorant from the USA for information about the components he bought.

HM10 v CC41UPDATE WARNING
It seems there’s two types of chip being passed of as HM10, the second actually being a CC41 and it appears these will not work, although some do.
Be careful which one you get, check with the supplier before you order one but bear in mind that that supplier will only know what their supplier told them. Best thing is to get a proper photo of them beforehand and make sure it’s a HM10 as per the picture on the right.
BLE face upBluetooth Low Energy 4.0 BLE Tranceiver HM-10 Module
From eBay seller AudioSpectrumAnalyzers I’ve got a working HM10 (see warning above), in fact he even has ‘xdrip’ in the items listing title. Cost: under £12.
The first one I bought was off eBay for £15.29 from Aura Communications.
WIXEL face downThe heart of the xDrip device is the WIXEL chip.
I got mine – along with lots of stuff – from Hobby Electronics.
Cost: £13.80
In the USA, one place to get it from is from Jaycon Systems:
JS-3237 Wixel Programmable USB Wireless Module

AdaFruit LiPo charger and batteryAdaFruit LiPo (Lithium-ion Polymer battery and MicroUSB charger.
I got the charger from eBay for £7.70 each, I bought two. An alternative is Pimoroni at £7.
I got the battery from eBay too, 1200mAh ones, although note that Stephen (the designer of xDrip) only uses a 500mAh battery.
In the USA one place to get from is Jaycon Systems
JS-1965 Micro-USB Lipo Charger (MCP73831)
JS-3418 3.7 Volt Rechargeable Lithium Battery (850 mAh)
jumper-wires-ff-6in-500x500You’ll need some wires to link it all together. I bought these and cut them in half as I’m going to build another xDrip.
Cost: £2
In the USA one place to get these from is Jaycon Systems
JS-3958 Flat Ribbon Cable – 16 Wire (15 Ft) 1
SolderingkitHaving never soldered before I was in need of a few things, all of which I found in this kit. Note that everything works well apart from the solder, buy some good stuff elsewhere.
The ‘magic hands’ and magnifying glass were a Godsend, I couldn’t have done without them.
digital-multimeter-basic-500x500I wouldn’t be without my multimeter when dealing with electrical stuff but you don’t actually need one. I used one for the first xDrip I built but not for the 2nd or 3rd which I use as spares in demos.
Cost: £10 or so, from any DIY or electronic hobbyist store, such as HobbyTronics.
Interested in further posts about this subject? Why not like this blog’s Facebook page and get notified of updates, or click ‘Follow’ using the button at the bottom-right of this page.

#WeAreNotWaiting thanks to #xDrip – Introduction

xDrip logo on left, Nightscout logo on right
As you can see xDrip loves Nightscout
NOTE: xDrip used to be called DexDrip so you might find some references to the old name in this article.

 

Okay, I’ll own up, I know I shouldn’t be so excited about this but I am.
This is a game changer, for us and many, many more.
It proved its worth within 24 hours when I saw Amy was hypo whilst sleeping (see below). Amy wouldn’t have woken up and tested her blood glucose for another 4 or 5 hours but by having xDrip working I saw that she needed some glucose tablets to raise her blood glucose levels. 5 minutes later she was back asleep…for four more hours. #Teenagers!

Interested in further posts about this subject? Why not like this blog’s Facebook page and get notified of updates, or click ‘Follow’ using the button at the bottom-right of this page.

PLEASE READ THIS ADVISORY

a) Never make a medical decision based on a reading from any CGM device, whether certified (eg Dexcom) or not (eg xDrip). Always perform a fingerstick blood glucose check first.
b) xDrip is a DIY product, decide for yourself if you wish to use it. Build it, test it, test it again and use (if you want to) in conjunction with a certified receiver.
c) The fact that it is working for us does not mean it’s right for you.
d) Never build a xDrip for anyone else and never sell one.
e) The blogs are provided for information only. We are not endorsing it for use by others, nor promoting it, just merely publishing our information as well as answering questions from previous blog articles.

partially made up xDripSo what is xDrip?
xDrip is a combination of a device and a software application which receives data sent out by a Dexcom G4 CGM transmitter/sensor and displays the glucose readings on an Android phone. The app can also upload it’s data for use by Nightscout, which in turn means glucose readings are available on the internet via a PC/Mac, phone or even a smart watch (Pebble etc.).
xDrip is made up of two things:
1. The first is a do-it-yourself device, made up of four components which you can buy off the Internet and solder together. Total price is about £40 including battery. (That’s a partially made device on the right).
2. The second is the xDrip application which runs on Android phones (4.3+above with Bluetooth Low Energy (BLE) support). The app uses the xDrip device to read the output from a Dexcom CGM (continuous glucose monitor) sensor/transmitter. xDrip links up to existing Nightscout databases. The xDrip app can feed the data to a Nightscout database, which in turn means the data can be accessed via the Internet practically anywhere, using a PC/Mac, laptop, smartphone (Android/IOS/Windows) or better still a SmartWatch.

Wait! What? Nightscout? BLE? CGM? Dexcom? Animas?
Okay, it’s probably a good time to go over some of the common words I’ve used in the article. I’ll presume you’re already aware of insulin, insulin pumps, glucose levels and the world of Smartphones.
Animas – Animas is a company that makes insulin pumps. My daughter Amy has been using one of their pumps – called the Vibe (yeah, yeah, I know!) – since since June 2013. We chose the Animas Vibe specifically because of it’s use of Dexcom’s CGM system, although it turned out to be a whole year before we got the chance to use CGM.
BLE – is a version of the Bluetooth communication protocol which uses a low amount of energy, which means devices can work for longer without charging. Android has built-in support for BLE from version 4.3 onwards.
CGM – Continuous glucose monitor. A device which regularly samples the glucose level of its wearer, sampling the glucose in the interstitial fluid, not the blood. If you’re new to CGM perhaps take a look at this blog of mine: CGM: we’re live with Animas/Dexcom.
CGM-in-the-Cloud – is a term for any CGM which can be connected to a web site to allow for remote monitoring of someone’s glucose levels. It’s pretty big in USA, not so much over in Europe. A big player in this is Nightscout (see below).
Dexcom – Dexcom is one of many manufacturers of CGM systems. We use Dexcom because it’s linked with Amy’s Animas Vibe pump, if we’d got a Medtronic pump we’d use their Enlite CGM system. One benefit of Dexcom’s CGM appears to be that the sensors last longer – which is a big thing for us (who pay for CGM ourselves) as it lowers the total cost of using CGM. For the record I don’t believe Dexcom is any better than the new Medtronic Enlites.
Nightscout – Nightscout is “an open source, DIY project that allows real time access to a Dexcom G4 CGM from web browsers via smartphones, computers, tablets, and the Pebble smartwatch. The goal of the project is to allow remote monitoring of the T1D’s glucose level using existing monitoring devices.” In short Nightscout and the people behind it are awesome.

Who should we thank for xDrip?
Not me that’s for sure.
xDrip is the brainchild of Stephen Black, who was recently diagnosed with Type 1 Diabetes. With the help from others in the CGM-in-the-Cloud community Stephen has designed the xDrip device and written the software.
I think he deserves a big round of applause.

So how does it work?
SmartWatch

  • Dexcom sensor reads glucose level
  • Dexcom transmitter sends out data from sensor, like a split second radio broadcast
  • The xDrip app (on Android phone/tablet) controls the xdrip device to listen for and receive the Dexcom data.
  • The app displays information about the person’s glucose levels now and over the last day or so, indicating whether it rising or falling or staying level
  • If required the app can upload the data to a Nightscout database. We didn’t do this initially but set it up within the first week.
  • If using Nightscout parents (etc.) can view Nightscout info on a PC/website/smartwatch, like on the right. I’ve seen some great pictures of parents looking at their kid’s glucose level being displayed on the parent’s Pebble watch whilst the kid does some activity with their friends.
  • A further step is the use of another Android/smartphone application named Nightwatch, also written by Stephen. It relays information from the Nightscout data onto a secondary phone and potentially on to a smartwatch.

That’s Stephen’s SmartWatch above/right, showing the glucose levels on mg/dl (so don’t panic UK people).

Stuff you’ll need before using xDrip

  • Dexcom G4 CGM system, including transmitter and sensors.
  • An Android phone or tablet running version 4.3 or above and the ability to use BLE.
  • Components for the xDrip device (Wixel (£14), LiPo battery (£6) and charger (£6), BLE module (£15) and some wires to link it all together.
  • A case to put all the components in. (Yes I really must buy a case soon.)
  • A soldering iron or a friend/relative with one. I bought one off eBay for £12 including the iron, solder, iron stand/sponge and magic hands with magnifying glass.
  • A bit of patience. I didn’t have any but on reflection it would probably be a good thing.

In this next blog I detail the components I bought, which are pretty much the same components Stephen Black (the creator of xDrip) used.

Is this really a do-it-yourself project?
Yes. Definitely.
Before starting on this project I had never soldered any electrical components, I even had to buy a soldering kit specifically for this. Fair enough I program computers for a living but in this case my knowledge actually hindered my progress as I looked for a complicated solution to a problem I didn’t actually have. Luckily Stephen was on hand (via Twitter) to help me through it.
Soldering wise I’d say I spent a couple of hours in elapsed time making up the device, but that’s only because I was taking it very slowly to make sure I got nothing wrong. I’d imagine anyone with soldering experience would have this done in a few minutes.
If you don’t feel you can solder the components together why not ask a friend, relative or colleague?

xDrip's first 'catch'A real life example
With the xDrip device in Amy’s room, we checked that our tablet’s xDrip app could communicate with it when in our bedroom and also when downstairs in the kitchen; it could.
Off to bed we all went, everyone drifting off quick quickly, except me as I was busy staring at a tablet mesmerised by the information in front of me. (I really hope that’s a first night thing!)
At 7am I woke up and went downstairs, taking the tablet with me but not looking at it, placing it on charge in the kitchen, underneath Amy’s bedroom. I heard a noise and presumed it to be a mobile getting a Facebook notification or something. Then it happened again.
I realised it was Amy’s Animas Vibe pump vibrating to tell her that something wasn’t great, it was right she was low. Amy was fast asleep with the pump lying on the mattress beside her, she couldn’t feel it, it didn’t wake her. On the other hand I was in the room underneath and heard it, the vibration going through the mattress, down the bed itself, onto the floorboards, through the joists and onto the ceiling below!
So I checked the tablet and saw the image on the right. I waited 10 minutes to see if her level improved – it didn’t – and went up to wake her to give her a few glucose tablets. Amy went straight back to sleep, I went downstairs happy that she was no longer in danger.
Twenty minutes later I was pleased by the 5.5mmol showing on the xDrip app.

Interested in further posts about this subject? Why not like this blog’s Facebook page and get notified of updates, or click ‘Follow’ using the button at the bottom-right of this page.

 

Interested in what components you’ll need to build xDrip? Then read this: #WeAreNotWaiting thanks to #xDrip – Components Required