Benutzerhandbuch

Installation der App, Controller, Kopplung, Gastschlüssel, Automatik und Sicherheit. Fassung des Dokuments: 30.05.2026.

Inhalt
  1. Was Entrixy ist
  2. Die App installieren
  3. Den Controller vorbereiten
    1. Firmware-Konfigurator
    2. Flashen aus dem Browser
    3. Fertige WLAN-Relais neu flashen
    4. Manuell mit esptool flashen
  4. Den Controller mit der App koppeln
  5. Objekte
    1. BLE-Controller
    2. Telefonnummer
    3. Webhook
  6. Gastschlüssel
  7. Automatisierung
    1. Standort
    2. Wi-Fi
    3. Zeit
    4. BLE
    5. Regeln kombinieren
    6. Bestätigung der Aktion
  8. Webhooks im Detail
    1. App-Modus
    2. Server-Modus
  9. Smart-Home-Integrationen
  10. Die Web-App für Gäste
  11. Sicherheit
  12. Häufige Fragen und Störungsbehebung

1. Was Entrixy ist

Entrixy ist ein System zur Fernsteuerung von Zugängen: Schranken, Türen, Tore, Schlösser. Dafür gibt es zwei Wege:

Jedes Objekt lässt sich mit einem Gast teilen — Verwandte, Kollegen, Kurier — begrenzt durch Zeitraum, Zeitplan oder Geobedingungen.

Weitere Funktionen:

2. Die App installieren

Die App wird als separate APK-Datei über die Website verteilt entrixy.com. In den App-Stores ist sie noch nicht.

Auf einem Android-Telefon

  1. Öffnen Sie auf dem Telefon entrixy.com/download/android und tippen Sie auf „APK herunterladen".
  2. Warten Sie das Herunterladen ab. Öffnen Sie die geladene entrixy.apk.
  3. Falls das System nachfragt, erlauben Sie Ihrem Browser oder Dateimanager die Installation aus unbekannten Quellen.
  4. Bestätigen Sie die Installation.
  5. Beim ersten Start fragt die App nach Berechtigungen. Wofür sie jeweils gebraucht werden:
    BerechtigungWofür
    Bluetooth (Suchen + Verbinden)Den Controller in der Nähe finden und den Öffnungsbefehl senden
    StandortAutomatikszenarien mit Geozonen. BLE-Suche auf älteren Android-Versionen.
    Standort im HintergrundAuslösen bei Annäherung an das Objekt, während die App im Hintergrund läuft
    KameraScannen des QR-Codes eines Gastschlüssels
    BenachrichtigungenHinweise auf einen eingehenden Anruf oder eine Aktion, die auf Bestätigung wartet
    Von der Akkuoptimierung ausnehmenDamit der Hintergunddienst nicht vom Energiesparen beendet wird
Ein Hinweis für Samsung und Huawei. Öffnen Sie Einstellungen → Akku → Apps, die nie schlafen (oder einen ähnlichen Punkt) und fügen Sie Entrixy hinzu.

Nach der Installation fragt die App, in welcher Rolle Sie sie nutzen möchten:

3. Den Controller vorbereiten

Wenn Sie bereits einen fertigen Controller mit werkseitiger Entrixy-Firmware haben, überspringen Sie diesen Abschnitt und gehen direkt zu Kopplung.

Standardmäßig arbeitet der Controller im Impulsbetrieb: Er schließt für kurze Zeit (0,5–2 Sekunden) ein Kontaktpaar am Antrieb oder Schloss, genau so, als hätte jemand die Taste Öffnen gedrückt.

Für Antriebe und Schlösser, die getrennte Eingänge für Öffnen/Schließen oder einen gehaltenen Zustand brauchen, gibt es bistabiler Modus: Der Controller schaltet die Position um und merkt sie sich — die App zeigt Offen/Geschlossen statt nur Ausgelöst. Der Modus wird beim Erstellen der Firmware im Konfigurator gewählt.

Als Controller eignen sich:

