Area Occupancy Detection pour Home Assistant (intégration de la Marketplace)

Installations: 603 partagent leurs statistiques
Étoiles GitHub: 338
Connexion: Fonctionne en local
Maintenance: Mise à jour au cours des 6 derniers mois
Version: 2026.10.2, 24 octobre 2026
Catégorie: Capteurs, Mouvement et présence
Type: Intégration de la Marketplace
Prérequis: Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
Domaine: area_occupancy
Source: github.com/Hankanman/Area-Occupancy-Detection
Problèmes: Signaler un problème

Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.

Captures d’écran Extraites du README de Hankanman/Area-Occupancy-Detection.

À propos

Area Occupancy Detection estime si chaque zone de Home Assistant est occupée, en utilisant la probabilité de présence plutôt que le seul mouvement. Elle combine des entrées comme les capteurs de mouvement et de présence, les portes, les fenêtres, les serrures, les volets, les lecteurs multimédias et les capteurs d’environnement grâce à une probabilité Bayesian, et elle apprend les habitudes d’usage au fil du temps. Chaque zone dispose de capteurs binaires pour l’état d’occupation et le sommeil, d’un nombre de seuil réglable, et de capteurs pour la probabilité, l’activité détectée, la confiance et la santé des capteurs. L’occupation s’estompe avec une décroissance dans le temps dont la demi-vie dépend de la fonction de la zone, et les zones adjacentes peuvent s’influencer mutuellement. Un maintien porte fermée garde occupées les pièces à entrée unique comme les salles de bain, et une entité de mode absence peut mettre l’apprentissage en pause. Les actions lancent l’analyse, exportent la configuration, suppriment l’historique appris d’une zone, renvoient des prévisions hebdomadaires d’occupation et modifient les options d’une zone depuis les automatisations. Elle fonctionne en local et se configure dans l’interface.

Résumé automatique du README et du code de Hankanman/Area-Occupancy-Detection, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact

Prise en charge

Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.

Fournit

Capteurs

Mise en place

Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.

Area Occupancy Detection

Sélectionne une zone ou une actionChoisis une zone à modifier ou à supprimer, ajoute une nouvelle zone, ou termine la configuration

Gérer les zones

Sélectionne une zone

Étape 3

Zone Home AssistantSélectionne la zone Home Assistant pour cette détection d’occupation. Le nom de la zone sera utilisé automatiquement pour l’appareil et les entités.
Usage de la zoneL’usage principal de cette zone détermine le comportement de la décroissance. Chaque usage a une demi-vie différente, ce qui influe sur la vitesse à laquelle la probabilité d’occupation diminue avec le temps.
Nom de la zone de détectionC’est le nom de la zone ou de la zone de détection. Il servira à nommer les capteurs et l’entité d’occupation de la zone.
Capteurs de mouvement/présenceIls serviront à détecter l’occupation et la présence. Ce peuvent être des capteurs de mouvement, des capteurs d’occupation ou des capteurs de présence.
Poids du mouvementLe poids accordé aux entrées des capteurs de mouvement dans le calcul de l’occupation.
Délai d’expiration du mouvementPour les capteurs de mouvement de type PIR, qui émettent une brève impulsion par détection et restent silencieux quand quelqu’un reste immobile, chaque détection continue de compter en entier pendant cette durée après le passage du capteur à l’état inactif, avant que la zone commence à se libérer, et elle est apprise comme temps d’occupation. Cela comble les intervalles entre les détections au lieu de les traiter comme du vide. Les capteurs qui restent à « on » tant que quelqu’un est présent (la plupart des capteurs de présence mmWave) ne sont pas prolongés ; l’intégration distingue les deux types d’après l’historique propre à chaque capteur.
P(Actif | Occupée)La probabilité qu’un capteur de mouvement soit actif quand la zone est réellement occupée. Des valeurs plus élevées (proches de 1.0) signifient que le capteur de mouvement est plus fiable quand la zone est occupée. Par défaut : 0.95 (95 %).
P(Actif | Non occupée)La probabilité qu’un capteur de mouvement soit actif quand la zone n’est pas occupée (taux de faux positifs). Des valeurs plus basses (proches de 0.0) signifient moins de faux positifs. Par défaut : 0.005 (0,5 %).
Capteurs de porte
État actif de la porteC’est l’état de la porte qui servira à détecter l’occupation.
Poids de la porteLe poids accordé aux entrées des capteurs de porte dans le calcul de l’occupation.
Capteurs de serrure
État actif de la serrureC’est l’état de la serrure qui servira à détecter l’occupation.
Poids de la serrureLe poids accordé aux entrées des capteurs de serrure dans le calcul de l’occupation.
Capteurs de fenêtre

