Skip to content

Latest commit

 

History

History
276 lines (197 loc) · 12 KB

README.md

File metadata and controls

276 lines (197 loc) · 12 KB

Xplora® Watch Version 2

Xplora® Watch Version 2 integration for Home Assistant

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.
hacs_badge GitHub release (latest by date) GitHub Release Date GitHub license GitHub stars GitHub issues
Code style: black
Github All Releases
Validate with hassfest and HACS

"Buy Me A Coffee"

✨ Wishlist from Amazon ✨


Xplora® Watch Version 2

🚨 Important: Upgrading from version 2.8.3 or earlier to version 2.10.* 🚨

  1. ⚠️back up your Homeassistant instance
  2. ⚠️save your backup externally
  3. Preparation
    • 👥There is more than one Xplora® Watch user logged into the Homeassistant instance
      • 🗑️remove the user that is generating the error Platform xplora_watch does not generate unique IDs.
      • 🗑️remove the sensors that are listed as unavailable
      • restart Homeassistant
    • 👤There is only one user for Xplora® Watch who is logged into the Homeassistant instance
      • no further steps necessary
  4. Upgrade the integration and restart Homeassistant instance
  5. Two instances (or more) of Xplora® Watch are now displayed - click on 2 devices new Device 1
  6. an instance with your name at the beginning is the new instance new Device 2
    • click on the old instance
    • Go to the pen in the upper right corner
    • disable this device
  7. (optional for more than one user)
    • add the second user ADD DEVICE
  8. Follow-up
    • new entities are created or old ones are listed as unavailable
    • the old entities can be removed
    • note that the new entities have a new naming convention

Names layout changed (v2.10.0)

binary_sensor:

  • "Watch Name" "Watch" "Charging" "Watch ID" to "Watch Name" "Watch" "Charging" "(Username)"
  • "Watch Name" "Watch" "Safezone" "Watch ID" to "Watch Name" "Watch" "Safezone" "(Username)"
  • "Watch Name" "Watch" "State" "Watch ID" to "Watch Name" "Watch" "State" "(Username)"

device_tracker:

  • "Watch Name" "Watch" "Tracker" "Watch ID" to "Watch Name" "Watch" "Tracker" "(Username)"
  • "Safzone" "Safzone Name" "Watch ID" to "Watch Name" "Watch" "Safzone" "Safzone Name" "(Username)"

sensor:

  • "Watch Name" "Watch" "Battery" "Watch ID" to "Watch Name" "Watch" "Battery" "(Username)"
  • "Watch Name" "Watch" "Xcoin" "Watch ID" to "Watch Name" "Watch" "Xcoin" "(Username)"
  • "Watch Name" "Watch" "Step Day" "Watch ID" to "Watch Name" "Watch" "Step Day" "(Username)"
  • "Watch Name" "Watch" "Message" "Watch ID" to "Watch Name" "Watch" "Message" "(Username)"
  • "Watch Name" "Watch" "Distance" "Watch ID" to "Watch Name" "Watch" "Distance" "(Username)"

switch:

  • "Watch Name" "Watch" "Alarm" "Time" "Watch ID" to "Watch Name" "Watch" "Alarm" "Time" "(Username)"
  • "Watch Name" "Watch" "Silent" "Time" "Watch ID" to "Watch Name" "Watch" "Silent" "Time" "(Username)"

Features

  • Control your watch from Home Assistant
  • Receive notifications from your watch
  • Track your watch's location
  • View your watch's battery level
  • And more!

IMPORTANCE: Of a service is activated by automation, the sensors will no longer be updated. Therefore, activate the xplora_watch.see service with a corresponding interval.

Features Type
Battery Sensor
Watch-Xcoin Sensor
Watch Step per Day Sensor
Watch Online state Binary Sensor
Watch is in Safezone Binary Sensor
charging state Binary Sensor
Watch silent(s) Switch
Watch alarm(s) Switch
Send Message Notify
Send Message Service Service
Read Messages from Account Service
Delete Messages from App Service
Manually update Service
Turn off Watch Service
Watch Tracking Device Tracker
Watch Show Safezone(s) Device Tracker

