ESPNOW Keyfob - Versionsgeschichte

Tut: /* Kommandos */

2024-12-30T23:39:40Z

‎Kommandos

2024-12-30T23:17:45Z

‎Kommandos

2024-12-20T22:10:51Z

‎Kommandos

2024-11-11T21:32:29Z

‎Kommandos

2024-11-11T19:33:24Z

‎Kommandos

2024-10-27T18:24:17Z

‎Details

2024-10-27T18:15:47Z

‎Hardware

2024-10-20T19:49:22Z

‎Antworten

2024-10-19T16:16:11Z

‎Protokoll

2024-10-19T16:15:56Z

‎Protokoll

@@ Zeile 85: / Zeile 85: @@
 * 'R': Rest. Beendet auch den debug modus.
 * 's': Get Status. Status der Tür wird zurück gegeben: Je ein ASCII-Zeichen als Ziffer, doorState [0=unknown,1=closed,2=open], lockState [0=unknown,1=locked,2=unlocked,3=open], trigState [0=nothing,1=moving,2=waiting]
 ==== Antworten ====

@@ Zeile 84: / Zeile 84: @@
 * 'C': Tür schließen.
 * 'R': Rest. Beendet auch den debug modus.
 ==== Antworten ====

@@ Zeile 81: / Zeile 81: @@
 * 't': Trigger. Triggert das Lock. Was hierbei passiert ist vom Schloss abhängig. Das ist das Kommando für KeyFobs mit nur einem Button. Einige Schlösser lassen sich damit nur öffnen, andere Öffnen und Schliessen.
 * 'U': Unlock debug und Webserver mode. Gerät wird sehr offen, nur kurz benutzen, danach Reset machen. Benötigt spezielle Rechte.
 ==== Antworten ====

@@ Zeile 80: / Zeile 80: @@
 * 'c': Get Challenge. Hierbei wird die Challenge nicht überprüft, auch damit die Übertragung schneller abläuft (Test der Challenge dauert etwa 100ms). Je nach Sicherheitskonzept gibt es nur bei hinterlegten Public Keys auch eine Challenge zurück.
 * 't': Trigger. Triggert das Lock. Was hierbei passiert ist vom Schloss abhängig. Das ist das Kommando für KeyFobs mit nur einem Button. Einige Schlösser lassen sich damit nur öffnen, andere Öffnen und Schliessen.
 ==== Antworten ====

@@ Zeile 78: / Zeile 78: @@
 ==== Kommandos ====
 Hier die Kommandos. Die meisten Kommandos werden hinterlegte Rechte und gültige Signaturen + Challenges benötigen.
-* 'c': Get Challenge. Hierbei wird die Challenge nicht überprüft (sollte aber mit Random gefüllt werden). Je nach Sicherheitskonzept gibt es nur bei hinterlegten Public Keys auch eine Challenge zurück.
+* 'c': Get Challenge. Hierbei wird die Challenge nicht überprüft, auch damit die Übertragung schneller abläuft (Test der Challenge dauert etwa 100ms). Je nach Sicherheitskonzept gibt es nur bei hinterlegten Public Keys auch eine Challenge zurück.
 * 't': Trigger. Triggert das Lock. Was hierbei passiert ist vom Schloss abhängig. Das ist das Kommando für KeyFobs mit nur einem Button. Einige Schlösser lassen sich damit nur öffnen, andere Öffnen und Schliessen.
 ==== Antworten ====

@@ Zeile 8: / Zeile 8: @@
 * Grundidee:
 ** Knopf wird gedrückt, ESP wird aktiviert
-** Keyfob fordert Challenge von der Tür an (Random value min 32bit) - ESPNow Broadcast
+** Private+Public Key und Name werden eingelesen, Test ob Public Key stimmt
 ** Wenn eine Tür in der Nähe ist, sendet sie eine Challenge zurück, die sie sich merkt
 ** Challenge wird von Keyfob empfangen
