summaryrefslogtreecommitdiffstats
path: root/doc/INSTALL
diff options
context:
space:
mode:
authormanuel <manuel@mausz.at>2013-12-25 13:25:16 +0100
committermanuel <manuel@mausz.at>2013-12-25 13:25:16 +0100
commit0c8c9ad976879f7c90f9915a60845ccb0cdb337d (patch)
tree162951b4713f3836f4114958a423e2c90ecf9c6b /doc/INSTALL
downloadwebiopi-0c8c9ad976879f7c90f9915a60845ccb0cdb337d.tar.gz
webiopi-0c8c9ad976879f7c90f9915a60845ccb0cdb337d.tar.bz2
webiopi-0c8c9ad976879f7c90f9915a60845ccb0cdb337d.zip
initial commit
Diffstat (limited to 'doc/INSTALL')
-rw-r--r--doc/INSTALL46
1 files changed, 46 insertions, 0 deletions
diff --git a/doc/INSTALL b/doc/INSTALL
new file mode 100644
index 0000000..e34f9db
--- /dev/null
+++ b/doc/INSTALL
@@ -0,0 +1,46 @@
1WebIOPi is developed and tested on Raspbian.
2
3You only need Python, either 2.7 or 3.2. Download, then extract and install WebIOPi. The setup script will automatically download and install required dependencies using apt-get. You may have to manually install GCC and Python development headers if you are not using Raspbian.
4
5$ wget http://webiopi.googlecode.com/files/WebIOPi-0.6.0.tar.gz
6$ tar xvzf WebIOPi-0.6.0.tar.gz
7$ cd WebIOPi-0.6.0
8$ sudo ./setup.sh
9
10Finally, run Python using webiopi command :
11$ sudo webiopi [-h] [-c config] [-l log] [-s script] [-d] [port]
12
13 Options:
14 -h, --help Display this help
15 -c, --config file Load config from file
16 -l, --log file Log to file
17 -s, --script file Load script from file
18 -d, --debug Enable DEBUG
19
20 Arguments:
21 port Port to bind the HTTP Server
22
23You're done, and ready to enjoy WebIOPi ! But the server and GPIO state will be lost when you'll stop the script (CTRL-C) or close the terminal.
24
25You can also start/stop the background service :
26$ sudo /etc/init.d/webiopi start
27and
28$ sudo /etc/init.d/webiopi stop
29
30You can even setup your system to start webiopi at startup :
31$ sudo update-rc.d webiopi defaults
32
33
34=Usage=
35If your are directly using your Raspberry Pi with keyboard/mouse/display plugged, open a browser to http://localhost:8000/
36
37If your Raspberry Pi is connected to your network, you can open a browser to http://raspberrypi:8000/ with any device of your network. Replace raspberrypi by its IP.
38
39You can even add a port redirection on your router (and/or use IPv6) to control your GPIOs over Internet !
40
41Default user is "webiopi" and password is "raspberry"
42
43By choosing the GPIO Header link on the main page, you will be able to control GPIO using a web UI which looks like the board header.
44 Click/Tap the OUT/IN button to change GPIO direction.
45 Click/Tap pins to change the GPIO output state.
46http://trouch.com/wp-content/uploads/2012/08/webiopi-chrome.png \ No newline at end of file