From 11b234c8bdb53a64d4cb730c2231db4b424896fb Mon Sep 17 00:00:00 2001 From: Arslaan Pathan Date: Sun, 29 Mar 2026 15:37:49 +1300 Subject: Add some explanations in the README --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index afee4e9..9f71382 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,23 @@ -# freefit (also known as: FereFit, Lyne_Wearables, HomieFit, zwsvibe, WIRCASS) +# zwzn-freefit-re Reverse-engineering a sketchy Chinese watch app Documentation/protocols derived from decompiled FereFit Android app (jadx) (com.czw.freefit, SHENZHEN ZHONGWEI INTELLIGENT TECHNOLOGY Co.,Ltd) +## What this is and why it exists + +This is a git repo containing protocol documentation of the `freefit` watch app, commonly known as "FereFit", "Lyne_Wearables", "HomieFit", "zwsvibe", and "WIRCASS". It allows us to make our own app implementations for some watches that use these apps. In particular, my testing occurs with the "Watch ULTRA", which I cannot find any more brand information on, though it's a sort of no-name Apple Watch ULTRA knockoff. Although, this protocol should work fine for most other watches that use these apps. + +This exists for many reasons, though here are the top few: + +- I'm 13 and have too much free time +- I wanted to get into reverse-engineering +- I had an old knockoff "Watch ULTRA" from the arcade, and the original app was spyware +- The RTC on this watch drifts badly, so without an app to periodically synchronize it, it becomes almost unusable + +Anyway, talk is cheap, let's get into the documentation! + ## BLE characteristics ### Main characteristics (presumably Nordic UART/Nordic semiconductor chips) -- cgit v1.2.3