Band connection, battery, charging and heart-rate/SpO2/stress monitoring settings.

Monitoring configuration is read-only. Remote reads reconnect automatically within the timeout; cached never contacts the phone. Unknown fields remain null. max_age_seconds: 1..86400; timeout_seconds: 10..90. No app UI interaction.

Recent HR, steps, sleep/workout history, wearing, sleep and activity state.

Each device-state observation has its own age/source. Current sleep_state is the band's classification, distinct from latest_sleep (a historical sleep session). cached uses local data only; remote reads reconnect automatically. This does not start a new measurement or change monitoring settings. max_age_seconds: 1..86400; device-state age is capped at 120s. timeout_seconds: 10..90.

Recent recorded heart rate, steps and historical sleep/workouts; Gadgetbridge adds battery.

cached returns immediately. prefer_fresh attempts an ordinary backend pull if HR is old; require_fresh returns freshness_unmet if the requested age cannot be met. No app UI interaction. A successful recent pull is reused for 60 seconds even when source data remains stale. wait_seconds: 1..30; max_age_seconds: 1..86400.

Cached natural-day summary (YYYY-MM-DD), with sleep assigned to the waking day.

Includes sample coverage and optional preceding-day comparisons (missing days excluded). For a morning digest, query yesterday's activity and today's waking sleep separately. Call sync_health first if needed. timezone is an IANA name, default Asia/Shanghai.

Bounded cached detail: metric buckets, sleep sessions, or workouts.

Supply both start (inclusive) and end (exclusive) as offset-aware ISO timestamps, or neither for the last 24 hours (timeseries) / 30 days (sessions). limit 1..500; use returned pagination for more. Session IDs from summaries select a session. Missing buckets remain missing. Common metrics: heart_rate.bpm (default), steps, calories, distance. Additional metrics depend on the configured backend; see health://device-profile. aggregation_minutes: 1..1440. No arbitrary SQL.

Update the selected local cache and report actual record-time advancement.

Gadgetbridge exports and pulls its database over ADB; refresh_app=true first requests recorded-data synchronization from the band and waits for completion. Xiaomi Health reads through SSH; refresh_app=true invokes its internal background synchronization. No screen interaction or new physiological measurement is requested. Configure the transport once; cached queries still work when the phone is unavailable. Concurrent syncs share a single writer; timeout_seconds: 1..180.

Request one live heart-rate reading from the connected, worn Mi Band, then stop.

Uses the app's authenticated Bluetooth connection, not the historical database. Reports received_at (host receipt time), start/stop acknowledgments and cleanup errors. No reading may be available if the band is not worn or disconnected. Timeout: 30..90s. Current-state queries prefer a newer successful live reading; daily aggregates remain based on recorded history. Always attempts to stop; check stop_confirmed rather than assuming success. Requires Xiaomi Health to be running with its band connection available.

Read actual band alarms/reminders, their IDs, repeat rules and device capacity.

Reconnect is automatic and bounded. Alarm time is the band's local wall clock; reminder timestamps are converted from UTC for display in the selected IANA timezone. timeout_seconds: 5..90. No data is invented if a device response is unavailable. Read again to reconcile an earlier write whose outcome was unknown. timezone defaults to the server setting.

Create or update one band alarm, preserving other alarms and verifying by read-back.

time is HH:MM in the band's local wall clock. weekdays uses ISO Monday=1..Sunday=7; [] means once, all seven means daily. Omit alarm_id to create; provide a listed ID to update that existing alarm. Supply the complete desired time/weekdays/enabled values. timezone labels the wall clock; it does not change the band's timezone. A lost write response is reconciled by reading back, never by blindly repeating the write. timeout_seconds: 5..90.

Create or update one wrist reminder, then verify its actual stored fields.

at is an ISO timestamp with UTC offset; wire dates/times are UTC. title is the text shown on the band. Omit reminder_id to create, or use a listed ID to update. Supply all desired fields; unrelated entries are preserved. Recurrence follows the band's UTC schedule, so it does not automatically track local daylight-saving changes. On an unknown result inspect get_band_schedule before attempting another create. timeout_seconds: 5..90.

Delete only the identified band alarm/reminder and verify its absence by read-back.

Obtain item_id from get_band_schedule. Other entries remain unchanged. Unknown write outcomes are reported explicitly; a transport acknowledgment alone is not success. timeout_seconds: 5..90.