Deutsch

Wichtiger Hinweis (Änderungen zum Ursprungsprojekt)

Durch die Vielzahl an Änderungen in den einzelnen Modulen ist dieser Fork nicht mehr kompatibel mit dem ursprünglichen Projekt__.

Es wird empfohlen, die Konfigurationsdatei für diesen Fork von Grund auf neu zu erstellen. Ausführliche Informationen dazu sind im Webinterface von DoorPi zu finden.

Falls bereits frühere Versionen dieses Projekts im Einsatz waren, wird eine Lektüre des Änderungsprotokolls__ ausdrücklich empfohlen.

https://github.com/motom001/DoorPi changelog.txt

Einführung

Ziel des Projektes DoorPi ist die Steuerung einer Türsprechanlage mithilfe eines Einplatiniencomputers wie dem Raspberry Pi und dem Kommunikationsprotokoll VoIP.

DoorPi ist ein Event-Action-basierendes System. Es gibt Komponenten, die Events auslösen, und Komponenten, die aufgrund dieser Events reagieren. Dazu sollen Ereignisse (Events), wie z.B. das Drücken einer Türklingel oder Vorhalten eines RFID-Chips, die Auslöser von Aktionen (Actions) sein, wie etwa ein Anruf bei einer hinterlegten Telefonnummer, das Versenden einer E-Mail oder das Auslösen des Türöffners.

Event-Quellen

Um diese Events zu registrieren, werden "DoorPi-Keyboards" genutzt. Diese sind zum Beispiel:

die GPIO-Pins
ein PiFace
Dateien im Dateisystem des Pi (z.B. für Remote-Befehle über SSH)
die serielle Schnittstelle (RDM6300 als NFC Reader)
Webservice mit Authentifizierung
VoIP-Telefon

An jedes Event können beliebig viele Actions angefügt werden, die synchron oder asynchron ausgeführt werden.

Action-Empfänger

Eine nicht vollständige Liste der Actions ist:

VoIP-Anrufe starten oder auflegen
E-Mail versenden
Programm ausführen
GPIO-Ausgänge ein- oder ausschalten
Status-Datei schreiben
Werte aus IP-Symcon lesen oder zurück schreiben
...

Durch die Kombination der Events und Actions ist eine Vielzahl an Kombinationen möglich.

Beispiele

Ein mögliches Szenario ist:

Beim Druck eines Klingeltasters wird ein Anruf ausgelöst und gezielt eine Nummer angerufen.
Der Bewohner kann mit der Außenstelle telefonieren und auf Wunsch den Türöffner auslösen, indem eine definierte Taste (oder Tastenfolge) auf dem Telefon gedrückt wird.
Der Bewohner vergisst das Auflegen und DoorPi beendet selbst das Gespräch, sobald die Tür wieder geschlossen wurde.
DoorPi versendet eine E-Mail, dass es einen Anruf gab, jemand die Tür geöffnet hat und jemand ins Haus gegangen ist.

Installation

ArchLinuxARM: Ein PKGBUILD ist im AUR verfügbar__. Gestartet wird mit systemctl start doorpi.service Für automatischen Start beim Hochfahren: systemctl enable doorpi.service
Raspbian und andere: Die Installation dieses Forks geschieht mithilfe der Python setuptools. Abhängigkeiten müssen gegebenenfalls vorher manuell installiert werden. ::
```
git clone https://github.com/Wuestengecko/DoorPi.git
cd DoorPi
python setup.py build
sudo python setup.py install --prefix=/usr/local
```
Für weitere Informationen siehe die Installationsanweisungen im offiziellen Forum__.

https://aur.archlinux.org/packages/doorpi http://www.doorpi.org/forum/board/21-installation/

DoorPi-Hilfe

Link zu Foren mit DoorPi Beiträgen:

DoorPi Forum__
[Haussteuerung] DoorPi (VoIP Wechselsprechanlage / Türsprechanlage mit Video-Support)__
DoorPI / VoIP Door-Intercomstation with Raspberry Pi__

http://www.doorpi.org/forum/ http://www.forum-raspberrypi.de/Thread-haussteuerung-doorpi-voip-wechselsprechanlage-tuersprechanlage-mit-video-support __ http://www.ip-symcon.de/forum/threads/26739-DoorPI-VoIP-Door-Intercomstation-with-Raspberry-Pi

English

Important Notes (Differences to the original project)

Due to a variety of changes in all modules, this fork is no longer compatible with the original project__.

It is recommended to rewrite the configuration from scratch. For extensive information on the supported configuration, please refer to the built-in web interface.

If you used a previous version of this project, it is recommended to also review the changelog__.

https://github.com/motom001/DoorPi changelog.txt

Introduction

Goal of the DoorPi project is the realization of a door intercom station with a single board computer like the Raspberry Pi and the communication protocol VOIP.

DoorPi is an event-action based system. There are components which fire events, and components which react on these events. That means that events like "Doorbell pressed" or "RFID chip xyz detected" can trigger actions like "call telephone xyz", "send email to xyz" or "open door".

Event-Sources

For registering these events, so-called "DoorPi-Keyboards" are used. Examples include:

GPIO pins
A PiFace
Files in the filesystem of the PI (e.g. for remote commands via SSH)
The serial port (e.g. with an RDM6300 as NFC reader)
Web service with authentification
VOIP phone

Each event can trigger the execution of any number of actions, which are executed synchronously or asynchronously.

Action-Receivers

A non-complete list of actions is:

Start or end a VoIP call
Send an e-mail
Execute a program
Set a GPIO output pin
Write a status file
Read values from IP-Symcon or write them back
...

By combining different events and actions, a great number of combinations is possible.

Examples

A possible scenario is:

When the doorbell is pressed, a call to a specific number is started.
The inhabitant can talk to the outside station and on demand open the door remotely by pressing a key (or key sequence) on the telephone.
The inhabitant forgets to end the call and DoorPi ends the call itself, as soon as the door is closed again.
DoorPi sends an email that there was a call, somebody opened the door and somebody walked into the house

Installation

ArchLinuxARM: A PKGBUILD is available in the AUR__. Start DoorPi with systemctl start doorpi.service To automatically start it after booting, use systemctl enable doorpi.service
Others (including Raspbian): Download and install this fork with python setuptools. You need to take care of dependencies yourself::
```
git clone https://github.com/Wuestengecko/DoorPi.git
cd DoorPi
python setup.py build
sudo python setup.py install --prefix=/usr/local
```
For more information see the official forum__.

https://aur.archlinux.org/packages/doorpi http://www.doorpi.org/forum/board/21-installation/