Home
Softono
export2garmin

export2garmin

Open source Python
GitHub
264
Stars
36
Forks
0
Issues
10
Watchers
1 week
Last Commit
Workout & Activity Tracking IoT & Embedded

About export2garmin

export2garmin automatically synchronizes data from Xiaomi Mi Body Composition Scales and Omron blood pressure monitors to Garmin Connect. The Miscale module supports Mi Body Composition Scale 2 (XMTZC05HM) and S400 (MJTZC01YM), uploading weight, BMI, body fat, muscle mass, bone mass, body water, physique rating, visceral fat, metabolic age, and heart rate, with automatic lbs to kg conversion. It supports multiple users with individual weight ranges. The Omron module supports M4 (HEM-7155T) and M7 (HEM-7322T Intelli IT) devices, uploading diastolic and systolic blood pressure plus heart rate, supporting two users. Both modules generate CSV backup files containing additional parameters like BMR, LBM, impedance, battery status, blood pressure category, movement detection, and irregular heartbeat flags for analysis in Excel. The modules can run individually or together, with options for sequential or parallel operation using one or two USB Bluetooth adapters. The User module handles configuration and manages Garm

Platforms

Web Self-hosted

Languages

Python

Links

Source Code
r
Published by
robertwojtowicz
Visit View Profile

README.md

View on GitHub

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) or Xiaomi Body Composition Scale S400 (tested on MJTZC01YM) directly to Garmin Connect, with following parameters:
    • Date and Time (measurement, from device);
    • Weight (NOTE: lbs is automatically converted to kg, applies to Mi Body Composition Scale 2);
    • BMI (Body Mass Index);
    • Body Fat;
    • Skeletal Muscle Mass;
    • Bone Mass;
    • Body Water;
    • Physique Rating;
    • Visceral Fat;
    • Metabolic Age;
    • Heart rate (Xiaomi Body Composition Scale S400 only, optional upload to blood pressure section).
  • 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 - Mi Body Composition Scale 2 only);
    • Impedance;
    • Impedance Low (Xiaomi Body Composition Scale S400 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:
    • Devices can run together (Mi Body Composition Scale 2 and Omron);
    • Devices can run together but there must be a sequence, first measuring blood pressure and then weighing (Xiaomi Body Composition Scale S400 and Omron);
      This is because Xiaomi Body Composition Scale S400 requires continuous scanning, importing data from scale will allow you to go to Omron module.
    • Devices can run together in parallel but two USB Bluetooth adapters are required, one for scanning Xiaomi Body Composition Scale S400 and other for Omron;
      This is an using separate processes, view section 2.6.4.
  • Synchronization diagram from Export 2 to Garmin Connect:

alt text

2.1. Miscale module | Mi Body Composition Scale 2 | 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;
  • This part of project is no longer being developed, but it still works.

Select your platform and go to instructions:

2.2. Miscale module | Mi Body Composition Scale 2 | 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;
  • This part of project is no longer being developed, but it still works.

Select your platform and go to instructions:

2.3. Miscale module | Xiaomi Body Composition Scale S400 | BLE VERSION

  • After weighing, Xiaomi Body Composition Scale S400 transmits weight data for a short while on bluetooth transmission;
  • A USB Bluetooth adapter scans BLE devices continuously to acquire data from scale;
  • Data from scale is decrypted and parsed into a readable form;
  • 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.4. 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 / S400):

4. Synchronizing data between different ecosystems

A very interesting project called SmartScaleConnect synchronizes scale data (applies to Mi Body Composition Scale 2 / S400) from Xiaomi cloud to Garmin:

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

Buy Me A Coffee