Wasp in a Box is an AppDaemon app for detecting occupancy using multiple sensors.
The wasp is a person or entity detected by a motion or presence sensor.
The box is a room or area with one or more door sensors.
- If we see a wasp, then there is a wasp in the box.
- If we close the box while there is a wasp in the box, then the wasp remains in the box.
- If the box remains closed when there is a wasp in the box, and the wasp stops moving, we assume it's still in the box.
- If the box is opened, and the wasp is not moving, we assume that the wasp has escaped (there is no wasp in the box).
The state of the generated binary sensor can be used for triggering automations.
If someone enters the bathroom and motion is detected, then turn on the light.
If the door is closed and motion is detected, then keep the light on as long as the door is closed.
If the door is open and no motion is detected, then turn off the light.
- Home Assistant
- AppDaemon
- An important note on breaking changes in 0.15.0+
- HACS for easy installation
- Go to HACS ❯ Automation ❯ + Explore & Download Repositories
- Search for "Wasp in a Box" and Download
- Wasp in a Box will be installed to
/config/appdaemon/wasp - Configure the
waspmodule in/config/appdaemon/apps/apps.yaml
bathroom_wasp:
module: wasp
class: Wasp
device_class: occupancy
name: Bathroom Occupancy
delay: 5
box_sensors:
- binary_sensor.bathroom_door_sensor
wasp_sensors:
- binary_sensor.bathroom_motion_sensor| key | optional | type | default | description |
|---|---|---|---|---|
module |
False | string | The module name of the app. | |
class |
False | string | The name of the Class. | |
device_class |
True | string | occupancy | The device class of the binary sensor. |
name |
True | string | Defaults to the app name, e.g. Bathroom Wasp | The friendly_name of the sensor. |
delay |
True | int | 0 | The number of seconds after closing the box before a wasp will be detected. |
box_sensors |
False | list | A list of sensor entity_ids, e.g. door sensors. | |
wasp_sensors |
False | list | A list of sensor entity_ids, e.g. motion sensors. |