aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorArslaan Pathan <[email protected]>2026-03-29 15:37:49 +1300
committerArslaan Pathan <[email protected]>2026-03-29 15:37:49 +1300
commit11b234c8bdb53a64d4cb730c2231db4b424896fb (patch)
tree71c74b38ff6dc04af517ea2cd16cf4d4795c0679
parent66b2e17f34553c5b161a12d1591d46bc1a2d9a91 (diff)
downloadzwzn-freefit-re-11b234c8bdb53a64d4cb730c2231db4b424896fb.tar.xz
zwzn-freefit-re-11b234c8bdb53a64d4cb730c2231db4b424896fb.zip
Add some explanations in the README
-rw-r--r--README.md15
1 files changed, 14 insertions, 1 deletions
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)