*--------------------------------------
* Archivo:  th-leeme.txt
* Objetivo: Explicar cmo usar "th"
* Autor:    Pedro Reina <pedro@pedroreina.net>
* Fecha:    D.2.10.2011
* Versin:  1.0
*--------------------------------------


Objetivo de estos archivos
--------------------------

Instalar en un servidor, preferiblemente libre, un
sistema que permita monitorizar va web la temperatura
y humedad ambiente usando una placa Arduino.


Requisitos del servidor
-----------------------

Para que funcione correctamente el contenido de estos
archivos es necesario que el servidor ya cuente con
algunos programas:

* El programa "cron" o algo similar, para que arranque
  automticamente th.pl cada cinco minutos.

* Perl para lanzar el programa th.pl, imprescindible para
  interactuar con la placa Arduino, recopilar los datos necesarios
  e ingresarlos en las bases de datos. Debe estar instalada la
  extensin Device::SerialPort.

* El programa rrdtool para almacenar las bases de datos
  "round robin" y generar los grficos.

* Servidor web con soporte PHP para consultar los archivos php.

* El servidor de bases de datos SQLite; se usa para almacenar todos
 los datos obtenidos y as disponer de un histrico completo y para
 consultar los ltimos datos registrados.


Instalacin del sistema
-----------------------

El sistema ha sido creado sobre un sistema oprativo Debian
Lenny y puede requerir modificaciones para funcionar sobre
otros sistemas.

* Se carga en la placa Arduino con un sensor DHT11 el cdigo
  del archivo th.pde y se enchufa por USB.

* Se crea en el directorio principal del servidor web un
  directorio para contener los archivos.

* Se copian a ese directorio los archivos que aparecen
  al descomprimir el archivo th-1.0.zip

* Se crean las bases de datos round robin usando el archivo
  ejecutable crea-rrd.sh con la orden
  ./crea-rrd.sh

* Se crea la base de datos SQLite con la orden
  sqlite3 th.db ".read th.sql"

* Se retoca al gusto las constantes del archivo th.pl

* Se editan al gusto los archivos php, que estn pensados
  para ejecutarse en mi sistema y probablemente den sencillos
  errores en el tuyo.

* Se copia al directorio de cron el archivo th.cron, quiz
  cambindole el nombre. En mi sistema:
  cp th.cron /etc/cron.d/th
  Si es necesario, se edita el archivo para que apunte al
  directorio donde est el programa th.pl

* Para que se creen todos los archivos png es necesario esperar
  hasta las 00:00 horas del da siguiente a la instalacin,
  pero los primeros png se crean en el primer minuto que sea
  cero o mltiplo de cinco.

* Comprueba el funcionamiento del sistema apuntando al cabo de un
  rato tu navegador a la pgina en la que lo has instalado.

* Los archivos th.sql, th-leeme.txt, crea-rrd.sh y th.cron ya no son
  necesarios, los puedes borrar del directorio de trabajo.
