Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/RobertWojtowicz/export2garmin

Export Miscale and Omron data to Garmin Connect
https://github.com/RobertWojtowicz/export2garmin

blood-pressure bluetooth esp32 fitness garmin garmin-api garmin-connect iot miscale miscale2garmin mqtt omron raspberry scale wifi xiaomi

Last synced: 10 days ago
JSON representation

Export Miscale and Omron data to Garmin Connect

Awesome Lists containing this project

README 

        
# 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.5 (import_data.sh)

=============================================



18.07.2024-16:56:01 SYSTEM * Path to temp files: /dev/shm/

18.07.2024-16:56:01 SYSTEM * Path to user 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:



![alt text](https://github.com/RobertWojtowicz/export2garmin/blob/master/manuals/workflow.png)



### 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)](https://github.com/RobertWojtowicz/export2garmin/blob/master/manuals/Miscale_BLE.md);

- [Windows 11](https://github.com/RobertWojtowicz/export2garmin/blob/master/manuals/all_BLE_win.md).



### 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)](https://github.com/RobertWojtowicz/export2garmin/blob/master/manuals/Miscale_ESP32.md);

- [Windows 11](https://github.com/RobertWojtowicz/export2garmin/blob/master/manuals/Miscale_ESP32_win.md).



### 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)](https://github.com/RobertWojtowicz/export2garmin/blob/master/manuals/Omron_BLE.md);

- [Windows 11](https://github.com/RobertWojtowicz/export2garmin/blob/master/manuals/all_BLE_win.md).



## 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

Buy Me A Coffee