Intégration domotique Hikvision, gratuite et open source
Caméras et enregistreurs Hikvision : images, détections, E/S d'alarme et PTZ, en local.
Publiée par prohand
- Appareils
- Version 0.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Reliez vos caméras IP et enregistreurs Hikvision (NVR / DVR) à Gladys, sur votre réseau local : images des caméras, détections en temps réel (mouvement, franchissement de ligne, intrusion, sabotage…), entrées et sorties d'alarme, PTZ, scènes et un widget de tableau de bord.
- 100 % local : Gladys dialogue directement avec chaque appareil via son ISAPI. Pas de compte Hik-Connect, pas de cloud, rien à ouvrir sur votre box.
- Un enregistreur apporte toutes ses caméras : ajoutez l'adresse du NVR, pas celle de chaque caméra branchée dessus.
Ce qu'il faut
- Gladys 5.1 ou plus récent.
- Une caméra ou un enregistreur Hikvision sur le même réseau que Gladys, avec une adresse IP fixe (réservation DHCP).
- Un compte utilisateur sur cet appareil (voir ci-dessous).
1. Préparer l'appareil
Dans l'interface web de la caméra ou de l'enregistreur :
- Créez un utilisateur dédié : Configuration > Système > Gestion des utilisateurs > Ajouter.
Donnez-lui le rôle Opérateur. Évitez
admin: Gladys n'en a pas besoin.- Pour que Gladys puisse activer et désactiver les détections (armer / désarmer), l'utilisateur doit avoir le droit de modifier les paramètres (« Paramètres » / configuration à distance).
- Activez l'ISAPI : Configuration > Réseau > Paramètres avancés > Protocole d'intégration — cochez Activer Hikvision-CGI avec l'authentification Digest. Sur les firmwares récents, c'est activé par défaut.
- Notez le port HTTP (Réseau > Paramètres de base > Port) s'il n'est pas 80.
Attention aux mots de passe : Hikvision bloque le compte (souvent 30 minutes) après quelques mauvais mots de passe. L'intégration ne retente donc jamais seule un mot de passe refusé : corrigez-le, puis enregistrez à nouveau la configuration (ou appuyez sur Tester la connexion).
2. Configurer l'intégration
Dans Gladys : Intégrations > Hikvision > Configuration.
| Champ | Quoi saisir |
|---|---|
| Adresses | Adresse IP de chaque caméra ou enregistreur, séparées par des virgules : 192.168.1.64, 192.168.1.70:8080. Ajoutez https:// pour le HTTPS. |
| Nom d'utilisateur / Mot de passe | Le compte créé ci-dessus. Le même compte sert pour tous les appareils. |
| Vérifier le certificat HTTPS | Laissez désactivé : les appareils Hikvision ont un certificat auto-signé. |
| Intervalle des images (s) | Fréquence de rafraîchissement de l'image de chaque caméra dans Gladys (60 s par défaut, 10 s minimum, 0 = seulement quand Gladys la demande). |
| Qualité des images | Flux secondaire (recommandé). Gladys accepte des images jusqu'à 150 Ko ; le flux principal est réduit en 1280×720, et remplacé s'il reste trop lourd. |
| Durée d'une détection (s) | Combien de temps une détection reste « active » après le dernier événement de la caméra (10 s par défaut). |
| Intervalle de vérification (s) | Fréquence de vérification de chaque appareil (60 s par défaut). |
| Journaux détaillés | À activer pour un diagnostic, puis à désactiver. |
Enregistrez, puis appuyez sur Tester la connexion : une ligne par appareil indique le modèle, le firmware, les caméras en ligne, les détections trouvées, si les événements arrivent en direct, et les entrées / sorties d'alarme. En cas de problème, la ligne dit quoi faire.
Ouvrez ensuite l'onglet Découverte et créez les appareils voulus.
3. Les appareils dans Gladys
Un appareil par caméra (une caméra en a un, un enregistreur un par caméra branchée) :
| Fonctionnalité | Type | Remarques |
|---|---|---|
| Image | caméra | rafraîchie à l'intervalle des images, et à la demande |
| Mouvement | détecteur de mouvement | toujours présent |
| Franchissement de ligne / Intrusion | détecteur de mouvement | si la caméra gère ces détections intelligentes |
| Sabotage | sabotage | si la caméra le gère |
| Détection de mouvement / … | interrupteur | active ou désactive cette détection sur la caméra (armer / désarmer) |
| PTZ | mouvement caméra | caméras PTZ uniquement : petits pas horizontaux / verticaux / zoom, toujours arrêtés |
| Preset | preset caméra | caméras PTZ avec des positions enregistrées : la liste vient de la caméra |
Un appareil « alarm I/O » par caméra ou enregistreur doté de contacts secs : chaque entrée d'alarme est une entrée binaire (1 tant qu'elle est en alarme), chaque sortie d'alarme (relais, sirène) est un interrupteur.
Chaque appareil affiche un badge local quand il répond, injoignable sinon. Un point orange veut dire que l'appareil répond mais que son flux d'événements n'est pas connecté : les détections n'arrivent pas.
4. Scènes
Déclencheurs
- Une caméra Hikvision détecte quelque chose — filtres : la caméra, l'événement (mouvement,
franchissement de ligne, intrusion, entrée / sortie de zone, sabotage, visage, changement de
scène, objet abandonné ou retiré, PIR, perte vidéo, entrée d'alarme) et, pour les événements
intelligents, la cible (personne ou véhicule). Déclenché une fois par détection, pas à chaque
répétition de la caméra. Variables :
event_type,target,device_name,channel,description. - Une caméra Hikvision se déconnecte / est de retour — variables :
device_name(etreasonà la déconnexion).
Les fonctionnalités de détection (Mouvement, Intrusion…) s'utilisent aussi avec le déclencheur standard « état d'un appareil ».
Actions
- Prendre une image Hikvision — capture l'image maintenant. Placez-la juste avant l'action
Gladys « Envoyer une image de caméra » pour recevoir le moment exact de la détection. Sortie :
captured. - Armer ou désarmer une détection Hikvision — active ou désactive une détection (mouvement,
franchissement de ligne, intrusion, sabotage) d'une caméra. Sorties :
applied,enabled. - Envoyer une caméra PTZ Hikvision sur un preset — numéro du preset tel qu'enregistré sur la
caméra. Sortie :
moved.
Exemple : Quand une intrusion avec la cible « personne » est détectée par la caméra Jardin, et que personne n'est à la maison → prendre une image → envoyer l'image de la caméra → allumer la sirène (sortie d'alarme).
5. Widget de tableau de bord
Ajoutez le widget Hikvision à un tableau de bord : caméras en ligne, détections des dernières 24 heures, l'image d'une caméra (celle choisie dans les réglages du widget, sinon la dernière à avoir détecté quelque chose) et la dernière détection de chaque caméra. Boutons : Instantané, Désarmer et Armer (toutes les détections de toutes les caméras, après confirmation).
Dépannage
| Problème | Solution |
|---|---|
| « nom d'utilisateur ou mot de passe refusé » | Vérifiez-les dans l'interface web de l'appareil. Si le compte s'est bloqué, attendez environ 30 minutes, puis enregistrez à nouveau la configuration. |
| « l'appareil ne répond pas à l'ISAPI » | Activez le protocole d'intégration (étape 1.2). |
| « cet utilisateur n'a pas les droits » | Donnez-lui le rôle Opérateur, ou le droit de modifier les paramètres. |
| Aucune détection n'arrive | Vérifiez que la détection est activée sur la caméra et que « Notifier le centre de surveillance » est coché dans sa méthode de liaison. Activez les journaux détaillés. |
| « l'image dépasse les 150 Ko » | Baissez la résolution du flux secondaire de la caméra (par ex. 640×360). |
| Une caméra de l'enregistreur est hors ligne | Gladys l'affiche injoignable et déclenche « se déconnecte » ; elle revient toute seule. |
| HTTPS refusé | Utilisez http:// ou décochez « Vérifier le certificat HTTPS » ; vérifiez le port. |
Vie privée et sécurité
Tout reste entre Gladys et vos appareils, sur votre réseau. Le mot de passe est rangé dans un champ
secret de Gladys et n'est jamais écrit dans les journaux. L'intégration ne garde dans son dossier
/data que ce qu'elle a appris des appareils (modèle, numéro de série, canaux), pour qu'un appareil
éteint au démarrage apparaisse quand même comme hors ligne.
Paramètres de configuration
Voici les paramètres demandés par Hikvision dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Tout reste sur votre réseau : Gladys dialogue avec chaque caméra ou enregistreur (NVR) via son ISAPI locale, sans compte Hik-Connect. Créez un utilisateur dédié sur l'appareil (rôle Opérateur), vérifiez que le protocole d'intégration (ISAPI) est activé, puis saisissez ci-dessous l'adresse de chaque appareil. |
| Adresses | string | Oui | Adresse IP (ou nom) de chaque caméra ou enregistreur, séparées par des virgules. Ajoutez le port s'il n'est pas 80, et https:// pour le HTTPS. Un enregistreur apporte toutes ses caméras : ne les ajoutez pas en plus. |
| Nom d'utilisateur | string | Oui | Le même compte sur chaque appareil. Un utilisateur Opérateur dédié vaut mieux qu'admin. |
| Mot de passe | secret | Oui | Hikvision bloque le compte après quelques mauvais mots de passe : un mot de passe refusé n'est pas retenté avant que vous enregistriez à nouveau la configuration. |
| Vérifier le certificat HTTPS | boolean | Non | Uniquement pour les adresses https://. Les appareils Hikvision ont un certificat auto-signé : laissez désactivé, sauf si vous avez installé un certificat reconnu par Gladys. |
| Intervalle des images (s) | number | Non | Fréquence de rafraîchissement de l'image de chaque caméra dans Gladys, en secondes (10 minimum). 0 la désactive : Gladys ne reçoit alors une image que lorsqu'il la demande. |
| Qualité des images | select | Non | Gladys accepte des images jusqu'à 150 Ko. Le flux secondaire passe toujours ; le flux principal est réduit en 1280×720 et remplacé par le flux secondaire s'il reste trop lourd. |
| Durée d'une détection (s) | number | Non | Durée pendant laquelle une détection reste active après le dernier événement envoyé par la caméra. Les caméras répètent leurs événements tant que quelque chose bouge : un déclencheur de scène par détection, pas par répétition. |
| Intervalle de vérification (s) | number | Non | Fréquence de vérification de chaque appareil : joignable ou non, caméras en ligne, sorties d'alarme et interrupteurs de détection. |
| Journaux détaillés (debug) | boolean | Non | Journalise chaque événement envoyé par les appareils. Activez-le pour comprendre pourquoi une détection n'arrive pas, puis désactivez-le : c'est verbeux. Les mots de passe ne sont jamais journalisés. |
Comment installer Hikvision dans Gladys
- Dans Gladys, ouvrez Intégrations : Hikvision apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/prohand/gladys-hikvision:0.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-hikvision.
Hikvision nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Hikvision est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation