Export 2 to Garmin Connect

1. Introduction

• This project is based on following projects:
  • https://github.com/cyberjunky/python-garminconnect;
  • https://github.com/wiecosystem/Bluetooth;
  • https://github.com/userx14/omblepy;
  • https://github.com/lolouk44/xiaomi_mi_scale;
  • https://github.com/dorssel/usbipd-win;
  • https://github.com/rando-calrissian/esp32_xiaomi_mi_2_hass.

1.1. Miscale module (once known as miscale2garmin):

• Allows fully automatic synchronization of Mi Body Composition Scale 2 (tested on XMTZC05HM) directly to Garmin Connect, with following parameters:
  • Date and Time (measurement, from device);
  • Weight (NOTE: lbs is automatically converted to kg);
  • BMI (Body Mass Index);
  • Body Fat;
  • Skeletal Muscle Mass;
  • Bone Mass;
  • Body Water;
  • Physique Rating;
  • Visceral Fat;
  • Metabolic Age.
• Miscale_backup.csv file also contains other parameters (can be imported e.g. for analysis into Excel):
  • BMR (Basal Metabolic Rate);
  • LBM (Lean Body Mass);
  • Ideal Weight;
  • Fat Mass To Ideal;
  • Protein;
  • Data Status (to_import, failed, uploaded);
  • Unix Time (based on Date and Time);
  • Email User (used account for Garmin Connect);
  • Upload Date and Upload Time (to Garmin Connect);
  • Difference Time (between measuring and uploading);
  • Battery status in V and % (ESP32 only).
• Supports multiple users with individual weights ranges, we can link multiple accounts with Garmin Connect.

1.2. Omron module:

• Allows fully automatic synchronization of Omron blood pressure (tested on M4/HEM-7155T and M7/HEM-7322T Intelli IT) directly to Garmin Connect, with following parameters:
  • Date and Time (measurement, from device);
  • DIAstolic blood pressure;
  • SYStolic blood pressure;
  • Heart rate.
• Omron_backup.csv file also contains other parameters (can be imported e.g. for analysis into Excel):
  • Category (NOTE: EU and US classification only);
  • MOV (Movement detection);
  • IHB (Irregular Heart Beat);
  • Data Status (to_import, failed, uploaded);
  • Unix Time (based on Date and Time);
  • Email User (used account for Garmin Connect);
  • Upload Date and Upload Time (to Garmin Connect);
  • Difference Time (between measuring and uploading).
• Supports 2 users from Omron device, we can connect 2 accounts with Garmin Connect.

1.3. User module:

• Enables configuration of all parameters related to integration Miscale and Omron;
• Provides export Oauth1 and Oauth2 tokens of your account from Garmin Connect (MFA/2FA support).

2. How does this work

• Miscale and Omron modules can be activated individually or run together:

$ /home/robert/export2garmin-master/import_data.sh

=============================================
Export 2 Garmin Connect v2.4 (import_data.sh)
=============================================

18.07.2024-16:56:01 SYSTEM * Default path to export.lock and temp.log files: /dev/shm/
18.07.2024-16:56:01 SYSTEM * Default path to export2garmin.cfg and *_backup.csv files: /home/robert/export2garmin-master/user/
18.07.2024-16:56:01 SYSTEM * BLE adapter is ON in export2garmin.cfg file, check if available
18.07.2024-16:56:01 SYSTEM * BLE adapter hci0(00:00:00:00:00:00) working, check if temp.log file exists
18.07.2024-16:56:01 SYSTEM * temp.log file exists, go to modules
18.07.2024-16:56:01 MISCALE * Module is ON in export2garmin.cfg file
18.07.2024-16:56:01 MISCALE * miscale_backup.csv file exists, checking for new data
18.07.2024-16:56:01 MISCALE * Importing data from a BLE adapter
18.07.2024-16:56:06 MISCALE * Saving import 1721314589 to miscale_backup.csv file
18.07.2024-16:56:07 MISCALE * Calculating data from import 1721314589, upload to Garmin Connect
18.07.2024-16:56:07 MISCALE * Data upload to Garmin Connect is complete
18.07.2024-16:56:07 MISCALE * Saving calculated data from import 1721314589 to miscale_backup.csv file
18.07.2024-16:56:07 OMRON * Module is ON in export2garmin.cfg file
18.07.2024-16:56:07 OMRON * omron_backup.csv file exists, checking for new data
18.07.2024-16:56:07 OMRON * Importing data from a BLE adapter
18.07.2024-16:56:39 OMRON * Prepare data for omron_backup.csv file
18.07.2024-16:56:40 OMRON * Calculating data from import 1721314552, upload to Garmin Connect
18.07.2024-16:56:40 OMRON * Data upload to Garmin Connect is complete
18.07.2024-16:56:40 OMRON * Saving calculated data from import 1721314552 to omron_backup.csv file

• Synchronization diagram from Export 2 to Garmin Connect:

2.1. Miscale module | BLE VERSION

• After weighing, Mi Body Composition Scale 2 is active for 15 minutes on bluetooth transmission;
• USB Bluetooth adapter or internal module scans BLE devices for 10 seconds to acquire data from scale;
• Body weight and impedance data on server are appropriately processed by scripts;
• Processed data are sent to Garmin Connect;
• Raw and calculated data from scale is backed up on server in miscale_backup.csv file.

Select your platform and go to instructions:

• Debian 12 | Raspberry Pi OS (based on Debian 12);
• Windows 11.

2.2. Miscale module | ESP32 VERSION

• After weighing, Mi Body Composition Scale 2 is active for 15 minutes on bluetooth transmission;
• ESP32 module operates in a deep sleep and wakes up every 7 minutes, scans BLE devices for 10 seconds to acquire data from scale, process can be started immediately via reset button;
• ESP32 module sends acquired data via MQTT protocol to MQTT broker installed on server;
• Body weight and impedance data on server are appropriately processed by scripts;
• Processed data are sent to Garmin Connect;
• Raw and calculated data from scale is backed up on server in miscale_backup.csv file.

Select your platform and go to instructions:

• Debian 12 | Raspberry Pi OS (based on Debian 12);
• Windows 11.

2.3. Omron module | BLE VERSION

• After measuring blood pressure, Omron allows you to download measurement data once;
• USB bluetooth adapter or internal module scans BLE devices for 10 seconds to acquire data from blood pressure device (downloading data can take about 1 minute);
• Pressure measurement data are appropriately processed by scripts on server;
• Processed data are sent to Garmin Connect;
• Raw and calculated data from device is backed up on server in omron_backup.csv file.

Select your platform and go to instructions:

• Debian 12 | Raspberry Pi OS (based on Debian 12);
• Windows 11.

3. Mobile App

I don't plan to create a mobile app, but I encourage you to take advantage of another projects (applies to Mi Body Composition Scale / Mi Scale support only):

• Android: https://github.com/lswiderski/mi-scale-exporter;
• iOS | iPadOS: https://github.com/lswiderski/WebBodyComposition.

If you like my work, you can buy me a coffee