Étape 4

Zone Home AssistantSélectionne la zone Home Assistant pour cette détection d’occupation. Le nom de la zone sera utilisé automatiquement pour l’appareil et les entités.
Usage de la zoneL’usage principal de cette zone détermine le comportement de la décroissance. Chaque usage a une demi-vie différente, ce qui influe sur la vitesse à laquelle la probabilité d’occupation diminue avec le temps.
Zones adjacentesLes autres zones configurées qui communiquent physiquement avec celle-ci (par exemple un couloir relié à une chambre). Les sélections sont réciproques : ajouter une zone ici ajoute aussi celle-ci à la liste de ses voisines. L’intégration apprend les schémas de transition entre zones adjacentes et s’en sert pour augmenter la probabilité d’une voisine et ralentir la décroissance quand ses sorties habituelles restent silencieuses.

Étape 5

Capteurs de mouvement/présenceIls serviront à détecter l’occupation et la présence. Ce peuvent être des capteurs de mouvement, des capteurs d’occupation ou des capteurs de présence.
Poids du mouvementLe poids accordé aux entrées des capteurs de mouvement dans le calcul de l’occupation.
Délai d’expiration du mouvementPour les capteurs de mouvement de type PIR, qui émettent une brève impulsion par détection et restent silencieux quand quelqu’un reste immobile, chaque détection continue de compter en entier pendant cette durée après le passage du capteur à l’état inactif, avant que la zone commence à se libérer, et elle est apprise comme temps d’occupation. Cela comble les intervalles entre les détections au lieu de les traiter comme du vide. Les capteurs qui restent à « on » tant que quelqu’un est présent (la plupart des capteurs de présence mmWave) ne sont pas prolongés ; l’intégration distingue les deux types d’après l’historique propre à chaque capteur.
P(Actif | Occupée)La probabilité qu’un capteur de mouvement soit actif quand la zone est réellement occupée. Des valeurs plus élevées (proches de 1.0) signifient que le capteur de mouvement est plus fiable quand la zone est occupée. Par défaut : 0.95 (95 %).
P(Actif | Non occupée)La probabilité qu’un capteur de mouvement soit actif quand la zone n’est pas occupée (taux de faux positifs). Des valeurs plus basses (proches de 0.0) signifient moins de faux positifs. Par défaut : 0.005 (0,5 %).

Étape 6

Capteurs de porte
État actif de la porteC’est l’état de la porte qui sera utilisé pour détecter l’occupation.
Poids des portesLe poids accordé aux entrées des capteurs de porte dans le calcul de l’occupation.
Capteurs de serrure
État actif de la serrureC’est l’état de la serrure qui sera utilisé pour détecter l’occupation.
Poids des serruresLe poids accordé aux entrées des capteurs de serrure dans le calcul de l’occupation.
Capteurs de fenêtre
État actif de la fenêtreC’est l’état de la fenêtre qui sera utilisé pour détecter l’occupation.
Poids des fenêtresLe poids accordé aux entrées des capteurs de fenêtre dans le calcul de l’occupation.
Capteurs de voletEntités de volet (stores, rideaux, portes de garage, volets roulants) qui indiquent une occupation quand leur état change.
États actifs des voletsLes états des volets qui indiquent une occupation (par exemple : ouvert, en ouverture, en fermeture).
Poids des voletsLe poids accordé aux entrées des capteurs de volet dans le calcul de l’occupation.
Lecteurs multimédias
États actifs des lecteurs multimédiasCe sont les états des lecteurs multimédias qui seront utilisés pour détecter l’occupation.
Poids des lecteurs multimédiasLe poids accordé aux entrées des lecteurs multimédias dans le calcul de l’occupation.