Steckdosen und WLAN-Schalter sind ungeeignet. Athom Plug, Shelly Plus Plug S und ähnliche Geräte schalten Netzspannung auf einen Verbraucher und besitzen keinen potentialfreien NO/COM-Ausgang. Für einen Torantrieb brauchen Sie entweder ein Relais mit potentialfreiem Kontakt (Shelly Plus 1) oder ein selbstgebautes Modul.
Wichtig zu den Chips. Direkte BLE-Steuerung beherrschen nur Chips der ESP32-Familie mit Bluetooth: ESP32, ESP32-S3, ESP32-C3, ESP32-C6, ESP32-H2. Der ESP32-S2 Chip und der ältere ESP8266 haben kein Bluetooth — sie lassen sich nur mit der WLAN-Firmware oder über einen Webhook nutzen.
Wenn Akkubetrieb keine Rolle spielt. Gibt es am Antrieb WLAN und eine Steckdose in der Nähe und möchten Sie aus der Ferne öffnen, dann werfen Sie einen Blick auf Internet-Variante. Das ist der alternative Weg: Der Controller ist immer online und hängt nicht davon ab, wie weit Ihr Telefon entfernt ist.

Wenn Sie den Controller selbst bauen oder Firmware für eine unübliche Pinbelegung brauchen, sind es drei Schritte:

3.1 Firmware-Konfigurator

Öffnen Sie entrixy.com/esp/ble/ — ein Formular mit den Firmware-Parametern. (Über den Hub entrixy.com/controller/ lässt Sie zuerst zwischen der BLE- und der Internet-Variante wählen — hier gehen wir den BLE-Weg.)

Was auszufüllen ist (das Formular ist in Abschnitte unterteilt):

  1. 1. Platine auswählen. Tippen Sie auf die Karte Ihres Boards (ESP32 DevKit, ESP32-S3 DevKit, ESP32-C3 SuperMini, fertiges Shelly-Plus-1-Relais, nacktes Modul und so weiter) — Modell, Pins und Polarität werden automatisch ausgefüllt. Danach lassen sie sich von Hand anpassen.
  2. 2. Platine. Das ESP32-Chipmodell — es bestimmt, welche Pins zur Verfügung stehen. Die Schaltfläche „Angeschlossenen Chip erkennen“ erkennt das Board in Chrome oder Edge über USB.
  3. 3. Schlossart. Schnapper — ein einzelner Öffnungsimpuls. Bistabil — zwei Positionen (Öffnen und Schließen auf getrennten Pins); der Zustand wird gespeichert und ist in der App sichtbar.
  4. 4. Pins und Polarität. Relais-Pin für das Öffnen — der GPIO, an dem der Steuereingang des Relaismoduls hängt; dessen NO/COM-Kontakte gehen an die Open-Klemmen des Antriebs. Pegel während des Impulses und Ruhepegel (HIGH/LOW): Bei den meisten fertigen Modulen und bei Shelly ist der Impuls LOW und der Ruhezustand HIGH; bei direkten Transistorschaltern ist es umgekehrt. Impulsdauer — üblicherweise 500–2000 ms. Darunter: der Pin der Kopplungstaste (meist die eingebaute BOOT-Taste, GPIO0; ein langer Druck löscht die Kopplung) und optionale LEDs (tragen Sie −1 ein, wenn Sie keine haben).
  5. 5. Stromversorgung und Akkusparen. Parameter des BLE-Zyklus: Periode des Sendezyklus (wie oft der Controller aufwacht — ein kleinerer Wert bedeutet schnellere Reaktion, ein größerer spart Strom), Länge des Sendefensters, Haltezeit der Verbindung, Kopplungsfenster und Schlaf zwischen den Zyklen (10–20 s — zwei AA-Batterien halten Monate; 0 bedeutet kein Schlaf, für USB-Betrieb).
  6. 6. Externe Uhr (optional). Ein RTC-Modul (DS3231, DS1307, PCF8563) und die I2C-Pins — nur nötig, wenn Sie Gästen zeitlich begrenzte Schlüssel ausstellen. Ohne ein solches Modul können Sie diesen Abschnitt überspringen.

