User Tools

Site Tools


infrastructure:dooris

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
infrastructure:dooris [2023-09-24 16:29 UTC] – created n0th1nginfrastructure:dooris [2026-11-11 16:55 UTC] (current) – [Hardware] stb
Line 1: Line 1:
-===== Dooris =====+===== dooris =====
  
-Dooris ist das Door Information System des Space. Sie regelt den Zugang zum Space sowie den Space-Status nach außen. +//dooris// a.k.a. //Türis// a.k.a. //dOwOris// ist das Zugangskontrollsystem für unsere Clubtüren. 
 +Sie lässt authorisierte Wesen unsere Clubräume auf- sowie zusperren und synchronisiert den Öffnungsstatus der Türen an verschiedene Systeme.
  
 ==== Projektverantwortliche ==== ==== Projektverantwortliche ====
-  * gnomus +  * [[user:lilly]] 
-  * Weitere werden gesucht +  * kritzl 
- +  * stb 
-=== Zukunft === +  * june
-Siehe [[club:projekte:dooris|]]+
  
 ==== Konzept ====  ==== Konzept ==== 
-  * Es gibt eine Klingelanlage an der Eingangstür. +  * Im Space läuft ein Server, welcher ein Web- & SSH-Interface zur verfügung stellt. Über diese Interfaces können alle Türen unseres Spaces digital geschlüsselt werden. 
-    * Für diese Klingelanlage haben wir eine Gegensprecheinheit im Flur vor dem Space +  * Die Zugriffsberechtigung auf dooris wird zentral über unser Identitiy-System [[infrastructure:services:keycloak]] geregelt. Wer dort in der entsprechenden Gruppe ist, erhält automatisch Interaktionsberechtigung in dooris. 
-  * Es wurde ein Kabel von der Gegensprecheinheit in unseren Raum gelegt, sowie ein Relais in der Gegensprecheinheit installiert. +  * Der Status unserer Türen wird automatisch aus der Hardware ausgelesen und an weitere Systeme ([[club:projekte:spaceapi]], [[infrastructure:services:club-assistant]]) synchronisiert. Auch ein manuelles Öffnen oder Schließen wird dadurch korrekt erfasst.
-  * Im Space hängt ein Raspberry PI am Kabel, der über seine GPIO-Pins den Summer betätigen kann. +
-  * Der Summer wird durch einen SSH-Login des Users 'door' betätigt. +
-  * Zugriffskontrolle erfolgt über SSH-Key-Auth +
-  * Für die Raumtür wurde eine Keymatic eingeset, die auch über den Raspi angesteuert wird +
-    * User hierfür sind 'lock' und 'unlock'+
  
 ==== How to use this thing ==== ==== How to use this thing ====
