Dies ist eine alte Version des Dokuments!


Türschloss (WIP)

Diese Seite dokumentiert das elektronische Türschloss der AfRA.

Funktionen

  • Auf/Zuschließen der AfRA via SSH (done)
  • Zuschließen der AfRA via Button + Timer (done)
  • Auf/Zuschließen via Buttons am Schloss (done)
  • Aufschließen der AfRA via RFID Token (done)

Einen Key bekommen

Wenn du Member bist und bereits einen Türschlüssel hast, oder einen Türschlüssel möchtest, wende dich bitte an Lexi. Lexi deployed deinen SSH-key auf dem Schloss. Alternativ kannst du zusätzlich einen RFID Token oder eine RFID Karte bekommen.

Benutzen

Wichtig: Das Schloss prüft nur alle 2-5 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

Verbinde dich mit dem AfRA WLAN und ssh auf open@172.23.42.114 auf. Achte darauf, den hinterlegten ssh-key zu nutzen (ssh -i PFAD_ZUM_KEY open@172.23.42.114). Das Schloss öffnet sich innerhalb vom 10 Sekunden.

Alternativ kannst du dein RFID Token verwenden. Der Reader ist hinter der Glastür eingebaut (schwarze Fläche mit rot-leuchtender LED). Halte einfach deinen Token oder deine Karte gegen den Leser. Du hörst einen Piep und der Leser leuchtet Grün. Das Schloss sollte jetzt öffnen.

Wenn du bereits im space bist, kannst du auch einfach den "Öffnen" Knopf auf dem Türschloss drücken. Dieser regiert sofort. Notfalls kannst du das Schloss per Hand am Rad öffnen - Bitte nutze diese Option nur wenn die Batterien leer sind, da sonst das System seinen State verliert und sich neu kalibrieren muss).

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: * Your name here

Tür zuschließen

  • Option 1: Drücke den Button an der Seite des transparenten Kontrollkastens. Eine rote LED blinkt im Kasten. Ziehe die Tür hinter dir zu. Nach ca 10 Sekunden schließt das Schloss selbstständig ab. Prüfe ob die Tür wirklich zu ist!
  • Option 2: ssh auf close@172.23.42.114 mit deinem hinterlegten Key.
  • Option 3: Wenn du im space bist, kannst du auch einfach den "Schließen" Knopf auf dem Türschloss drücken. Dieser regiert sofort. Notfalls kannst du das Schloss per Hand am Rad schließen - Bitte nutze diese Option nur wenn die Batterien leer sind, da sonst das System seinen State verliert und sich neu kalibrieren muss).

Hardware

Das Schloss ist ein equiva BLUETOOTH® Smart Türschlossantrieb. 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.

Der RFID Reader ist ein Neuftech EM4100 Reader für 125KHz Token. Quasi jeder Token der den EM4100 Standard verwendet lässt sich benutzen. Die meisten RFID Karten (BVG, Mensa) sind inzwischen 13,56MHz, was aber nicht durch unsere Glastür funktionieren würde.

Software

Angesteuert wird das Schloss von Python-Skripten (/opt/afra_door/*.py) auf dem RPI. Diese sind für den open/close user als login-shell hinterlegt. Außerdem gibt es noch den Close-Button-Watcher als systemd daemon. Der open/close user haben kein Passwort, Authentifizierung nur via ssh key.

Zur Kommunikation mit dem Schloss wird keyble benutzt.

Um Keys deployen zu können und das System zu ändern gibt es den "pi" user.

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 werden an den Vorstand übergeben).

Die aktuelle Software findet sich unter https://github.com/c1ko/afra_door

Vor dem Launch noch zu tun

  • Statische IP/Hostname/DNS für das Schloss
  • Sicherheitsschloss einbauen
  • Aufhängen der Box mit dem RPI in Türnähe
Drucken/exportieren