From 1f52692d07c920b7b9af9e35f8b8c0a504543c08 Mon Sep 17 00:00:00 2001 From: sudoxnym <76703581+sudoxnym@users.noreply.github.com> Date: Tue, 15 Apr 2025 12:37:36 -0600 Subject: [PATCH] Update README.md --- README.md | 197 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 101 insertions(+), 96 deletions(-) diff --git a/README.md b/README.md index 9e207b2..73e48eb 100644 --- a/README.md +++ b/README.md @@ -1,55 +1,60 @@

- Add to HACS + add to hacs

-

๐ŸŒ™ SAAS - Sleep As Android Status

+

๐ŸŒ™ saas - Sleep As Android status

-

๐Ÿ“– Description:

+

๐Ÿšจ breaking changes ๐Ÿšจ

+due to changes in **Home Assistant** 2025.12, you **must** remove your existing **SAAS** integration entries and re-add them after updating to this version. + +--- + +

๐Ÿ“– description:

-Sleep As Android Status is my solution for wake/sleep state within HA. It listens for the Sleep As Android MQTT Messages, so it does require being on the same network. As of 0.0.4 Buttons that link with the Companion app have been added. +sleep as android status is my solution for wake/sleep state within HA. it listens for the Sleep As Android MQTT messages, so it does require being on the same network. as of 0.0.4, buttons that link with the companion app have been added.

-

๐Ÿ’ก This integration works best with a Xioami MiBand (7 or older) mixed with the Notify app and Sleep As Android configured.

+

๐Ÿ’ก this integration works best with a **Xiaomi Mi Band** (7 or older) mixed with the notify app and Sleep As Android configured.

-

๐Ÿงฑ This integration will create:

+

๐Ÿงฑ this integration will create:

- โœ… Known working + โœ… known working
-

๐Ÿงช Installation:

+

๐Ÿงช installation:

-

โš™๏ธ Configuration:

+

โš™๏ธ configuration:

-๐Ÿ“ฒ Set Up Notify for Mi Band 7 -
    -
  1. Pair MiBand 7 as you normally would with Mi Fitness
    2. -
  2. Obtain auth key for Notify app using ADB
    3. -
+ ๐Ÿ“ฒ set up Notify for Mi Band 7 +
    +
  1. pair **Mi Band 7** as you normally would with Mi Fitness
    2. +
  2. obtain auth key for Notify app using ADB
    3. +
-
+  
 adb shell
 grep -E "authKey=[a-z0-9]*," /sdcard/Android/data/com.xiaomi.wearable/files/log/XiaomiFit.device.log |
 awk -F ", " '{print $17}' | grep authKey | tail -1 | awk -F "=" '{print $2}'
-

+
-

Credit: iamfosscad

+

credit: iamfosscad

-
    -
  1. Uninstall Mi Fitness
    2. -
  2. Download/Install Notify for Mi Band
    3. -
  3. Follow prompts, input auth key, select Mi Fitness is not installed
    4. -
  4. Enable Sleep as Android in Notify settings
    5. -
+
    +
  1. uninstall **Mi Fitness**
    2. +
  2. download/install Notify for Mi Band
    3. +
  3. follow prompts, input auth key, select Mi Fitness is not installed
    4. +
  4. enable Sleep As Android in Notify settings
    5. +
-๐Ÿ” Extracting the Zepp authKey on a Rooted Android Device -
+  ๐Ÿ” extracting the Zepp authKey on a rooted android device
+  
 su
 cd /data/data/com.huami.watch.hmwatchmanager/databases/
 ls origin_db_*
 sqlite3 origin_db_1234567890 "SELECT AUTHKEY FROM DEVICE;"
-

+
- +
-

๐Ÿ›Œ Sleep as Android Setup

+

๐Ÿ›Œ sleep as android setup

    -
  1. Open the app and follow setup
    2. -
  2. Settings wheel > Services > Automation > MQTT
    3. +
  3. open the app and follow setup
    4. +
  4. settings wheel > services > automation > MQTT
@@ -153,42 +158,42 @@ sqlite3 origin_db_1234567890 "SELECT AUTHKEY FROM DEVICE;"
    -
  1. Enable automatic tracking
    2. -
  2. Sensor: Sonar or Accelerometer
    3. -
  3. Wearables > Xiaomi Mi Band > Test sensor
    4. +
  4. enable automatic tracking
    5. +
  5. sensor: sonar or accelerometer
    6. +
  6. wearables > **Xiaomi Mi Band** > test sensor
- ๐Ÿ“ฆ Changes - 0.0.6a + ๐Ÿ“ฆ changes + 0.2.0 0.1.0 + + 0.0.6a +
- ๐Ÿšจ Known Issues - 
-Logger: homeassistant.helpers.service
-Source: /usr/src/homeassistant/homeassistant/helpers/service.py:708
-Failed to load integration: saas
-NoneType: None
-
-

๐Ÿ’ฌ No known effects. Just an error message, everything works as expected.

-

This is my first integration.

+ ๐Ÿšจ known issues +

๐Ÿ’ฌ no known issues at this time.