Extracting Step Count, Heart Rate, and Activity Data From the Mi-Band 5: A Guide with Gadgetbridge and R
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.
In this post, we will see how to extract step count, heart rate, and activity data from the Xiaomi Mi-Band 5 tracking device. The Mi-Band 5 is a relatively inexpensive personal tracker that was released in July of 2020. I bought one in August after my Fitbit died (after 888 days of use). I considered buying another Fitbit, but was not very pleased the lifespan of the previous one (the devices are apparently designed not to be very durable).
One nice thing about the Mi-Band is that it’s relatively straightforward to extract the activity data from the tracker. The approach described in this blog is as follows: first, we will install a modified Mi-Fit app in order to get access to an “auth key” which allows other applications to communicate with the tracker. We then install Gadgetbridge, an open source application that interfaces with and collects the data recorded by the Mi-Band tracker. Finally, we use Gadgetbridge to export the raw data from the device, and then use R to extract the data and format them for analysis.
The steps outlined below are for Android mobile devices (because that’s the kind of phone I have, though I imagine the steps would be similar for other types of phones). You can find the complete code on Github here. Let’s get started!
Part 1: Install the Modified Mi-Band App and Extract the “Auth Key”
The first step is to install a modified Mi-Band app and extract the “Auth Key.” This YouTube video gives a very clear overview of the process (you can download the modified app here). If you’re comfortable with Python, you can also apparently get the auth key programatically (see this guide here – I haven’t tested it myself), but for this post we won’t assume any Python knowledge.
Part 2: Install F-Droid & Gadgetbridge
Next, install F-Droid, a free software repository (like Google Play) for open source apps on Android. From F-Droid, you can search for and install Gadgetbridge, an open source mobile application that can interface with a number of different tracking devices (Pebble, Mi Band, Amazfit Bip, Hplus, among others).
You can find the information on how to connect the Mi-Band to Gadgetbridge using the auth key in the YouTube video mentioned above.
Part 3: Export the Data
It is very easy to export the data from the Mi-Band using Gadgetbridge. You can check out this web-page for the details, but all you really need to do is go to “Database Management” in the app and select “Export DB” (see the picture below). The data will be contained in the directory listed in the screenshot below.
When you navigate to the correct folder on your phone, you will find the database in SQLite format, simply called “Gadgetbridge”. The code below takes this data file as input.
Part 4: Extract and Clean the Data
Because Gadgetbridge works with a number of different fitness trackers, the SQLite database contains multiple tables (one table per supported device). Because we are exporting data from the Mi-Band, we need to extract data from the table named “MI_BAND_ACTIVITY_SAMPLE”.
This table contains the following variables:
- TIMESTAMP: This represents the time that a given row of data was recorded, using the Unix time format (see below for details).
- DEVICE_ID: This is an ID code that tracks the device from which a given row of data was recorded. This information is only useful if there are multiple devices linked to Gadgetbridge.
- USER_ID: This is an ID code that indicates which user’s information is recorded in the given row of data. This information is only useful if there are multiple users using multiple devices linked to Gadgetbridge.
- RAW_INTENSITY: This variable is a code representing the activity that is recorded in the given row of data. I find these categories somewhat inscrutable, and am not alone in that regard.
- STEPS: This represents the number of steps recorded in a given row of data.
- RAW_KIND: This appears to have something to do with activity codes, particularly for sleep. As with the RAW_INTENSITY variable, it seems there’s no clear agreement on what these codes mean (see here for more info).
- HEART_RATE: The heart rate measurement for the given row of data.
Granularity of the Data
One of the main issues is that the granularity in the recorded data is quite high. Specifically, data are written to database every second, but many observations are missing because not all parameters are measured every second. The maximum frequency for heart rate measurement, for example, is once per minute. The step counts are also written to the database once per minute.
In our extraction of the data, therefore, we will not read the second-level data into R. If you’ve recorded many weeks worth of data, you can easily end up with millions of rows if you don’t make some sensible exclusions in the query to the SQLite database.
In the code below, I make an immediate subset in the SQL query, selecting rows where the HEART_RATE variable is not equal to -1 and where the RAW_INTENSITY is variable is not equal to -1 (which occurs when there are missing values for both of these variables). The rows that remain contain the complete data for the variables that I care the most about: steps and heart rate.
Making Sense of the Time Stamp
The time stamp for each observation is recorded in Unix time, e.g. the number of seconds since January 1, 1970. In order to convert this to an interpretable format, I use the lubridate package to convert the values to an R date-time format. I specify the time zone I’m in (“Europe/Paris”) which gives the correct time conversion to when the measurements were taken.
Adding More Date Information
Because I often want to analyze step count data at the day/hour level, I extract the date and hour and add them as separate columns to the data frame with the lubridate package.
The Code to Extract the Data
The following code performs all of the operations discussed above. It returns a dataset with 1 row per minute, with the key parameters (described above) contained in the columns.
Here is a sample of the data extracted from the SQLite database with the above function:
TIMESTAMP | DEVICE_ID | USER_ID | RAW_INTENSITY | STEPS | RAW_KIND | HEART_RATE | TIMESTAMP_CLEAN | hour | date |
---|---|---|---|---|---|---|---|---|---|
1598598000 | 1 | 1 | 36 | 0 | 96 | 74 | 2020-08-28 09:00:00 | 9 | 2020-8-28 |
1598598060 | 1 | 1 | 57 | 21 | 1 | 76 | 2020-08-28 09:01:00 | 9 | 2020-8-28 |
1598598120 | 1 | 1 | 82 | 37 | 1 | 89 | 2020-08-28 09:02:00 | 9 | 2020-8-28 |
1598598180 | 1 | 1 | 29 | 7 | 16 | 87 | 2020-08-28 09:03:00 | 9 | 2020-8-28 |
1598598240 | 1 | 1 | 48 | 0 | 96 | 81 | 2020-08-28 09:04:00 | 9 | 2020-8-28 |
1598598300 | 1 | 1 | 26 | 0 | 96 | 79 | 2020-08-28 09:05:00 | 9 | 2020-8-28 |
1598598360 | 1 | 1 | 49 | 0 | 80 | 78 | 2020-08-28 09:06:00 | 9 | 2020-8-28 |
1598598420 | 1 | 1 | 72 | 12 | 80 | 90 | 2020-08-28 09:07:00 | 9 | 2020-8-28 |
1598598480 | 1 | 1 | 78 | 39 | 17 | 83 | 2020-08-28 09:08:00 | 9 | 2020-8-28 |
1598598540 | 1 | 1 | 40 | 0 | 16 | 74 | 2020-08-28 09:09:00 | 9 | 2020-8-28 |
Part 5: Aggregate to the Day / Hour Level
The raw data are recorded at the second level, and above we’ve done an extraction to obtain information at the minute level. However, this level of granularity is still a bit too detailed for analyzing step count data. In previous blog posts, I’ve done quite a bit of data analysis of step counts, usually analyzing steps per hour (instead of steps per minute).
The function below takes our second-level data frame and aggregates it to the day / hour level. It first sets to NA all measurements of heart rate that are greater than 250 (it’s unrealistic to ever have a heart rate this high and 255 is a code representing missing readings).
I then group the data by day and hour, and create three summary statistics: the total sum of steps within the hour, the average heart rate, and the standard deviation of the heart rate measurements. I also add a column containing the cumulative steps per day (this is the way the data are presented to the user on the device itself - the number of steps taken so far that day). Finally, I group the data by date and add a column with the total step count per day.
The last step in this function adds information about the day of the week for each observation, and then creates another column indicating whether the day was a weekday or a weekend (I know from previous analyses of my steps that the patterns are quite different on weekdays vs. weekends). I then re-arrange the columns and add a meta-data column called “device” which is set to ‘MiBand’. These data are now in a similar format as the step count data I’ve collected from previous devices - Accupedo and Fitbit.
The code to perform these steps looks like this:
Which returns a dataset named omnibus_mi_band that looks like this:
date | daily_total | hour | hourly_steps | cumulative_daily_steps | dow | week_weekend | mean_heart_rate | sd_heart_rate | device |
---|---|---|---|---|---|---|---|---|---|
2020-8-28 | 24800 | 9 | 3213 | 3747 | Fri | Weekday | 82.51 | 6.91 | MiBand |
2020-8-28 | 24800 | 10 | 6010 | 9757 | Fri | Weekday | 89.53 | 8.13 | MiBand |
2020-8-28 | 24800 | 11 | 1370 | 11127 | Fri | Weekday | 85.08 | 8.73 | MiBand |
2020-8-28 | 24800 | 12 | 791 | 11918 | Fri | Weekday | 82.02 | 7.93 | MiBand |
2020-8-28 | 24800 | 13 | 184 | 12102 | Fri | Weekday | 80.98 | 8.67 | MiBand |
2020-8-28 | 24800 | 14 | 5827 | 17929 | Fri | Weekday | 89.14 | 6.46 | MiBand |
2020-8-28 | 24800 | 15 | 771 | 18700 | Fri | Weekday | 84.68 | 9.02 | MiBand |
2020-8-28 | 24800 | 16 | 4276 | 22976 | Fri | Weekday | 84.82 | 6.91 | MiBand |
2020-8-28 | 24800 | 17 | 448 | 23424 | Fri | Weekday | 79.85 | 6.64 | MiBand |
2020-8-28 | 24800 | 18 | 484 | 23908 | Fri | Weekday | 80.07 | 8.99 | MiBand |
Part 6: Data Checks
When doing this type of data extraction and aggregation, it’s always best to do some checks to make sure the end result makes sense. In this case, there are at least 3 different checks that we can do.
- Count the number of observations per day. If we have done things correctly, we should have 24 observations per day (except for the day I started using Gadgetbridge and the day I extracted the data). We can check this with the following code:
Which returns:
2020-10-1 | 2020-10-10 | 2020-10-2 | 2020-10-3 | 2020-10-4 | 2020-10-5 | 2020-10-6 | 2020-10-7 | 2020-10-8 | 2020-10-9 | 2020-8-23 | 2020-8-24 | 2020-8-25 | 2020-8-26 | 2020-8-27 | 2020-8-28 | 2020-8-29 | 2020-8-30 | 2020-8-31 | 2020-9-1 | 2020-9-10 | 2020-9-11 | 2020-9-12 | 2020-9-13 | 2020-9-14 | 2020-9-15 | 2020-9-16 | 2020-9-17 | 2020-9-18 | 2020-9-19 | 2020-9-2 | 2020-9-20 | 2020-9-21 | 2020-9-22 | 2020-9-23 | 2020-9-24 | 2020-9-25 | 2020-9-26 | 2020-9-27 | 2020-9-28 | 2020-9-29 | 2020-9-3 | 2020-9-30 | 2020-9-4 | 2020-9-5 | 2020-9-6 | 2020-9-7 | 2020-9-8 | 2020-9-9 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
24 | 18 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 22 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 | 24 |
and
18 | 22 | 24 |
---|---|---|
1 | 1 | 47 |
Indeed, there are 24 observations for all days except the first day I used the Mi-Fit (2020-8-23) and the day I extracted the data for this blog post (2020-10-10).
-
Check the step count figures in our data frame with the step count figures displayed in the Gadgetbridge app. If we have done things correctly, the daily total step counts extracted in the above data should match the totals given in the app. If this is the case, we can be confident we have not “lost” any steps during our data extraction and transformations. In the example data shown above, the cumulative total steps for the date 2020-8-28 is 24,800; this is also the total step count given in the Gadgetbridge app for that date!
-
Check the step count figures in our data frame with the step count figures displayed on the device right after the data are extracted. Specifically, the total cumulative and total daily steps for the most recent observation in the data set should match the step count on the Mi-Band (presuming you remain seated when extracting the data and conducting the analysis). Every time I’ve done this, the figures have lined up, giving me further confidence that this approach is retrieving all the data correctly.
Part 7: Make a Plot
One of the best ways of exploring data is by making graphs or plots of relationships among variables. Let’s make a quick plot with the data we have extracted here. We will borrow some plotting code from the very first blog post I ever did about step count data. Specifically, we’ll plot out the cumulative step counts across the hours of the day, with separate loess regression lines for weekdays and weekends.
Which returns the following plot:
This plot is very interesting - the patterns are quite different than they were in the first blog post about my step counts. Firstly, overall the step count values are lower. I think this is partially because I walk a bit less than I did 3 years ago, and partially because Accupedo seemed to record more steps than the Mi-Band does.
Second, the patterns of step counts during weekdays and weekends have reversed! Three years ago, I walked more on weekdays than I did on weekends. At that point, I walked back and forth to work every day, which meant that my step count was rather high during the week. The data displayed above were collected between the end of August and the beginning of October 2020. This was during COVID time, and I was working from home (meaning no steps for commuting). During this period, I tried to walk a fair amount every day, but it’s not easy to do 15,000 steps when your desk is 20 steps from your bedroom!
Summary and Conclusion
In this post, we saw how to extract data from the Mi-Band 5 with Gadgetbridge. We first used a modified Mi-Fit app to extract the “auth key”, which allowed us to connect the open source Gadgetbridge app to the Mi-Band device. We used Gadgetbridge to export an SQL database containing the data recorded by the Mi-Band. We used R to extract the raw data per minute, and then aggregated those data to the day / hour level. Finally, we made a basic plot of the extracted data and saw how my walking patterns differ on weekdays versus weekends. A comparison with a blog post from 3 years ago shows that my walking patterns are definitely different now!
Coming Up Next
In the next blog post, we’ll look at my step count data for 2020, and see how the COVID-19 crisis impacted the way I moved around this past year.
Stay tuned!
R-bloggers.com offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.