feat: configRealTimeMeasure

2 files changed, 72 insertions, 0 deletions

diff --git a/FereFit_configRealTimeMeasure_BLE.py b/FereFit_configRealTimeMeasure_BLE.py
new file mode 100644
index 0000000..3059263
--- /dev/null
+++ b/FereFit_configRealTimeMeasure_BLE.py
@@ -0,0 +1,53 @@
+import asyncio
+import sys
+try:
+    from bleak import BleakScanner, BleakClient
+except ModuleNotFoundError:
+    print("Error importing bleak, are you sure you installed it?")
+    print("Try running the following command: \"pip3 install bleak\"")
+    print("If that fails, try this: \"pip3 install bleak --break-system-packages\"")
+    sys.exit(1)
+
+async def sync(device_name: str):
+    print(f"Scanning for {device_name}...")
+    device = await BleakScanner.find_device_by_name(device_name, timeout=10)
+    if not device:
+        print("Watch not found!")
+        return
+    print(f"Found at {device.address}")
+
+    got_aggregate = False
+    got_generic = False
+
+    def notification_handler(sender, data):
+        nonlocal got_aggregate, got_generic
+        if data[0] == 0xE1:
+            aggregate_rates = [data[1], data[5], data[6], data[7]]  # skip 2-4 because they seem to be zero padding or something redundant
+            print(f"Got aggregate rates: {aggregate_rates}")
+            got_aggregate = True
+        if data[0] == 0x94:
+            print(f"Got generic measurement: {data[1]}")
+            got_generic = True
+
+    try:
+        async with BleakClient(device) as client:
+            await client.start_notify("6E40FC21-B5A3-F393-E0A9-E50E24DCCA9E", notification_handler)
+            # byte[1] = 0x00 for heart rate, TODO add more measurements later, maybe split into separate scripts if logic differs
+            packet = bytes([0x60, 0x00, 0x01])
+            await client.write_gatt_char("6E40FC20-B5A3-F393-E0A9-E50E24DCCA9E", packet)
+            while not got_generic:
+                await asyncio.sleep(1)
+            while not got_aggregate:
+                await asyncio.sleep(1)
+            # byte[2] = 0x00 for stop
+            packet = bytes([0x60, 0x00, 0x00])
+            await client.write_gatt_char("6E40FC20-B5A3-F393-E0A9-E50E24DCCA9E", packet)
+            await client.stop_notify("6E40FC21-B5A3-F393-E0A9-E50E24DCCA9E")
+    except Exception as e:
+        print(f"Failed: {e}")
+
+if __name__ == "__main__":
+    watch_name = input("Enter watch name shown in BLE discovery (default: Watch ULTRA): ")
+    if watch_name == "":
+        watch_name = "Watch ULTRA"
+    asyncio.run(sync(watch_name))
diff --git a/README.md b/README.md
index 6496c92..a838a5e 100644
--- a/README.md
+++ b/README.md
@@ -68,6 +68,22 @@ byte[1] = 0x01 to start vibrating, else 0x00
 
 Response: 0xD1 0x01 for vibrating, else 0xD1 0x00 (6E40FC21)
 
+### configRealTimeMeasure (heart rate/blood oxygen/blood pressure/blood sugar)
+
+Real-time measurements packet structure (write/6E40FC20)
+```
+byte[0] = 0x60 (command)
+byte[1] = 0x00 if heart rate, 0x02 if blood oxygen, 0x03 if blood sugar, 0x01 if blood pressure
+byte[2] = 0x01 to start measuring, else 0x00
+```
+
+Heart rate possible responses:
+
+- Generic measurements: 0x94 <measurement>, e.g. 0x94 0x55
+- Aggregate measurements: 0xE1 <measurement 1> 0x00 0x00 0x00 <measurement 2> <measurement 3> <measurement 4> 0x00, e.g. 0xE1 0x58 0x00 0x00 0x00 0x57 0x58 0x55 0x00
+
+Other responses (blood oxygen, blood pressure, blood sugar) have not been tested yet.
+
 ### enterMakeDial (watch face)
 
 Watch face header packet (write/6E40FC20)  
@@ -91,6 +107,8 @@ byte[21]    = show date (0x01 = yes, 0x00 = no)
 
 Header packet is followed by chunked RGB565 data, 1 chunk = MTU-14 bytes
 
+This function/protocol has not been tested yet, don't expect this structure of headers and RGB565 data to work at the moment. Could very well change drastically if other parts of the protocol are found
+
 ## Scripts and tests
 
 Located in the root of this git repo are some test scripts and files to get you going with your own implementations. BLE implementations are written in Python + the bleak library from PyPI.
@@ -99,6 +117,7 @@ The following scripts are available:
 
 - FereFit_syncTime_BLE.py --- synchronizes the time on the watch
 - FereFit_switchFindBand_BLE.py --- vibrates the watch for 5 seconds
+- FereFit_configRealTimeMeasure_BLE.py --- measures heart rate, TODO add more measurements later
 
 They are named after FereFit, one of the names of the app, because I am decompiling the FereFit APK (even though it's all one codebase under different names, the app detects which one it's meant to be using functions such as isFereFit() and isHomieFit(), etc and just sets the UI and API to that).  
 They will probably stay that way because I can't be bothered to rename them to freefit, and therefore future ones will also be named after FereFit for consistency or something like that.