Tutorial para manejar el encendido y apagado de LEDS remotamente por un servidor o ssh a travs de una Raspberry Pi usando Python

y/o C

Integrantes: Alberto Aguilera Eduardo Arancibia Paula Lasalas Fabricio Rosales Jorge Ortz

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

La GPIO (General Purpose Input Output) de la raspberry pi posee pines con distintas funciones, los cuales pueden ser manejados con software y a su vez conectarse a otros hardwares como arduino. En nuestro caso gestionaremos la GPIO mediante lenguajes de programacin como C y Python, montaremos un servidor web y lo usaremos como estacin remota para encender luces led a distancia dentro de una misma red. Luego haremos un proceso parecido para controlar las luces directamente en la raspberry Pi. Para el siguiente tutorial se recomienda tener conocimientos previos sobre Python y C. Comencemos!

Materiales que necesitaremos 1 Raspberry Pi (con conexin a internet, de preferencia modelo B) 1 Protoboard 3 LED 3 resistencias de 330 [ohm] 1 Cable UTP 4 Jumpers

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Paso 1: Armar el circuito En la imagen se pueden apreciar las distintas distribuciones que poseen los pin de la GPIO, nosotros en este proyecto usaremos solo el de poder 3V3(3,3 volts) y para los 3 LED el GPIO7, GPIO8 y GPIO10. La estructura del circuito la definiremos como la siguiente: Siendo r una resistencia de 330 [Ohm]

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Paso 2: manejar la GPIO para encender o apagar un LED Para manejar las luces como si la raspberry fuese un interruptor los pin de la GPIO poseen dos estados: Low (0 o False) y High (1 o True), los cuales respectivamente los asociaremos con el encendido y apagado de estas. Primero necesitaremos instalar un modulo en python llamado RPI.GPIO que nos dejar controlar la GPIO, para ello abrimos una terminal y ponemos:
sudo apt-get install python-rpi.gpio

Ahora que tenemos el modulo instalado podremos hacer funcionar los led, probemos: Tenemos conectado un led al GPIO10(pin 10), entonces para encenderlo ponemos:
sudo python

#llamamos al modulo y lo importamos.

import RPi.GPIO as GPIO

#Fijamos los parmetros indicando el numero del pin (ver imagen con los nmeros por si no esta claro) y si es entrada o salida.
GPIO.setup(10, GPIO.OUT)

#Ahora iniciamos el pin a False para que se encienda el led (Si ponemos True estara apagado).
GPIO.output(10, False)

Y listo, hemos controlado un led usando python y la raspberry pi.

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Paso 3: Instalar y configurar servidor Instalaremos un servidor APACHE con PHP y MSQL, luego lo configuraremos para usarlo mas adelante. Antes de empezar debemos asegurar que nuestro sistema este actualizado poniendo en la terminal:
sudo apt-get update sudo apt-get upgrade

Luego de haber hecho esto instalamos Apache y PHP:

sudo apt-get install apache2 php5 libapache2-mod-php5

Luego reiniciamos Apache:

sudo /etc/init.d/apache2 restart

Y ya tenemos nuestro servidor listo, ahora hay que otorgar permisos. Los directorios tpicamente utilizados por un servidor web en linux se sitan en /var/www, y el usuario tpico para dicho entorno suele ser www-data. Ahora vamos a crear el grupo y usuario estndar para nuestro servidor, a la par que otorgamos los permisos pertinentes y aadimos a nuestro usuario por defecto (pi) al grupo comentado. De esta forma no ser preciso que el usuario root (su) sea siempre el que pueda operar en /var/www. Comenzamos cambiando el usuario y el grupo al directorio:
sudo chown www-data:www-data /var/www/

Damos los permisos a la carpeta www/:

sudo chmod 775 /var/www/

Agregamos el usuario pi al grupo www-data:

sudo usermod -a -G www-data pi

Ahora ponemos:
sudo visudo

Agregamos el siguiente cdigo al final:

www-data ALL=(root) NOPASSWD:ALL

Reiniciamos el Servidor:
sudo /etc/init.d/apache2 restart

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Luego podremos entrar al servidor ya creado colocando nuestra ip (en este caso es 192.168.0.178) en un navegador y apreciaremos que aparece la tpica imagen de apache dicindonos que funciona. It Works!

Ahora produciremos un archivo de prueba, Hola mundo en PHP. Para ello creamos un archivo con nano:
sudo nano /var/www/hola_mundo.php

Luego dentro del archivo escribimos:

<?php echo HOLA MUNDO DESDE RASPBIAN; ?>

Aqu unas imgenes de ejemplo de esto llevado a cabo y su resultado.

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Paso 4: Sistema de encendido y apagado va web. Hasta el momento poseemos el circuito armado, hemos visto como manejar un led con python y como montar un servidor web. Ahora lo que haremos ser juntar ambas cosas y hacerlas trabajar en conjunto. En PHP existe una funcin llamada exec, la cual puede ejecutar un programa externo como puede ser Python. Funciona de la siguiente manera:
<?php echo exec(programa); ?>

Nosotros ejecutaremos un script de python como por ejemplo:

<?php $a=exec('sudo python /var/www/pi/leds/prende.py'); echo $a; ?>

Ubicado en /var/www/pi/leds , el script prende.py contiene:

import RPi.GPIO as GPIO GPIO.setup(10, GPIO.OUT) GPIO.output(10, False)

Tambin podemos probar ejecutndolo en la consola:

sudo php /var/www/pi/leds/prende.php

Y listo, ahora solo falta un ltimo paso en lo que es va web que es descargarse una aplicacin que nos har el trabajo un poco ms fcil. http://jeffersonrivera.com/pi/led.zip

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Carpeta css ->Contiene los archivos de estilos, entre estos, el modelo del interruptor Carpeta js -> Contiene el script de jQuery 1.9 Carpeta images-> Contiene la imagen de fondo La web que pondremos ser en cdigo html, el que viene listo y solo hay que modificar para agregarle las otras 2 luces (y as podemos hacerlo tambin si ponemos mas de 3 luces). Index.html parte 1:

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Index.html parte 2:

Originalmente ese es el cdigo para 1 led, pero nosotros lo que haremos ser encender 3 luces, por lo que modificaremos este cdigo de la siguiente manera: Para agregar un interruptor nuevo que vaya dirigido a otra luz distinta no es necesario escribir un tremendo cdigo de nuevo, solo basta con duplicar (o vale decir copiar y pegar) desde la lnea 13 hasta la 64, es decir:
<div class="container"> <header><br> <h4>CONTROL REMOTO DE UN LED CON RASPBERRY PI</h4>
. (Hasta) .

//alert("Salida: "+response ); } }); } }); </script>

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Adems de ello, tambin se deben modificar las variables independientes, de otro modo, podramos terminar usando dos interruptores diferentes para un mismo led, o provocar un malfuncionamiento en el cdigo. He aqu una comparacin de la pgina original y la modificada para 3 leds.

Ahora continuamos con los otros archivos encontrados en la carpeta.

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

El siguiente es procesa.php:

En la lnea 2, recibimos la variable valor_estado, por el mtodo POST, y la guardamos en $valor_estado, luego preguntamos si es igual a 1, si es cierto, ejecutamos apaga.py, si no ejecutamos prende.py prende.py

apaga.py

Como se puede apreciar, debemos modificar segn nos convenga el archivo prende.py y apaga.py. En nuestro caso usaremos 3 leds, en las cuales usaremos 3 GPIO distintas, lo que significa que tendremos que modificar el cdigo y/o agregar lneas en el caso de la pgina web(como quedo demostrado anteriormente), hacer un procesa2.php, procesa3.php y que para cada led debe haber un archivo prende.py y apaga.py, lo cual nos deja por ejemplo con: Led 1 GPIO10 prende.py y apaga.py

Led 2 GPIO8 prende2.py y apaga2.py

Todo lo ltimo que estamos viendo solo es relacionar lo que hemos visto en los pasos 2 y 3.

Led 3 GPIO7 prende3.py y apaga3.py

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Y con una carpeta como la siguiente:

Con ello nuestra web estara funcional.

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Paso 5: Instalacin de WiringPi para controlar directamente con C Ya hemos acabado con el servidor web, el php, html y python, ahora continuaremos con implementar un programa en C que nos ayude a encender y apagar las luces directamente desde la raspberry, para ello necesitaremos primero instalar la librera WiringPi para el control de la GPIO mediante este lenguaje de programacin. Antes que todo, debemos tener instalado GIT en nuestra Raspberry pi, en caso de no tenerlo, desde la terminal ingresamos la siguiente lnea:
sudo apt-get install git-core

Nota: hay una posibilidad de que esto nos lance algn error, y esto se debe a que nuestra raspberry no esta actualizada, pero como ello lo hemos hecho en el paso 3 no debiera pasar. Ahora debemos obtener WiringPi mediante GIT:
sudo git clone git://git.drogon.net/wiringPi

Si es la primera vez que utilizas la funcin clone, debes hacer lo siguiente:

cd wiringPi git pull origin

Finalmente, para instalar la librera debemos ingresar a la carpeta wiringPi y ejecutar build:
cd wiringPi sudo ./build

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Paso 6: Utilizando C para el control de los leds La esencia es la misma que cuando utilizamos Python, solo que ac abrimos un editor de texto (nano, gedit, etc) y lo primero que debemos hacer es incluir la librera wiringpi a nuestro programa:
#include <wiringPi.h>

Luego utilizamos las funciones de esta librera para el control de los leds: wiringPiSetup(): Esta funcin inicia el sistema wiringPi y asume que ser usado el esquema de pines wiringpi.

pinMode (int pin, int mode): configura los pines para que sean de entrada o salida (INPUT, OUTPUT), en este caso en particular usaremos OUTPUT. digitalRead(int pin): Lee en que estado se encuentra el pin HIGH o LOW (1, 0), dependiendo de su estado lgico. digitalWrite(int pin, int estado_logico): Le asigna un estado al pin, sea HIGH o LOW.

Ejemplo:

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

En nuestro caso usando 3 luces led nuestro cdigo quedara as (fragmento):

En un archivo leds.C

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Por lo que queda listo para usarse directo en la raspberry pi: ./leds

Es importante sealar que al momento de compilar el programa escrito en C se debe hacer de la siguiente manera: Tenemos un archivo no compilado leds.c
sudo gcc leds.c -o 1 lwiringPi

ya que estamos trabajando con la librera wiringPi y con el hardware, por lo que necesitamos permisos del root.

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013

Bibliografa:
https://projects.drogon.net/raspberry-pi/wiringpi/download-and-install/ https://projects.drogon.net/raspberry-pi/wiringpi/functions/ http://riverajefer.blogspot.com/2013/06/control-remoto-de-un-led-con-raspberry.html http://www.cl.cam.ac.uk/projects/raspberrypi/tutorials/turing-machine/two.html http://es.wikihow.com/hacer-un-servidor-web-Raspberry-Pi

http://jeffersonrivera.com/pi/Proyecto_raspberry_pi.pdf

Agradecimientos especiales al trabajo de Jefferson Rivera: WEB: http://jeffersonrivera.com/ BLOG: http://riverajefer.blogspot.com/ YOUTUBE: https://www.youtube.com/user/riverajefer

Universidad Tcnica Federico Santa Mara, Introduccin a la ingeniera Telemtica, ao 2013