Tutorial para manejar el encendido y apagado de LEDS remotamente por un servidor o ssh a través de una Raspberry Pi usando Python y/o C
Integrantes:
Alberto Aguilera
Eduardo Arancibia
Paula Lasalas
Fabricio Rosales
Jorge Ortíz
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 programación como C y Python, montaremos un servidor web y lo usaremos como estación 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 conexión a internet, de preferencia modelo B)
1 Protoboard
3 LED
3 resistencias de 330 [ohm]
1 Cable UTP
4 Jumpers
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]
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 parámetros indicando el numero del pin (ver imagen con los números 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 estaría apagado).
GPIO.output(10, False)
Y listo, hemos controlado un led usando python y la raspberry pi.
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 típicamente utilizados por un servidor web en linux se sitúan en /var/www, y el usuario típico para dicho entorno suele ser www-data. Ahora vamos a crear el grupo y usuario estándar para nuestro servidor, a la par que otorgamos los permisos pertinentes y añadimos 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 código al final:
www-data ALL=(root) NOPASSWD:ALL Reiniciamos el Servidor:
sudo /etc/init.d/apache2 restart
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 típica imagen de apache diciéndonos 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 imágenes de ejemplo de esto llevado a cabo y su resultado.
Paso 4: Sistema de encendido y apagado vía 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 función 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)
También podemos probar ejecutándolo en la consola:
sudo php /var/www/pi/leds/prende.php
Y listo, ahora solo falta un último paso en lo que es vía web que es descargarse una aplicación que nos hará el trabajo un poco más fácil.
http://jeffersonrivera.com/pi/led.zip
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 código html, el que viene listo y solo hay que modificar para agregarle las otras 2 luces (y así podemos hacerlo también si ponemos mas de 3 luces).
Index.html parte 1:
Index.html parte 2:
Originalmente ese es el código para 1 led, pero nosotros lo que haremos será encender 3 luces, por lo que modificaremos este código de la siguiente manera:
Para agregar un interruptor nuevo que vaya dirigido a otra luz distinta no es necesario escribir un tremendo código de nuevo, solo basta con duplicar (o vale decir copiar y pegar) desde la línea 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>
Además de ello, también se deben modificar las variables independientes, de otro modo, podríamos terminar usando dos interruptores diferentes para un mismo led, o provocar un malfuncionamiento en el código.
He aquí una comparación de la página original y la modificada para 3 leds.
Ahora continuamos con los otros archivos encontrados en la carpeta.
El siguiente es procesa.php:
En la línea 2, recibimos la variable valor_estado, por el método 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 según 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 código y/o agregar líneas en el caso de la página 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
Led 3 GPIO7
prende3.py y apaga3.py
Todo lo último que estamos viendo solo es relacionar lo que hemos visto en los pasos 2 y 3.
Y con una carpeta como la siguiente:
Con ello nuestra web estaría funcional.
Paso 5: Instalación 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 librería WiringPi para el control de la GPIO mediante este lenguaje de programación.
Antes que todo, debemos tener instalado GIT en nuestra Raspberry pi, en caso de no tenerlo, desde la terminal ingresamos la siguiente línea:
sudo apt-get install git-core
Nota: hay una posibilidad de que esto nos lance algún 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 función clone, debes hacer lo siguiente:
cd wiringPi git pull origin
Finalmente, para instalar la librería debemos ingresar a la carpeta wiringPi y ejecutar build:
cd wiringPi sudo ./build
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 librería wiringpi a nuestro programa:
#include <wiringPi.h>
Luego utilizamos las funciones de esta librería para el control de los leds:
wiringPiSetup(): Esta función 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 lógico.
digitalWrite(int pin, int estado_logico): Le asigna un estado al pin, sea HIGH o LOW.
Ejemplo:
En nuestro caso usando 3 luces led nuestro código quedaría así (fragmento):
En un archivo “leds.C”
Por lo que queda listo para usarse directo en la raspberry pi:
./leds
Es importante señalar 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 librería wiringPi y con el hardware, por lo que necesitamos permisos del root.
Bibliografía:
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