Comment intégrer votre Nuki Ultra à un interphone Hikvision : Guide complet pour une automatisation fluide

html

Vous souhaitez automatiser l’ouverture de votre porte avec votre Nuki Ultra en réponse à une demande via votre interphone Hikvision ? Ce tutoriel vous guide pas à pas vers une solution robuste et sécurisée, combinant des équipements compatibles et une intégration domotique professionnelle.

Cette solution repose sur trois piliers :

• Un relais domestique pour déclencher le Nuki Ultra
• Un hub domotique pour centraliser les commandes
• Une intégration logicielle via Home Assistant

🛠️ LE MATÉRIEL REQUIS

• Nuki Ultra (avec clé USB ou Bluetooth pour la configuration initiale)
• Interphone Hikvision DS-K1P ou DS-K1P Pro (ou tout modèle compatible avec l’API Hik-Connect)
• Relais domestique Shelly 2.5 (ou Shelly Plus 2PM pour plus de fonctionnalités)
• Un Raspberry Pi 4 ou équivalent (pour installer Home Assistant)
• Câbles Ethernet (pour relier le Shelly et le Raspberry Pi au réseau)
• Alimentation 12V/2A pour le Shelly (si non fournie avec le kit)
• Compte Hik-Connect (nécessaire pour l’API de l’interphone)

🔧 PRÉREQUIS TECHNIQUES

Avant de commencer, assurez-vous que :

• Votre Nuki Ultra est déjà configuré sur le réseau Wi-Fi et accessible via l’application Nuki
• L’interphone Hikvision est installé et connecté à Internet (via Wi-Fi ou Ethernet)
• Vous avez accès à un compte administrateur sur votre réseau local
• Home Assistant est installé et opérationnel (voir guide officiel)

ÉTAPE 1 : CONFIGURER LE RELAIS SHELLY POUR CONTROLLER LE NUKI ULTRA

1. Branchez le Shelly 2.5 à une prise secteur et connectez-le à votre réseau Wi-Fi via l’application Shelly (disponible sur Android/iOS). Suivez les instructions pour le configurer comme un relais standard.
2. Dans l’application Shelly, allez dans les paramètres du relais et activez le mode « Switch » (interrupteur). Notez l’adresse IP locale du Shelly (ex: 192.168.1.100).
3. Connectez physiquement le Shelly au Nuki Ultra :
   • Débranchez l’alimentation du Nuki Ultra
   • Reliez le fil rouge (alimentation) du Shelly à la borne L du Nuki Ultra
   • Reliez le fil noir (retour) du Shelly à la borne N du Nuki Ultra
   • Branchez à nouveau l’alimentation du Nuki Ultra
4. Testez le relais : dans l’application Shelly, activez/désactivez le relais pour vérifier que le Nuki Ultra s’ouvre/ferme correctement.

ÉTAPE 2 : INTÉGRER LE SHELLY DANS HOME ASSISTANT

1. Dans Home Assistant, ajoutez un intégration « Shelly » via le menu Paramètres > Intégrations > Ajouter une intégration. Entrez l’adresse IP du Shelly et validez.
2. Une fois l’intégration créée, vous devriez voir apparaître une entité du type switch.shelly_relay_1 (ou similaire).
3. Créez un automation pour lier cette entité au Nuki Ultra :
   • Allez dans Paramètres > Automations et scénarios
   • Cliquez sur Créer un scénario
   • Donnez un nom comme « Ouverture porte via Shelly »
   • Dans la section Déclencheur, ajoutez une condition « Appuyez sur un bouton » (ou utilisez une API pour une déclenchement plus avancé)
   • Dans la section Action, ajoutez une action « Appeler un service » et sélectionnez switch.turn_on pour switch.shelly_relay_1
4. Testez l’automatisation en déclenchant manuellement le Shelly via Home Assistant.

ÉTAPE 3 : CONFIGURER L’INTERPHONE HIKVISION POUR L’API

1. Connectez-vous à votre compte Hik-Connect et identifiez votre interphone Hikvision.
2. Dans les paramètres de l’interphone (via l’application mobile ou le web), activez l’API et notez :
   • L’ID de l’appareil
   • La clé API (générée automatiquement)
   • L’adresse IP publique de votre interphone (si accessible depuis Internet)
