Skip to content

Latest commit

 

History

History
130 lines (114 loc) · 7.15 KB

README.md

File metadata and controls

130 lines (114 loc) · 7.15 KB
Raw

Export 2 to Garmin Connect

1. Introduction

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.2 (import_data.sh)
=============================================

18.07.2024-16:56:01 SYSTEM * BLE adapter enabled in export2garmin.cfg, check if available
18.07.2024-16:56:01 SYSTEM * BLE adapter hci0(00:00:00:00:00:00) working, check if temp.log 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
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
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:

alt text

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:

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:

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:

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):

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

Buy Me A Coffee