device_tracker.py

Go to the documentation of this file.

"""Demo platform for the Device tracker component."""
 
from __future__ import annotations
 
import random
 
from homeassistant.components.device_tracker import SeeCallback
from homeassistant.core import HomeAssistant, ServiceCall
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
 
from .const import DOMAIN, SERVICE_RANDOMIZE_DEVICE_TRACKER_DATA
 
 
def setup_scanner(
    hass: HomeAssistant,
    config: ConfigType,
    see: SeeCallback,
    discovery_info: DiscoveryInfoType | None = None,
) -> bool:
    """Set up the demo tracker."""
 
    def offset() -> float:
        """Return random offset."""
        return (random.randrange(500, 2000)) / 2e5 * random.choice((-1, 1))
 
    def random_see(dev_id: str, name: str) -> None:
        """Randomize a sighting."""
        see(
            dev_id=dev_id,
            host_name=name,
            gps=(hass.config.latitude + offset(), hass.config.longitude + offset()),
            gps_accuracy=random.randrange(50, 150),
            battery=random.randrange(10, 90),
        )
 
    def observe(call: ServiceCall | None = None) -> None:
        """Observe three entities."""
        random_see("demo_paulus", "Paulus")
        random_see("demo_anne_therese", "Anne Therese")
 
    observe()
 
    see(
        dev_id="demo_home_boy",
        host_name="Home Boy",
        gps=(hass.config.latitude - 0.00002, hass.config.longitude + 0.00002),
        gps_accuracy=20,
        battery=53,
    )
 
    hass.services.register(DOMAIN, SERVICE_RANDOMIZE_DEVICE_TRACKER_DATA, observe)
 
    return True