Wenn das Formular ausgefüllt ist, klicken Sie auf Programm erstellen.

3.2 Flashen aus dem Browser

Der einfachste Weg — ohne zusätzliche Software.

Voraussetzungen:
  • Chrome, Edge, Opera oder Brave auf dem Desktop, Version 89 oder neuer. Firefox, Safari und mobile Browser unterstützen WebSerial nicht und funktionieren hier nicht.
  • Ein USB-Kabel zur Verbindung von Controller und Computer.
  • Ein USB-zu-COM-Treiber. Bei den meisten Boards installiert er sich selbst. Nutzt Ihr Board einen CH340- oder CP210x-Chip und es erscheint kein Port, installieren Sie den Treiber des Herstellers.
  1. Verbinden Sie den Controller per USB mit dem Computer.
  2. Klicken Sie im Konfigurator auf „In den Controller laden".
  3. Der Browser zeigt eine Auswahl der USB-Geräte. Wählen Sie Ihren Controller aus der Liste.
  4. Auf der Seite erscheint ein Ablaufprotokoll:
    • Auslesen der Chip-Daten (Typ, MAC-Adresse).
    • Herunterladen der Firmware vom Server.
    • Das Schreiben beginnt. Der Fortschrittsbalken läuft von 0 bis 100 %.
    • Neustart des Controllers.
  5. Am Ende startet der Controller von selbst neu und läuft mit der neuen Firmware.
Ziehen Sie das USB-Kabel während des Flashens nicht ab. Wird der Vorgang unterbrochen, bleibt der Controller im Bootloader-Modus und muss erneut geflasht werden.

Wenn etwas schiefgeht:

SymptomAbhilfe
WebSerial wird nicht unterstütztÖffnen Sie die Seite im Desktop-Chrome oder Edge
Der Controller erscheint nicht in der PortauswahlInstallieren Sie den USB-COM-Treiber (CH340, CP210x)
Failed to connect nach langem WartenHalten Sie die BOOT- (oder IO0-)Taste auf dem Board gedrückt, drücken Sie RESET, lassen Sie RESET los und danach BOOT — so versetzen Sie den Controller von Hand in den Bootloader-Modus
«Port is already open»Schließen Sie Arduino IDE, PuTTY, MicroPython und alles andere, was den Port belegt

3.3 Fertige WLAN-Relais neu flashen

Fertige WLAN-Relais mit potentialfreiem Kontakt (Shelly Plus 1, Shelly Plus 1PM) kommen mit der Firmware des Herstellers. Für direkte BLE-Steuerung ohne Cloud und ohne WLAN-Abhängigkeit muss diese Firmware durch Entrixy ersetzt werden.

Diese Geräte sind für Tor- und Schrankenautomatik gebaut: Sie besitzen ein Paar potentialfreie NO/COM-Klemmen, die direkt an die Open-Klemmen Ihres Antriebs gehen. Das Gehäuse ist kompakt, das Relais zertifiziert, und anders als ein Eigenbaumodul braucht es keine Abzweigdose.

Was Sie brauchen:

Sicherheit. Trennen Sie das Gerät vom Netz, bevor Sie es öffnen. Schließen Sie niemals einen USB-UART-Adapter an ein Gerät an, das unter Netzspannung steht — die Potentialdifferenz der Masse zerstört den USB-Port Ihres Rechners.

