Guide de configuration de l'intégration Home Assistant ONVIF

 

Ajouter une caméra IP au Home Assistant semble simple, jusqu'à ce que vous appreniez que chaque marque de caméra parle son propre dialecte. L'intégration ONVIF est la seule norme qui coupe le bruit : une seule intégration Home Assistant qui fonctionne avec les clones Reolink, Amcrest, Dahua, Hikvision et la plupart des caméras IP « compatibles ONVIF » vendues depuis 2018. Ce guide vous guide à travers la configuration complète, les pièges que personne ne mentionne dans les fils de discussion et le moyen le moins cher de l'exécuter : une LinknLink iSG Box SE avec Home Assistant préinstallé pour 69,90 $.

LinknLink iSG Box SE Passerelle Home Assistant pour l'automatisation des caméras ONVIF locales

1. Qu'est-ce qu'ONVIF et pourquoi les utilisateurs de Home Assistant en ont besoin

ONVIF (Open Network Video Interface Forum) est une norme ouverte qui définit la manière dont les caméras IP, les NVR et les clients vidéo communiquent entre eux sur un réseau local. Au lieu d'avoir besoin d'une application différente pour chaque marque de caméra, n'importe quel appareil compatible ONVIF peut découvrir, diffuser et recevoir des événements de n'importe quel autre appareil compatible ONVIF.

Pour les utilisateurs de Home Assistant, cela est important pour trois raisons :

  • Confidentialité et contrôle local. ONVIF fonctionne entièrement sur votre réseau local. Aucune vidéo ne quitte votre maison, aucun compte n'est requis, aucun fabricant de caméra ne peut désactiver votre flux avec une mise à jour du micrologiciel. C’est exactement le contraire du modèle Wyze, Ring ou Arlo.
  • Latence. Un flux de caméra basé sur le cloud effectue généralement un aller-retour de 300 à 1 200 ms via un serveur de fournisseur avant d'atteindre Home Assistant. L'ONVIF sur le réseau local dure généralement moins de 150 ms, ce qui est suffisamment rapide pour déclencher les automatisations Home Assistant (lumières, CVC, sirènes) avant que la personne entrant dans le cadre n'ait fini de faire deux pas.
  • Pas de dépendance envers un fournisseur. Si la marque de votre caméra cesse ses activités ou passe à un modèle d'abonnement, votre système continue de fonctionner. ONVIF est une spécification ouverte de style W3C avec des milliers d'appareils compatibles.

Si vous êtes encore en train de décider si un hub dédié en vaut la peine, nous abordons les principes fondamentaux dans Qu'est-ce qu'un hub pour maison intelligente. Pour ONVIF en particulier, un hub doté d’une marge CPU suffisante pour gérer plusieurs flux RTSP n’est pas négociable – c’est pourquoi le choix matériel dans la section suivante est important.

Marques de caméras qui fonctionnent bien avec ONVIF + Home Assistant :

  • Reolink (séries RLC, E1, Duo) — excellente exposition du profil ONVIF, flux principal + secondaire prêt à l'emploi
  • Amcrest (séries IP4M, IP5M) — Dahua OEM, événements ONVIF très solides
  • Dahua (séries IPC-HFW, IPC-HDW) — ONVIF natif, événements de mouvement à toute épreuve
  • Hikvision et changements de marque (Annke, LTS, LaView) — ONVIF fonctionne mais activez-le d'abord dans l'interface utilisateur Web de la caméra
  • Ubiquiti UniFi Protect G3/G4/G5 — ONVIF uniquement via l'exportation Protect, la plupart des utilisateurs ignorent ce chemin
  • Axis, Bosch, Vivotek – niveau entreprise, excellente prise en charge ONVIF

Marques de caméras à éviter pour ONVIF : Wyze, Blink, Arlo, Ring, Google Nest. Ce sont des produits axés sur le cloud ; leur exposition ONVIF est soit inexistante, soit instable après les mises à jour du micrologiciel.

Interface de configuration de caméra locale Home Assistant ONVIF et RTSP

Meilleure passerelle locale pour l'automatisation des caméras

Avant de toucher l'écran d'intégration ONVIF, assurez-vous d'avoir aligné ces quatre éléments :

2.1 Un hôte Home Assistant suffisamment puissant pour les flux RTSP

Le système d'exploitation Home Assistant fonctionnant sur un Raspberry Pi 4 (4 Go) fonctionne techniquement pour 1 à 2 caméras, mais rien de plus - ou au moment où vous ajoutez Frigate pour la détection de l'IA - et le Pi commence à perdre des images et à surchauffer.

