Add device_tracker home enter/leave triggers

homeassistant/components/automation/__init__.py

@@ -127,6 +127,7 @@
     "binary_sensor",
     "climate",
     "cover",
+    "device_tracker",
     "fan",
     "lawn_mower",
     "light",

homeassistant/components/device_tracker/icons.json

@@ -11,5 +11,13 @@
     "see": {
       "service": "mdi:account-eye"
     }
+  },
+  "triggers": {
+    "entered_home": {
+      "trigger": "mdi:account-arrow-left"
+    },
+    "left_home": {
+      "trigger": "mdi:account-arrow-right"
+    }
   }
 }

homeassistant/components/device_tracker/strings.json

@@ -1,4 +1,8 @@
 {
+  "common": {
+    "trigger_behavior_description": "The behavior of the targeted device trackers to trigger on.",
+    "trigger_behavior_name": "Behavior"
+  },
   "device_automation": {
     "condition_type": {
       "is_home": "{entity_name} is home",
@@ -44,6 +48,15 @@
       }
     }
   },
+  "selector": {
+    "trigger_behavior": {
+      "options": {
+        "any": "Any",
+        "first": "First",
+        "last": "Last"
+      }
+    }
+  },
   "services": {
     "see": {
       "description": "Manually update the records of a seen legacy device tracker in the known_devices.yaml file.",
@@ -80,5 +93,27 @@
       "name": "See"
     }
   },
-  "title": "Device tracker"
+  "title": "Device tracker",
+  "triggers": {
+    "entered_home": {
+      "description": "Triggers when one or more device trackers enter home.",
+      "fields": {
+        "behavior": {
+          "description": "[%key:component::device_tracker::common::trigger_behavior_description%]",
+          "name": "[%key:component::device_tracker::common::trigger_behavior_name%]"
+        }
+      },
+      "name": "Entered home"
+    },
+    "left_home": {
+      "description": "Triggers when one or more device trackers leave home.",
+      "fields": {
+        "behavior": {
+          "description": "[%key:component::device_tracker::common::trigger_behavior_description%]",
+          "name": "[%key:component::device_tracker::common::trigger_behavior_name%]"
+        }
+      },
+      "name": "Left home"
+    }
+  }
 }

homeassistant/components/device_tracker/trigger.py

@@ -0,0 +1,21 @@
+"""Provides triggers for device_trackers."""
+
+from homeassistant.const import STATE_HOME
+from homeassistant.core import HomeAssistant
+from homeassistant.helpers.trigger import (
+    Trigger,
+    make_entity_state_trigger,
+    make_from_entity_state_trigger,
+)
+
+from .const import DOMAIN
+
+TRIGGERS: dict[str, type[Trigger]] = {
+    "entered_home": make_entity_state_trigger(DOMAIN, STATE_HOME),
+    "left_home": make_from_entity_state_trigger(DOMAIN, from_state=STATE_HOME),
+}
+
+
+async def async_get_triggers(hass: HomeAssistant) -> dict[str, type[Trigger]]:
+    """Return the triggers for device trackers."""
+    return TRIGGERS

homeassistant/components/device_tracker/triggers.yaml

@@ -0,0 +1,18 @@
+.trigger_common: &trigger_common
+  target:
+    entity:
+      domain: device_tracker
+  fields:
+    behavior:
+      required: true
+      default: any
+      selector:
+        select:
+          options:
+            - first
+            - last
+            - any
+          translation_key: trigger_behavior
+
+entered_home: *trigger_common
+left_home: *trigger_common

homeassistant/helpers/trigger.py

@@ -394,12 +394,12 @@ def state_change_listener(
             if not from_state or from_state.state in (STATE_UNAVAILABLE, STATE_UNKNOWN):
                 return
 
-            # The trigger should never fire if the previous state was not the from state
-            if not to_state or not self.is_from_state(from_state, to_state):
+            # The trigger should never fire if the new state is not the to state
+            if not to_state or not self.is_to_state(to_state):
                 return
 
-            # The trigger should never fire if the new state is not the to state
-            if not self.is_to_state(to_state):
+            # The trigger should never fire if the previous state was not the from state
+            if not self.is_from_state(from_state, to_state):
                 return
 
             if behavior == BEHAVIOR_LAST:
@@ -453,6 +453,22 @@ def is_to_state(self, state: State) -> bool:
         return state.state in self._to_states
 
 
+class FromEntityStateTriggerBase(EntityTriggerBase):
+    """Class for entity state changes from a specific state."""
+
+    _from_state: str
+
+    def is_from_state(self, from_state: State, to_state: State) -> bool:
+        """Check if the state matches the origin state."""
+        return (
+            from_state.state == self._from_state and to_state.state != self._from_state
+        )
+
+    def is_to_state(self, state: State) -> bool:
+        """Check if the state matches the target state."""
+        return state.state != self._from_state
+
+
 class EntityStateAttributeTriggerBase(EntityTriggerBase):
     """Trigger for entity state attribute changes."""
 
@@ -493,6 +509,20 @@ class CustomTrigger(ConditionalEntityStateTriggerBase):
     return CustomTrigger
 
 
+def make_from_entity_state_trigger(
+    domain: str, *, from_state: str
+) -> type[FromEntityStateTriggerBase]:
+    """Create a "from" entity state trigger class."""
+
+    class CustomTrigger(FromEntityStateTriggerBase):
+        """Trigger for "from" entity state changes."""
+
+        _domain = domain
+        _from_state = from_state
+
+    return CustomTrigger
+
+
 def make_entity_state_attribute_trigger(
     domain: str, attribute: str, to_state: str
 ) -> type[EntityStateAttributeTriggerBase]: