PiSwitch/README.md

88 lines
2.8 KiB
Markdown
Raw Normal View History

2015-03-30 12:18:32 +00:00
# PiSwitch
2015-03-30 13:16:16 +00:00
2015-04-06 17:13:59 +00:00
# Wozu dient PiSwitch?
2015-03-30 13:16:16 +00:00
Mit PiSwitch können Funksteckdosen über ein Webinterface gesteuert werden.
Dazu wird nur ein kleiner Sender benötigt und natürlich einen Raspberry Pi mit Webserver und PHP 5.
2015-03-30 13:35:40 +00:00
Aktuell ist das Projekt nur für 3 Steckdosen ausgelegt, später wird es aber mehr geben.
2015-03-30 13:16:16 +00:00
------------
# Was wird benötigt?
1. Ein 433MHz Funksender (http://goo.gl/0CpSmH)
2. Die Funksteckdosen (http://goo.gl/jtSpMM)
Wichtig: Der Steckdosen MÜSSEN über DIP-Schalter verfügen!
3. Ein Raspberry Pi (egal welches Model)
4. Jumpercable + evtl. Steckbrett
------------
# Welche Software wird benötigt?
1. Ein Webserver (z.B. nginx) mit PHP5
(Hilfe (bis Schritt 8): http://jankarres.de/2012/08/raspberry-pi-webserver-nginx-installieren/)
2. rcswitch-pi + wiringpi
------------
# Hinweis!
2015-03-30 14:00:09 +00:00
Im Laufe der Installation werden dem Nutzer www-data Root-Rechte gegeben, damit die Scripte funktionieren.
2015-03-30 13:16:16 +00:00
Deswegen darf bei aktuellem Stand des Projektes KEINE Freigabe des Webports erfolgen.
Wenn im Router das Portforwarding eingeschalten ist (für den Raspberry Pi und dem Webport) ist es möglich ohne entsprechender Absicherung den Pi zu hacken.
Das ist ein sehr großes Sicherheitsrisiko.
Ist der Pi aber nur im eigenen Heimnetzwerk sollte dies kein Problem darstellen.
(Für evtl. Schäden übernehme ich keine Haftung)
------------
# Installation von rcswitch-pi und wiringpi
2015-03-30 14:00:09 +00:00
Daher das rcswitch-pi auf wiringpi aufbaut, muss dies auch zuerst installiert werden!
2015-03-30 13:16:16 +00:00
wiringPi:
2015-03-30 13:19:56 +00:00
2015-03-30 13:16:16 +00:00
1. sudo apt-get update && sudo apt-get upgrade
2. sudo apt-get install git-core
3. git clone git://git.drogon.net/wiringPi
4. cd wiringPi
5. ./build
rcswitch-pi:
2015-03-30 13:19:56 +00:00
2015-03-30 13:21:43 +00:00
0. sudo apt-get update && sudo apt-get upgrade
2015-03-30 13:16:16 +00:00
1. git clone https://github.com/r10r/rcswitch-pi.git
2. cd rcswitch-pi
3. make
------------
# Anschluss der Hardware
1. Funksender anschließen
(ATAD -> GPIO 17; VCC -> 5V; GND -> Ground)
2. Code der DIP-Schalter an den Funksteckdosen ändern
------------
# Installation von PiSwitch
Wenn dann also die Hardware angeschlossen ist und der Webserver mit PHP 5 läuft, kann dann PiSwitch installiert werden.
1. sudo usermod -a -G gpio www-data
2. Mit "git clone https://github.com/Landei/PiSwitch.git" PiSwitch herunterladen
3. Danach mit "sudo cp -R PiSwitch/ /usr/share/nginx/www/piswitch" PiSwitch kopieren
2015-03-30 13:16:16 +00:00
Fertig!
------------
# Konfiguration von PiSwitch
1. Mit "sudo /usr/share/nginx/www/piswitch/config.php" den Code der DIP-Schalter ändern und evtl. den Pfad zu rcswitch-pi ändern
2. Die Namen der Steckdosen kann in der Datei "name.php" geändert werden
------------
Zum Schluss kann man dann am PC die Website aufrufen, indem man "[IP des Pi's]/piswitch" aufruft.
Anschließend kann auch gleich die Funktionalität geprüft werden.
------------
Viel Spaß mit PiSwitch
Florian
Bei Fragen oder Problemen einfach eine E-Mail an piswitch@landei.pfweb.eu :)