Nous recommandons le LinknLink iSG Boîte SE pour cette configuration. À 69,90 $, il s'agit de l'hôte Home Assistant le moins cher du marché avec HA préinstallé, et il offre beaucoup plus de calcul qu'un Pi 4 – suffisamment de marge pour plus de 8 caméras ONVIF en HA natif, ou 2 à 4 caméras avec Frigate NVR sur le même boîtier. La comparaison complète du matériel est dans notre Guide du matériel Home Assistant.

Pourquoi iSG Box SE est la bonne valeur par défaut pour une version ONVIF :

  • Home Assistant préinstallé - branchez l'alimentation et Ethernet, ouvrez votre navigateur, terminez l'assistant de configuration. Pas d'imagerie de carte SD, pas de Proxmox, pas d'attente dans la chaîne d'approvisionnement jaune Home Assistant.
  • Architecture axée sur le local — Contrôle local à 100 %, pas de compte cloud, pas de frais mensuels.
  • Assez de CPU pour la frégate — le bonus §5 sur la détection d'objets AI fonctionne sans ajouter d'accélérateur USB Coral pour une configuration de 2 à 4 caméras.
  • Prix - 69,90 $ contre Home Assistant Green à 158,90 $ ou un kit Raspberry Pi 5 qui atterrit au-dessus de 120 $ une fois que vous ajoutez un SSD et un boîtier.

2.2 Une caméra IP compatible ONVIF sur le même LAN

Consultez la fiche technique de la caméra ou l'interface utilisateur d'administration pour la bascule « ONVIF ». La plupart des caméras des marques du §1 sont livrées avec ONVIF activé mais sans mot de passe — vous ajouterez les informations d'identification au §3.

2.3 Une réservation IP statique dans votre routeur

Home Assistant intègre des caméras par adresse IP. Si votre routeur transmet à la caméra une nouvelle adresse IP la semaine prochaine, l'intégration s'interrompt silencieusement. Dans les paramètres DHCP de votre routeur, réservez une adresse IP LAN permanente pour l'adresse MAC de chaque caméra (généralement affichée dans l'interface utilisateur d'administration de la caméra).

2.4 Informations d'identification de l'administrateur de la caméra

Il ne s'agit pas des paramètres d'usine par défaut : modifiez-les d'abord. Les informations d'identification ONVIF sont envoyées par défaut sur le réseau local dans l'authentification Digest, et les mots de passe par défaut restent la surface la plus analysée dans n'importe quel réseau domestique.

Configuration de la caméra RTSP locale

Une fois le matériel prêt, l’intégration réelle prend moins de dix minutes. Voici les cinq étapes exactes.

Étape 1 — Activez ONVIF dans l'interface utilisateur Web de la caméra

Ouvrez l'adresse IP de la caméra dans votre navigateur (par ex. http://192.168.1.50), connectez-vous avec les informations d'identification de l'administrateur et recherchez la section ONVIF. Parcours par marque :

  • Reolink : Paramètres de l'appareil → Réseau → Avancé → Paramètres du port → cochez « ONVIF »
  • Amcrest/Dahua : Configuration → Réseau → Connexion → ONVIF → Authentification = "Digest" ou "Aucun"
  • Hikvision : Configuration → Réseau → Paramètres avancés → Protocole d'intégration → activer ONVIF et créer un utilisateur ONVIF dédié

Hikvision est la seule marque livrée avec ONVIF désactivé par défaut et nécessite un compte utilisateur ONVIF distinct – configurez-le avant de continuer.

Étape 2 — Notez les URL du flux RTSP (facultatif mais utile)

Pendant que vous êtes dans l’interface utilisateur Web, copiez les URL RTSP du flux principal et secondaire. L'intégration ONVIF de Home Assistant les découvre automatiquement, mais les avoir à portée de main rend le débogage beaucoup plus rapide en cas d'échec de la découverte. Formats typiques :

  • Reolink principal : rtsp://admin:password@192.168.1.50:554/h264Preview_01_main
  • Sous Reolink : rtsp://admin:password@192.168.1.50:554/h264Preview_01_sub
  • Amcrest principal : rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=0
  • Sous Amcrest : rtsp://admin:password@192.168.1.50:554/cam/realmonitor?channel=1&subtype=1

Étape 3 — Ouvrez Home Assistant et ajoutez l'intégration ONVIF

Dans l'interface utilisateur du Home Assistant (qu'il soit exécuté sur iSG Box SE ou ailleurs) :

  1. Aller à Paramètres → Appareils et services
  2. Cliquez + Ajouter une intégration (en bas à droite)
  3. Rechercher "ONVIF" et sélectionnez-le