3. Installez l’intégration Hikvision dans Home Assistant :
   • Dans le terminal de Home Assistant, exécutez :
     hacs repository add –category integration hikvision
   • Redémarrez Home Assistant
   • Ajoutez l’intégration via Paramètres > Intégrations > Ajouter une intégration > Hikvision
   • Entrez les identifiants API et validez
4. Vérifiez que les entités de l’interphone apparaissent dans Home Assistant (ex: binary_sensor.hikvision_visitor_present).

ÉTAPE 4 : CRÉER L’AUTOMATION COMPLÈTE

1. Dans Home Assistant, créez une nouvelle automatisation avec le nom « Ouverture porte Hikvision → Nuki Ultra ».
2. Définissez le déclencheur :
   • Choisissez Condition > Appuyez sur un bouton (ou utilisez une condition plus précise comme binary_sensor.hikvision_visitor_present)
   • Pour une solution plus robuste, utilisez une scène déclenchée par une requête HTTP depuis l’API Hikvision (voir exemple ci-dessous)
3. Définissez les actions dans l’ordre suivant :
   1. Envoyer une notification (optionnelle) via notify.notify pour confirmer la demande
   2. Activer le relais Shelly via service: switch.turn_on pour switch.shelly_relay_1
   3. Après 3 secondes (délai pour l’ouverture), désactiver le relais via service: switch.turn_off
   4. Envoyer une confirmation d’ouverture via notification
4. Exemple de code YAML pour une automatisation avancée (à placer dans configuration.yaml) :
   alias: « Ouverture porte Hikvision → Nuki Ultra »
   trigger:
   – platform: rest
   resource: « http://votre-adresse-hikvision/api/doorbell/ring »
   method: « POST »
   headers:
   X-API-Key: « VOTRE_CLE_API »
   action:
   – service: notify.notify
   data:
   message: « Demande d’ouverture reçue via Hikvision »
   – delay: « 00:00:03 »
   – service: switch.turn_on
   target:
   entity_id: switch.shelly_relay_1
   – delay: « 00:00:05 »
   – service: switch.turn_off
   target:
   entity_id: switch.shelly_relay_1
   – service: notify.notify
   data:
   message: « Porte ouverte via Nuki Ultra »
5. Redémarrez Home Assistant pour appliquer les changements.

ÉTAPE 5 : TESTS ET OPTIMISATIONS

1. Testez l’automatisation en :
   • Appuyant sur le bouton de l’interphone Hikvision
   • Vérifiant les logs dans Home Assistant (Développeur > Logs)
   • Confirmant visuellement l’ouverture/fermeture du Nuki Ultra
2. Optimisez les délais et les notifications selon vos besoins.
3. Pour une sécurité accrue, ajoutez une condition de vérification (ex: demande de confirmation via une caméra Hikvision avant ouverture).

🔄 SOLUTIONS EN CAS DE PROBLÈMES

💡 AMÉLIORATIONS POSSIBLES

• Intégration avec Alexa/Google Assistant : Créez des routines vocales pour contrôler le système depuis vos enceintes intelligentes.
• Notifications push : Configurez des alertes sur votre smartphone en cas de tentative d’ouverture non autorisée.
• Journalisation avancée : Utilisez Home Assistant Logger pour tracer toutes les ouvertures/fermetures.
• Mode « Invité » : Limitez l’accès à certaines heures ou jours via des règles dans Home Assistant.

📌 RÉSUMÉ DES ÉTAPES CLES

1. Relier physiquement le Shelly au Nuki Ultra
2. Configurer le Shelly dans Home Assistant
3. Activer l’API sur l’interphone Hikvision
4. Créer une automatisation liant Hikvision → Shelly → Nuki Ultra
5. Tester et optimiser le système

Avec cette configuration, votre Nuki Ultra répondra automatiquement aux appels de votre interphone Hikvision, tout en restant sécurisé et personnalisable. Pour aller plus loin, explorez les intégrations avancées de Home Assistant comme Node-RED ou Python Scripts pour des fonctionnalités sur mesure.

Ce tutoriel a été rédigé en réponse à un besoin technique identifié sur les forums communautaires. La solution d’ingénierie a été développée par le Laboratoire SolarLogik.

« `