tristan/homeassistant-ekey
tristan/homeassistant-ekey
Watch
1
0
Fork
You've already forked homeassistant-ekey
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
eine eKey-Integration für Home Assistant.
11 commits 1 branch 0 tags 14 MiB
  • Python 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Tristan Tzschichholz 5bb84b21ae Docs: eKey-Logo als Vektorquelle (SVG) aufnehmen 
Vektorquelle der gerenderten Brand-Bilder (brand/logo*.png, brand/icon*.png).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-17 07:11:01 +02:00
custom_components/ekey_net Brand: Icon aus SVG-Signet in Zielgröße (256 + @2x 512) 2026-07-16 19:45:42 +02:00
docs Docs: eKey-Logo als Vektorquelle (SVG) aufnehmen 2026-07-17 07:11:01 +02:00
tests M4: Komfort & Automations-UX (Trigger, Sensoren, Diagnostics) 2026-07-16 19:19:51 +02:00
tools Byte-Verifikation: Parser gegen echte eKey-net-Hardware bestätigt 2026-07-16 19:05:53 +02:00
.gitignore Brand: Icon aus SVG-Signet in Zielgröße (256 + @2x 512) 2026-07-16 19:45:42 +02:00
hacs.json M2: UDP-Listener + Config-/Options-Flow 2026-07-15 20:52:58 +02:00
PLAN.md M4: Komfort & Automations-UX (Trigger, Sensoren, Diagnostics) 2026-07-16 19:19:51 +02:00
README.md Recherche & Planung der eKey-net Home-Assistant-Integration 2026-07-15 20:11:35 +02:00

README.md

homeassistant-ekey

Custom-Integration, um alle Ereignisse eines eKey-net-Systems in Home Assistant nutzbar zu machen — als event-Entitäten pro Fingerscanner, mit automatischer Klartext-Übersetzung und optionalem Mapping auf Home-Assistant-Personen.

Status: Recherche- & Planungsphase abgeschlossen. Implementierung folgt (siehe PLAN.md). Zielsystem: eKey net (Ethernet, Windows-Server-System) — getestet wird ausschließlich gegen ein reales eKey-net.

Kurzüberblick

  • Empfohlener Entitätstyp: event-Entität (zustandslose Zutritts-Ereignisse), ergänzt um Device Triggers. Begründung in docs/home-assistant-entity-choice.md.
  • Datenkanal: eKey-net UDP-Versand. Empfohlen: Terminal-Server-rare-Format (liefert aufgelöste Benutzernamen), Alternative: CV-LAN-Klartext net/net v2.
  • Leitprinzipien: einfachste UI-Einrichtung („Port eintragen → fertig", Auto-Geräteanlage), automatische Übersetzung numerischer IDs in Fingerbezeichnungen (+ Aktion/Relais), optionales eKey-User → HA-person-Mapping.

Dokumente

Datei Inhalt
PLAN.md Implementierungsplan (Architektur, Dateistruktur, Meilensteine, Teststrategie)
docs/home-assistant-entity-choice.md Schritt 1: Analyse & Wahl des HA-Entitätstyps
docs/ekey-net-protocol.md Schritt 3: konsolidierte, öffentliche eKey-Protokoll-/Schnittstellen-Referenz
docs/ekey-sources/ Primärquellen (eKey-PDFs + Textextrakte)

Abgrenzung zu anderen eKey-Integrationen

  • ekeybionyx (offiziell in HA Core) ist für das Cloud-Produkt ekey bionyx — nicht für eKey net verwendbar.
  • klein0r/ha-ekeylegacy und ochorocho/ekey_home_rs485 sind für ekey home/multi (kleine Standalone-Systeme), nicht für das net-System.
  • Diese Integration schließt die Lücke für eKey net.

Nächster Schritt

Freigabe des Plans → Start mit Component-Gerüst und testgetriebenem Parser (ohne Hardware absicherbar). Für die Byte-genaue Verifikation der UDP-Formate wird ein Wireshark-Mitschnitt eines echten Ereignisses vom Zielsystem benötigt.