Étape 7

Seuil d’occupation (%)Le seuil de probabilité au-dessus duquel la zone est considérée comme occupée.
Activer la décroissance dans le tempsActive ou non la décroissance de la probabilité d’occupation en fonction du temps.
Demi-vie de la décroissanceDurée au bout de laquelle la probabilité d’occupation diminue de moitié. Mets 0 pour utiliser la valeur par défaut selon la fonction, ou saisis une valeur entre 10 secondes et 1 heure pour la remplacer.
Remplacement de la probabilité a priori minimaleLa probabilité a priori minimale qui sera utilisée quel que soit les habitudes apprises. Mets 0.0 pour désactiver (par défaut).
Exclure de Toutes les zonesSi activé, cette zone ne contribuera pas aux capteurs agrégés Toutes les zones. Utile pour les garages, les allées et les zones extérieures.
Porte fermée signifie toujours occupéPour une pièce avec une seule entrée, comme une salle de bain. Tant que ses portes restent fermées après un mouvement, la zone reste occupée, même si le mouvement perd de vue une personne immobile. Elle se libère quand une porte s’ouvre, ou après la durée maximale de Wasp in Box (une heure par défaut). Nécessite un capteur de porte. Remplace Wasp in Box.
Activer Wasp in Box (obsolète)Obsolète : remplacé par un maintien porte fermée intégré qui reprend ce réglage automatiquement. Active le comportement et l’entité wasp-in-box pour cette zone. Utile pour les pièces à entrée unique comme les salles de bain.
Délai d’expiration du mouvementDurée pendant laquelle un mouvement reste valide après sa détection.
Poids du capteurLe poids accordé à ce capteur dans le calcul de l’occupation.
Durée maximaleDurée maximale pendant laquelle wasp-in-box reste actif après le dernier mouvement détecté.
Délai de vérificationLe délai après la fermeture de la dernière porte avant que tout mouvement détecté soit considéré comme une occupation réelle. (0 = désactivé).

Après la mise en place