-** Keyfob baut Ed25519 signierte Nachricht und sendet sie per ESPNow Broadcast zur Tür zurück
+** Keyfob baut Ed25519 signierte Nachricht 't' für trigger und sendet sie per ESPNow Broadcast zur Tür zurück
-*** Nachrichtenlänge (muss mit ESPNow Paketlänge übereinstimmen)
-*** Public Key (32 Bytes)
-*** Name       (32 Bytes, 0 gefüllt)
-*** Signatur   (64 Bytes)
-*** Challenge  (32 Bytes)
-*** Aktion     (1-xx Bytes) 'Open'+0
 ** Tür empfängt Nachricht. Wenn Signatur, Challenge, Länge und alles andere stimmt, wird Aktion ausgefürt.
 *** Public Key inkl. Name muss 1:1 in der Tür vorhanden sein - daran sind die User-Rechte gespeichert.
 *** Wichtig: Aktuelle challenge muss nach der Ausführung auf ungültig gesetzt werden!
 *** War der Aufbau richtig, aber der Nutzer (=Public Key) nicht bekannt, wird dieser zwischengespeichert
-** Tür bestätigt ggf. Nachricht (nicht Pflicht)
+** Tür bestätigt Nachricht
 ** ESP geht in Power-Off Mode.

@@ Zeile 3: / Zeile 3: @@
 === Hardware ===
-Einfachste Version: ESP01S oder ESP12S wird per CR2032 Knopfzelle über Taster mit Strom versorgt.
+Einfachste Version: ESP01S oder ESP12S wird per CR2032 Knopfzelle über Taster mit Strom versorgt. Evtl. wird ein Pufferkondensator benötigt, weil recht hohe Stromspitzen auftreten können, die die Knopfzelle nicht schafft.
 === Details ===

@@ Zeile 87: / Zeile 87: @@
 ==== Antworten ====
-Signaturen sind normalerweise nicht nötig. Um ggf. einen bestimmten Anfrager zu unterscheiden wird dessen Public Key zurück gesendet. Bei Broadcasts ist dieser mit 0 gefüllt. Auch werden 4 Bytes für den Antworttyp definiert:
+Signaturen sind normalerweise nicht nötig. Um ggf. einen bestimmten Anfrager zu unterscheiden wird dessen Public Key zurück gesendet. Bei Broadcasts ist dieser mit 0 gefüllt. Hier wird auch immer eine neue Challenge übertragen, die eine Zeit lang gültig ist.
 {| class="wikitable"
 |+ Hackffm Lock Protocol - Antwort
 |-
 ! Offset !! Länge in Bytes !! Inhalt
 |-
 | 0 || 32 || Last public key of device that sent command (000.. for unspecific)
 |-
-| 32 || 4 || 'ANSW' for command answers, 'INFO' for generic infos, 'ERRR' for errors
+| 32 || 8 || Next challenge
 |-
-| 36 || x || Command specific answer
+| 40 || x || Command specific answer
 |}
-Kommando Antworten, eingeleitet mit 'ANSW':
+Kommando Antworten:
-* 'c' + 32 byte: Nächste zu verwendende Challenge (verfallen nach einigen Sekunden, evtl. können mehrere gültig sein)
+* 'c': Nächste zu verwendende Challenge (verfallen nach einigen Sekunden, evtl. können mehrere gültig sein)
-* 'tok' : Trigger ausgeführt.
+* 't': Trigger ausgeführt.
+* 'E': Error, more info in following bytes.
-Bei 'INFO' und 'ERRR' werden typischerweise Klartext Antworten gesendet.

@@ Zeile 77: / Zeile 77: @@
 | 128 || 8 || Challenge Respone
 |-
-| 136 || 70 * || Kommando (0-filled)
+| 136 || 70 *1 || Kommando (0-filled)
 |}
-* Länge kann auch anders sein, definiert durch drüberliegendes Protokol, dass die Länge überträgt.
+ *1 Länge kann auch anders sein, definiert durch drüberliegendes Protokol, dass die Länge überträgt.
 ==== Kommandos ====