Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
tuerschloss [2019-01-05 23:30] – [Vor dem Launch noch zu tun] ciko | tuerschloss [2022-02-22 17:34] (aktuell) – [Schlüssel bekommen] zotan | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | ====== Türschloss | + | ====== |
- | Diese Seite dokumentiert das elektronische Türschloss | + | Die Eingangstür |
- | ===== Funktionen ===== | + | Diese Seite beschreibt die Bedienung des Schlosses. Für Details zu Implementierung, |
- | * Auf/ | + | |
- | * Zuschließen der AfRA via Button + Timer (done) | + | |
- | * Auf/ | + | |
- | * Aufschließen der AfRA via RFID Token (tbd) | + | |
- | ===== Benutzen ===== | + | {{:img_20190117_210636.jpg?200|}} |
- | Wichtig: Das Schloss prüft nur alle 5-10 Sekunden nach neuen Befehlen - dafür halten die Batterien aber auch 1 Jahr (BLE). Es kann also einen Moment dauern, bis sich die Tür öffnet. | + | |
- | ==== Tür aufschließen ==== | ||
- | Dein SSH-Key muss auf dem Türschloss hinterlegt sein! //(Hier fehlt der Prozess, wer wann Keys bewilligt und wer diese auf dem Türschloss deployt)// | ||
- | Verbinde dich mit dem AfRA WLAN und ssh auf open@SCHLOSS_IP (derzeit 172.23.42.114) auf. Achte darauf, den hinterlegten ssh-key zu nutzen (ssh -i PFAD_ZUM_KEY open@SCHLOSS_IP). Das Schloss öffnet sich innerhalb vom 10 Sekunden. | + | ===== Schlüssel bekommen ===== |
- | Wenn du bereits im space bist, kannst du auch einfach den " | + | Um einen Schlüssel für die AfRA zu erhalten, wende dich bitte an das monatliche [[plenum|Plenum]]. Für mehr details, siehe [[Infos für Mitglieder# |
- | Sollte sich die Tür nicht öffnen lassen, kann ein physischer Key trotzdem die Tür öffnen. Hier ist eine Liste mit Kontaktdaten zu physischen Keyholdern: | + | Es gibt hierbei zwei Arten von elektronischen Schlüsseln für das Schloss: SSH-Keys und RFID-Tokens. |
- | * Your name here | + | |
- | ==== Tür zuschließen ==== | + | |
- | | + | * Ein **RFID-Token** (oder eine Karte) |
- | | + | |
- | * Option 3: Wenn du im space bist, kannst du auch einfach den " | + | |
- | ===== Hardware ===== | + | Gerne kannst du auch beide Varianten nutzen (für mehr Redundanz!). |
- | Das Schloss ist ein [[https:// | + | |
- | Angesteuert wird alles von einem RPI Zero W über Bluetooth Low Energy. Die Hardware ist in einer transparenten Box verbaut. Die Box bekommt einmal 12V und bucht sich via WLAN ins AfRA Netz ein. | + | |
- | {{: | + | Für Notfälle bzw. Ausfälle des elektronischen Schlosses existieren auch physische Schlüssel. Diese werden jedoch nur an eine //kleine// Anzahl von Mitgliedern vergeben, die z.B. in der Nähe der AfRA wohnen und in Notfällen aufschließen können. |
- | {{:: | + | |
- | ===== Software ===== | ||
- | Angesteuert wird das Schloss von Python-Skripten (/ | ||
- | Zur Kommunikation mit dem Schloss wird [[https:// | + | ===== Bedienung ===== |
- | Um Keys deployen zu können und das System zu ändern gibt es den " | + | Wichtig: Das Schloss prüft nur alle 2-5 Sekunden nach neuen Befehlen - dafür halten |
- | Die Verbindung RPI <-> Schloss ist mit einem PSK gesichert, welcher als QR Code vorliegt. Aus dem PSK leitet sich ein user-key ab. Der einzige user-key ist aktuell auf dem RPI hinterlegt. Die PSKs liegen derzeit bei ciko. //(Und er sollte diese bei Implementierung an $Vorstand übergeben)// | ||
- | ===== Vor dem Launch noch zu tun ===== | + | ==== Aufschließen (beim Betreten der AfRA) ==== |
- | * Statische IP/ | + | |
- | * Ein Sicherheitsschloss (Schlüssel | + | Um via **SSH** aufzuschließen, |
- | * Bequemeres Key Management | + | Verbinde dich dann mit '' |
- | * Ein Prozess, um die physischen Keys umzutauschen | + | Das Schloss öffnet sich innerhalb von 10 Sekunden. |
- | * Ein Prozess, um einen Key zugesprochen | + | |
- | * Aufhängen der Box mit dem RPI in Türnähe | + | Um via **RFID** aufzuschließen, |
+ | Dieser ist hinter der Glastür eingebaut (schwarze Fläche mit rot-leuchtender LED). \\ | ||
+ | Du hörst einen Piep-Ton und der Leser leuchtet Grün. Das Schloss sollte jetzt öffnen. | ||
+ | |||
+ | Sollte sich die Tür nicht öffnen lassen, kann ein physischer Key trotzdem die Tür öffnen. Hier ist eine Liste mit Kontaktdaten zu physischen Keyholdern: [Link] FIXME | ||
+ | |||
+ | |||
+ | ==== Zuschließen (beim Verlassen der AfRA) ==== | ||
+ | |||
+ | Wenn du als Letztes die AfRA verlässt, stell bitte sicher, dass du die Tür zuschließt. Beachte bitte außerdem die Hinweise im [[shutdown|Shutdown-Protokoll]]. | ||
+ | |||
+ | Um die Tür zu verschließen, | ||
+ | Ziehe die Tür hinter dir zu. Nach ca. **10 Sekunden** schließt | ||
+ | |||
+ | Alternativ kannst du die Tür auch mit deinem | ||
+ | |||
+ | Wenn sich die Tür mal nicht abschließen lässt, du aber gehen möchtest, reboote einmal den Raspberry Pi im Kontrollkasten (Stecker raus, Stecker rein). | ||
+ | Wenn das immer noch nicht funktioniert, | ||
+ | **Bitte informiere die Mitglieder über die Mailingliste**, dass du die Tür manuell zugeschlossen hast, und bring den Schlüssel so bald wie möglich zurück! | ||
+ | |||
+ | |||
+ | ==== Bedienung des Schlosses innerhalb der AfRA ==== | ||
+ | |||
+ | Wenn du im Space bist und das Schloss auf- oder zuschließen möchtest, benutze die **zwei Buttons**, die sich am Türschloss selbst (weißer Kasten direkt an der Tür) befinden. | ||
+ | Diese reagieren ohne Verzögerung. Der obere Button schließt auf, der untere Button | ||
+ | |||
+ | Wenn einmal gar nichts mehr geht, z.B. weil die Batterien leer sind, lässt sich das Schloss auch per Hand am Rad öffnen | ||
+ | |||
+ | |||
+ | ===== Status-Abfrage via HTTP ===== | ||
+ | |||
+ | Innerhalb des WLANs (discord) ist es möglich, über HTTP den aktuellen Status des Türschlosses abzufragen. | ||
+ | |||
+ | Hierfür reicht ein simpler GET-Request auf http:// | ||
+ | |||
+ | Der HTTP-Server antwortet dann mit '' | ||
+ | |||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * < | ||
+ | |||
+ | // | ||
+ | Dies ist jedoch aus mehreren Gründen explizit **nicht** gewünscht. Türschloss und Space-Status sind unabhängig voneinander. Sinn dieser Status-Abfrage ist beispielsweise eine space-interne Steuerung von Geräten, die nur dann angeschaltet sein sollen, wenn jemand da ist, z.B. Heizungsthermostat, | ||
+ | |||
+ | |||
+ | ===== Implementierung ===== | ||
+ | |||
+ | Wer sich dafür interessiert, | ||
+ | |||
+ | Das Schloss wurde am 15.02.2019 |