===== Dooris =====

Dooris ist das Door Information System des Space. Sie regelt den Zugang zum Space sowie den Space-Status nach außen. 

==== Projektverantwortliche ====
  * gnomus
  * Weitere werden gesucht

=== Zukunft ===
Siehe [[club:projekte:dooris|]]

==== Konzept ==== 
  * Im Space hängt ein Raspberry PI, der über seine GPIO-Pins den Keymatic an der Flurtür betätigen kann.
  * Die Tür wird durch einen SSH-Login angesteuert
    * User hierfür sind 'lock' und 'unlock'
  * Zugriffskontrolle erfolgt über SSH-Key-Auth
  * Das öffnen der Tür über den SSH login updatet auch den Status der Tür auf der Website und im Matrix
    

==== How to use this thing ====
  * Beantrage beim Plenum (1. Di. des Monats) Zugang zur internen Mailingliste
    * Dafür benötigst du 2 Bürgen die dich schon ein paar mal im Club gesehen haben
  * Wenn dein Antrag angenommen wurde, frag jemanden vom Vorstand oder NOC Team nach Gitlab access, und pushe deinen SSH-Key in das Repo  
  * Wenn dein SSH-Key im Repo gelandet ist, kommt er beim nächsten Sync auf die Dooris
    * Dooris synct sich immer zur vollen Stunde
  * Zum Öffnen der Tür reicht ein **ssh <user>@<ip>**
    * Dooris hängt aktuell auf der IP **10.31.208.31**
    * Es gibt folgende User
      * unlock: Schließt die Raumtür auf
      * lock: Schließt die Raumtür ab

==== Hardware ====
  * Kabel von Gegensprecheinheit zu Raum (done)
  * Reed-Relais in der Gegensprecheinheit (Achtung: RPi GPIO ist 3,3V und nicht 5V tolerant!) (done)
  * Raspi eingerichtet (done)
  * Relaiskarte für Keymatic gelötet (done)
  * Keymatic installiert und verkabelt (done)
  * Keymatic Stromversorgung realisieren (done by Hammi & Karolherbst 5v USB netzteil)
  * Dooris und Wichtiges zübehör an USV anschließen / Vorhandene USV ohne batterien mit batterien ausstatten. (done?)

==== Software ====
  * [[https://github.com/rickmer/dooris4pebble|App für Pebble]]
  * [[https://gitlab.hamburg.ccc.de/hansenerd/doorito|IRC-Bot doorito]]

=== Space API ===
Der aktuelle Türstatus ist maschinenlesbar unter https://www.hamburg.ccc.de/dooris/status.json im [[https://spaceapi.io/|SpaceAPI]]-Format verfügbar. TODO: Wo ist die Software, die das auf dem Webserver macht? Für alle die wissen wollen wann die größte chance besteht, ob der Space offen ist. Kann ich [[https://mapall.space/heatmap/show.php?id=CCC+Hamburg|Heatmap]] empfehlen.

==== Quellen ====
  * https://gitlab.hamburg.ccc.de/dooris/concierge
  * https://gitlab.hamburg.ccc.de/ccchh/z9-access