Sphinx: Unterschied zwischen den Versionen

Aus Hacksaar Wiki
Zur Navigation springen Zur Suche springen
(TODOs aus Ralfs Mail)
 
(31 dazwischenliegende Versionen von 7 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Die '''Sphinx''' ist unser automatisches Zugangssystem für Mitglieder. Jedes Vereinsmitglied bekommt einen eigenen Account, kann sich per ssh auf der Sphinx anmelden und sich so Zugang zum Space verschaffen.
+
== Retired ==
 +
 
 +
[[Datei:Spinx logo.svg|64px|right]]
 +
 
 +
Die '''Sphinx''' war unser automatisches Zugangssystem für Mitglieder. Jedes Vereinsmitglied bekommt einen eigenen Account, kann sich per ssh auf der Sphinx anmelden und sich so Zugang zum Space verschaffen.
  
 
== Funktion ==
 
== Funktion ==
Die Sphinx hat in unserem WLAN die IP 222. Wer einen Account hat, kann per SSH darauf zugreifen und wird von der TyShell (Tür Shell, in Python geschrieben) begrüßt. Die wichtigsten Kommandos sind
+
Die Sphinx hat in unserem Mitgliedernetz die IP 222 und den Hostnamen "sphinx". Sie hängt nur im Mitgliedernetz, welches nicht aus dem Freifunk-WLAN erreichbar ist! Wer einen Account hat, kann per SSH darauf zugreifen und wird von der TyShell (Tür Shell, in Python geschrieben) begrüßt. Die wichtigsten Kommandos sind
  
 
*buzz: Summer an der Haustür betätigen
 
*buzz: Summer an der Haustür betätigen
Zeile 9: Zeile 13:
  
 
Ein normaler Bedienungsablauf wäre, vor der Haustür den Laptop/das Smartphone auszupacken, sich ins WLAN zu verbinden und per SSH ''buzz'' zu befehlen. Oben angekommen, befiehlt man dann ''open'' und kann somit den Space betreten. Für die vereinfachte Bedienung auf Touchgeräten gibt es auch eine Androidapp, die das Tippen erspart (siehe unten).
 
Ein normaler Bedienungsablauf wäre, vor der Haustür den Laptop/das Smartphone auszupacken, sich ins WLAN zu verbinden und per SSH ''buzz'' zu befehlen. Oben angekommen, befiehlt man dann ''open'' und kann somit den Space betreten. Für die vereinfachte Bedienung auf Touchgeräten gibt es auch eine Androidapp, die das Tippen erspart (siehe unten).
 +
 +
'''Hinweis:''' Die unten erwähnten Leuchten sind momentan leider nicht verdrahtet, und daher immer aus.
  
 
=== Modi ===
 
=== Modi ===
Zeile 15: Zeile 21:
  
 
==== Space offen ====
 
==== Space offen ====
Die grüne Leuchte ist an. Die Tür ist nicht abgesperrt, sodass man sie von außen einfach aufdrücken kann. Wenn jemand klingelt, reagiert die Sphinx automatisch damit, den Haustürsummer zu betätigen. Die [http://spaceapi.hacksaar.de/ SpaceAPI] zeigt online an, dass der Space offen ist.
+
Die grüne Leuchte ist an und der Schalter auf ''ON''. Die Tür ist nicht abgesperrt, sodass man sie von außen einfach aufdrücken kann. Wenn jemand klingelt, reagiert die Sphinx automatisch damit, den Haustürsummer zu betätigen. Die [http://spaceapi.hacksaar.de/ SpaceAPI] zeigt online an, dass der Space offen ist.
  
 
==== Space zu ====
 
==== Space zu ====
Die grüne Leuchte ist aus. Die Wohnungstür ist abgesperrt. Die Sphinx reagiert nicht automatisch auf Klingeln.
+
Die grüne Leuchte ist aus und der Schalter auf ''OFF''. Die Wohnungstür ist abgesperrt. Die Sphinx reagiert nicht automatisch auf Klingeln.
  
 
==== Space verlassen ====
 
==== Space verlassen ====
Zum Verlassen des Space kippt man den Kippschalter an der Sphinx auf ''Space zu'', geht durch die Tür und zieht diese hinter sich zu. Sobald die Tür zu ist, sollte die Sphinx versuchen, die Tür abzusperren. Aufgrund der Schwäche des Türschließers ist es nötig, beim Absperren die Tür zuzuhalten.
+
Zum Verlassen des Space kippt man den Kippschalter an der Sphinx auf ''OFF'' (nach ''unten''), geht durch die Tür und zieht diese hinter sich zu. Sobald die Tür zu ist, sollte die Sphinx versuchen, die Tür abzusperren. Aufgrund der Schwäche des Türschließers ist es nötig, beim Absperren die Tür zuzuhalten.
  
 
==== Inkonsistenzen ====
 
==== Inkonsistenzen ====
Wenn die Wohnungstür nicht abgesperrt ist, obwohl der Schalter auf "Space zu" steht oder umgekehrt die Wohnungstür abgesperrt ist aber der Schalter auf "Space zu" steht, wird der Türstatus als ''inkonsistent'' bezeichnet. In diesem Fall leuchtet die rote Lampe an der Sphinx. Im Fall, dass die Tür offen ist, wird das als Sicherheitslücke betrachtet und nach einer gewissen Zeit wird '''Alarm ausgelöst'''! Wer einen Fehlalarm auslöst, wird als Noob beschimpft.
+
Wenn die Wohnungstür nicht abgesperrt ist, obwohl der Schalter auf ''OFF'' steht oder umgekehrt die Wohnungstür abgesperrt ist aber der Schalter auf ''ON'' steht, wird der Türstatus als ''inkonsistent'' bezeichnet. In diesem Fall leuchtet die rote Lampe an der Sphinx. Im Fall, dass die Tür offen ist, wird das als Sicherheitslücke betrachtet und nach einer gewissen Zeit wird versucht, die Tür zu schließen, und '''Alarm ausgelöst'''! Wer einen Fehlalarm auslöst, wird als Noob beschimpft.
  
 
=== Sensorausfälle/Fallbackmodus ===
 
=== Sensorausfälle/Fallbackmodus ===
Für den Fall, dass einer oder mehrere Sensoren der Sphinx ausfallen, besitzt die Software einen Fallbackmodus. In diesem werden die meisten Sensorinputs ignoriert. Ein Funktionieren des Kippschalters ist nötig, um den Space verlassen zu können (Flanke von ''auf'' auf ''zu'' beginnt den Vorgang). Ansonsten reagiert die Sphinx nicht auf Sensoreingaben. Man kann sie in diesem Modus nur per SSH über die TyShell steuern.
+
Für den Fall, dass einer oder mehrere Sensoren der Sphinx ausfallen, besitzt die Software einen Fallbackmodus. In diesem werden die meisten Sensorinputs ignoriert. Ein Funktionieren des Kippschalters wird jedoch vorrausgesetzt. Um den Space zu verlassen, muss dieser Kippschalter von ein auf aus geschaltet werden. Ist der Schalter auf "an" und die Klingel wird gedrückt, wird der Haustürsummer ausgelöst. Ansonsten reagiert die Sphinx nicht auf Sensoreingaben. Man kann sie in diesem Modus nur per SSH über die TyShell steuern. Dass der Modus aktiv ist, erkennt man daran, dass die Rote LED alle 2 Sekunden aufblinkt.
  
Nur die Sphinxadmins können den Fallbackmodus aktivieren. Sollte dies nötig sein, müssen diese also benachrichtigt werden.
+
Der Fallbackmodus kann in der Tyshell aktiviert werden.
  
  
== Aufbau des Türsystems ==
+
== Hardware ==
Das Herzstück der Sphinx bildet das elektronische Schließsystem Abus HomeTec CFA 1000. Dieses bietet Pins, die wir zum Öffnen und Schließen ansteuern können. Jochen hat dazu eine Schaltung entworfen, die Taster zum Schalten und eine stabile Spannungsversorgung für das Türsystem zur Verfügung stellt. Die Platine kann auch mit den GPIOs von einem Raspberry Pi angesprochen werden, um softwareseitig auf- und zuzuschließen.
 
  
[[Datei:Sphinx_taster.jpg|200px]]
+
Das Herzstück der Sphinx ist ein Rasperry Pi, der neben der Tür hängt. Der ist verbunden mit dem elektronischen Schließsystem Abus HomeTec CFA 1000. Dieses bietet Pins, die wir zum Öffnen und Schließen ansteuern können. Jochen, Marc und Carsten haben dazu eine Schaltung entworfen die ensprechende Ein- und Ausgänge hat. Dieser werden über I²C Busexpander (PCF8574) mit dem Pi verbunden.
[[Datei:Sphinx_spannung.jpg|200px]]
+
Die Spannungsversorgung von Pi und SphinxBoard läuft über ein externes 5V Netzteil (Backpowering).  
[[Datei:Sphinx_hometec.jpg|200px]]
+
Der Schlossaktor (Abus) wird über die gleiche Spannungsschiene versorgt. Das erlaubt es dessen Eingänge direkt an die Busexpander anzuschließen.
  
Für den Auto-Mode muss die Klingel abgefragt werden. Wenn die Klingel gedrückt wird, kommt oben eine schöne sinusförmige Spannung mit etwa 12V effektiv an. Diese wird mit einem Brückengleichrichter mit nachgeschalteter Last und Glättungskondensator zu einer Gleichspannung gemacht, die wir mit einem Linearspannungsregler LF33 auf einen Pegel von 3,3V für den Pi gebracht wird. Der Pi kann jetzt also an einer steigenden Flanke am GPIO ein Klingeln erkennen.
+
Für den Auto-Mode muss die Klingel abgefragt werden. Wenn die Klingel gedrückt wird, kommt oben eine sinusförmige Spannung mit etwa 12V effektiv an. Diese wird gleichgerichtet und über einen Optokoppler getrennt. Die Schaltung am Pi kann jetzt also an einer steigende ein Klingeln erkennen, und das per I²C dem Pi mitteilen.
An einem anderen GPIO-Pin des Pi kann der Summer an der Haustür geschaltet werden. Die 3,3V des GPIO schalten über einen Transistor eine Steuerspannung von 5V auf ein Relais, das den Kontakt für den Summer schließt.
+
An einem anderen I²C-Register des Pi kann der Summer an der Haustür geschaltet werden. Die 3,3V des GPIO schalten über einen Transistor eine Steuerspannung von 5V auf ein Relais, das den Kontakt für den Summer schließt.
 +
Um die Tür automatisch zu öffnen ist ein Relais vorgesehen.
  
 +
Alte Version: https://wiki.hacksaar.de/index.php?title=Sphinx&oldid=1618
  
[[Datei:Sphinx_sinus.jpg|200px|Relaiskarte für den Summer]]
+
== Software ==
[[Datei:Sphinx_relais.jpg|200px|Relaiskarte für den Summer]]
 
[[Datei:Sphinx_schema_v-0-1.png|400px]]
 
 
 
Den ersten, rudimentären Schaltplan haben wir schnell zusammengestellt. Die nächsten Schritte werden das Umsetzen des Ganzen in ein Platinenlayout und der Einbau in das Wandgehäuse. Der Schaltplan kann als [[Datei:Sphinx_schema_v-0-1.pdf|PDF]] bezogen werden. Zum Erstellen der Schaltpläne und des Layouts wird KiCAD verwendet. Die jeweils letzte Schaltplanversion ist [http://jochenbauer.net/publicfiles/sphinx_schema_latest.tar.gz hier] verfügbar.
 
  
 +
Auf dem Türserver (statische IP 192.168.42.222, immer an) hat jeder mit Türzugang einen Linux Useraccount (PAM) mit einem Homeverzeichnis und einer .ssh/authorized_keys. Die Nutzer der Gruppe tuer erhalten beim Login eine in Python geschriebene custom Shell (tyshell), die zum Öffnen und Schließen der Wohnungstür sowie zum Betätigen des Summers verwendet werden kann. Dies wird in der Konfiguration vom SSHD vorgeschrieben.
  
 +
Die tyshell sendet die Kommandos dann per UNIX socket (<tt>/run/tuer.sock</tt>) das Kommando an den Türdaemon (tuerd). Der tuerd führt dann sequentiell alle erhaltenen Kommandos aus, kapselt also letztlich komplett die ausgehende Kommunikation über den I²C. Er besorgt außerdem das Logging, und kann dabei Kernel-Funktionen nutzen, um den die Aktion auslösenden User herauszufinden.
  
== Software ==
+
Damit I²C funktioniert, muss in der <tt>/boot/config.txt</tt> folgendes gesetzt werden: <tt>dtparam=i2c_arm=on</tt>.
  
Auf dem Türserver (statische IP 192.168.178.222, immer an) hat jeder mit Türzugang einen Linux Useraccount (PAM) mit einem Homeverzeichnis und einer .ssh/authorized_keys. Die Nutzer der Gruppe tuer erhalten beim Login eine in Python geschriebene custom Shell (tyshell), die zum Öffnen und Schließen der Wohnungstür sowie zum Betätigen des Summers verwendet werden kann. Dies wird in der Konfiguration vom SSHD vorgeschrieben.
+
Die Software liegt unter <tt>/opt/tuer</tt>. Die jeweils aktuelle Entwicklung findet unter <tt>/home/pi/tuer</tt>, das ist im Wesentlichen ein Klon des [https://git.hacksaar.de/hacksaar/sphinx git-Repos]. Die systemweite Installation erfolgt mittels "sudo make". Die Software benötigt das Python-Modul [https://pypi.python.org/pypi/smbus-cffi/ smbus-cffi], welches im root-lokalen Ordner (<tt>/root/.local/lib/python3.*/site-packages</tt>) installiert ist. Das muss jedoch niemand von Hand machen, <tt>sudo pip3 install --user smbus_cffi</tt> richtet alles automatisch ein.
  
Die tyshell sendet die Kommandos dann per UNIX socket ( /run/tuer.sock ) das Kommando an den Türdaemon (tuerd). Der tuerd führt dann sequentiell alle erhaltenen Kommandos aus, kapselt also letztlich komplett die ausgehende Kommunikation über die GPIO Pins. Er besorgt außerdem das Logging, und kann dabei Kernel-Funktionen nutzen, um den die Aktion auslösenden User herauszufinden.
+
Der Daemon loggt seine Tätigkeiten nach <tt>/var/log/door.log</tt>. Die Logdateien werden außerdem regelmäßig auf den Hacksaar-Server (/home/sphinxlog/data) gesynced.
  
Des Weiteren wird irgendwann ein zweiter Daemon laufen, der die Klingel überwacht (ringd). Wenn dieser das geheime Klingelmuster erkennt, sendet er "buzz" an den tuerd, der daraufhin den Summer betätigt. EVentuell wird dieser Daemon auch teil des tuerd werden.
+
Zum E-Mail-Versand schickt der Daemon die Mails direkt an den [[Brückenkopf]], der sie dann über hacksaar.de an den gewünschten Empfänger weiterreicht.
  
Geplant ist außerdem ein Daemon, der eine Webcam durch den Türspion überwacht. Sobald er einen QR-Code eines Mitglieds (im Homeordner des Users unter ".qrpw.txt") scant, sendet er "open" an den tuerd, um die Wohnungstür zu öffnen. Mit dem Klingelmuster + QR Code kann man dann also komplett ohne elektronische Geräte den Space betreten.
+
Eine offene Idee ist ein Daemon, der eine Webcam durch den Türspion überwacht. Sobald er einen QR-Code eines Mitglieds (im Homeordner des Users unter ".qrpw.txt") scant, sendet er "open" an den tuerd, um die Wohnungstür zu öffnen. Mit dem Klingelmuster + QR Code kann man dann also komplett ohne elektronische Geräte den Space betreten.
  
 
== Zugang erhalten ==
 
== Zugang erhalten ==
  
Die Türadmins sind [[Benutzer:Ralf | Ralf]], [[Benutzer:Constantin | Constantin]] und [[Benutzer:Bausparfuchs | Chriss]]. Wer Zugang möchte, soll einer dieser Personen den gewünschten Nutzernamen und einen SSH-Publickey zukommen lassen (Mittwochs manuell per USB Stick oder per signierter EMail). Der Pi ist (absichtlich) von außerhalb des Spaces nicht erreichbar. Daher können die Admins den SSH-Key nur vor Ort hinzufügen.
+
Die Türadmins sind [[Benutzer:Ralf | Ralf]], [[Benutzer:Constantin | Constantin]] und [[Benutzer:Chriss | Chriss]]. Wer Zugang möchte, muss sich ein [https://help.github.com/articles/generating-ssh-keys/ SSH-Schlüsselpaar generieren] und dessen öffentlichen Teil einer dieser Personen zusammen mit dem gewünschten Nutzernamen zukommen lassen (Mittwochs manuell per USB Stick oder per signierter EMail). Der Pi ist (absichtlich) von außerhalb des Spaces nicht erreichbar. Daher können die Admins den SSH-Key nur vor Ort hinzufügen.
  
 
== Was fehlt noch ==
 
== Was fehlt noch ==
 
*Türschließer hält die Tür nicht dicht genug zum Zusperren
 
*Türschließer hält die Tür nicht dicht genug zum Zusperren
*Notfallmöglichkeit für Nicht-Admins, den Fallbackmodus zu aktivieren
 
*Lautsprecher, damit die Sphinx die Leute anmotzen kann, bevor sie Alarm auslöst
 
*LAN-Anschluss (WLAN ist manchmal unzuverlässig)
 
*alles auf eine Platine ätzen
 
  
 
== Ansprechpartner ==
 
== Ansprechpartner ==
  
 
=== Software ===
 
=== Software ===
*Ralf
+
*[[Benutzer:Ralf | Ralf]]
*Constantin
+
*[[Benutzer:Constantin | Constantin]]
*Marvin (Android-App)
+
*[[Benutzer:Marvin| Marvin]] (Android-App)
 +
*[[Benutzer:Kimcm| Kim]] (Windows Phone App)
 +
*[[Benutzer:Matsta| Mathias]] (Android-App (YASC))
  
 
=== Hardware ===
 
=== Hardware ===
*Jochen
+
*[[Benutzer:Jochen | Jochen]]
 +
*[[Benutzer:Cpresser | Carsten]]
 
*Micha
 
*Micha
  
 
== Weitere Links ==
 
== Weitere Links ==
[http://wiki.hacksaar.de/images/2/25/Sphinx_schema_v-0-1.pdf Schaltplan als PDF]
+
* [https://git.hacksaar.de/hacksaar/sphinx Projekt-Seite] in unserem [[GitLab]]
 +
 
 +
* [https://git.hacksaar.de/hacksaar/rinx Reimplementierung in Rust] (noch in der Planungsphase)
 +
 
 +
* [https://play.google.com/store/apps/details?id=de.matsta.sshclient YASC (Yet Another Sphinx Client) Android-App Google Play]
 +
 
 +
* [https://git.hacksaar.de/matsta/yasc/uploads/fdf5632d5d87997a6202fa360683d97e/yasc-release_v3.apk YASC (Yet Another Sphinx Client) Android-App APK-Download]
 +
 
 +
* [http://larma.de/AndTuer.apk Alte Android-App]
  
[http://www.ralfj.de/git/saartuer.git Sourcecode]
+
* [https://github.com/KimCM/SpaceControl Sourcecode für Windows Phone 8 App]
  
[http://larma.de/AndTuer.apk Android-App]
+
[[Kategorie:Projekt]]

Aktuelle Version vom 25. März 2024, 12:07 Uhr

Retired

Spinx logo.svg

Die Sphinx war unser automatisches Zugangssystem für Mitglieder. Jedes Vereinsmitglied bekommt einen eigenen Account, kann sich per ssh auf der Sphinx anmelden und sich so Zugang zum Space verschaffen.

Funktion

Die Sphinx hat in unserem Mitgliedernetz die IP 222 und den Hostnamen "sphinx". Sie hängt nur im Mitgliedernetz, welches nicht aus dem Freifunk-WLAN erreichbar ist! Wer einen Account hat, kann per SSH darauf zugreifen und wird von der TyShell (Tür Shell, in Python geschrieben) begrüßt. Die wichtigsten Kommandos sind

  • buzz: Summer an der Haustür betätigen
  • open: Tür oben aufschließen
  • help: Verfügbare Befehle anzeigen

Ein normaler Bedienungsablauf wäre, vor der Haustür den Laptop/das Smartphone auszupacken, sich ins WLAN zu verbinden und per SSH buzz zu befehlen. Oben angekommen, befiehlt man dann open und kann somit den Space betreten. Für die vereinfachte Bedienung auf Touchgeräten gibt es auch eine Androidapp, die das Tippen erspart (siehe unten).

Hinweis: Die unten erwähnten Leuchten sind momentan leider nicht verdrahtet, und daher immer aus.

Modi

Die Sphinx beherrscht zwei Modi, zwischen denen mit dem Kippschalter an der Sphinx selbst gewechselt werden kann.

Space offen

Die grüne Leuchte ist an und der Schalter auf ON. Die Tür ist nicht abgesperrt, sodass man sie von außen einfach aufdrücken kann. Wenn jemand klingelt, reagiert die Sphinx automatisch damit, den Haustürsummer zu betätigen. Die SpaceAPI zeigt online an, dass der Space offen ist.

Space zu

Die grüne Leuchte ist aus und der Schalter auf OFF. Die Wohnungstür ist abgesperrt. Die Sphinx reagiert nicht automatisch auf Klingeln.

Space verlassen

Zum Verlassen des Space kippt man den Kippschalter an der Sphinx auf OFF (nach unten), geht durch die Tür und zieht diese hinter sich zu. Sobald die Tür zu ist, sollte die Sphinx versuchen, die Tür abzusperren. Aufgrund der Schwäche des Türschließers ist es nötig, beim Absperren die Tür zuzuhalten.

Inkonsistenzen

Wenn die Wohnungstür nicht abgesperrt ist, obwohl der Schalter auf OFF steht oder umgekehrt die Wohnungstür abgesperrt ist aber der Schalter auf ON steht, wird der Türstatus als inkonsistent bezeichnet. In diesem Fall leuchtet die rote Lampe an der Sphinx. Im Fall, dass die Tür offen ist, wird das als Sicherheitslücke betrachtet und nach einer gewissen Zeit wird versucht, die Tür zu schließen, und Alarm ausgelöst! Wer einen Fehlalarm auslöst, wird als Noob beschimpft.

Sensorausfälle/Fallbackmodus

Für den Fall, dass einer oder mehrere Sensoren der Sphinx ausfallen, besitzt die Software einen Fallbackmodus. In diesem werden die meisten Sensorinputs ignoriert. Ein Funktionieren des Kippschalters wird jedoch vorrausgesetzt. Um den Space zu verlassen, muss dieser Kippschalter von ein auf aus geschaltet werden. Ist der Schalter auf "an" und die Klingel wird gedrückt, wird der Haustürsummer ausgelöst. Ansonsten reagiert die Sphinx nicht auf Sensoreingaben. Man kann sie in diesem Modus nur per SSH über die TyShell steuern. Dass der Modus aktiv ist, erkennt man daran, dass die Rote LED alle 2 Sekunden aufblinkt.

Der Fallbackmodus kann in der Tyshell aktiviert werden.


Hardware

Das Herzstück der Sphinx ist ein Rasperry Pi, der neben der Tür hängt. Der ist verbunden mit dem elektronischen Schließsystem Abus HomeTec CFA 1000. Dieses bietet Pins, die wir zum Öffnen und Schließen ansteuern können. Jochen, Marc und Carsten haben dazu eine Schaltung entworfen die ensprechende Ein- und Ausgänge hat. Dieser werden über I²C Busexpander (PCF8574) mit dem Pi verbunden. Die Spannungsversorgung von Pi und SphinxBoard läuft über ein externes 5V Netzteil (Backpowering). Der Schlossaktor (Abus) wird über die gleiche Spannungsschiene versorgt. Das erlaubt es dessen Eingänge direkt an die Busexpander anzuschließen.

Für den Auto-Mode muss die Klingel abgefragt werden. Wenn die Klingel gedrückt wird, kommt oben eine sinusförmige Spannung mit etwa 12V effektiv an. Diese wird gleichgerichtet und über einen Optokoppler getrennt. Die Schaltung am Pi kann jetzt also an einer steigende ein Klingeln erkennen, und das per I²C dem Pi mitteilen. An einem anderen I²C-Register des Pi kann der Summer an der Haustür geschaltet werden. Die 3,3V des GPIO schalten über einen Transistor eine Steuerspannung von 5V auf ein Relais, das den Kontakt für den Summer schließt. Um die Tür automatisch zu öffnen ist ein Relais vorgesehen.

Alte Version: https://wiki.hacksaar.de/index.php?title=Sphinx&oldid=1618

Software

Auf dem Türserver (statische IP 192.168.42.222, immer an) hat jeder mit Türzugang einen Linux Useraccount (PAM) mit einem Homeverzeichnis und einer .ssh/authorized_keys. Die Nutzer der Gruppe tuer erhalten beim Login eine in Python geschriebene custom Shell (tyshell), die zum Öffnen und Schließen der Wohnungstür sowie zum Betätigen des Summers verwendet werden kann. Dies wird in der Konfiguration vom SSHD vorgeschrieben.

Die tyshell sendet die Kommandos dann per UNIX socket (/run/tuer.sock) das Kommando an den Türdaemon (tuerd). Der tuerd führt dann sequentiell alle erhaltenen Kommandos aus, kapselt also letztlich komplett die ausgehende Kommunikation über den I²C. Er besorgt außerdem das Logging, und kann dabei Kernel-Funktionen nutzen, um den die Aktion auslösenden User herauszufinden.

Damit I²C funktioniert, muss in der /boot/config.txt folgendes gesetzt werden: dtparam=i2c_arm=on.

Die Software liegt unter /opt/tuer. Die jeweils aktuelle Entwicklung findet unter /home/pi/tuer, das ist im Wesentlichen ein Klon des git-Repos. Die systemweite Installation erfolgt mittels "sudo make". Die Software benötigt das Python-Modul smbus-cffi, welches im root-lokalen Ordner (/root/.local/lib/python3.*/site-packages) installiert ist. Das muss jedoch niemand von Hand machen, sudo pip3 install --user smbus_cffi richtet alles automatisch ein.

Der Daemon loggt seine Tätigkeiten nach /var/log/door.log. Die Logdateien werden außerdem regelmäßig auf den Hacksaar-Server (/home/sphinxlog/data) gesynced.

Zum E-Mail-Versand schickt der Daemon die Mails direkt an den Brückenkopf, der sie dann über hacksaar.de an den gewünschten Empfänger weiterreicht.

Eine offene Idee ist ein Daemon, der eine Webcam durch den Türspion überwacht. Sobald er einen QR-Code eines Mitglieds (im Homeordner des Users unter ".qrpw.txt") scant, sendet er "open" an den tuerd, um die Wohnungstür zu öffnen. Mit dem Klingelmuster + QR Code kann man dann also komplett ohne elektronische Geräte den Space betreten.

Zugang erhalten

Die Türadmins sind Ralf, Constantin und Chriss. Wer Zugang möchte, muss sich ein SSH-Schlüsselpaar generieren und dessen öffentlichen Teil einer dieser Personen zusammen mit dem gewünschten Nutzernamen zukommen lassen (Mittwochs manuell per USB Stick oder per signierter EMail). Der Pi ist (absichtlich) von außerhalb des Spaces nicht erreichbar. Daher können die Admins den SSH-Key nur vor Ort hinzufügen.

Was fehlt noch

  • Türschließer hält die Tür nicht dicht genug zum Zusperren

Ansprechpartner

Software

Hardware

Weitere Links