¿Que es esphome?


Si está empezando a construir sus propios dispositivos IoT, verá muchas menciones al IDE Arduino y a escribir código. Si está intentando crear un dispositivo domótico sencillo y no eres un gran fan de la programación, te desanimarás rápidamente. Escribir código es complicado, ¡incluso si se es un programador experimentado! ¿Y si hubiera una forma de especificar qué tipo de sensor tiene conectado a su ESP8266/ESP32 y que éste supiera cómo leer los datos por usted? ¿Y si pudiera disponer de estos sensores en Home Assistant sin escribir una sola línea de código? Suena increíble, ¿verdad?

ESPHOME

ESPHOME es un framework de codigo abierto para controlar los módulos ESP8266/ESP32 de una manera muy sencilla pero potente y crear dispositivos inteligentes1. Estos módulos, amigo lector como sabrá son microcontroladores económicos y potentes que se utilizan en una amplia gama de dispositivos, desde bombillas inteligentes hasta sensores de temperatura.

ESPHome proporciona una interfaz de usuario fácil de usar para configurar los dispositivos ESP. Puede usar ESPHome para controlar los pines del dispositivo, conectar sensores y actuadores, e incluso acceder a servicios en la nube.

Asimismo también permite modificar el sistema de otros dispositivos que utilicen estos módulos, como la gama Sonoff, para hacerlos más potentes y versátiles1.

Algunos ejemplos de lo que puede hacer con ESPHome incluyen:

  • Crear una bombilla inteligente que se pueda controlar con su voz o con un toque en su teléfono.
  • Crear un sensor de temperatura que envíe datos a su sistema de automatización del hogar.
  • Crear un interruptor de luz que se pueda controlar con un botón físico o con un comando de voz.

ESPHome es un firmware alternativo para los procesadores ESP8266 y ESP32 que nos permite el uso de multitud de sensores y actuadores con una interfaz web que nos ofrece la edición e incluso el flasheado del dispositivo2. Vemos pues que ESPHome es una herramienta poderosa que puede ayudarlo a crear sus propios dispositivos inteligentes personalizados. Si está interesado en la domótica o el Internet de las cosas, ESPHome es una excelente manera de comenzar asi que sigamos.

INSTALACION ESPHOME

Una vez que haya configurado su dispositivo ESP con ESPHome, puede controlarlo con una variedad de sistemas de automatización del hogar, incluido Home Assistant, Homey y Domoticz.

Para instalar ESPHome, hay dos opciones: la instalación manual y la instalación a través de Home Assistant. La instalación manual es un proceso más detallado que requiere la instalación de Python y la instalación de ESPHome a través de pip3, para ello puede seguir los siguientes pasos para instalar ESPHome:

  1. Actualice su Raspberry Pi a la última versión de Raspbian.
  2. Instale las herramientas de desarrollo de Python.
  3. Instale el paquete ESPHome.

Para actualizar su Raspberry Pi, abra una terminal y ejecute los siguientes comandos:

sudo apt update
sudo apt upgrade

Para instalar las herramientas de desarrollo de Python, ejecute el siguiente comando:

sudo apt install python3-dev

Para instalar el paquete ESPHome, ejecute el siguiente comando:

pip3 install esphome

Una vez que haya instalado ESPHome, puede comenzar a crear sus propios dispositivos inteligentes.

Instalación de ESPHome con Docker

Si prefiere instalar ESPHome con Docker, siga estos pasos:

  1. Instale Docker en su Raspberry Pi.
  2. Cree un directorio para ESPHome.
  3. Cree un archivo de configuración de Docker para ESPHome.

Para instalar Docker en su Raspberry Pi, siga las instrucciones de la documentación de Docker.

Para crear un directorio para ESPHome, ejecute el siguiente comando:

mkdir /docker/esphome

Para crear un archivo de configuración de Docker para ESPHome, abra un editor de texto y pegue el siguiente código:

version: '3.8'
services:
  esphome:
    container_name: esphome
    image: esphome/esphome
    volumes:
      - /docker/esphome:/config
      - /etc/localtime:/etc/localtime:ro
    restart: always
    privileged: true
    network_mode: host

Guarde el archivo como docker-compose.yml en el directorio /docker/esphome.

Para iniciar ESPHome, ejecute el siguiente comando:

docker-compose up -d

Una vez que ESPHome esté iniciado, puede acceder a la interfaz web de ESPHome en http://localhost:8080.

Alternativamente, puede instalar ESPHome a través de Home Assistant, para ello siga estos pasos:

  1. Abra la interfaz de usuario de Home Assistant y navega hasta el panel Supervisor.
  2. Busque ESPHome en la pestaña “Add-on Store”.
  3. Haga clic en el botón “Install” para instalar ESPHome.
  4. Espere a que se complete la instalación.

Primeros pasos

