App Setup for xDoor

From xHain
Jump to: navigation, search
xDoor can be locked manually too

(english below)
Wir haben eine elektronische Steuerung für die xHain-Eingangstür. Die xDoor kann die Tür auf- und zuschließen. Wenn deine Schlüsselberechtigung von der Schlüsselkindergruppe genehmigt wurde, dann kannst du dein Smartphone wie folgt einrichten, um Zugang zur xDoor zu erhalten.

We have an electronically controlled front door at xHain. With xDoor you can lock and unlock the front door. Once you have been granted key access by our "Schlüsselkinder" (latch-key members), you can then connect your smartphone with xDoor as follows.

xDoor (de/en)

Die xDoor ist ein Mechanismus, der elektronisch gesteuert den Türschlüssel von innen mit einem Motor dreht. Man kann von innen manuell die Tür auf- oder abschließen durch drücken des "unlock" (oben) bzw. "lock" (unten) Knopfes. Beim Verlassen des Spaces kann von außen durch den Türspalt nach innen gegriffen werden, den unteren "verschließen"-Knopf betätigen und die Tür schnell zuziehen.

  • Warte beim abschließen einen Moment bis der Motor fertig gedreht hat, und überprüfe dann ob die Tür auch tatsächlich verriegelt ist.
  • Achtung! Die (äussere) Türklinke beim betätgen des Knopfes NICHT herunterdrücken bzw. gedrückt halten!! Das versetzt den Schließmechanismus in einen deadlock-Zustand der nur mit einem herkömmlichen Hardware-Schlüssel behoben werden kann! (Kontaktiere @felix falls das passiert.)

xDoor is an electronically controlled mechanism, which turns the key with a motor. You can manually unlock (upper button) or lock (lower button) the door by pressing the buttons. When leaving the space you can lock the door behind you by pulling the door almost shut, reach inside to press the "lock" button and quickly pull the door fully shut.

  • Wait a few moments for the motor to finish its movement. Then check if the door is actually locked.
  • Caution! DO NOT pull the outer handle or keep it pulled down while the door mechanism is in motion. This will put the door into a deadlock position which can only be resolved by using a regular hardware key. (Contact @felix if this happens.)

Android (deutsch)

ConnectBot 02.png
ConnectBot 02.1.png
ConnectBot 03.png
ConnectBot 04.png
ConnectBot 06.png
  1. Installiere die App "ConnectBot" (auch im Fdroid verfügbar)
  2. Starte die App. Klicke auf Menü > Pubkeys verwalten (Manage Pubkeys)
    1. Name: xDoor, Typ: "ed25519" auswählen
    2. "erstellen" ("generate) klicken (ganz unten)
    3. auf dem Feld wild rumwischen
  3. langer Klick auf den Schlüssel (xDoor) > öffentlichen Schlüssel kopieren ("copy public key")
    1. den Key aus der Zwischenablage an xdoor@x-hain.de schicken. (Falls uns deine Email-Adresse nicht bekannt ist, kann es sein, daß es eine persönliche Rückfrage gibt um deine Identität zu überprüfen bevor dieser Key im System eingetragen wird.)
  4. App-Homebildschirm: auf Plus klicken um neuen Host zu erstellen
    1. Benutzername ("username@hostname:port"): open@xdoor
    2. Name ("nickname"): open
    3. verwendete pubkey-auth ("use pubkey authentification"): xDoor Key auswählen
    4. aktivieren: "schließe bei disconnect" ("close on disconnect")
    5. speichern (Diskettensymbol oben rechts, "save host")
  5. nochmal neuen Host erstellen
    1. Benutzername: close@xdoor
    2. Name: close
    3. verwendeter pubkey-auth: xDoor
    4. "schließe bei disconnect" aktivieren
    5. speichern (oben rechts)
  6. Wenn du die Bestätigung erhalten hast, daß dein public key eingetragen wurde (das kann ein paar Tage dauern), dann kannst du jetzt die Tür wie folgt bedienen:
    1. Ins xHain-Wlan einloggen (ggf. Mobilfunk-Datenverbindung vorübergehend trennen, da die Kommunikation über das Wlan erfolgen muss. Falls du eine Firewall installiert hast, kannst du der ConnectBot App auch die Rechte entziehen über Mobilfunk zu kommunizieren).
    2. Auf dem App-Homebildschirm (Hosts) auf "open" bzw. "close" klicken, um die xDoor auf- bzw. abzuschließen.

Android (english)

  1. install the app "ConnectBot" (available also in Fdroid store)
  2. start the app. Click on menu > Manage Pubkeys
    1. Name: xDoor, Type: select "ed25519"
    2. click on "generate" (at very bottom)
    3. draw random wild pattern on the field
  3. long press on key (xDoor) > "copy public key"
    1. paste the key from the clipboard into an email and send it to xdoor@x-hain.de. (If your email adress is unknown to us, we may ask for more information to verify your identity before entering your pubkey into our system.)
  4. on app homescreen: tap on plus-symbol to create new host
    1. Username ("username@hostname:port"): open@xdoor
    2. nickname: open
    3. "use pubkey authentification": select xDoor key
    4. activate: "close on disconnect"
    5. save (symbol at top right, "save host")
  5. repeat steps to create another host
    1. username: close@xdoor
    2. nickname: close
    3. activate: "close on disconnect"
    4. save (symbol at top right, "save host")
    5. save (top right)
  6. Once you have received the confirmation that your public key has been entered into our system (it may take a few days), you can now lock and unlock the door as follows:
    1. Connect your phone with the xHain Wifi (you may have to disable mobile data connections to force the app to use the wifi. If you have a firewall you may also revoke acces to the mobile data connection for the app).
    2. Tap on "open" or "close" on the home screen of the app to unlock or lock the xDoor

iOS

Die xDoor kann man auf dem iPhone mit der terminus app aufsetzen. Das hat aber noch kein iOS-Nutzer dokumentiert.
Connecting to the xDoor with an iPhone can be done with the terminus app. No iOS user has documented it yet.