Sélectionne une zone
Zone Home AssistantSélectionne la zone Home Assistant pour cette détection d’occupation. Le nom de la zone sera utilisé automatiquement pour l’appareil et les entités.
Fonction de la zoneLa fonction principale de cette zone détermine le comportement de la décroissance. Chaque fonction a une demi-vie différente, qui influe sur la vitesse à laquelle la probabilité d’occupation diminue avec le temps.
Nom de la zone de détectionC’est le nom de la zone ou de la zone de détection. Il servira à nommer les capteurs et l’entité d’occupation de la zone.
Capteurs de mouvement/présenceIls serviront à détecter l’occupation et la présence. Ce peuvent être des capteurs de mouvement, d’occupation ou de présence.
Poids du mouvementLe poids accordé aux entrées des capteurs de mouvement dans le calcul de l’occupation.
Délai d’expiration du mouvementPour les capteurs de mouvement de type PIR, qui émettent une brève impulsion à chaque détection et restent silencieux quand quelqu'un ne bouge pas, chaque détection continue de compter pleinement pendant cette durée après l'arrêt du capteur, avant que la zone ne commence à se vider, et elle est apprise comme du temps d'occupation. Cela comble les intervalles entre les détections au lieu de les traiter comme des périodes d'inoccupation. Les capteurs qui restent sur « on » tant que quelqu'un est présent (la plupart des capteurs de présence mmWave) ne sont pas prolongés ; l'intégration distingue les deux types à partir de l'historique de chaque capteur.
P(Actif | Occupée)La probabilité qu'un capteur de mouvement soit actif quand la zone est réellement occupée. Plus la valeur est élevée (proche de 1.0), plus le capteur de mouvement est fiable quand la zone est occupée. Par défaut : 0.95 (95 %).
P(Actif | Non occupée)La probabilité qu'un capteur de mouvement soit actif quand la zone n'est pas occupée (taux de faux positifs). Plus la valeur est basse (proche de 0.0), moins il y a de faux positifs. Par défaut : 0.005 (0,5 %).
Capteurs de porte
État actif de la porteC'est l'état de la porte qui sera utilisé pour détecter l'occupation.
Poids de la porteLe poids accordé aux entrées des capteurs de porte dans le calcul d'occupation.
Capteurs de serrure
État actif de la serrureC'est l'état de la serrure qui sera utilisé pour détecter l'occupation.
Poids de la serrureLe poids accordé aux entrées des capteurs de serrure dans le calcul d'occupation.
Capteurs de fenêtre
Zone Home AssistantSélectionne la zone Home Assistant pour cette détection d'occupation. Le nom de la zone sera utilisé automatiquement pour l'appareil et les entités.
Usage de la zoneL'usage principal de cette zone détermine le comportement de décroissance. Chaque usage a des valeurs de demi-vie différentes, qui influencent la vitesse à laquelle la probabilité d'occupation diminue avec le temps.
Zones adjacentesAutres zones configurées qui communiquent physiquement avec celle-ci (par exemple un couloir relié à une chambre). Les sélections sont réciproques : ajouter une zone ici ajoute aussi celle-ci à la liste de ses voisines. L'intégration apprend les schémas de transition entre zones adjacentes et s'en sert pour augmenter la probabilité d'une zone voisine et ralentir la décroissance quand ses sorties habituelles restent silencieuses.
Capteurs de mouvement/présenceIls serviront à détecter l'occupation et la présence. Il peut s'agir de capteurs de mouvement, de capteurs d'occupation ou de capteurs de présence.
Poids du mouvementLe poids accordé aux entrées des capteurs de mouvement dans le calcul d'occupation.
Délai d'expiration du mouvementPour les capteurs de mouvement de type PIR, qui émettent une brève impulsion à chaque détection et restent silencieux quand quelqu'un ne bouge pas, chaque détection continue de compter pleinement pendant cette durée après l'arrêt du capteur, avant que la zone ne commence à se vider, et elle est apprise comme du temps d'occupation. Cela comble les intervalles entre les détections au lieu de les traiter comme des périodes d'inoccupation. Les capteurs qui restent sur « on » tant que quelqu'un est présent (la plupart des capteurs de présence mmWave) ne sont pas prolongés ; l'intégration distingue les deux types à partir de l'historique de chaque capteur.
P(Actif | Occupée)La probabilité qu'un capteur de mouvement soit actif quand la zone est réellement occupée. Plus la valeur est élevée (proche de 1.0), plus le capteur de mouvement est fiable quand la zone est occupée. Par défaut : 0.95 (95 %).
P(Actif | Non occupée)La probabilité qu'un capteur de mouvement soit actif quand la zone n'est pas occupée (taux de faux positifs). Plus la valeur est basse (proche de 0.0), moins il y a de faux positifs. Par défaut : 0.005 (0,5 %).
Capteurs de porte
État actif de la porteC'est l'état de la porte qui sera utilisé pour détecter l'occupation.
Poids de la porteLe poids accordé aux entrées des capteurs de porte dans le calcul d'occupation.
Capteurs de serrure
État actif de la serrureC'est l'état de la serrure qui sera utilisé pour détecter l'occupation.
Poids de la serrureLe poids accordé aux entrées des capteurs de serrure dans le calcul d'occupation.
Capteurs de fenêtre
État actif de la fenêtreC'est l'état de la fenêtre qui sera utilisé pour détecter l'occupation.
Poids de la fenêtreLe poids accordé aux entrées des capteurs de fenêtre dans le calcul d'occupation.
Capteurs de voletEntités de volet (stores, rideaux, portes de garage, volets roulants) qui indiquent une occupation quand leur état change.
États actifs des voletsLes états des volets qui indiquent une occupation (par exemple : ouvert, en ouverture, en fermeture).
Poids du voletLe poids accordé aux entrées des capteurs de volet dans le calcul d'occupation.
Lecteurs multimédias
États actifs du lecteur multimédiaCe sont les états des lecteurs multimédias qui seront utilisés pour détecter l'occupation.
Poids du lecteur multimédiaLe poids accordé aux entrées des lecteurs multimédias dans le calcul d'occupation.
Seuil d'occupation (%)Le seuil de probabilité au-dessus duquel la zone est considérée comme occupée.
Activer la décroissance dans le tempsActive ou non la décroissance de la probabilité d'occupation en fonction du temps.
Demi-vie de la décroissanceDurée au bout de laquelle la probabilité d'occupation diminue de moitié. Mets 0 pour utiliser la valeur par défaut selon l'usage, ou saisis une valeur entre 10 secondes et 1 heure pour la remplacer.
Remplacement du prior minimalLa probabilité a priori minimale qui sera utilisée quelles que soient les habitudes apprises. Mets 0.0 pour la désactiver (par défaut).
Exclure de toutes les zonesSi cette option est activée, cette zone ne contribue pas aux capteurs agrégés de toutes les zones. Utile pour les garages, les allées et les zones extérieures.
Porte fermée signifie toujours occupéPour une pièce avec une seule entrée, comme une salle de bain. Tant que ses portes restent fermées après un mouvement, la zone reste occupée, même si le mouvement perd une personne immobile. Elle se libère quand une porte s'ouvre, ou après la durée maximale de Wasp in Box (une heure par défaut). Nécessite un capteur de porte. Remplace Wasp in Box.
Activer Wasp in Box (obsolète)Obsolète : remplacé par un maintien porte fermée intégré qui reprend ce réglage automatiquement. Active le comportement et l'entité wasp-in-box pour cette zone. Utile pour les pièces à entrée unique comme les salles de bain.
Délai d'expiration du mouvementDurée pendant laquelle un mouvement reste valide après sa détection.
Poids du capteurLe poids accordé à ce capteur dans le calcul de l'occupation.
Durée maximaleDurée maximale pendant laquelle wasp-in-box reste actif après le dernier mouvement détecté.
Délai de vérificationLe délai après la fermeture de la dernière porte avant que tout mouvement détecté soit considéré comme une occupation réelle. (0 = désactivé).
Heure de début du sommeilL'heure à laquelle ton horaire de sommeil commence. Pendant cette période, les zones ayant l'usage « Sleeping » utilisent leur demi-vie de décroissance configurée.
Heure de fin du sommeilL'heure à laquelle ton horaire de sommeil se termine. En dehors des heures de sommeil, les zones ayant l'usage « Sleeping » se comportent comme les zones « Relaxing ».
Surveillance de la santé des capteursSi cette option est activée, l'intégration crée des corrections Home Assistant pour les capteurs bloqués, indisponibles ou jamais déclenchés, et pour les cycles d'analyse lents ou en échec. Désactive-la pour faire taire toutes les corrections de cette intégration ; les problèmes déjà signalés seront effacés au prochain cycle d'analyse.
Précision de l'état des capteurs (décimales)Des valeurs plus faibles réduisent nettement les écritures dans la base de données de l'enregistreur par les capteurs de diagnostic. 0 est recommandé, sauf si tu as besoin d'une résolution inférieure au pourcent.
Entité du mode absenceFacultatif. Une entité booléenne (input_boolean, binary_sensor ou switch) qui est activée quand le foyer est absent, comme un interrupteur de mode vacances. Tant qu'elle est activée, le temps d'absence est exclu de l'apprentissage et les alertes de capteurs bloqués inactifs ou jamais déclenchés sont suspendues. Si elle est définie, elle est utilisée pour les alertes à la place du suivi des personnes et des appareils. Laisse vide pour utiliser le suivi des personnes pour les alertes uniquement.
Sélectionne une personne

Textes issus du code de Hankanman/Area-Occupancy-Detection. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.

Entités

Capteurs binairesÉtat d'occupation, Wasp in Box, Sommeil
NombresSeuil d'occupation
CapteursProbabilité d'occupation, Probabilité a priori, État de décroissance, Activité détectée, Confiance de l'activité, Indices, Confiance de présence, Confiance environnementale, Santé du capteur, Précision

Actions

Lancer l'analyseLance l'analyse de toutes les zones de l'instance d'occupation des zones.
Exporter la configurationExporte la configuration complète de l'intégration au format YAML.
Purger l'historique de la zoneSupprime tout l'historique appris pour une seule zone configurée (probabilités a priori, corrélations, intervalles, agrégats, intervalles d'occupation en cache) sans retirer la zone de l'intégration. Utilise cette action quand le comportement appris d'une pièce n'est plus exact et que tu veux que l'intégration réapprenne depuis zéro.Champs : Zone
Obtenir les probabilités a priori horairesRenvoie la prévision hebdomadaire apprise des probabilités a priori d'occupation pour chaque zone : pour chaque créneau hebdomadaire (jour de la semaine x heure de la journée), la probabilité que la zone soit généralement occupée. Contrairement au capteur de probabilité d'occupation (une estimation de l'état actuel), cette action expose les probabilités a priori de créneaux futurs, afin que d'autres intégrations puissent construire un profil d'occupation prévisionnel, par exemple pour préchauffer une pièce avant son occupation habituelle. Renvoie uniquement des données de réponse.Champs : Zone
Définir une option de zoneModifie les paramètres de détection d'une zone configurée depuis une automatisation ou un script. Les valeurs passent par la même validation et la même gestion des valeurs par défaut selon l'usage que l'interface de configuration, donc une automatisation ne peut pas mettre une zone dans un état que l'interface refuserait. La configuration structurelle (quelles entités appartiennent à une zone, zones adjacentes) ne peut volontairement pas être définie ici.Champs : Zone, Seuil d'occupation, Activer la décroissance dans le temps, Demi-vie de décroissance, Remplacement du prior minimal, Activer Wasp in Box, Porte fermée signifie toujours occupée

Dépannage

DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Wasp in Box est remplacé par un maintien intégré de la porte fermée, A appris qu’il est occupé la plupart du temps

Extrait du README

Have you ever had your lights turn off while you're still in the room? Or watched your smart home mark you as "away" while you're sitting perfectly still, watching TV? These frustrating experiences happen because most occupancy detection relies on simple motion sensors that can't understand context.
Area Occupancy Detection solves these real-world problems by thinking more intelligently about what "occupied" really means. Instead of just checking if motion was detected, it combines multiple clues, learns from your patterns, and calculates the probability that someone is actually there.
Bayesian Occupancy Detection: Combines multiple sensor inputs using Bayesian probability for accurate occupancy detection.
Dual-Model Approach: Separates presence indicators (motion, media, appliances, doors, windows, covers, power, sleep) from environmental support (temperature, humidity, CO2, etc.). Presence sets the…
Multiple Sensor Support:
Motion/Occupancy Sensors: Primary input and ground truth for detecting presence.
Media Devices: TV, media players, and similar devices as activity indicators.
Appliances: Switches or sensors representing devices like fans, PCs, or other appliances.
Cover Sensors: Blinds, shades, shutters, and garage doors being operated.
Environmental Sensors: Temperature, humidity, illuminance, CO2, sound pressure, atmospheric pressure, air quality, VOC, PM2.5, and PM10 sensors contribute subtle occupancy clues.
Doors and Windows: Entry/exit and ventilation patterns.

Extrait du README de Hankanman/Area-Occupancy-Detection, MIT License. Abrégé.

S’affiche dans Vulpo :

carte Graphique, Apple Watch.

Informations

Installations: 603 partagent leurs statistiques
Étoiles GitHub: 338
Connexion: Fonctionne en local
Maintenance: Mise à jour au cours des 6 derniers mois
Version: 2026.10.2, 24 octobre 2026
Catégorie: Capteurs, Mouvement et présence
Type: Intégration de la Marketplace
Prérequis: Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
Domaine: area_occupancy
Source: github.com/Hankanman/Area-Occupancy-Detection
Problèmes: Signaler un problème