Home Assistant analysera le réseau local via WS-Discovery. La plupart des caméras apparaissent automatiquement. Si ce n’est pas le cas, vous pouvez l’ajouter manuellement par IP.

Étape 4 — Entrez l'adresse IP, le port et les informations d'identification

Le port ONVIF par défaut est 80 (HTTP) sur la plupart des caméras, pas 554 (c'est-à-dire RTSP — un port différent). Si votre caméra utilise un port ONVIF non standard (2020, 8000, 8899 sont courants), il sera répertorié dans l'interface utilisateur Web de la caméra sous la section Réseau ou ONVIF.

Entrez :

  • Hôte : l'adresse IP LAN statique de la caméra
  • Port : généralement 80 ; Hikvision utilise souvent 80, Dahua 80, Reolink 8000
  • Nom d'utilisateur/Mot de passe : les informations d'identification ONVIF que vous avez définies au §2.4 (Hikvision : l'utilisateur ONVIF dédié créé à l'étape 1)

Étape 5 — Choisissez les profils (flux principal + secondaire)

Home Assistant exposera chaque « profil » ONVIF annoncé par la caméra – généralement un pour le flux principal (haute résolution) et un pour le flux secondaire (basse résolution). Activez les deux :

  • Flux principal — utilisé pour les enregistrements, les instantanés et la visualisation de haute qualité
  • Sous-flux — utilisé pour la vignette du tableau de bord Home Assistant Lovelace (pour que le tableau de bord se charge rapidement même sur mobile)

Cliquez Soumettre. La caméra apparaît maintenant sous Appareils et services avec des entités pour le flux en direct, un capteur de mouvement et (si la caméra le prend en charge) des capteurs binaires pour tout événement déclenché par la caméra : franchissement de ligne, détection d'intrusion, classification humain/véhicule, falsification.

Dépannage Reolink ONVIF

Ce sont les quatre problèmes qui génèrent 90 % des discussions sur le forum concernant Home Assistant ONVIF. Voici comment résoudre chacun d’eux en moins de deux minutes.

4.1 "Caméra non découverte" lors de l'ajout d'une intégration

WS-Discovery utilise le DNS multidiffusion (mDNS). Si votre hôte Home Assistant et votre caméra se trouvent sur des VLAN ou des SSID WiFi différents, les paquets mDNS ne traversent pas la frontière. Correctifs, par ordre d'effort :

  • Placez temporairement la caméra sur le même sous-réseau que Home Assistant pour la découverte, puis déplacez-la en arrière.
  • Ajoutez la caméra manuellement par IP lors de la configuration de l'intégration (WS-Discovery est une commodité, pas une exigence).
  • Activez la réflexion mDNS / Avahi sur votre routeur (UniFi : « Multicast DNS », pfSense : package « Avahi », OpenWrt : « umdns »). C'est la solution permanente.

4.2 Le flux en direct continue de se mettre en mémoire tampon ou d'afficher « Flux non disponible »

Le flux principal en 4K ou 1440p + 30 fps est souvent trop pour le tableau de bord Lovelace, notamment sur mobile. Basculez la vignette du tableau de bord vers le sous-flux :

  • Paramètres → Appareils et services → Intégration ONVIF → Configurer → décochez "Profil principal" pour la carte d'entité photo
  • Ou directement dans la carte caméra YAML : définir flux_source à l'entité de sous-profil

Frigate NVR (abordé au §5) est une solution plus propre ici : il réencode le flux une fois et sert du HLS/WebRTC à faible latence à tous les clients.

4.3 Les entités de détection de mouvement ne déclenchent pas d'événements dans Home Assistant

Les événements de mouvement ONVIF sont facultatifs dans la spécification : la caméra doit à la fois (a) avoir la détection de mouvement activée localement et (b) être configurée pour publier des événements ONVIF. Étapes :

  1. Dans l'interface utilisateur Web de la caméra, activez la détection de mouvement (généralement Événement → Détection de mouvement → Activer)
  2. Recherchez les paramètres ONVIF ou « événement intelligent » et activez « Événements ONVIF » ou « Événements push »
  3. Dans Home Assistant, redémarrez l'intégration ONVIF : Paramètres → Appareils et services → ONVIF → menu à trois points → Recharger

Si vous êtes sur une caméra Hikvision ou Hikvision-OEM et que les événements ne se déclenchent toujours pas, vérifiez que l'utilisateur ONVIF que vous avez créé au §3 Étape 1 dispose des autorisations « Événement » et « Média » — par défaut, l'utilisateur ONVIF est en lecture seule pour Utilisateur gestion, ce qui est correct, mais certaines versions de firmware restreignent également l'abonnement aux événements.

4.4 La caméra fonctionne pendant une journée, puis se déconnecte jusqu'à un redémarrage

Il s'agit presque toujours d'une expiration de bail DHCP (pas de réservation statique) ou d'un délai d'attente de maintien RTSP. Confirmez que la réservation IP statique du §2.3 est appliquée sur le routeur, pas seulement dans les paramètres réseau de la caméra. Certaines caméras honorent les deux ; certains ignorent leur propre adresse IP statique et prennent ce que le routeur leur attribue.

5. Bonus : ajout de Frigate NVR pour la détection d'objets IA

Le mouvement Home Assistant ONVIF natif est binaire : "quelque chose a bougé" ou "rien n'a bougé". Cela déclenche de nombreux faux positifs dus aux feuilles soufflées sur la pelouse ou aux ombres au coucher du soleil.

Frégate est un NVR gratuit et open source qui fonctionne comme un module complémentaire Home Assistant et effectue une détection locale des objets IA sur le flux de la caméra. Ainsi, au lieu du « mouvement », vos automatisations se déclenchent sur « personne », « voiture », « colis » ou « chien ». Tout fonctionne sur votre hôte Home Assistant ; aucune trame ne quitte le réseau local.

Pourquoi l'iSG Box SE est suffisamment puissante pour héberger Frigate :

  • Le détecteur de processeur par défaut de Frigate gère 2 à 4 caméras à 5 à 7 ips chacune sur l'iSG Box SE sans limitation thermique.
  • Si vous passez à 6 à 8 caméras plus tard, ajoutez un accélérateur USB Google Coral à 60 $ et Frigate décharge l'inférence vers le TPU - l'iSG Box SE dispose d'une bande passante USB disponible pour cela.
  • L'installation prend environ 15 minutes : installez le module complémentaire Frigate à partir de la boutique de modules complémentaires Home Assistant, collez vos URL RTSP ONVIF du §3 Étape 2 dans frégate.yaml, rechargez.

Associez cela aux automatisations Home Assistant (« si Frigate détecte une personne à la porte d'entrée entre 22 heures et 6 heures du matin, allumez la lumière du porche et faites clignoter la lampe du salon trois fois ») et vous obtenez un système de sécurité intelligent qui ne coûte rien au-delà de la facture d'électricité. Le iSG Box SE est le point de départ à friction la plus faible pour exactement cette pile.

FAQ sur l'intégration ONVIF du Home Assistant

Le Home Assistant peut-il utiliser des caméras ONVIF sans accès au cloud ?

Oui. Le Home Assistant peut se connecter à de nombreuses caméras ONVIF sur le réseau local à l'aide de l'adresse IP de la caméra, du port ONVIF et des informations d'identification locales.

Pourquoi une caméra Reolink a-t-elle besoin de paramètres RTSP avec ONVIF ?

ONVIF gère la découverte et le contrôle, tandis que RTSP transporte souvent le flux vidéo en direct. Si la vidéo échoue, confirmez le chemin RTSP, le micrologiciel et les autorisations LAN.

Quelle passerelle LinknLink est la meilleure pour l’automatisation des caméras locales ?

Utilisez l'iSG Box SE pour une passerelle Home Assistant compacte, ou l'iSG Display Max lorsque vous souhaitez également un écran mural pour les commandes de la caméra et de la pièce.

7. Conclusion : démarrez votre configuration ONVIF avec iSG Box SE dès aujourd'hui

L'intégration ONVIF est le chemin le plus court entre "J'ai une caméra IP" et "mes lumières s'allument lorsque quelqu'un monte dans l'allée, mon CVC change lorsque le salon est vide pendant 20 minutes et mon téléphone me signale lorsque Frigate voit une camionnette de livraison au lieu d'un chat errant". Et le moyen le moins cher d'y arriver sans bricoler du matériel pendant un week-end est de Boîte LinknLink iSG SE (69,90 $) — Home Assistant préinstallé, 100% local, prêt à exécuter ONVIF et Frigate dès l'ouverture de la boîte.

Suivez les cinq étapes du §3 et vous aurez votre première caméra en streaming dans le Home Assistant en moins de dix minutes. Ajoutez la couche Frégate §5 le week-end prochain. Ajoutez le reste de vos caméras quand vous le souhaitez : l'intégration ONVIF s'adapte à plus de 8 appareils sans aucune configuration supplémentaire.

Obtenez l'iSG Box SE →