> ## Content Index
> Fetch the complete content index at: https://blog.xavigonzalez.net/llms.txt
> Use this file to discover other available public pages before exploring further.

# Termostato inteligente con Raspberry Pi
- URL: https://blog.xavigonzalez.net/termostato-inteligente-con-raspberry-pi/
- Published: 2020-05-03T17:12:42.000Z
- Updated: 2026-10-29T15:01:33.000Z
- Author: Xavi Gonzalez
- Tags: Curiosidades, GNU/Linux, HowTo, Informatica, Raspberry Pi, casa, dht11, domotica, flask, home, jquery, materialize, raspberry, raspbian, sensor, smart, smart thermostat, smarttemp, sqlite, temperatura, termostato, thermostat, #wordpress, #Import 2026-10-27 20:56

En estos días de confinamiento, a parte de trabajar, he tenido tiempo para volver a cacharrear con mi Raspberry. Recordé que tenía guardados algunos sensores de **un kit de Arduino**, y que con eso **y un relé mecánico,** lo tenía todo para construir un **termostato inteligente para casa.**  
Si quieres ver como lo hice, ¡sigue leyendo!

## Raspberry Smarttemp

Para crear este termostato inteligente, he creado una aplicación web con **Python** y el framework [**Flask**](https://flask.palletsprojects.com/en/1.1.x/?ref=blog.xavigonzalez.net). La parte frontend se genera en **HTML**, **JQuery**, y el framework CSS de [**Materilize**](https://materializecss.com/?ref=blog.xavigonzalez.net) y los datos se almacenan en una base de datos **SQLite** local. 

El resultado es un web app servida por HTTP para controlar el funcionamiento del sensor y la salida **GPIO** que enciende el relé conectado a la calefacción. Y este es su aspecto y funcionamiento:

![](https://blog.xavigonzalez.net/content/images/wordpress/2020/05/smarttemp-556x1024.gif)

Podemos ver:

- El estado actual del relé
- La temperatura real actual que recibe el sensor
- La temperatura objetivo que guarda el usuario
- Un interruptor general para pagarla completamente
- Un programador diario por franjas horarias.

He publicado el código en **[GitHub](https://github.com/xavigm/raspitemp.git?ref=blog.xavigonzalez.net)** bajo una licencia de **Creative Commons**. Todavía está en fase de mejora y a falta de una buena refactorización para considerarla definitiva. Pero se puede usar perfectamente. 

### ¿Qué necesitamos?

- Una **Raspberry** con **WiFi** (a partir de 2B) , y una SD de al menos 8GB con [Raspbian](https://www.raspberrypi.org/downloads/raspbian/?ref=blog.xavigonzalez.net) instalado.
- Un sensor de temperatura **DHT11** (como [este](https://www.amazon.es/AZDelivery-Conexion-Temperatura-Humedad-incluido/dp/B07TXR5NQ6/ref=sr%5F1%5F3?%5F%5Fmk%5Fes%5FES=%C3%85M%C3%85%C5%BD%C3%95%C3%91&dchild=1&keywords=sensor+dht11&qid=1588517166&sr=8-3&ref=blog.xavigonzalez.net))
- **Un relé mecánico** para encender la calefacción como [este](https://www.amazon.es/Yizhet-acoplador-adecuado-Arduino-canales/dp/B07GXC4FGP/ref=sr%5F1%5F2%5Fsspa?%5F%5Fmk%5Fes%5FES=%C3%85M%C3%85%C5%BD%C3%95%C3%91&dchild=1&keywords=rele+mecanico+raspberry&qid=1588517253&sr=8-2-spons&psc=1&spLa=ZW5jcnlwdGVkUXVhbGlmaWVyPUExV0hNTVRYTjk3UDFRJmVuY3J5cHRlZElkPUEwMDU4NDQyMlBHUE41VUxLUkcyMiZlbmNyeXB0ZWRBZElkPUEwNTg3NjU2MkU3NVJFTDBJU0hDViZ3aWRnZXROYW1lPXNwX2F0ZiZhY3Rpb249Y2xpY2tSZWRpcmVjdCZkb05vdExvZ0NsaWNrPXRydWU=&ref=blog.xavigonzalez.net).  
[Aquí](http://rsppi.blogspot.com/2013/07/control-de-rele-mecanico.html?ref=blog.xavigonzalez.net) puedes ver como funcionan.

### GPIO Raspberry

En la imagen siguiente podéis ver un detallado esquema del GPIO de la Raspberry.  
En el programa, están prefijados los pines de GPIO de la Raspberry a dos en concreto. Puedes modificarlo en el código si te interesa, en el fichero **functions.py,** variable **pin** (sensor temperatura) y **led** (relé).

![](https://blog.xavigonzalez.net/content/images/wordpress/2018/12/rp2_pinout.png)

### Conectando el sensor

![](https://blog.xavigonzalez.net/content/images/wordpress/2020/05/DHT11.jpg)

Este es el sensor de temperatura DHT11.  
Tiene 3 conexiones, la primera para los datos.  
En el ejemplo, y como viene preconfigurado, **conectaremos el sensor DHT11 al GPIO 4 (pin 7).**

La segunda conexión es el positivo **VCC** y se lo conectaremos a **cualquier salida de 5V** PWR, por ejemplo, al **pin 2.**

La tercera, **Ground** (-) la conectaremos a **cualquier GND** de la Raspberry, como por ejemplo, el 8.

### Conectando el relé / led

Si queréis probar como funciona el termostato antes de instalarlo en casa, podéis conectar un led en vez del relé y hacer pruebas.  
Cuando se encienda el led, es como si el relé mecánico cerrara el circuito con la calefacción.   
**Conectaremos el relé al pin 16 (GPIO 23).**  
[Mira aquí](http://rsppi.blogspot.com.es/2013/07/control-de-rele-mecanico.html?ref=blog.xavigonzalez.net) como funciona y se conecta un relé mecánico.

###  Ejecutando el programa

Una vez tengamos todos los componentes conectados, podemos ejecutar el programa con Docker, o instalando el programa.

#### Docker

Si queremos ejecutar un contenedor de Docker con la aplicación, solo tenemos que descargar la imagen desde el repositorio de Docker Hub:

\[terminal\]sudo docker pull xavigm/raspitemp:latest\[/terminal\]

Y la ejecutamos:

\[terminal\]sudo docker run –privileged –name raspitemp -v /etc/localtime:/etc/localtime -v /etc/timezone:/etc/timezone -p 80:80 -d –restart=always xavigm/raspitemp \[/terminal\]

Ahora ya podemos comprobar si el contenedor se está ejecutando y abrir la aplicación en nuestro navegador, con la IP de la Raspberry.

\[terminal\]sudo docker ps  
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES  
ed955b4f8e85 raspitemp «/bin/sh -c ‘python3…» 17 minutes ago Up 17 minutes 0.0.0.0:80->80/tcp raspitemp\[/terminal\]

#### Instalando la aplicación Python

Accedemos a la Raspberry por SSH, y instalamos Python3 y las librerías necesarias para ejecutar el programa:

\[terminal\]sudo apt-get install python3 python3-pip sqlite3\[/terminal\]

\[terminal\]sudo pip3 install waitress Adafruit\_DHT flask RPi.GPIO\[/terminal\]

Y descargamos el programa desde GitHub:

\[terminal\]git clone https://github.com/xavigm/raspitemp.git\[/terminal\]

\[terminal\]cd raspitemp\[/terminal\]

Ahora ya podemos ejecutar el programa con el comando:

\[terminal\]sudo python3 main.py &\[/terminal\]

Se ejecutará el servidor web y empezará a permitir peticiones por el puerto 80\. Puedes comprobarlo abriendo un navegador desde tu móvil u ordenador y abrir la URL con la IP de tu Raspberry, por ejemplo:

**http://192.168.1.100**

Si quieres que el programa se ejecute al arrancar la Raspberry, puedes copiar el último comando y pegarlo en el fichero **/etc/rc.local**

**¡Ya puedes usar tu termostato inteligente desde cualquier parte de tu casa por Wifi!**

Si quieres mejorar el proyecto, eres libre de usar y compartir mi código, ya que está publicado en una licencia CreativeCommons Libre aquí:

[https://github.com/xavigm/raspitemp](https://github.com/xavigm/raspitemp?ref=blog.xavigonzalez.net)

Si quieres saber como está estructurado, porque te parece un poco caotico, te lo explico:

### Ficheros:

**main.py** 
Donde están definidas todas las rutas de la aplicación para renderizar el contenido html, lectura y actualización de valores de la base de datos.  
También se ejecuta el thread (definido en las funciones) que comprueba cada 20 segundos los valores para encender o apagar el relé.  
**functions.py**  
Donde están las funciones para: leer la temperatura del sensor, comprobar si en el momento actual debe estar encendido el relé según la programación, ejecutar las acciones sobre el GPIO, y guardar el estado general del relé en la bd.  
**temp.db** 
Fichero de base de datos Sqlite, con 3 tablas (temp,estado,dias) donde se guardan los estados y la programación diaria.  
**templates/index.html**  
El template en html con el frontend de la aplicación, con CSS de w3schools, y Materialize CSS.  
**static/style.css**  
Fichero con algunos estilos extras necesarios.  
**static/rangeslide.js**  
Codigo en jQuery para hacer funcionar los sliders de rango de tiempo en el frontend, y mostrar los valores guardados en la bd.

Puedes comentar lo que te apetezca en los comentarios.  
Si te ha gustado este proyecto, ¡compártelo!  
Muchas gracias.