Guide de l'utilisateur
Installation de l'application, contrôleur, appairage, clés d'invité, automatisation et sécurité. Version du document : 30.05.2026.
1. Qu'est-ce qu'Entrixy
Entrixy est un système de commande à distance des accès : barrières, portes, portails, serrures. Deux voies sont possibles :
- Contrôleur BLE — reçoit la commande directement du téléphone par Bluetooth et ferme le relais. Ni serveur ni internet ne sont nécessaires : cela fonctionne même sans réseau, et l'application peut aussi ouvrir automatiquement à l'approche.
- Contrôleur Internet — garde une connexion permanente au serveur et ouvre l'objet depuis n'importe où, pas seulement à proximité (ESP32, ESP8266 ou Raspberry Pi). Le Wi-Fi et une alimentation permanente sont nécessaires près de la motorisation.
- Numéro de téléphone — ouvre le portail ou la barrière en appelant le numéro du contrôleur, ou par reconnaissance du numéro appelant.
- Webhook — envoie une requête HTTP à un service tiers : maison connectée, relais sur votre réseau Wi-Fi, API d'un contrôleur de portail.
N'importe quel objet peut être partagé avec un invité — un proche, un collègue, un livreur — avec des limites de durée, d'horaire ou de géolocalisation.
Fonctions supplémentaires :
- Déclenchement automatique à l'approche — par géolocalisation, BLE, connexion au Wi-Fi domestique ou selon un planning.
- Confirmation par code PIN ou biométrie avant chaque ouverture.
- Un journal de chaque ouverture, avec son auteur.
- Fonctionne avec les systèmes domotiques : Home Assistant, Shelly, Tasmota, ESPHome, OpenHAB.
2. Installation de l'application
L'application est distribuée en APK autonome depuis le site entrixy.com. Elle n'est pas encore dans les magasins d'applications.
Sur un téléphone Android
- Ouvrez sur votre téléphone entrixy.com/download/android et appuyez sur « Télécharger l'APK ».
- Attendez la fin du téléchargement. Ouvrez le fichier
entrixy.apk. - Si le système le demande, autorisez l'installation depuis des sources inconnues pour votre navigateur ou votre gestionnaire de fichiers.
- Confirmez l'installation.
- Au premier lancement, l'application demande des autorisations. À quoi sert chacune :
Autorisation À quoi elle sert Bluetooth (recherche et connexion) Trouver le contrôleur à proximité et envoyer la commande d'ouverture Géolocalisation Scénarios d'automatisation par géozone. Recherche BLE sur les anciennes versions d'Android. Position en arrière-plan Déclenchement à l'approche de l'objet lorsque l'application est en arrière-plan Appareil photo Scan du QR code d'une clé invité Notifications Alertes sur un appel entrant ou une action en attente de confirmation Exclure de l'optimisation de la batterie Pour que l'économie d'énergie ne tue pas le service en arrière-plan
Après l'installation, l'application demande dans quel rôle vous souhaitez l'utiliser :
- « Je suis le propriétaire » — vous aurez un contrôleur, vous l'appairerez et pourrez partager l'accès avec d'autres personnes.
- « J'ai une invitation » — quelqu'un vous a envoyé un QR code ou un lien. Vous le scannez et obtenez l'accès à son objet.
3. Préparation du contrôleur
Si vous disposez déjà d'un contrôleur prêt à l'emploi avec le micrologiciel Entrixy d'usine, sautez cette section et passez directement à l'appairage.
Par défaut, le contrôleur fonctionne en mode impulsion : il ferme brièvement (0,5–2 secondes) une paire de contacts de la motorisation ou de la serrure, exactement comme si l'on appuyait sur le bouton Ouvrir.
Pour les motorisations et serrures qui exigent des entrées séparées ouverture/fermeture ou un état maintenu, il existe mode bistable : le contrôleur bascule la position et la mémorise — l'application affiche Ouvert/Fermé au lieu d'un simple Déclenché. Le mode se choisit lors de la génération du micrologiciel dans le configurateur.
Peuvent servir de contrôleur :
- Une carte que vous assemblez — une carte de développement ESP32 (S3 DevKit, le classique WROOM, C3 SuperMini et similaires) avec un module relais raccordé. L'option la plus souple, mais elle demande des bases en soudure.
- Un relais Wi-Fi du commerce à contact sec NO/COM, reflashé vers Entrixy. Les Shelly Plus 1 et Shelly Plus 1PM conviennent — des relais dotés de bornes Open supplémentaires, conçus précisément pour les automatismes de portail et de garage. Il faudra ouvrir le boîtier et raccorder un adaptateur USB-série aux broches UART de la carte.
- Un appareil Wi-Fi du commerce sans reflashage avec son cloud d'origine, Tasmota ou ESPHome, piloté via un webhook Entrixy. Pas besoin de BLE et la mise en route est plus simple, mais la consommation est plus élevée et la réaction plus lente. Décrit dans la section « Intégrations ».
Si vous fabriquez le contrôleur vous-même ou s'il vous faut un micrologiciel pour un brochage non standard, cela tient en trois étapes :
3.1 Configurateur de micrologiciel
Ouvrez entrixy.com/esp/ble/ — c'est un formulaire de paramètres du micrologiciel. (Le hub entrixy.com/controller/ permet de choisir d'abord entre l'option BLE et l'option internet — ici, nous suivons la voie BLE.)
Que remplir (le formulaire est divisé en sections) :
- 1. Choisissez votre carte. Touchez la carte correspondant à votre platine (ESP32 DevKit, ESP32-S3 DevKit, ESP32-C3 SuperMini, relais Shelly Plus 1 prêt à l'emploi, module nu, etc.) — le modèle, les broches et la polarité se remplissent automatiquement. Vous pourrez les ajuster ensuite à la main.
- 2. Carte. Le modèle de puce ESP32 — il détermine les broches disponibles. Le bouton « Détecter la puce connectée » reconnaît la carte par USB dans Chrome ou Edge.
- 3. Type de serrure. Loquet — une seule impulsion d'ouverture. Bistable — deux positions (ouverture et fermeture sur des broches distinctes) ; l'état est mémorisé et visible dans l'application.
- 4. Broches et polarité. Broche du relais d'ouverture — la broche GPIO à laquelle est raccordée l'entrée de commande du module relais ; ses contacts NO/COM vont aux bornes Open de la motorisation. Niveau pendant l'impulsion et niveau au repos (HIGH/LOW) : sur la plupart des modules du commerce et sur Shelly, l'impulsion est LOW et le repos HIGH ; sur les commutateurs à transistor directs, c'est l'inverse. Durée de l'impulsion — en général 500–2000 ms. En dessous : la broche du bouton d'appairage (souvent le bouton BOOT intégré, GPIO0 ; un appui long efface l'appairage) et les LED facultatives (indiquez −1 si vous n'en avez pas).
- 5. Alimentation et économie de batterie. Paramètres du cycle BLE : période du cycle d'annonce (à quelle fréquence le contrôleur se réveille — une valeur plus faible accélère la réaction, une valeur plus élevée économise l'énergie), durée de la fenêtre d'annonce, durée de maintien de la connexion, fenêtre d'appairage et sommeil entre les cycles (10–20 s — deux piles AA tiennent des mois ; 0 signifie pas de veille, pour une alimentation USB).
- 6. Horloge externe (facultatif). Un module RTC (DS3231, DS1307, PCF8563) et les broches I2C — nécessaires uniquement si vous délivrez à vos invités des clés à durée limitée. Sans lui, vous pouvez sauter cette section.
Une fois le formulaire rempli, appuyez sur « Générer le programme ».
- La première génération prend 25 à 60 secondes selon la puce.
- Si quelqu'un a déjà compilé un programme avec les mêmes paramètres, il arrive instantanément depuis le cache.
- Une fois la génération terminée, les boutons apparaissent « Charger dans le contrôleur » (flashage directement depuis le navigateur), « Télécharger le fichier » et « Ouvrir dans l'éditeur ».
3.2 Flashage depuis le navigateur
La méthode la plus simple — sans logiciel supplémentaire.
- Chrome, Edge, Opera ou Brave sur ordinateur, version 89 ou plus récente. Firefox, Safari et les navigateurs mobiles ne prennent pas en charge WebSerial et ne fonctionneront pas.
- Un câble USB pour relier le contrôleur à l'ordinateur.
- Un pilote USB-COM. Sur la plupart des cartes, il s'installe tout seul. Si la vôtre utilise une puce CH340 ou CP210x et qu'aucun port n'apparaît, installez le pilote du fabricant.
- Reliez le contrôleur à l'ordinateur en USB.
- Dans le configurateur, appuyez sur « Charger dans le contrôleur ».
- Le navigateur affiche un sélecteur de périphériques USB. Choisissez votre contrôleur dans la liste.
- Un journal du processus s'affiche sur la page :
- Lecture des informations de la puce (type, adresse MAC).
- Téléchargement du micrologiciel depuis le serveur.
- L'écriture démarre. La barre passe de 0 à 100 %.
- Redémarrage du contrôleur.
- À la fin, le contrôleur redémarre de lui-même et démarre avec le nouveau micrologiciel.
Si quelque chose ne va pas :
| Symptôme | Solution |
|---|---|
| « WebSerial n'est pas pris en charge » | Ouvrez la page dans Chrome ou Edge pour ordinateur |
| Le contrôleur n'apparaît pas dans le sélecteur de port | Installez le pilote USB-COM (CH340, CP210x) |
| « Failed to connect » après une longue attente | Maintenez le bouton BOOT (ou IO0) de la carte, appuyez sur RESET, relâchez RESET puis BOOT — cela place manuellement le contrôleur en mode bootloader |
| «Port is already open» | Fermez l'IDE Arduino, PuTTY, MicroPython et tout ce qui occupe le port |
3.3 Reflasher des relais Wi-Fi du commerce
Les relais Wi-Fi du commerce à contact sec (Shelly Plus 1, Shelly Plus 1PM) sont livrés avec le micrologiciel du fabricant. Pour obtenir une commande BLE directe, sans cloud ni dépendance au Wi-Fi, ce micrologiciel doit être remplacé par Entrixy.
Ces appareils sont conçus pour l'automatisation de portails et de barrières : ils possèdent une paire de bornes sèches NO/COM qui se raccordent directement aux bornes Open de votre motorisation. Le boîtier est compact, le relais est certifié et, contrairement à un module fait maison, il ne nécessite pas de boîte de dérivation.
Ce qu'il vous faut :
- Un adaptateur USB-série (CP2102, CH340, FTDI). Il coûte quelques euros.
- Quatre ou cinq fils à pinces crocodile ou cavaliers.
- Un tournevis pour ouvrir le boîtier.
- Un multimètre est utile pour sonner les broches si votre exemplaire est d'une révision plus récente et qu'elles diffèrent de celles publiées.
Étapes :
- Ouvrez le configurateur entrixy.com/esp/ble/. Choisissez dans la section « Relais Wi-Fi du commerce à reflasher » le préréglage portant le nom de votre relais.
- Les réglages de broches se remplissent automatiquement. Ils proviennent de bases de brochages ouvertes (templates.blakadder.com, devices.esphome.io) et sont testés sur les révisions courantes.
- Sur la page du configurateur, dans la section « Accéder à l'UART des relais Wi-Fi du commerce », trouvez votre modèle et suivez les instructions de câblage.
- Raccordez l'adaptateur USB-série : TX au RX de l'appareil, RX au TX de l'appareil, GND au GND. Alimentez l'appareil par le 3,3 V de l'adaptateur, ou par sa propre alimentation, secteur débranché.
- Placez l'ESP en mode bootloader (sur la plupart des appareils, reliez GPIO0 au GND au moment de la mise sous tension).
- Appuyez sur « Générer le programme » et attendez la fin.
- Téléversez-le avec « Envoyer vers le contrôleur » ou avec esptool depuis votre ordinateur.
- Débranchez tous les fils et refermez le boîtier. Rendez à l'appareil son alimentation secteur habituelle.
- Le relais apparaît en BLE comme un appareil en attente d'appairage. Appairez-le comme décrit à la section 4. Appairage du contrôleur.
- Câblez les bornes NO/COM côté secteur de l'appareil en parallèle du bouton Ouvrir de votre motorisation (voir le tableau des bornes courantes dans la section « Raccorder le relais à la motorisation » du configurateur).
Si votre modèle n'est pas dans les préréglages :
- Cherchez-le sur templates.blakadder.com — une base ouverte de modèles Tasmota.
- Le modèle indique les GPIO des éléments principaux : Relay1 = broche du relais, Button1 = broche du bouton, Led1 = LED d'état.
- Assurez-vous que l'appareil possède des bornes de sortie NO/COM (contact sec) — sans elles, il ne peut pas piloter une motorisation de portail, seulement commuter du courant vers une charge.
- Saisissez à la main dans le formulaire du configurateur les valeurs GPIO que vous avez trouvées.
3.4 Flashage manuel avec esptool
Si WebSerial ne fonctionne pas (sur un ordinateur ancien ou un appareil mobile, par exemple), téléchargez le fichier du micrologiciel et utilisez l'utilitaire esptool.
- Sur la page du configurateur, appuyez sur « Télécharger le fichier » et enregistrez le .bin.
- Installez esptool via Python :
pip install esptool - Reliez le contrôleur à l'ordinateur.
- Lancez la commande de flashage :
Sous Windows, au lieu deesptool.py --chip auto --port /dev/ttyUSB0 \ write_flash 0x0 entrixy-ble-XXXX.bin/dev/ttyUSB0utilisez le port COM (par exempleCOM3). Mettez votre propre nom de fichier. L'adresse0x0est correct — notre fichier contient déjà le bootloader, la table de partitions et l'application dans une seule image fusionnée. - Une fois terminé, débranchez le contrôleur puis rebranchez-le pour démarrer le nouveau micrologiciel.
4. Appairage du contrôleur avec l'application
Après le flashage, le contrôleur attend l'appairage. Dans ce mode, il émet pendant 90 secondes le signal « en attente d'un propriétaire ». Si personne ne s'appaire dans ce délai, il passe en mode normal sans propriétaire.
- Ouvrez l'application en tant que propriétaire.
- Allez dans Réglages → « Ajouter un objet » → type « BLE ».
- L'application recherche les contrôleurs en mode appairage.
- Si le contrôleur est déjà en mode appairage (fraîchement flashé, ou son bouton d'appairage vient d'être pressé), il apparaît dans la liste. Sélectionnez-le.
- S'il n'apparaît pas, appuyez sur le bouton d'appairage du contrôleur. La LED se met à clignoter rapidement et la liste de l'application se rafraîchit.
- L'application effectue un échange de clés ECDH. Cela prend quelques secondes. Ensuite, le contrôleur est à vous — personne d'autre ne pourra s'y appairer tant que vous ne l'aurez pas réinitialisé.
- Donnez un nom à l'objet (« Barrière de la cour », « Portillon latéral », « Serrure du local »). Vous pouvez choisir une icône ou téléverser une photo.
5. Objets
Un objet, c'est ce que vous voulez commander. Un même utilisateur peut avoir plusieurs objets de types différents : la barrière de la cour (un contrôleur BLE), le numéro de l'exploitant (un numéro de téléphone), un relais dans la maison connectée (un webhook).
5.1 Contrôleur BLE
S'ajoute via la section « Appairage du contrôleur » ci-dessus. Sur l'écran principal, il apparaît comme une carte avec un indicateur d'état :
- Gris — le contrôleur n'est pas visible par radio (hors de portée BLE ou éteint).
- Orange — le contrôleur est visible, mais vous n'êtes pas encore dans la zone de déclenchement (lorsque l'automatisation est configurée).
- Vert — vous êtes dans la zone de déclenchement, l'ouverture a lieu.
- Gris bordé de vert avec la mention « Appuyez pour appeler » — vient de se déclencher ; appuyez pour rouvrir.
Un appui sur la carte ouvre directement l'objet, si vos réglages de sécurité l'autorisent.
5.2 Numéro de téléphone
Pour les portails et barrières qui s'ouvrent par appel.
- Réglages → « Ajouter un objet » → type « Appel ».
- Saisissez le numéro de l'exploitant ou celui du contrôleur de la barrière.
- Réglez « Raccrocher après N secondes » si vous voulez un appel d'ouverture court (5–10 secondes), sans conversation.
- Choisissez le mode de traitement :
- Appel direct — l'application compose le numéro elle-même.
- Notification — les invités reçoivent la demande « ouvrir ? », vous confirmez vous-même et l'appel part de votre téléphone.
5.3 Webhook
Pour l'intégration avec tout ce qui accepte des commandes HTTP : maison connectée, relais sur votre réseau Wi-Fi, API de portail, IFTTT.
- Réglages → « Ajouter un objet » → type « URL ».
- Saisissez l'URL du service cible.
- Choisissez la méthode HTTP : GET, POST, PUT.
- Ajoutez des en-têtes s'ils sont exigés (Authorization, X-API-Key).
- Indiquez le corps de la requête pour POST ou PUT.
- Choisissez le mode : application ou serveur (détails en section 8. Webhooks).
6. Clés invité
Une clé d'invité est une invitation faite à une autre personne pour accéder à vos objets. L'invité utilise la même application Entrixy, simplement dans le rôle d'invité.
Créer une clé
- Sur l'écran principal : Invités → Créer une clé.
- Saisissez le nom du destinataire (« Livreur », « Anna »). Ce nom, c'est vous qui le voyez dans le journal ; l'invité en voit un autre.
- Cochez les objets auxquels vous donnez accès. N'importe quel sous-ensemble de vos objets convient.
- Configurez l'automatisation de chaque objet partagé (géozone, planning, zone BLE). Vous pouvez verrouiller les réglages pour que l'invité ne puisse pas les modifier, ou proposer des valeurs par défaut que l'invité pourra assouplir ou durcir.
- Enregistrez. La clé apparaît dans la liste des invités.
Transmettre la clé
La fiche de la clé propose plusieurs façons de la transmettre au destinataire :
- QR code — le destinataire le scanne avec l'appareil photo de son téléphone. Le moyen le plus rapide lorsqu'il est à côté de vous.
- Lien — copié dans le presse-papiers. Envoyez-le par messagerie, e-mail ou SMS. Le destinataire touche le lien, celui-ci ouvre l'application Entrixy (si elle est installée) et ajoute la clé.
- Texte — un court code d'activation que l'on peut dicter.
Gérer les invités
La section Invités liste les clés que vous avez délivrées. Pour chacune d'elles, vous pouvez :
- Modifier les objets visibles par l'invité.
- Modifier les règles d'automatisation.
- Modifier le nom affiché.
- Révoquer entièrement la clé — l'invité perd l'accès immédiatement.
- Voir l'état : en ligne ou hors ligne, et la date de dernière utilisation.
Le journal d'événements de l'invité
Chaque ouverture effectuée par un invité arrive dans le journal du propriétaire avec la mention « Invité : nom ». Cela fonctionne même si l'invité a utilisé le BLE directement sans réseau — l'événement est conservé sur le téléphone de l'invité et envoyé dès qu'il se connecte au serveur.
7. Automatisation
Chaque objet peut être réglé pour se déclencher automatiquement selon des conditions. Ouvrez-le depuis le menu de l'objet → Automatisation.
7.1 Géolocalisation
S'ouvre à l'approche d'un point sur la carte.
- Placez le point sur la carte (appuyez sur « Utiliser la position actuelle » si vous êtes près de l'objet).
- Fixez le rayon — la distance à laquelle le déclenchement se produit (en général 20–50 mètres pour une cour, 100–200 pour un grand parking).
- Enregistrez.
Comment se produit le déclenchement :
- Dans la zone extérieure — le rayon plus 250 mètres, mais jamais à moins de 300 m du point — la carte devient orange : vous approchez. Le déclencheur est armé.
- À l'intérieur du rayon, l'ouverture se fait automatiquement, une seule fois. La carte clignote en vert, puis devient grise avec un contour vert.
- Il ne se déclenchera pas de nouveau tant que vous n'aurez pas quitté la zone extérieure. Cela évite les ouvertures répétées lorsque vous vous déplacez autour du point.
7.2 Wi-Fi
Ouvre dès que votre téléphone se connecte à un réseau Wi-Fi donné. Pratique pour « quand je suis chez moi, ouvre le portail à mon arrivée ».
- Activez la règle Wi-Fi.
- Ajoutez un réseau. L'application liste ceux à proximité.
- Vous pouvez ajouter plusieurs réseaux (chez vous et au travail, par exemple). Par défaut, n'importe quelle correspondance déclenche.
7.3 Heure
Une limite par heure de la journée et jour de la semaine. Utilisez-la pour restreindre un invité (« accès uniquement aux heures ouvrées ») ou comme condition dans votre propre automatisation.
- Ajoutez un intervalle : d'une heure à une autre. Plusieurs intervalles par jour sont permis.
- Cochez les jours de la semaine.
- Vous pouvez créer plusieurs intervalles différents avec des jours différents.
7.4 BLE
Se déclenche selon la puissance du signal BLE du contrôleur. Utile pour les serrures et barrières là où le GPS est imprécis — à l'intérieur ou dans un parking souterrain.
- Définissez le rayon de déclenchement (de 1 à 30 mètres).
- À l'intérieur du rayon, la carte devient verte et l'ouverture se fait automatiquement.
- À portée mais hors du rayon, la carte est orange.
- Il ne se redéclenche qu'après la sortie de portée.
7.5 Combinaison de règles
Vous pouvez activer plusieurs règles à la fois et choisir comment elles se combinent :
- OU (par défaut) — se déclenche dès que l'une d'elles est remplie. Par exemple : « à la maison (Wi-Fi) ou à l'arrivée (géozone) ».
- ET — ne se déclenche que lorsque toutes les règles sont remplies en même temps. Par exemple : « heures ouvrées (planning) ET au bureau (Wi-Fi) ». En mode ET, il n'y a pas d'ouverture automatique : la carte indique simplement que les conditions correspondent et que vous pouvez appuyer.
7.6 Confirmation de l'action
Vous pouvez exiger une confirmation supplémentaire avant chaque ouverture :
- Code PIN — un court code numérique saisi dans l'application.
- Biométrie — empreinte digitale ou reconnaissance du visage, via la boîte de dialogue système d'Android.
- Confirmation — une simple boîte de dialogue « Ouvrir ? Oui / Non ». Elle protège d'un appui accidentel.
Ces réglages peuvent être inscrits dans la clé d'un invité — exiger un code PIN de l'invité, par exemple, mais pas de vous-même.
8. Les webhooks en détail
Un objet webhook fonctionne dans l'un des deux modes. Le choix dépend de qui doit émettre la requête HTTP : votre téléphone ou notre serveur.
8.1 Mode application
La requête HTTP est envoyée par l'application sur votre téléphone. Au déclenchement — vous appuyez, ou un invité en fait la demande via le serveur — le serveur signale à votre téléphone, et celui-ci émet la requête vers l'adresse cible.
Quand le choisir :
- Le service cible se trouve sur votre réseau local (Shelly, Tasmota, un relais domotique) et n'est pas joignable depuis internet. La requête part de votre téléphone, à l'intérieur de votre réseau.
- Vous ne voulez pas que notre serveur connaisse l'URL cible.
Limite : votre téléphone doit être en ligne à ce moment-là. S'il est éteint ou sans internet, le webhook ne sera pas envoyé.
8.2 Mode serveur
Notre serveur émet lui-même la requête HTTP, depuis sa propre adresse IP. Votre téléphone n'est pas nécessaire à ce moment-là.
Le corps de la requête est du JSON avec signature HMAC :
{
"action": "open",
"object_id": 42,
"timestamp": 1717075200,
"nonce": "8f2a1c4b5e6d7f80",
"signature": "a3b4c5d6e7f8..."
}
La signature se calcule ainsi : construisez la chaîne timestamp.nonce.action.object_id et calculez HMAC-SHA256(cette chaîne, webhook_secret), puis comparez-la à la signatureque vous avez reçue. Rejetez la requête si |now − timestamp| date de plus de 300 secondes. Le format complet et un vecteur de test se trouvent sur entrixy.com/webhook.
Quand le choisir :
- Le service cible est joignable depuis internet (Home Assistant sur une adresse publique, une API cloud, IFTTT).
- Vous voulez que l'ouverture ait lieu même téléphone éteint — selon un planning, par exemple, ou à la demande d'un invité.
- Le service cible exige des requêtes signées pour se protéger des appels falsifiés venus de l'extérieur.
Sécurité : à la création du webhook, vous définissez un webhook_secret. Les invités ne reçoivent jamais ce secret, même lorsqu'ils ont accès à l'objet. Le serveur signe les requêtes avec lui en votre nom.
Délai : si le service cible ne répond pas dans les 15 secondes, le serveur ferme la connexion et renvoie un statut d'erreur.
9. Intégrations domotiques
Le répertoire /integrations/ du site contient des configurations prêtes à l'emploi pour les plateformes courantes. Chacune a son propre README avec un schéma de câblage.
| Plateforme | Que faire |
|---|---|
| Home Assistant | Copiez configuration.yaml depuis le répertoire. Dans Entrixy, créez un webhook en mode serveur avec l'URL https://your-ha/api/webhook/entrixy. |
| Shelly | Dans Entrixy, créez un webhook en mode application avec l'URL http://shelly-ip/relay/0?turn=on. Un simple appel GET : le téléphone émet la requête à l'intérieur de votre réseau domestique. |
| Tasmota | Comme pour Shelly. URL : http://tasmota-ip/cm?cmnd=Power%20Toggle. |
| ESPHome | Micrologiciel alternatif pour l'ESP32 si vous préférez l'écosystème ESPHome à notre protocole BLE. Le répertoire contient un exemple de configuration YAML. |
| OpenHAB | Semblable à Home Assistant. Il accepte les requêtes HTTP via l'API de règles. |
| curl | Un script de test. Il accepte notre JSON, vérifie la signature HMAC et affiche le résultat. Utilisez-le pour le débogage. |
| Flask | Un squelette Python pour votre propre service. Il accepte notre JSON et valide la signature. |
10. L'application web pour invités
Si un invité ne veut pas installer l'application Android, ou s'il a un iPhone, il existe une version web à l'adresse entrixy.com/app/.
L'application web prend en charge :
- L'ouverture par numéro de téléphone et par webhook.
- Le journal des événements.
- L'installation sur l'écran d'accueil en tant que PWA (via le menu « Installer l'application » du navigateur).
L'application web ne prend pas en charge:
- Le travail direct avec un contrôleur BLE (un navigateur n'a pas accès à la pile Bluetooth au niveau requis).
- L'automatisation par géolocalisation en arrière-plan.
- Les notifications via FCM.
Pour que tout fonctionne sans limites, mieux vaut que l'invité installe l'application Android.
11. Sécurité
La liaison avec le contrôleur
Le premier appairage utilise ECDH X25519. Les deux parties calculent le secret partagé en même temps — le secret lui-même ne circule jamais sur les ondes.
Chaque commande d'ouverture (FIRE) est signée en HMAC-SHA256 avec le secret partagé et un nonce à usage unique délivré au préalable par le contrôleur. Écouter les ondes ne permet pas de rejouer la commande — ce nonce est déjà consommé.
Accès invité
L'invité ne reçoit pas le secret partagé mais un jeton à durée de vie limitée (24 heures par défaut), signé par le propriétaire. Le contrôleur vérifie la signature du propriétaire et l'expiration — même un jeton d'invité ayant fuité cesse de fonctionner une fois expiré.
Le jeton est renouvelé automatiquement via le serveur tant que l'appairage du propriétaire tient. Dès que le propriétaire révoque la clé, le renouvellement suivant échoue et l'invité perd l'accès.
La liaison entre l'application et le serveur
Toutes les connexions passent par TLS (HTTPS et WSS). Les données utilisateur — numéros de téléphone, noms des objets et des invités — sont stockées sur le serveur chiffrées de bout en bout : même le propriétaire du serveur ne peut pas les lire sans votre clé.
La cryptographie est décrite en détail dans le document Architecture E2EE.
Webhooks en mode serveur
Les requêtes sont signées en HMAC-SHA256. Le secret que vous définissez sur le serveur n'est jamais remis aux clients ni aux invités. Celui qui intercepte une requête ne peut pas la rejouer, car l'horodatage expire au bout de 300 secondes — une règle que le service cible applique.
12. Questions fréquentes et dépannage
Le contrôleur BLE n'est pas visible
- Vérifiez que le contrôleur est alimenté. La LED doit clignoter.
- Vérifiez que le Bluetooth du téléphone est activé.
- Si l'économie de batterie est active, désactivez-la pour Entrixy.
- Rapprochez-vous du contrôleur, à un ou deux mètres — en limite de portée, le signal peut chuter.
- Si le contrôleur est réglé en sommeil profond (deep_sleep_wake_s > 0), il n'émet pas en permanence — seulement pendant sa fenêtre d'éveil. Patientez 10 à 30 secondes.
Il se déclenche plusieurs fois de suite
Vous vous tenez très probablement juste à la limite de la zone de déclenchement et le signal fluctue à cause des interférences. Que faire :
- Réduisez le rayon de la zone BLE dans les réglages d'automatisation.
- Éloignez le contrôleur des objets métalliques qui font écran au signal.
Un invité signale que la carte est grise et n'ouvre pas
Vérifiez l'état de sa clé dans votre section Invités. Causes possibles :
- Le jeton de l'invité a expiré — plus de 24 heures se sont écoulées depuis que son téléphone était en ligne, par exemple. L'invité doit ouvrir l'application et se connecter à un réseau : le jeton se renouvelle tout seul.
- Vous avez révoqué la clé par mégarde. Créez-en une nouvelle.
- L'invité est hors de portée — les objets BLE exigent d'être physiquement à côté du contrôleur.
L'application s'est fermée toute seule
Android tue agressivement les services d'arrière-plan pour économiser la batterie. Pour l'éviter :
- Ouvrez Paramètres des applications → Entrixy → Batterie et choisissez Sans restriction.
- Sur Samsung, ajoutez Entrixy aux Applications jamais mises en veille, dans Maintenance de l'appareil.
- Sur Xiaomi et Redmi, autorisez le démarrage automatique d'Entrixy.
- Sur Huawei, ajoutez-la aux Applications protégées et autorisez l'activité en arrière-plan.
Le webhook n'arrive pas jusqu'à Home Assistant
- Vérifiez l'URL dans les réglages du webhook. Elle doit être complète — avec le schéma https:// et le port s'il n'est pas standard.
- Vérifiez que Home Assistant est joignable depuis l'extérieur (en mode serveur) ou depuis votre réseau domestique (en mode application).
- Regardez les journaux de Home Assistant au moment du déclenchement — une entrée doit correspondre à la requête entrante.
- Vérifiez le pare-feu de votre routeur, au cas où il bloquerait les connexions entrantes.
Les notifications d'appel ne fonctionnent pas sur Huawei
Les notifications push reposent sur Google FCM, indisponible sur Huawei sans les services Google. En contournement, laissez l'application ouverte plutôt que réduite, ou utilisez l'appairage BLE et les géozones à la place des notifications.
Comment mettre à jour l'application
Ouvrez entrixy.com/download/android sur votre téléphone et installez la dernière version par-dessus l'actuelle. Vos données sont conservées.
Lorsqu'une mise à jour est obligatoire — un correctif de sécurité critique — l'application affiche au démarrage une boîte de dialogue bloquante.
Comment supprimer votre compte et toutes vos données
Ouvrez l'application → Paramètres → Supprimer le compte. Tout ce qui se trouve sur le serveur est effacé sous 30 jours, le délai standard indiqué dans la politique de confidentialité.
Pour une suppression immédiate, envoyez une demande à l'adresse d'assistance indiquée dans la Politique de confidentialité.
Document mis à jour le 30.05.2026. Si quelque chose reste flou ou si votre cas n'est pas traité, écrivez à hello@entrixy.com.