-  * Beantrage beim Plenum (1. Di. des Monats) Zugang zur internen Mailingliste +  * Zum Bedienen der dooris musst du schlüsselberechtigt sein. Siehe dazu [[club:zugehoerigkeit-und-berechtigungsgruppen]] 
-    * Dafür benötigst du 2 Bürgen die dich schon ein paar mal im Club gesehen haben +  * Per Web 
-  * Wenn dein Antrag angenommen wurde, frag jemanden vom Vorstand oder NOC Team nach Gitlab access, und pushe deinen SSH-Key in das Repo   +    * Besuche [[https://dooris.ccchh.net/|https://dooris.ccchh.net/]] (nur aus dem Clubnetz erreichbar) 
-  * Wenn dein SSH-Key im Repo gelandet ist, kommt er beim nächsten Sync auf die Dooris +    * Lesender Zugriff zum Einsehen des Türstatus ist dort jederzeit möglich. 
-    * Dooris synct sich immer zur vollen Stunde +    * Um Türen zu bedienen, logge dich mit [[infrastructure:services:keycloak]] ein. Anschließend tauchen Knöpfe unter den Türen auf, welche das Auf- sowie Zuschließen ermöglichen. 
-  * Zum Öffnen der Tür reicht ein **ssh <user>@<ip>** +  * Per SSH 
-    * Dooris hängt aktuell auf der IP **10.31.208.31** +    * Hinterlege in deiner [[https://id.hamburg.ccc.de/realms/ccchh/account/|Keycloak Account Console]] einen oder zwei öffentliche SSH-Schlüssel. 
-    * Es gibt folgende User +    * dooris synchronisiert regelmäßig (alle 15 Minuten) die Liste der authorisierten Public-SSH-Keys. Nach kurzer Verweildauer bist du also per SSH berechtigt. 
-      * unlock: Schließt die Raumtür auf +    * Verbinde dich mit ''ssh dooris@dooris.ccchh.net'' 
-      * lock: Schließt die Raumtür ab+      * **Öffnen des Hauptraums**: ''ssh dooris@dooris.ccchh.net unlock Hauptraum'' 
 +      * **Schließen des Hauptraums**: ''ssh dooris@dooris.ccchh.net lock Hauptraum'' 
 +      * Weitere Hilfstexte: ''ssh dooris@dooris.ccchh.net help''
  
 ==== Hardware ==== ==== 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?) 
  
 +Wir setzen für die Schlösser auf die [[https://homematic-ip.com/de| HomeMaticIP-Produktfamilie]]. Zur Steuerung kommt eine VM auf einem eigenen Proxmox-Host zum Einsatz, zusammen mit einem USB-Funk-Dongle Homematic IP RF-USB-Stick.
 +
 +Sowohl die Haupt- als auch Werkstatt-Tür sind mit einem [[https://homematic-ip.com/de/produkt/tuerschlossantrieb|Türschlossantrieb]] ausgestattet, der den Schließzylinder per Schlüssel umschließt. Der Antrieb ist auf der Innenseite der Tür am Schließzylinder angeschraubt. Die verbautenBKS Profilzylinder PZ 8812 (Baulänge 35/50 mit Gefahrenfunktion) können von beiden Seien umgeschlossen werden, so daß man auch immer von außen per Schlüssel schließen kann.
 +
 +Zusätzlich haben wir einen Schalter/Taster, der dazu dienen soll, die Werkstatt einfach vom Hauptraum aus auf- und zuschließen zu können. Stand 11/26 ist der aber noch nicht eingebaut.
 ==== Software ==== ==== Software ====
-  * [[https://github.com/rickmer/dooris4pebble|App für Pebble]] 
-  * [[https://gitlab.hamburg.ccc.de/hansenerd/doorito|IRC-Bot doorito]] 
  
-=== Space API === +Die Software der dooris ist selbst implementiert und bei uns im Forgejo unter [[https://git.hamburg.ccc.de/CCCHH/dooris]] aufzufinden.  
-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? +Eine Dokumentation der genauen Funktionsweise ist dort im README dokumentiert. 
 + 
 +=== Synchonisation in externe Systeme === 
 + 
 +Aktuell synchronisiert dooris den Türstatus mit folgenden Systemen: 
 + 
 +  * [[club:projekte:spaceapi]] zum Anzeigen des Türstatus auf unserer Website sowie öffentliche Kommunikation z.B. zu [[https://www.mapall.space/heatmap/show.php?id=CCC%20Hamburg|www.mapall.space]]. 
 +  * [[infrastructure:services:club-assistant]] für Automatisierung von z.B. Licht, Heizung und Luftfiltern, wenn der Space geöffnet und geschlossen wird. 
 + 
 +==== Geschichte ==== 
 + 
 +Historisch war die dooris ein Projekt von gnomus, welcher sowohl eigene Hardware als auch Software gebaut hatte. Diese Version hat per GPIO einen eigenen Elektromotor angesprochen, welcher den Schließzylinder bewegt hat.
  
-==== Quellen ==== 
   * https://gitlab.hamburg.ccc.de/dooris/concierge   * https://gitlab.hamburg.ccc.de/dooris/concierge
-  * https://gitlab.hamburg.ccc.de/ccchh/z9-access+
infrastructure/dooris.1695572985.txt.gz · Last modified: by n0th1ng

Except where otherwise noted, content on this wiki is licensed under the following license: CC0 1.0 Universal
CC0 1.0 Universal Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki