{{Projekt|verantwortlich=Matthis|status=aktiv|beschreibung=Verlängerung der Türklingel, sowie des Türöffners in den Frickelraum, geht aber gerade nicht richtig|bild=|bildbeschreibung=|interessenten=[[Benutzer:Chrissi^|Chrissi^]]|source=[http://svn.tinyhost.de/stratum0/doorbell/ svn.tinyhost.de]|lizenz=netIO Firmware: GNU GPL|download=|version=}}

== Ziel ==
Oft sitzt man gemütlich im Frickelraum und hängt seinen Problemen nach. Und dann passiert es: ''Es klingelt, aber niemand bekommt es mit.''
Das Problem: Mit N (N > 0) geschlossenen Türen oder halbwegs lauter Musik bekommt man von der Klingel im Frickelraum schlicht nichts mehr mit.

Dies soll nun dadurch behoben werden, dass ein Klingeln an der Tür von einem Gerät erkannt und über ein Protokoll über das Netzwerk verteilt wird. Slaves sollen aufgrund einer solchen Information ein Klingeln erkennen und somit ihrerseits ein Klingelsignal auslösen.

Zusätzlich scheint es sinnvoll nicht nur die Information einer Türklingel, sondern auch die Information eines betätigten Türöffners zu übertragen. Somit ist man <s>gewarnt</s> informiert, wenn jemand in den Space kommt.

== Idee ==
* An der Tür wird ein [http://www.pollin.de/shop/dt/MTQ5OTgxOTk-/Bausaetze_Module/Bausaetze/Bausatz_AVR_NET_IO.html NetIO] eingesetzt, dass Schaltvorgänge an der Türklingel und am Türöffner überwacht.
* Passiert auf einer der beiden Leitungen ein Event, wird dieses per IP Broadcast über Ethernet Broadcast und ein UDP auf einem lustigen Port ins LAN geblasen.
* Dort können beliebige Slaves mithören und das anzeigen.
* Im Frickelraum gibt es dann ein weiteres netIO, dass auf diese Broadcasts wartet und diese, wenn sie eintreten, visualisiert.
* Ist es möglich einen befehl in der art von "leuchte 30 sec." zu geben? --[[Benutzer:Matthis|Matthis]] 15:15, 18. Okt. 2012 (CEST)
** Ja, ist möglich. Das Quell-Gerät sagt nur: Das Event ist passiert. Wie die anderen Geräte reagieren, kann auf denen jeweils festlegen. Eine Zeit ist dabei auf jeden Fall schon vorgesehen. --[[Benutzer:Chrissi^|Chrissi^]] 15:28, 18. Okt. 2012 (CEST)

== Systemarchitektur ==
Die Abbildung ''Doorbell-Extender: Event Propagation'' veranschaulicht den Aufbau des Systems.
[[Datei:Systemueberblick.svg|thumb|Doorbell-Extender: Event Propagation]]
Das sendende netIO überwacht die digitalen Eingänge 1 .. 4. Tritt an einem dieser Eingänge eine positive und/oder eine negative Flanke auf, so wird das dem Eingang zugeordnete Event per UDP ins LAN übertragen. Im LAN können nun mehrere Clients nach Broadcast-Events lauschen. 

Auf Client-netIOs können Events im LAN lokale Aktionen zugeordnet werden. Solche Aktionen können das toggeln eines Ausgangs, das Ein- oder Ausschalten eines Ausgangs, sowie das zeitgesteuerte Aktiveren eines Ausgangs sein.

=== UDP-Pakete ===
:''siehe: [[EVENTDISTR]]''

Doorbell-Extender Ereignisse werden per UDP als IP-Broadcast (Broadcast des lokalen Netzes) auf Port 31337 (''wir sind in einem Hackerspace; welcher Port auch sonst!'') übertragen. Der Datenteil der Pakete hat dabei einen fixen Aufbau:
 <Proto ID>;<Event name>=<Event type>
Den Feldern kommt dabei folgende Bedeutung zu:
* '''Proto ID''': String, der das genaue verwendete Protokoll beschreibt. Zunächst ist nur der String "''EVENTDISTRv1''" erlaubt!
* '''Event name''': Name des Events. Maximal 10 Zeichen.
* '''Event type''': Der Typ des Events. Gibt an, was genau Auslöser des Events war. Erlaubte Eigenschaften sind:
** ''RISING''
** ''FALLING''

Der Datenteil des UDP-Paketes darf eine maximale Länge von 100 Byte nicht überschreiten!
[[Datei:Beispiel UDP-Paket.jpg|thumb|Beispielhaftes UDP-Paket]]

== Fortschritt ==
[x] netIO kann Events senden. <br>
[x] netIO kann Events emfpangen. <br>
[x] Es gibt eine elektrische Schnittstelle, so dass ein netIO mitbekommt, wenn es klingelt. <br>
[x] Netzwerkanbindung im Flur (z.B. über WLAN auf LAN Brücke) <br>
[x] <s>Eine Lampe für das empfangene netIO </s> Eine akustische Klingel zum Klingeln.<br>
[x] Eine elektrische Schnittstelle zwischen netIO und Lampe <br>
[x] Es soll aus dem Frickelraum möglich sein, den Türöffner zu betätigen.<br>
--> [x] Einsetzen eines Tasters im Frickelraum incl. absetzen des entsprechenden Events <br>
--> [x] Entgegennehmen des Events an der Tür und Weitergabe an den Türöffner. (Wahrscheinlich am Einfachsten parallel zum bestehenden Handy-Türöffner ^^)<br>
[x] Es wurde gewünscht die Klingel etwas leiser bzw. weniger störend zu machen. <br>
[ ] Eventuell sollte man die Klingellautstärke an die Raumlautstärke anpassen. <br>

== Ereignisse und Reaktionen ==

=== Ereignisse ===
* '''DingDong'''
** Auf netIO an der Tür. Wird gesendet, so lang geklingelt wird. (RISING und FALLING)


=== Reaktionen ===
* '''DingDong'''
** Auf netIO mit Lampe im Frickelraum. Ein Ausgang wird für 20 Sekunden eingeschaltet.


== Fotos ==
[[Datei:2012-10-23 19.56.12.jpg|thumb|Geschlossene Klingel-Box]]
[[Datei:2012-10-23 19.56.32.jpg|thumb|Geöffnete Klingel-Box]]
[[Datei:2012-10-23 19.57.59.jpg|thumb|netIO im Flur]]

== Demonstrator-Anwendung ==
Java-Klasse, mit der UDP-Events gesendet und empfangen werden können.
* Broadcast für den Space: 192.168.178.255
* Events: siehe weiter oben

Verfügbar im [http://svn.tinyhost.de/stratum0/doorbell/trunk/UDP_SEND_workspace_%28Java%29/UDP-Send/src/doorbell/ SVN]

=== kleines Python-Skript um die Tür unten zu öffnen ===
<pre>
import socket as sock
import time

stop_command = b"EVENTDISTRv1;DoorUnten=RISING"
start_command = b"EVENTDISTRv1;DoorUnten=FALLING"
ip = "192.168.178.255"
port = 31337

s = sock.socket(sock.AF_INET, sock.SOCK_DGRAM)
s.setsockopt(sock.SOL_SOCKET,sock.SO_BROADCAST,1)
s.sendto(start_command,(ip,port))
time.sleep(3)
s.sendto(stop_command,(ip,port))
s.close()
</pre>