🌙 saas - Sleep As Android status

🚨 0.2.0 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.

💡 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:

📡 8 sensors
- message received *state*
- wake status
- sound
- disturbance
- alarm
- lullaby
- sleep tracking
- sleep stage
this should intelligently and dynamically allow for state changes in the wake status sensor.
🎛️ 8 buttons
- alarm dismiss
- alarm snooze
- lullaby stop
- sleep tracking pause
- sleep tracking resume
- sleep tracking start
- sleep tracking start with optimal alarm
- sleep tracking stop

🛠️ 1 service

service: saas.saas_example_alarm_set
data:
  message: Example Message!
  day: monday
  hour: 7
  minute: 30

🔗 1 device per user

one HA device is created per configured user instance to link sensors, services, and buttons.

✅ known working

📟 **Xiaomi Mi Band 7**
📟 **Xiaomi Mi Band 8** and **Mi Band 9** may work, but they have a different os that jumps through hoops to work.
⌚ **Garmin Fenix 7X** with garmin alternative, **not** the free one.
⌚ **Xiaomi Amazfit GTR Mini** — may require root. i am rooted so i just did what's in this guide, but there may be alternative ways to get the key.

🧪 installation:

add https://www.github.com/sudoxnym/saas to your custom repositories in HACS
search and download **SAAS - Sleep As Android status**
restart Home Assistant
add integration: **SAAS - Sleep As Android status**

⚙️ configuration:

name: name of user
topic: MQTT topic from Sleep As Android
qos: quality of service
awake duration: time in seconds in which awake states = true to indicate awake. fixed
asleep duration: time in seconds in which sleep states = true to indicate asleep. fixed
awake states: states to indicate being awake
asleep states: states to indicate being asleep
mobile app: target for buttons requires companion app

📲 set up Notify for Mi Band 7

pair **Mi Band 7** as you normally would with Mi Fitness
obtain auth key for Notify app using ADB

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

uninstall **Mi Fitness**
download/install Notify for Mi Band
follow prompts, input auth key, select Mi Fitness is not installed
enable Sleep As Android in Notify settings

🔐 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;"

⚠️ do not unpair before extracting
use with caution – root required
modified apps are available on GeekDoing and FreeMyBand

🛌 sleep as android setup

open the app and follow setup
settings wheel > services > automation > MQTT

(tcp/ssl)://(MQTT User):(MQTT Pass)@(HA URL):(port)

topic: must match config
client id: any unique id

enable automatic tracking
sensor: sonar or accelerometer
wearables > **Xiaomi Mi Band** > test sensor

📦 changes

0.2.0

added services.yaml to resolve known NoneType error
fixed deprecation warnings for future Home Assistant releases
breaking changes: remove and re-add existing integration entries after update

0.1.0

fixed wake status timing
bug fixes on sound sensor
accurate updates to alarmevent, disturbance, sound
organized readme

0.0.6a

initial beta release
added persistent states
alarm event sensor attributes

🚨 known issues

💬 no known issues at this time.