Si ha escrito código personalizado para sensores en el pasado, estará encantado con la facilidad de uso de ESPHome pues puede registrar sensores y dispositivos con simples archivos de configuración YAML en lugar de escribir código. En este post, vamos a configurar un dispositivo ESP8266 con ESPHome y crear un dispositivo IOT interactivo utilizando un sencillo archivo de configuración ESPHome.

Estos son los pasos que vamos a repasar en esta guía:

  • Instalar el complemento ESPHome en Home Assistant.
  • Conectar un sensor a su dispositivo ESP8266/ESP32
  • Crear un archivo de configuración ESPHome básico.
  • Flashear su dispositivo ESP con su configuración ESPHome.
  • Añadir el dispositivo ESPHome a Home Assistant.
  • Añadir el sensor del dispositivo ESPHome a su panel de control de Home Assistant.

PASO 1-Instale el complemento ESPHome en Home Assistant

Como puede ver, supondremos que tiene una configuración de Home Assistant en funcionamiento y que ya tienes un dispositivo ESP8266 o ESP32. Los dos sensores que vamos a utilizar en esta guía son un sensor de temperatura/humedad DHT11 ( del que hemos tratado en numerosas ocasiones en este blog) y un simple relé (el sensor de temperatura/humedad demostrará cómo se pueden leer fácilmente los valores de su sensor con ESPHome y el relé nos enseñará cómo se puede hacer su propio dispositivo domótico interactivo a través de Home Assistant).

Utilizaremos el panel ESPHome que puede instalar en el Asistente Doméstico por unas sencillas razones:

  • Home Assistant es propietario del proyecto ESPHome, por lo que la integración es muy estable.
  • Si ya tiene Home Assistant funcionando en una Raspberry Pi o algún otro dispositivo, vamos a mantenerlo simple.
  • Su Home Assistant será/seguirá siendo el punto centralizado de todos sus proyectos de domótica.

Por el bien de esta guía, vamos a suponer que vamos a seguir con la guía e instalar ESPHome en Home Assistant. Para instalar el Aadd-on en Home Assistant, tenemos que navegar a la tienda de complementos:Home assistant dashboard → Supervisor → Add-on store

Ahora busque ESPHome en la tienda de complementos:

Haga clic en el complemento y en la página siguiente podrá instalarlo en su Asistente de inicio.

ESPHome es propiedad de Home Assistant, por lo que puede estar seguro de que la instalación está bien probada y es fiable. Las actualizaciones no romperán su instalación. Puede activar las opciones «Iniciar al arrancar«, «Vigilancia«, «Actualización automática» y «Mostrar en la barra lateral». Estas opciones harán que sea mucho más fácil añadir rápidamente nuevos dispositivos y gestionar los existentes. La facilidad de uso es la clave.

Si todo va como esperamos ,acabara de instalar el panel ESPHome en su instancia del Asistente Doméstico. Ahora estamos listos para ir al siguiente paso: Dar a su ESP8266/ESP32 algo que hacer, para lo cual vamos a conectarle un sensor que podremos añadir a Home Assistant más adelante.

Paso 2-Conecte un sensor a su dispositivo ESP8266/ESP32

Vamos a conectar nuestros primeros sensores a nuestro dispositivo ESP: Un sensor DHT11 (sensor de temperatura y humedad) y un relé que podemos utilizar para encender dispositivos más grandes como lámparas. Para guiarle a través de este proceso, usamos un ESP8266 para configurar los sensores. Si está utilizando un ESP32, su disposición de pines puede ser un poco diferente, así que asegúrese de prestar atención a estos.

El ESP8266 tiene los nombres de los pines en un lado de la placa, mientras que los pines reales están en el otro lado de los pines. Esto hace que sea un poco difícil de poner los sensores en el pin GPIO derecho a veces, así que le aconsejo que siempre vuelva a comprobar si usted tiene sus sensores conectados a los pines GPIO derecho.

El sensor DHT11 tiene 3 pines, así que vamos a necesitar 3 pines en el ESP8266:

  • Una conexión a tierra: marcada como GND tanto en el ESP8266 como en el sensor DHT11
  • Una fuente de alimentación: marcada como 3v3 en el ESP8266, y como VCC en el sensor DHT11
  • Una conexión de datos: utilizaremos el pin GPIO D5 ya que está justo al lado de un pin 3v3 y GND en el ESP8266

Vamos a conectar el ESP8266 y el DHT11 juntos con ters cablecillos hembra/hembra, por lo que se ve un poco como esto:

Ahora haremos lo mismo con un relé. El relé, al igual que el sensor DHT11, tiene 3 pines:

  • Una conexión a tierra: Marcada como GND o DC- dependiendo de su relé.
  • Una fuente de alimentación: marcada como VCC o DC+ dependiendo de su relé
  • Una conexión de datos: Marcada como IN en su relé

Conectemos el Relé a un pin 3v3, GND, y GPIO D8.