Schritte:

  1. Öffnen Sie den Konfigurator entrixy.com/esp/ble/. Wählen Sie im Abschnitt „Fertige WLAN-Relais zum Umflashen“ die Vorlage mit dem Namen Ihres Relais.
  2. Die Pin-Einstellungen werden automatisch ausgefüllt. Sie stammen aus offenen Pinout-Datenbanken (templates.blakadder.com, devices.esphome.io) und sind an den verbreiteten Revisionen erprobt.
  3. Suchen Sie auf der Konfiguratorseite im Abschnitt „Zugang zum UART bei fertigen WLAN-Relais“ Ihr Modell und folgen Sie der Anschlussanleitung.
  4. Schließen Sie den USB-UART-Adapter an: TX an RX des Geräts, RX an TX des Geräts, GND an GND. Versorgen Sie das Gerät über die 3,3 V des Adapters oder über sein eigenes Netzteil bei getrennter Netzspannung.
  5. Versetzen Sie den ESP in den Bootloader-Modus (bei den meisten Geräten GPIO0 beim Einschalten auf GND legen).
  6. Klicken Sie auf „Programm erstellen" und warten Sie ab.
  7. Spielen Sie sie mit „Auf den Controller hochladen“ oder mit esptool auf Ihrem Rechner ein.
  8. Trennen Sie alle Leitungen und schließen Sie das Gehäuse. Versorgen Sie das Gerät wieder wie gewohnt mit Netzspannung.
  9. Das Relais erscheint über BLE als Gerät, das auf die Kopplung wartet. Koppeln Sie es wie im Abschnitt beschrieben 4. Den Controller koppeln.
  10. Verdrahten Sie die NO/COM-Klemmen auf der Netzseite des Geräts parallel zur Open-Taste Ihres Antriebs (siehe die Tabelle der üblichen Klemmen im Konfiguratorabschnitt „Relais an den Antrieb anschließen“).

Wenn Ihr Modell nicht unter den Vorlagen ist:

  1. Suchen Sie es auf templates.blakadder.com — eine offene Datenbank mit Tasmota-Vorlagen.
  2. Die Vorlage nennt die GPIOs der wichtigsten Teile: Relay1 = Relais-Pin, Button1 = Tasten-Pin, Led1 = Status-LED.
  3. Vergewissern Sie sich, dass das Gerät NO/COM-Ausgangsklemmen besitzt (potentialfreier Kontakt) — ohne sie kann es keinen Torantrieb ansteuern, sondern nur Strom auf einen Verbraucher schalten.
  4. Tragen Sie die ermittelten GPIO-Werte von Hand in das Formular des Konfigurators ein.

3.4 Manuell mit esptool flashen

Wenn WebSerial nicht funktioniert (etwa auf einem älteren Rechner oder einem Mobilgerät), laden Sie die Firmware-Datei herunter und nutzen Sie das Werkzeug esptool.

  1. Drücken Sie auf der Konfiguratorseite „Datei herunterladen“ und speichern Sie die .bin.
  2. Installieren Sie esptool über Python: 
    pip install esptool
  3. Verbinden Sie den Controller mit dem Computer.
  4. Führen Sie den Flash-Befehl aus: 
    esptool.py --chip auto --port /dev/ttyUSB0 \
  write_flash 0x0 entrixy-ble-XXXX.bin
    Unter Windows statt /dev/ttyUSB0 den COM-Port verwenden (zum Beispiel COM3). Setzen Sie Ihren eigenen Dateinamen ein. Die Adresse 0x0 ist richtig — unsere Datei enthält Bootloader, Partitionstabelle und Anwendung bereits in einem zusammengeführten Abbild.
  5. Wenn es fertig ist, trennen Sie den Controller kurz von der Stromversorgung und stecken ihn wieder ein, damit die neue Firmware startet.

4. Den Controller mit der App koppeln

Nach dem Flashen wartet der Controller auf die Kopplung. In diesem Modus sendet er 90 Sekunden lang das Signal „warte auf einen Besitzer“. Koppelt sich in dieser Zeit niemand, wechselt er in den normalen Modus ohne Besitzer.

  1. Öffnen Sie die App in der Rolle des Eigentümers.
  2. Gehen Sie zu Einstellungen → Objekt hinzufügen → Typ BLE.
  3. Die App sucht nach Controllern im Kopplungsmodus.
  4. Ist der Controller bereits im Kopplungsmodus (frisch geflasht oder die Kopplungstaste wurde kürzlich gedrückt), erscheint er in der Liste. Wählen Sie ihn aus.
  5. Erscheint er nicht, drücken Sie die Kopplungstaste am Controller. Die LED beginnt schnell zu blinken, und die Liste in der App aktualisiert sich.
  6. Die App führt einen ECDH-Schlüsselaustausch durch. Das dauert ein paar Sekunden. Danach gehört der Controller Ihnen — niemand sonst kann sich mit ihm koppeln, solange Sie ihn nicht zurücksetzen.
  7. Geben Sie dem Objekt einen Namen („Schranke im Hof“, „Seitentor“, „Schloss am Lagerraum“). Sie können ein Symbol wählen oder ein Foto hochladen.
Kopplung zurücksetzen. Um den Controller an einen anderen Besitzer zu übergeben oder ihn erneut zu koppeln, halten Sie die Kopplungstaste länger als 5 Sekunden gedrückt. Der Controller kehrt in den Auslieferungszustand zurück und geht für 90 Sekunden wieder in den Kopplungsmodus.

5. Objekte

Ein Objekt ist das, was Sie steuern möchten. Ein Nutzer kann mehrere Objekte verschiedener Art haben: die Schranke im Hof (ein BLE-Controller), die Nummer des Betreibers (eine Rufnummer), ein Relais im Smart Home (ein Webhook).

5.1 BLE-Controller

Wird über den Abschnitt „Controller koppeln“ weiter oben hinzugefügt. Auf dem Hauptbildschirm erscheint es als Karte mit Statusanzeige:

Ein Tippen auf die Karte öffnet das Objekt direkt, sofern Ihre Sicherheitseinstellungen das zulassen.

5.2 Telefonnummer

Für Tore und Schranken, die sich per Anruf öffnen.

  1. Einstellungen → Objekt hinzufügen → Typ Anruf.
  2. Geben Sie die Nummer des Betreibers oder die Nummer der Schrankensteuerung ein.
  3. Stellen Sie „Nach N Sekunden auflegen“ ein, wenn der Öffnungsanruf kurz sein soll (5–10 Sekunden) und ohne Gespräch.
  4. Wählen Sie die Verarbeitung:
    • Direkter Anruf — die App wählt die Nummer selbst.
    • Benachrichtigung — Gäste erhalten die Rückfrage „öffnen?“, Sie bestätigen selbst, und der Anruf geht von Ihrem Telefon aus.

5.3 Webhook

Für die Anbindung an alles, was HTTP-Befehle annimmt: Smart Home, ein Relais im eigenen WLAN, die API eines Tors, IFTTT.

  1. Einstellungen → Objekt hinzufügen → Typ URL.
  2. Geben Sie die URL des Zieldienstes ein.
  3. Wählen Sie die HTTP-Methode: GET, POST, PUT.
  4. Fügen Sie Header hinzu, falls sie verlangt werden (Authorization, X-API-Key).
  5. Geben Sie den Anfragekörper für POST oder PUT an.
  6. Wählen Sie den Modus: App oder Server (Näheres in Abschnitt 8. Webhooks).

6. Gastschlüssel

Ein Gastschlüssel ist eine Einladung für eine andere Person, Zugang zu Ihren Objekten zu erhalten. Der Gast nutzt dieselbe Entrixy-App, nur in der Gastrolle.

Schlüssel erstellen

  1. Auf dem Hauptbildschirm: Gäste → Schlüssel erstellen.
  2. Geben Sie den Namen des Empfängers ein („Kurier“, „Anna“). Diesen Namen sehen Sie im Protokoll; der Gast sieht einen anderen.
  3. Markieren Sie die Objekte, zu denen Sie Zugang gewähren. Jede beliebige Auswahl Ihrer Objekte ist möglich.
  4. Richten Sie für jedes freigegebene Objekt die Automatik ein (Geozone, Zeitplan, BLE-Zone). Sie können die Einstellungen festschreiben, sodass der Gast sie nicht ändern kann, oder Vorgaben anbieten, die der Gast lockern oder verschärfen darf.
  5. Speichern. Der Schlüssel erscheint in der Gästeliste.

Den Schlüssel übergeben

Die Karte des Schlüssels bietet mehrere Wege, ihn dem Empfänger zu übergeben:

Gäste verwalten

Im Bereich Gäste stehen die von Ihnen ausgestellten Schlüssel. Für jeden davon können Sie:

Das Ereignisprotokoll des Gastes

Jede Öffnung durch einen Gast landet im Protokoll des Besitzers mit dem Vermerk „Gast: Name“. Das funktioniert auch, wenn der Gast BLE direkt ohne Netz genutzt hat — das Ereignis wird auf dem Telefon des Gastes gespeichert und in dem Moment gesendet, in dem es sich mit dem Server verbindet.

7. Automatisierung

Für jedes Objekt lässt sich automatisches Auslösen nach Bedingungen einrichten. Öffnen Sie es über das Objektmenü → Automatik.

7.1 Standort

Öffnet, wenn Sie sich einem Punkt auf der Karte nähern.

  1. Setzen Sie den Punkt auf der Karte (drücken Sie „Aktuellen verwenden“, wenn Sie neben dem Objekt stehen).
  2. Legen Sie den Radius fest — die Entfernung, bei der ausgelöst wird (üblich sind 20–50 Meter für Höfe, 100–200 für große Parkplätze).
  3. Speichern.

So funktioniert die Auslösung:

7.2 Wi-Fi

Öffnet, sobald sich Ihr Telefon mit einem bestimmten WLAN verbindet. Praktisch für „wenn ich zu Hause bin, öffne das Tor bei der Zufahrt“.

  1. Schalten Sie die WLAN-Regel ein.
  2. Fügen Sie ein Netz hinzu. Die App zeigt die verfügbaren.
  3. Sie können mehrere Netze hinzufügen (etwa zu Hause und im Büro). Standardmäßig löst jede Übereinstimmung aus.

7.3 Zeit

Eine Begrenzung nach Tageszeit und Wochentag. Nutzen Sie sie, um einen Gast einzuschränken („Zugang nur zu Geschäftszeiten“) oder als Bedingung in Ihrer eigenen Automatik.

7.4 BLE

Löst anhand der Stärke des BLE-Signals des Controllers aus. Gut für Schlösser und Schranken, wo GPS ungenau ist — in Gebäuden oder in der Tiefgarage.

7.5 Regeln kombinieren

Sie können mehrere Regeln gleichzeitig aktivieren und festlegen, wie sie zusammenwirken:

7.6 Bestätigung der Aktion

Vor jeder Öffnung lässt sich eine zusätzliche Bestätigung verlangen:

Diese Einstellungen lassen sich in den Schlüssel eines Gastes einbauen — verlangen Sie etwa vom Gast eine PIN, von sich selbst aber nicht.

8. Webhooks im Detail

Ein Webhook-Objekt arbeitet in einem von zwei Modi. Welchen Sie wählen, hängt davon ab, wer die HTTP-Anfrage stellen soll: Ihr Telefon oder unser Server.

8.1 App-Modus

Die HTTP-Anfrage sendet die App auf Ihrem Telefon. Beim Auslösen — Sie tippen, oder ein Gast fragt über den Server an — gibt der Server Ihrem Telefon ein Signal, und das Telefon richtet die Anfrage an die Zieladresse.

Wann Sie ihn wählen:

Einschränkung: Ihr Telefon muss in diesem Moment online sein. Ist es ausgeschaltet oder ohne Internet, wird der Webhook nicht gesendet.

8.2 Server-Modus

Unser Server sendet die HTTP-Anfrage selbst, von seiner eigenen IP-Adresse. Ihr Telefon wird in diesem Moment nicht gebraucht.

Der Anfragekörper ist JSON mit HMAC-Signatur:

{
  "action": "open",
  "object_id": 42,
  "timestamp": 1717075200,
  "nonce": "8f2a1c4b5e6d7f80",
  "signature": "a3b4c5d6e7f8..."
}

Die Signatur entsteht so: Bilden Sie die Zeichenkette timestamp.nonce.action.object_id und berechnen Sie HMAC-SHA256(diese Zeichenkette, webhook_secret), dann vergleichen Sie sie mit der signaturedie Sie erhalten haben. Weisen Sie die Anfrage ab, wenn |now − timestamp| älter als 300 Sekunden ist. Das vollständige Format und ein Testvektor stehen auf entrixy.com/webhook.

Wann Sie ihn wählen:

Sicherheit: beim Anlegen des Webhooks legen Sie ein webhook_secret. Gäste erhalten dieses Secret nie, selbst wenn sie Zugang zum Objekt haben. Der Server signiert die Anfragen damit in Ihrem Namen.

Zeitlimit: Antwortet der Zieldienst nicht innerhalb von 15 Sekunden, schließt der Server die Verbindung und meldet einen Fehlerstatus.

9. Smart-Home-Integrationen

Das Verzeichnis /integrations/ auf der Website enthält fertige Konfigurationen für die verbreiteten Plattformen. Jede hat ihre eigene README mit Anschlussschema.

PlattformWas zu tun ist
Home AssistantKopieren Sie configuration.yaml aus dem Verzeichnis. Legen Sie in Entrixy einen Webhook im Servermodus mit der URL an https://your-ha/api/webhook/entrixy.
ShellyLegen Sie in Entrixy einen Webhook im App-Modus mit der URL an http://shelly-ip/relay/0?turn=on. Ein einfacher GET-Aufruf: Das Telefon stellt die Anfrage innerhalb Ihres Heimnetzes.
TasmotaGenau wie bei Shelly. URL: http://tasmota-ip/cm?cmnd=Power%20Toggle.
ESPHomeAlternative Firmware für den ESP32, wenn Ihnen das ESPHome-Ökosystem lieber ist als unser BLE-Protokoll. Im Verzeichnis liegt eine YAML-Beispielkonfiguration.
OpenHABÄhnlich wie Home Assistant. Es nimmt HTTP-Anfragen über die Regel-API entgegen.
curlEin Testskript. Es nimmt unser JSON entgegen, prüft die HMAC-Signatur und gibt das Ergebnis aus. Nutzen Sie es zum Debuggen.
FlaskEin Python-Gerüst für Ihren eigenen Dienst. Es nimmt unser JSON entgegen und prüft die Signatur.

10. Die Web-App für Gäste

Möchte ein Gast die Android-App nicht installieren oder hat er ein iPhone, gibt es eine Webversion unter entrixy.com/app/.

Die Web-App unterstützt:

Die Web-App unterstützt nicht:

Damit alles ohne Einschränkungen funktioniert, installiert ein Gast besser die Android-App.

11. Sicherheit

Die Verbindung zum Controller

Die erste Kopplung nutzt ECDH X25519. Beide Seiten berechnen das gemeinsame Geheimnis gleichzeitig — das Geheimnis selbst geht nie über die Luft.

Jeder Öffnungsbefehl (FIRE) wird mit HMAC-SHA256 signiert, unter Verwendung des gemeinsamen Geheimnisses und einer einmaligen Nonce, die der Controller vorab ausgibt. Wer die Luft mithört, kann den Befehl nicht wiederholen — diese Nonce ist bereits verbraucht.

Gastzugang

Ein Gast erhält nicht das gemeinsame Geheimnis, sondern ein Token mit begrenzter Lebensdauer (standardmäßig 24 Stunden), signiert vom Besitzer. Der Controller prüft die Signatur des Besitzers und die Gültigkeit — selbst ein abhandengekommenes Gasttoken hört nach Ablauf auf zu funktionieren.

Das Token wird über den Server automatisch erneuert, solange die Kopplung des Besitzers besteht. Entzieht der Besitzer den Schlüssel, scheitert die nächste Erneuerung, und der Gast verliert den Zugang.

