Skip to main content

provide intercomstation to the doorstation by VoIP

Project description

travis_status_master code_climate_badge Code Climate

DoorPi @ PyPi:

Download CC BY-NC 4.0

Downloads last day Downloads last week Downloads last month

DoorPi @ GitHub:
 

open issues on github all issues on github

github_watchs github_stars github_forks

Deutsch

Einführung

Ziel des Projektes DoorPi ist die Steuerung einer Türsprechanlage mittels einem Einplatiniencomputer 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 “Drücken einer Türklingel” oder “RFID Chip xyz vorgehalten” die Auslöser von Aktionen (Actions) wie “Anruf bei Telefon xyz”, “E-Mail an xxx” oder “Öffne Tür” sein.

Event-Quellen

Um diese Events zu registrieren, werden “DoorPi-Keyboards” genutzt, was z.B.:

  • 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

sein können.

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

Action-Empfänger

Eine nicht vollständige Liste der Actions ist:

  • VoIP Anruf zu festgelegter Nummer starten
  • VoIP Anruf zu Nummer starten, die aus einer Datei ausgelesen wird
  • Anruf beenden
  • E-Mail versenden
  • Programm ausführen
  • Ausgang schalten
  • Status-Datei schreiben
  • Werte aus IP-Symcon lesen oder zurück schreiben

Durch die Kombination der Events und Actions sind fast alle gewünschten Kombinationen möglich.

Beispiele

Ein mögliches Szenario ist:

  1. Beim Druck eines Klingeltasters wird ein Anruf ausgelöst und gezielt eine Nummer angerufen (z.B. interne FritzBox Nummer **613 aber auch Handynummern).
  2. Der Bewohner kann mit der Außenstelle telefonieren und auf Wunsch die Tür remote öffnen, in dem eine definierte Taste (oder Tastenfolge) auf dem Telefon gedrückt wird (z.B. die Taste “#”).
  3. Der Bewohner vergisst das auflegen und DoorPi beendet selbst das Gespräch, sobald die Tür wieder geschlossen wurde.
  4. DoorPi versendet eine E-Mail, dass es einen Anruf gab, jemand die Tür geöffnet hat und jemand ins Haus gegangen ist.

Mittlerweile gibt es auch Video-Support, so dass an der Haustür eine Kamera installiert werden kann und das Bild auf den Innenstationen angesehen werden kann, noch bevor das Gespräch angenommen wird.

Installation

via PyPi:

sudo pip install doorpi &&
doorpi_cli --trace

via GitHub:

sudo rm -r -f /tmp/DoorPi
git clone https://github.com/motom001/DoorPi.git /tmp/DoorPi
cd /tmp/DoorPi
sudo python setup.py install
doorpi_cli --trace

Konfiguration

Der Start von DoorPi endet mit der Ausgabe der Weboberfläche-URL wie hier:

2015-09-10 17:52:28,085 [INFO] [doorpi.status.webserver] DoorPiWeb URL is http://raspberrypi:53540/

Aktuell bin ich noch nicht dazu gekommen, die Config pro Gerät (GPIO, PiFace, …) zu individualisieren. In der Weboberfläche ist auf dem Startbildschirm die Übersicht der Module (z.B. GPIO). Rechts von dem Modul gibt es den Button Info. In der Info-Seite findest Du neben der Beschreibung auch die möglichen Parameter mit default-Werten. Parallel dazu gibt es in der Navigation den Konfig-Editor. Dort kannst Du die Config bearbeiten, wenn Du weißt, welche Parameter wo hin gehören. Auch die Config abspeichern kannst Du in der Übersicht.

Daemon

Anleitung um DoorPi als Daemon einzurichten ist hier zu finden: https://github.com/motom001/DoorPi/tree/master/doorpi/docs/service

Es sollte aber auf jeden Fall der BASE_PATH auf den Ablageort der Config-Datei angepasst werden.

English

Introduction

coming soon

Event-Sorces

coming soon

Action-Receiver

coming soon

Examples

coming soon

Installation

via PyPi:

sudo pip install doorpi &&
sudo doorpi_cli --trace

via GitHub:

sudo rm -r -f /tmp/DoorPi
git clone https://github.com/motom001/DoorPi.git /tmp/DoorPi
cd /tmp/DoorPi
sudo python setup.py install
doorpi_cli --trace

Configuration

coming soon

Daemon

The readme to install doorpi as daemon is here: https://github.com/motom001/DoorPi/tree/master/doorpi/docs/service

But you should change the BASE_PATH to the path of the config file.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
DoorPi-2.4.1.5-py2.7.egg (231.6 kB) Copy SHA256 hash SHA256 Egg 2.7

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page