Su ESP8266 (o ESP32) ahora debe tener 2 elementos conectados:

  • Un sensor DHT11 con una conexión de datos en D5.
  • Un relé con una conexión de datos en D8.

Ambos elementos también deben estar conectados a un 3v3 y un GND. Ahora estamos listos para crear una configuración básica ESPHome para nuestros dispositivos ESP, el sensor DHT11 conectado, y el relé. ¡Vamos a ello!

Crear un archivo de configuración ESPHome básico

Después de haber instalado el tablero ESPHome en el Asistente de Hogar, ha añadido el complemento a la barra lateral. Navegue hasta el panel ESPHome.

Se le presentará una página básica con un gran botón verde en la esquina inferior derecha «+ NUEVO DISPOSITIVO«. Cuando haga clic en este botón y no esté ejecutando Home Assistant en HTTPS, Home Assistant le dirá que tendrá que conectar el ESP8266 al ordenador que está ejecutando el panel ESPHome. Esto suena un poco confuso, pero significa que tendrá que conectar su ESP8266 a su Raspberry Pi (u otra máquina) que esté ejecutando Home Assistant en su casa. Puede conectar los dos usando un cable micro-USB.

Una vez que haga clic en «Continuar», se le pedirá que introduzca un nombre para su configuración. Puede elegir un nombre reconocible para su nuevo dispositivo inteligente. En este ejemplo lo llamaremos temperature-light (temperatura-luz).

Cuando pulse continuar, ESPHome le preguntará para qué tipo de dispositivo quieres crear la configuración. Si conoce la placa específica que está utilizando, puede seleccionarla en la opción «Elegir placa específica». En nuestro caso, como tenemos una placa NodeMCU ESP8266, eso es lo que seleccionamos. Ahora, todo lo que tiene que hacer es pulsar «siguiente» y ¡su primera configuración ESPHome se creará para usted!

Si quisiera, podría instalar esta configuración en el dispositivo ESP que ha conectado a su Raspberry Pi u otra máquina. Sin embargo, su dispositivo inteligente no hará nada si instala esta configuración actual. Así que vamos a pulsar «Saltar» por ahora y establecer nuestra configuración Wi-Fi.

Ahora que estamos en la página de ESPHome con nuestra configuración «temperatura-luz», vamos a ver una de las características importantes de ESPHome.

Cuando cree su primer dispositivo domótico con ESPHome, lo más probable es que quiera conectar su dispositivo a su red Wi-Fi local. Para ello,si desea conectarse a su red Wi-Fi, necesitará 2 cosas: El nombre de la red Wi-Fi y la contraseña. Podría añadir la contraseña de su red local en la configuración, pero eso no es una buena idea por 2 razones:

  • Se supone que tu contraseña es secreta.
  • Va a reutilizar esta contraseña para muchas configuraciones y ¿qué pasa si cambias su contraseña Wi-Fi? Tendrás que cambiar cada archivo de configuración a mano.

¡Así que pongamos esta contraseña Wi-Fi en los secretos!, En la esquina superior derecha de la página ESPHome, verá un sección de «Secretos». Cuando lo pulse, aparecerá una ventana emergente con el título «secrets.yaml«.

Vamos a añadir nuestro punto de acceso Wi-Fi y la contraseña Wi-Fi en este archivo:

## Your Wi-Fi SSID and password wifi
ssid: "MyWiFiAccessPointName"
wifi_password: "MyWiFiPassword"

Después de introducir sus datos, puede pulsar «Guardar» en la parte inferior de la ventana emergente.

Escribir la configuración

Ya hemos configurado nuestros secretos Wi-Fi, así que ahora podemos editar la configuración de nuestro flamante dispositivo domótico. Vamos a editar la configuración de nuestro dispositivo haciendo clic en «editar«:

Ahora será recibido con el único «código» que está involucrado en todo este proceso. Este es el archivo de configuración para su dispositivo ESPHome.

Es posible que ya vea los secretos Wi-Fi que se aplican en la configuración, pero si no, puede establecer estos ahora:

wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password

Anteriormente, hemos conectado dos «sensores» a nuestro dispositivo ESP:

  • Un sensor DHT11 en el pin GPIO D5
  • Un relé en GPIO pin D8

Para que estos dispositivos sean manejables a través de ESPHome, tendremos que configurar los sensores en este archivo de configuración. Esto suena complicado, pero casi todo el trabajo ya se ha hecho antes por los colaboradores del proyecto ESPHome. Todo lo que tenemos que hacer es encontrar la configuración correcta en esphome.io. Abrir esphome.org en una nueva pestaña y seguir adelante. 

En el sitio web, usted encontrará una gran cantidad de configuración, que es abrumador al principio pero se aprendea navegar por ella con bastante rapidez.

Vamos a utilizar la barra de búsqueda en la esquina superior izquierda para buscar «DHT»:

Nos aparecerán los resultados de la búsqueda del sensor adecuado:

Cuando se desplace por esta página, verá un ejemplo de la configuración utilizada:

Vamos a copiar/pegar esta configuración en nuestro dispositivo ESPHome. Cambiemos el pin a «D5», renombremos el nombre de la temperatura a «Light temperature«, y renombremos el nombre de la humedad a «Light Humidity». Vamos a mantener el update_interval en 60s, por lo que nuestro dispositivo comprobará cada 60 segundos los cambios en la temperatura o la humedad. Si quiere comprobarlo con menos frecuencia, por ejemplo cada 10 minutos, puede cambiarlo a 600s. Esta es la configuración que tenemos en ESPHome para el sensor ahora:

sensor:
- platform: dht
pin: D5
temperature:
name: "Light temperature"
humidity:
name: "Light Humidity"
update_interval: 60s

Ya hemos configurado nuestro primer sensor domótico. Sigamos los mismos pasos para el relé y veamos la configuración final de nuestro dispositivo:

esphome:
name: temperature-light
esp8266:
board: nodemcuv2
Enable logging
logger:
Enable Home Assistant API
api:
ota:
password: "auto-generated-password-goes-here"
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
# Enable fallback hotspot (captive portal) in case wifi connection fails
ap:
ssid: "Temperature-Light"
password: "auto-generated-ap-password-goes-here"
captive_portal:
switch:
platform: gpio
pin:
number: D8
inverted: true
name: "Relay"
icon: "mdi:lightbulb-on-outline"
sensor:
platform: dht
pin: D5
temperature:
name: "Light temperature"
humidity:
name: "Light Humidity"
update_interval: 60s

Flashea tu dispositivo ESP con tu configuración ESPHome

¡Vamos a flashear el dispositivo ESP con la configuración que hemos creado! La primera vez que hacemos esto, tenemos que conectarlo al ordenador en el que ha instalado ESPHome. En este ejemplo como el servidor sería la Raspberry Pi que está ejecutando Home Assistant, necesitaremos usar un cable micro-USB para esto.

Ahora que el dispositivo está conectado al ordenador que ejecuta ESPHome, podemos flashear el dispositivo a través de la interfaz ESPHome. En la página de ESPHome, vemos tres puntos uno encima del otro en nuestra configuración. Pulse estos puntos y seleccione «Instalar«.

Aparecerá una nueva ventana emergente que te preguntará cómo quiere instalar su nuevo dispositivo.

Seleccione «Conectar al ordenador que ejecuta ESPHome Dashboard«. Ahora podrá seleccionar su dispositivo de la lista de dispositivos USB conectados:

Cuando seleccione el dispositivo USB correcto, ESPHome comenzará a instalar su nuevo dispositivo domótico: Esto llevará un rato la primera vez, así que haga otra cosa durante un rato. La próxima vez que realice este proceso, será mucho más rápido, pero ESPHome se está instalando ahora en su dispositivo ESP, por lo que es bastante lento.

Después de un rato, aparece el mensaje: «setup() finalizó con éxito». El dispositivo se ha instalado y puede pulsar «Detener» en la parte inferior de la ventana emergente.

Ahora notarás que el estado del dispositivo ha cambiado de «offline» a «online«.

La parte de hardware de este proceso ya está completa. Lo único que le queda por hacer es integrar su nuevo dispositivo domótico en el Asistente Domótico.

Añadir el dispositivo ESPHome al Asistente Doméstico

¡La parte más difícil de este proceso ya se ha completado! ¡Ha configurado e instalado su primer dispositivo domótico con ESPHome!

Vamos a añadirlo al Asistente Domótico, para que podamos utilizar la interfaz agradable para interactuar con nuestro nuevo dispositivo. Naveguemos hasta:Home assistant dashboard → Configuration → Integrations

En la página de integraciones, ya verá que se descubre nuestro nuevo dispositivo ESPHome:

Configuremos este dispositivo auto descubierto pulsando en «Configurar». La ventana emergente le preguntará si quiere añadir el nuevo dispositivo al Asistente Doméstico. Todo lo que tiene que hacer es pulsar «Enviar«. El Asistente Domiciliario se conectará ahora a su dispositivo domótico y registrará los sensores.

Una vez que se haya conectado a su dispositivo y configurado los sensores, se le preguntará en qué área se encuentra este dispositivo. Puedes seleccionar la zona adecuada y pulsar «Finalizar«.

Su dispositivo domótico se ha añadido al Asistente Domótico, lo que significa que puede crear interruptores virtuales en el panel del Asistente Domótico, veamos ahora cómo hacerlo.

Navegue hasta la página «Visión general» y vaya a «Editar panel de control«. Ahora puede añadir una nueva tarjeta a su panel de control:

Puede elegir cuál le gustaría añadir, pero le sugerimos «Entidades«, para que pueda añadir todos los sensores del nuevo dispositivo domótico al salpicadero en 1 tarjeta.

Seleccione las entidades adecuadas para la tarjeta como se indica a continuación.

Si ha utilizado la misma configuración que hemos visto hasta ahora, los nombres de sus entidades serán:

  • sensor.light_temperature
  • sensor.light_humidity
  • switch.relay

Dele a su tarjeta un nombre reconocible y pulsa «Guardar«.

Ahora habrá añadido una representación de su nuevo dispositivo domótico en el Asistente Domótico. Verá que el relé ha reconocido automáticamente que puede encenderse y apagarse, por lo que ha creado un bonito interruptor que puede probar si funciona como esperaba encendiendo y apagando el interruptor.

¡Enhorabuena! Ya has añadido tu primer dispositivo domótico al Asistente Domótico utilizando ESPHome. Puedes utilizar los datos de los sensores para crear automatizaciones, o simplemente dejarlos como están ahora en tu panel de control.

Fuente https://www.espforbeginners.com/guides/how-to-install-basic-esphome-home-assistant/

Instalación de Home Assistant desde cero en Raspberry Pi


Home Assistant es una plataforma de automatización del hogar de código abierto que te permite controlar y monitorear dispositivos y servicios en tu hogar. Esta diseñado para funcionar como un concentrador central para la gestión de la domótica, lo que permite integrar una variedad de dispositivos y sistemas en una única interfaz.

Algunas de las características clave de Home Assistant incluyen:

  1. Integración de Dispositivos: Home Assistant es compatible con una amplia gama de dispositivos y tecnologías de automatización del hogar, como luces inteligentes, termostatos, cerraduras, cámaras de seguridad, sensores, entre otros. Puede integrar dispositivos de diferentes fabricantes y protocolos.
  2. Automatización y Escenas: Puede crear automatizaciones personalizadas para que los dispositivos interactúen entre sí en respuesta a ciertos eventos o condiciones. También puede configurar escenas para controlar varios dispositivos con un solo comando.
  3. Control Remoto: Puede acceder a Home Assistant de forma remota a través de una interfaz web o utilizando aplicaciones móviles, lo que permite controlar y monitorear su hogar desde cualquier lugar.
  4. Soporte para Plataformas de Voz: Home Assistant es compatible con plataformas de voz como Amazon Alexa y Google Assistant, lo que permite controlar tus dispositivos usando comandos de voz.
  5. Personalización y Extensibilidad: La plataforma es altamente personalizable y extensible. Puede crear paneles de control personalizados, utilizar temas y agregar componentes adicionales según sus necesidades.
  6. Seguridad: Home Assistant ofrece características de seguridad, como la posibilidad de habilitar la autenticación de dos factores y utilizar conexiones seguras a través de HTTPS.

Home Assistant se ejecuta en una variedad de plataformas, incluyendo Raspberry Pi, servidores Linux, contenedores Docker y más siendo una opción popular para aquellos que desean tener un control centralizado sobre sus dispositivos domésticos inteligentes y desean evitar depender de plataformas propietarias. Además, al ser de código abierto, la comunidad de usuarios contribuye al desarrollo y mejora continua de la plataforma.

Instalar Home Assistant en una Raspberry Pi es una de las opciones mas populares y viablse para muchos usuarios, especialmente aquellos que están buscando una solución de automatización del hogar de bajo costo y energéticamente eficiente. Aquí hay algunas consideraciones:

  1. Bajo Costo: Las Raspberry Pi son dispositivos de bajo costo, lo que hace que sea accesible para una amplia gama de usuarios.
  2. Consumo de Energía: Las Raspberry Pi tienen un bajo consumo de energía en comparación con computadoras más grandes. Esto las hace ideales para estar siempre encendidas y actuar como un concentrador de automatización del hogar.
  3. Soporte Oficial: Home Assistant ofrece soporte oficial para instalar la plataforma en una Raspberry Pi, lo que facilita la configuración.
  4. Comunidad Activa: Dada la popularidad de las Raspberry Pi y Home Assistant, encontrarás una comunidad activa que puede proporcionar soporte y compartir experiencias.

Sin embargo, hay algunas consideraciones que debe tener en cuenta:

  1. Recursos Limitados: Las Raspberry Pi tienen recursos limitados en términos de potencia de procesamiento, RAM y almacenamiento. Si planea integrar muchos dispositivos o usar complejas automatizaciones, podría alcanzar los límites de rendimiento de la Raspberry Pi.
  2. Almacenamiento SD: Las Raspberry Pi generalmente utilizan tarjetas SD para almacenamiento. Las tarjetas SD pueden desgastarse con el tiempo debido a la escritura constante de datos, por lo que es posible que desees considerar opciones para mitigar este desgaste, como utilizar tarjetas de alta calidad o configurar la plataforma para minimizar la escritura en la tarjeta.
  3. Evaluación de Requisitos: Antes de decidirse por una Raspberry Pi, evalúe sus necesidades específicas. Si tiene una gran cantidad de dispositivos o si planea ejecutar aplicaciones adicionales junto con Home Assistant, podría necesitar una plataforma más potente ( por ejemplo un minipc).

En general, instalar Home Assistant en una Raspberry Pi es una excelente opción para muchos usuarios, especialmente aquellos que están comenzando con la automatización del hogar y desean una solución asequible y fácil de configurar. Sin embargo, tenga en cuenta las limitaciones de recursos y asegúrese de que se adapte a sus necesidades específicas.

Esta guía muestra cómo instalar el sistema operativo Home Assistant en su Raspberry Pi usando Raspberry Pi Imager , por línea de comando o mediante un contenedor. Si su plataforma no admite Raspberry Pi Imager también es posible porque puede utilizar Balena Etcher en su lugar (es el ultimo método que describimos al final de este post).

Photo by Frank Cone on Pexels.com

METODO 1:ESCRIBIR LA IMAGEN EN SU TARJETA SD.

Sin duda es el método mas sencillo de realizar porque básicamente vamos a instalar una imagen de Raspbian con todo instalado y solo tendremos que personalizar los aspectos mas generales. Estos son los pasos a seguir:

  1. Descargue e instale Raspberry Pi Imager en su ordenador como se describe en https://www.raspberrypi.com/software/ .Instalar el generador de imágenes Raspberry Pi
  2. Abra Raspberry Pi Imager y seleccione su dispositivo Raspberry Pi.Abra el generador de imágenes Raspberry Pi
  3. Elija el sistema operativo:
    1. Seleccione Elegir sistema operativo .
    2. Seleccione Otro SO específico > Asistentes del hogar y domótica > Home Assistant .
    3. Elija el sistema operativo Home Assistant que coincida con su hardware (RPi 3 o RPi 4).Elige el sistema operativo
  4. Elija el almacenamiento:
    1. Inserte la tarjeta SD en la computadora. Nota: se sobrescribirá el contenido de la tarjeta.
    2. Selecciona tu tarjeta SD.Seleccione el almacenamiento
  5. Escriba el instalador en la tarjeta SD:
    1. Para iniciar el proceso, seleccione Siguiente .
    2. Espere a que el sistema operativo Home Assistant se escriba en la tarjeta SD.Seleccione escribir
  6. Expulse la tarjeta SD.

INICIE SU RASPBERRY PI

  1. Inserte la tarjeta SD en tu Raspberry Pi.
  2. Conecte un cable Ethernet y asegúrese de que la Raspberry Pi esté conectada a la misma red que su computadora.
  3. Conecte la fuente de alimentación para iniciar el dispositivo.

ACCEDER AL ASISTENTE DE INICIO

Unos minutos después de conectar la Raspberry Pi, podrá comunicarse con su nuevo Home Assistant.

  • En el navegador de su sistema de escritorio, ingrese homeassistant.local:8123 .Si está ejecutando una versión anterior de Windows o tiene una configuración de red más estricta, es posible que necesite acceder a Home Assistant en homeassistant:8123 o `http://XXXX:8123` (reemplace XXXX con la dirección IP de su Raspberry Pi).
  • El tiempo que tarda esta página en estar disponible depende de su hardware. En una Raspberry Pi 4, esta página debería estar disponible en un minuto.
    • Si no aparece después de 5 minutos en un Pi 4, tal vez la imagen no se escribió correctamente.
      • Intente actualizar la tarjeta SD nuevamente, posiblemente incluso pruebe con una tarjeta SD diferente.
    • Si esto no ayuda, vea la salida de la consola en Raspberry Pi.
      • Para hacer esto, conecte un monitor a través de HDMI.

¡Felicidades! ¡Terminaste la configuración de Raspberry Pi!

METODO 2:Instalar el núcleo de Home Assistant con linea de comandos

Este es un proceso de instalación avanzado y algunos pasos pueden diferir en su sistema. Teniendo en cuenta la naturaleza de este tipo de instalación, asumimos que puede manejar diferencias sutiles entre este documento y la configuración del sistema que está utilizando. En caso de duda, considere uno de los otros métodos de instalación , ya que podrían ser más adecuados.

Requisitos previos

Esta guía asume que ya tiene un sistema operativo configurado y ha instalado Python 3.11 (incluido el paquete python3-dev) o una versión más reciente.

Para instalar Python 3.11 en su Raspberry Pi, hay varias formas de hacerlo. Aquí hay una forma de hacerlo:

  1. Abra la terminal en su Raspberry Pi.
  2. Escriba el siguiente comando en la terminal: sudo apt-get update
  3. Escriba el siguiente comando en la terminal: sudo apt-get install software-properties-common
  4. Escriba el siguiente comando en la terminal: sudo add-apt-repository ppa:deadsnakes/ppa
  5. Escriba el siguiente comando en la terminal: sudo apt-get update
  6. Escriba el siguiente comando en la terminal: sudo apt-get install python3.11

Esto debería instalar Python 3.11 en su Raspberry Pi. Si tiene algún problema, asegúrese de que su Raspberry Pi esté conectada a Internet y que los comandos se hayan escrito correctamente.

También puede descargar Python 3.11 desde el sitio web oficial de Python y compilarlo desde la fuente. Sin embargo, esta es una opción más avanzada y no se recomienda para principiantes.

INSTALAR DEPENDENCIAS

Antes de comenzar, asegúrese de que su sistema esté completamente actualizado, todos los paquetes de esta guía están instalados con apt, si su sistema operativo no lo tiene, busque alternativas.

sudo apt-get update
sudo apt-get upgrade -y

Instale las dependencias:

sudo apt-get install -y python3 python3-dev python3-venv python3-pip bluez libffi-dev libssl-dev libjpeg-dev zlib1g-dev autoconf build-essential libopenjp2-7 libtiff6 libturbojpeg0-dev tzdata ffmpeg liblapack3 liblapack-dev libatlas-base-dev

Las dependencias mencionadas anteriormente pueden diferir o faltar, según su sistema o el uso personal de Home Assistant.

CREAR UNA CUENTA

Agregue una cuenta para Home Assistant Core llamada homeassistant. Dado que esta cuenta es solo para ejecutar Home Assistant Core, se agregan argumentos adicionales -rm para crear una cuenta del sistema y crear un directorio de inicio. Los argumentos -G dialout,gpio,i2cagregan al usuario al dialoutgpioal i2cgrupo. El primero es necesario para utilizar controladores Z-Wave y Zigbee, mientras que el segundo es necesario para comunicarse con GPIO.

sudo useradd -rm homeassistant -G dialout,gpio,i2c

CREAR EL ENTORNO VIRTUAL

Primero crearemos un directorio para la instalación de Home Assistant Core y cambiaremos el propietario de la homeassistantcuenta.

sudo mkdir /srv/homeassistant
sudo chown homeassistant:homeassistant /srv/homeassistant

El siguiente paso es crear y cambiar a un entorno virtual para Home Assistant Core. Esto se hará con la cuenta homeassistant.

sudo -u homeassistant -H -s
cd /srv/homeassistant
python3 -m venv .
source bin/activate

Una vez que haya activado el entorno virtual (observe que el mensaje cambia a (homeassistant) homeassistant@raspberrypi:/srv/homeassistant $), deberá ejecutar el siguiente comando para instalar un paquete de Python requerido.

python3 -m pip install wheel

Una vez que haya instalado el paquete Python requerido, ¡es el momento de instalar Home Assistant Core!

pip3 install homeassistant==2023.11.3

Inicie Home Assistant Core por primera vez. Esto completará la instalación por usted, creará automáticamente el .homeassistantdirectorio de configuración en el /home/homeassistantdirectorio e instalará las dependencias básicas.

hass

Ahora puede acceder a su instalación a través de la interfaz web en http://homeassistant.local:8123.

Si esta dirección no funciona, también puede probar http://localhost:8123http://X.X.X.X:8123(reemplace XXXX con la dirección IP de su máquina).

Cuando ejecute el comando hass por primera vez, descargará, instalará y almacenará en caché las bibliotecas/dependencias necesarias. Este procedimiento puede tardar entre 5 y 10 minutos. Durante ese tiempo, es posible que reciba un error de «no se puede acceder al sitio» al acceder a la interfaz web. Esto sólo sucederá la primera vez. Los reinicios posteriores serán mucho más rápidos.

SSH remoto

Ciertamente todos los comandos comentados lo podemos ejecutar r desde la consola de Raspberry pi con un teclado, monitor y ratón , pero seguramente desde un ordenador convencional será mucho mas fácil, para ello desde W11, puede usar SSH. Hay varias formas de hacerlo, pero aquí hay una forma de hacerlo:

  1. Asegúrese de que su Raspberry Pi esté conectada a la misma red que su computadora.
  2. Abra PowerShell en su computadora presionando Ctrl + Shift + P.
  3. Escriba el siguiente comando en PowerShell: ssh [nombre de usuario]@[dirección IP de Raspberry Pi].
  4. Reemplace [nombre de usuario] con el nombre de usuario de su Raspberry Pi y [dirección IP de Raspberry Pi] con la dirección IP de su Raspberry Pi.
  5. Presione Enter y escriba la contraseña de su Raspberry Pi cuando se le solicite.

Si no ha habilitado SSH en su Raspberry Pi, deberá hacerlo primero.

Recuerde por cierto que para obtener la dirección IP de su Raspberry puede usar el comando ifconfig.

METODO 3:INSTALACIÓN CON DOCKER

Este método rivaliza con el método inicial pues la instalación con Docker es sencilla. Estos son los pasos a realizar:

En primer lugar ajuste el siguiente comando para que:

  • /PATH_TO_YOUR_CONFIGapunta a la carpeta donde desea almacenar su configuración y ejecutarla. Asegúrate de conservar la :/configpieza.
  • MY_TIME_ZONEes un nombre de base de datos tz , como TZ=America/Los_Angeles.
  • D-Bus es opcional pero necesario si planea utilizar la integración Bluetooth

Una vez que el contenedor de Home Assistant se esté ejecutando, se debería poder acceder a Home Assistant usando http://<host>:8123(reemplazar con el nombre de host o IP del sistema). Puede continuar con la incorporación.

REINICIAR EL ASISTENTE DE INICIO

Si cambia la configuración, debe reiniciar el servidor. Para hacerlo tienes 3 opciones.

  1. En la interfaz de usuario de Home Assistant, vaya a Configuración > Sistema y haga clic en el botón Reiniciar .
  2. Puede ir a Herramientas de desarrollador > Servicios , seleccionar el servicio homeassistant.restarty seleccionar Llamar al servicio .
  3. Reinícielo desde una terminal.

DOCKER COMPOSER

docker composeya debería estar instalado en su sistema. De lo contrario, puede instalarlo manualmente .

A medida que el comando Docker se vuelve más complejo, docker composepuede ser preferible cambiar a y admitir el reinicio automático en caso de falla o reinicio del sistema. Cree un archivo compose.yml:

version: '3'
services:
  homeassistant:
    container_name: homeassistant
    image: "ghcr.io/home-assistant/home-assistant:stable"
    volumes:
      - /PATH_TO_YOUR_CONFIG:/config
      - /etc/localtime:/etc/localtime:ro
      - /run/dbus:/run/dbus:ro
    restart: unless-stopped
    privileged: true
    network_mode: host

Inícielo ejecutando:

docker compose up -d

Una vez que el contenedor Home Assistant se esté ejecutando, se debería poder acceder a Home Assistant usando http://<host>:8123(reemplazar con el nombre de host o IP del sistema). Puede continuar con la incorporación.

DISPOSITIVOS DE EXPOSICIÓN

Para utilizar Zigbee u otras integraciones que requieran acceso a dispositivos, debe asignar el dispositivo apropiado al contenedor. Asegúrese de que el usuario que ejecuta el contenedor tenga los privilegios correctos para acceder al /dev/tty*archivo, luego agregue la asignación del dispositivo a las instrucciones de su contenedor:CLI de ventana acoplableComposición acoplable

docker run ... --device /dev/ttyUSB0:/dev/ttyUSB0 ...

OPTIMIZACIONES

Home Assistant Container utiliza una biblioteca de asignación de memoria alternativa, jemalloc, para una mejor administración de la memoria y acelerar el tiempo de ejecución de Python.

Como jemalloc puede causar problemas en cierto hardware, se puede desactivar pasando la variable de entorno DISABLE_JEMALLOCcon cualquier valor, por ejemplo:

El mensaje de error <jemalloc>: Unsupported system page sizees un indicador conocido.

METODO 4:Escribiendo la imagen con Balena Etcher

Por ultimo ,utilice este procedimiento si su plataforma no admite Raspberry Pi Imager.

  1. Inserte la tarjeta SD en la computadora. Nota: se sobrescribirá el contenido de la tarjeta.
  2. Descargue e inicie Balena Etcher . Es posible que necesite ejecutarlo con privilegios de administrador en Windows.
  3. Descargue la imagen a su ordenador.
    • Copie la URL correcta para Raspberry Pi 3 o 4 (Nota: ¡hay 2 enlaces diferentes a continuación!):
https://github.com/home-assistant/operating-system/releases/download/11.1/haos_rpi4-64-11.1.img.xz

Seleccione y copie la URL o use el botón «copiar» que aparece cuando pasa el cursor sobre ella.

  1. Pegue la URL en tu navegador para iniciar la descarga.
  2. Seleccione Flash del archivo y seleccione la imagen que acaba de descargar.
    • Flash desde URL no funciona en algunos sistemas.

6. Seleccione el objetivo

 Captura de pantalla del software Etcher que muestra el botón de selección de destino resaltado.

7. Seleccione la tarjeta SD que desea utilizar para su instalación. Captura de pantalla del software Etcher que muestra los objetivos disponibles.

8. Seleccione ¡Flash! para empezar a escribir la imagen. Captura de pantalla del software Etcher que muestra el botón Flash resaltado.

9. Una vez que Balena Etcher haya terminado de escribir la imagen, verá una confirmación.Captura de pantalla del software Etcher que muestra que la instalación se ha completado.

Mas información en https://www.home-assistant.io/installation/raspberrypi/