Installation

MANUAL INSTALLATION

Copy the xplora_watch last Release folder and all of its contents into your Home Assistant's custom_components folder. This folder is usually inside your /config folder. If you are running Hass.io, use SAMBA to copy the folder over. If you are running Home Assistant Supervised, the custom_components folder might be located at /usr/share/hassio/homeassistant. You may need to create the custom_components folder and then copy the localtuya folder and all of its contents into it. Alternatively, you can install localtuya through HACS by adding this repository.

INSTALLATION mit HACS

  1. Ensure that HACS is installed.
  2. Search for and install the "Xplora® Watch Integration" integration. GitHub release (latest by date)
  3. Configuration for the "Xplora® Watch Version 2" integration is now performed via a config flow as opposed to yaml configuration file.

Basis Configuration

  1. Go to HACS -> Integrations -> Click "+"
  2. Search for "Xplora® Watch" repository and add to HACS
  3. Restart Home Assistant when it says to.
  4. In Home Assistant, go to Configuration -> Integrations -> Click "+ Add Integration"
  5. Search for "Xplora® Watch" and follow the instructions to setup.

Xplora® should now appear as a card under the HA Integrations page with "Configure" selection available at the bottom of the card.

add in Version 2.2.0 add in Version 2
signin image integration image

Disable scan interval (v2.13.0)

  • To deactivate the scan interval you can set the value to "0", the default value is 180.

Downloaded from voice messages, Videos and Images (v2.7.0)

  • All voice messages, videos and images are stored in config/www/{voice|video|image|}. #152
    • The voice message will be downloaded as amr and converted to mp3.
    • Videos as mp4
    • Images as jpeg
  • updated Markdown Card Sample #155

Delete Messages from App (v2.6.0)

  • new service added - delete only app message
  • chats: add delete_flag 1 = message is deleted
  • updated Markdown Card Sample
  • add Emoji
    • M1001 = "😄"
    • M1002 = "😏"
    • M1003 = "😘"
    • M1004 = "😅"
    • M1005 = "😂"
    • M1006 = "😭"
    • M1007 = "😍"
    • M1008 = "😎"
    • M1009 = "😜"
    • M1010 = "😳"
    • M1011 = "🥱"
    • M1012 = "👏"
    • M1013 = "😡"
    • M1014 = "👍"
    • M1015 = "😏"
    • M1016 = "😓"
    • M1017 = "🍧"
    • M1018 = "😮"
    • M1019 = "M1019"
    • M1020 = "🎁"
    • M1021 = "M1021"
    • M1022 = "☺️"
    • M1023 = "M1023"
    • M1024 = "🌹"

Read Messages from Account (v2.4.0)

  • A new (message) sensor has been added, default: disabled
  • new service added, (message) sensor will be updated
  • change Number of Messages option find in "Configure"
  • Markdown Card Sample (updated v2.6.0)
  • Automation Sample

markdown sample


Multilanguage (v2.1.0)

  • DE
  • EN

Manually update (v2.0.8 & v2.0.9)

Manually update all information from your watch

manually_refresh image


Change Friendly Name (v2.0.7)

Set Friendly Name Please note that this can also change the entry_id!

Rule format: watchID=New Name Notice the equals sign

friendly_name image


Send Message

Set Target with the WatchID for the receiver watch

require (v2.10.0)

  • message
  • target
  • data
    • user_id
service: notify.xplora_watch
data:
  message: Message
  data:
    user_id: 053eb6e5e5b32e502cfb1934cefb77ff
  target: 01102f442f1125f525f5f3336316068

notify image


Send Message via Service (v2.0.3)

message_service image



Debug

logger:
  logs:
    custom_components.xplora_watch: debug


Changelog

[v2] - 2022-09-18