Die Verbindung zwischen App und Server

Alle Verbindungen laufen über TLS (HTTPS und WSS). Nutzerdaten — Rufnummern, Namen von Objekten und Gästen — liegen auf dem Server Ende-zu-Ende verschlüsselt, sodass selbst der Betreiber des Servers sie ohne Ihren Schlüssel nicht lesen kann.

Die Kryptografie ist ausführlich im Dokument beschrieben E2EE-Architektur.

Webhooks im Servermodus

Anfragen werden mit HMAC-SHA256 signiert. Das Secret, das Sie auf dem Server hinterlegen, wird niemals an Clients oder Gäste weitergegeben. Wer eine Anfrage abfängt, kann sie nicht wiederholen, denn der Zeitstempel verfällt nach 300 Sekunden — eine Regel, die der Zieldienst durchsetzt.

12. Häufige Fragen und Fehlersuche

Der BLE-Controller ist nicht sichtbar

  1. Prüfen Sie, ob der Controller Strom hat. Die LED sollte blinken.
  2. Prüfen Sie, ob Bluetooth am Telefon eingeschaltet ist.
  3. Ist der Energiesparmodus aktiv, schalten Sie ihn für Entrixy ab.
  4. Gehen Sie näher an den Controller heran, auf ein bis zwei Meter — am Rand der Reichweite kann das Signal abreißen.
  5. Ist am Controller Tiefschlaf eingestellt (deep_sleep_wake_s > 0), ist er nicht durchgehend auf Sendung — nur während seines Wachfensters. Warten Sie 10–30 Sekunden.

Es löst mehrmals hintereinander aus

Höchstwahrscheinlich stehen Sie genau am Rand der Auslösezone, und das Signal schwankt wegen Störungen. Was hilft:

Ein Gast meldet, die Karte sei grau und öffne nicht

Prüfen Sie den Status seines Schlüssels in Ihrem Bereich Gäste. Mögliche Gründe:

Die App hat sich von selbst beendet

Android beendet Hintergrunddienste aggressiv, um Akku zu sparen. Dagegen hilft:

Der Webhook kommt bei Home Assistant nicht an

  1. Prüfen Sie die URL in den Webhook-Einstellungen. Sie muss vollständig sein — mit dem Schema https:// und dem Port, falls er vom Standard abweicht.
  2. Prüfen Sie, ob Home Assistant von außen erreichbar ist (im Servermodus) oder aus Ihrem Heimnetz (im App-Modus).
  3. Beobachten Sie die Protokolle von Home Assistant beim Auslösen — dort sollte ein Eintrag für die eingehende Anfrage stehen.
  4. Prüfen Sie die Firewall Ihres Routers, falls sie eingehende Verbindungen blockiert.

Anrufbenachrichtigungen funktionieren auf Huawei nicht

Push-Nachrichten stützen sich auf Google FCM, das auf Huawei ohne Google-Dienste nicht verfügbar ist. Als Ausweg lassen Sie die App geöffnet statt minimiert, oder Sie nutzen BLE-Kopplung und Geozonen statt Benachrichtigungen.

So aktualisieren Sie die App

Öffnen Sie entrixy.com/download/android auf Ihrem Telefon und installieren Sie die neueste Version über die vorhandene. Ihre Daten bleiben erhalten.

Ist ein Update zwingend — etwa ein kritischer Sicherheitsfix — zeigt die App beim Start einen blockierenden Dialog.

So löschen Sie Ihr Konto und alle Daten

Öffnen Sie die App → Einstellungen → Konto löschen. Alles auf dem Server wird innerhalb von 30 Tagen gelöscht, der in der Datenschutzerklärung genannten Regelfrist.

Für eine sofortige Löschung senden Sie eine Anfrage an die in der Datenschutzerklärung genannte Support-Adresse.

Dokument aktualisiert am 30.05.2026. Wenn etwas unklar ist oder Ihr Szenario nicht abgedeckt wird, schreiben Sie an hello@entrixy.com.