Instalando MyOpenHAB (OpenHAB Cloud Service)

Prerrequisitos:

Este tutorial esta basado en una imagen ubuntu-20.04.2.0-desktop-amd64.iso

Antes que nada, debemos actualizar nuestro sistema utilizando los comandos:

sudo apt-get update

sudo apt-get upgrade

Asimismo debemos establecer el nombre del host:

sudo hostname myopenhab.tudominio.es

Procedemos con la instalación del Docker y el Docker-Compose

————————————-

Documentación relacionada:

https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository
https://docs.docker.com/compose/install/ → Linux

————————————-

Instalación del Docker

Añadimos la clave GPG oficial de Docker:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg –dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Utilice el siguiente comando para configurar el repositorio estable

echo \

“deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \

$(lsb_release -cs) stable” | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Actualizamos nuevamente el APT:

sudo apt-get update

Y procedemos a instalar la última versión de Docker Engine y containerd:

sudo apt-get install docker-ce docker-ce-cli containerd.

Y verificamos la versión instalada

docker –version

Para poder ejecutar Docker en caso de no ser root, añadimos el usuario al grupo “docker”

sudo usermod -aG docker $USER + +Y creamos en nuevo grupo “docker”

newgrp docker

Procedemos a ejecutar una imagen de prueba para validar si Docker-Engine esta instalado y funcionando correctamente:

docker run hello-world

Instalación del Docker-Compose

Se ejecuta el comando para descagar la ultima versión del Docker-Compose:

sudo curl -L “https://github.com/docker/compose/releases/download/1.29.0/docker-compose-$(uname -s)-$(uname -m)” -o /usr/local/bin/docker-composse

Aplicamos los permisos ejecutables al binario:

sudo chmod +x /usr/local/bin/docker-compose

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Se comprueba la instalación y versión del Docker-Compose:

docker-compose –version

*Instalación del OpenHAB Cloud Service

Vamos a la ruta en la que queramos instalarlo desde GIT:

cd /home/ubuntu

Clonamos el directorio:

git clone https://github.com/openhab/openhab-cloud.git

Luego nos vamos a la ruta para configurar el OHCS en el Docker Compose:

cd /home/ubuntu/openhab-cloud/deployment/docker-compose

Guardamos una copia del fichero .env:

sudo cp .env .env.BAK

Asimismo creamos el fichero config.json desde la plantilla config.json.template

sudo cp config.json.template config.json

Y editamos ambos archivos según los ajustes que necesitemos:

sudo nano .env // Cambiar todos los campos

sudo nano config.json  //Cambiar “registration_enabled” a true para la inicialización (volver a false al registrarse)

Editar el “docker-compose.yml”:

sudo nano docker-compose.yml

Añadir esto (vvv) debajo de la línea que empieza con ./config.json.template

– ./config.json:/opt/openhabcloud/config.json

Continuar editando el “docker-compose.yml”: +

y copiar (por la indexación) esta (vvv) línea (que está en otras secciones) al final de la sección “traefik:”:

+#     restart: always

Extrae una imagen asociada con un servicio definido en el fichero docker-compose.yml, es decir, ejecutamos lo que esta en este fichero:

sudo docker-compose pull

Iniciamos la imagen recientemente creada:

sudo docker-compose up -d

Vemos los archivos de logs de ejecución de esta imagen:

sudo docker-compose logs -f app

En este punto ya podemos ir a nuestro Dominio y ver que se ejecuta perfectamente:

Conectando OpenHAB a TTNv2

Antes de empezar, el nodo debe estar ya funcionando en TTN:

1. Vamos al Panel de Administración de OpenHAB -> Things

+Una vez instalado, nuevamente vamos a “Things” y damos click en “MQTT Binding”

+Luego, antes de añadir el dispositivo (nodo) como tal, debemos crear el puente entre OpenHAB y TTN, seleccionamos “MQTT Broker”

+Debemos ingresar los datos correspondientes a la conexión con TTNv2:

+Habilitar “Secure Connection” para usar una conexión segura

En “Username” debe ir “Application ID” en TTNv2

+Habilitar “Show advanced” para que nos muestre todas la opciones:

En “Broker Hostname/IP” deberá ir la url de TTNv2 genérica

En “Broker Port” podemos dejarlo en blanco

En “Password” debe ir “Access Keys” en TTNv2

Debemos deshabilitar las siguientes opciones para que se pueda conectar a TTN sin ningún problema:

+Si todo ha salido bien debería mostrar la conexión ONLINE

+Creado el “MQTT Broker”, procedemos a crear otro “Thing” pero en este caso será de tipo “Generic MQTT Thing” que será realmente el dispositivo (nodo) en cuestión:

+En Parent Bridge, deberemos seleccionar el puente MQTT que acabamos de crear:

Al finalizar, debería mostrarnos en Status como ONLINE

+Creado el “Thing”, debemos crear los respectivos “Channels”, aquí es donde obtendremos realmente información del nodo.

Debemos tener en cuenta, en que formato vamos a recibir la información del nodo, para así saber que tipo de canal usar.

+Creado el “MQTT StateTopic”, debemos ingresar lo siguiente.

+Luego de creado en canal, debemos asociarlo a un “Item” que es aquel que nos mostrara el dato especifico que queremos ver de toda la información que nos envía el dispositivo (nodo)

+Cumplimentamos los campos requeridos en función de lo que necesitamos:

+Debemos tener en cuenta el tipo de dato que tendrá como resultado este “Item”

+Es posible asignarle una categoría en función del dato o información especifica que se va a obtener:

Asimismo, debemos asignarle una clase semántica y su propiedad, si aplica:

+Uno de los puntos mas importante en que caso de que utilicemos un dispositivo (nodo) que envia mucha información en un JSON, es filtrar según su propio contexto (payload) para que nos muestre solo ese dato especifico:

+En este caso solo necesitamos, “filtrar” o “extraer el valor que se encuentra en el campo “batV”, que es el Voltaje de la batería. Para lo que entonces debemos utilizar el JSONPATH y decirle que nos muestre el valor que solo este campo nos da:

JSONPath Expression:

$.payload_fields.batV

+Hecho lo anterior, podemos ver que efectivamente nos muestra el valor correspondiente:

Conectando OpenHAB a myopenhab.org

Para poder recibir notificaciones push en nuestra app de OpenHAB de nuestro móvil así como de disponer de algunas funciones básicas, es necesario configurar el conector de nube openhab que conecta nuestro servidor local a los servidores en la nube de myopenhab.org.

Esto nos permite adicionalmente controlar de forma remota nuestros dispositivos domóticos. Por ejemplo, después de hacer esto, puede encender un interruptor en casa desde cualquier lugar del mundo siempre que tenga una conexión a Internet. Además, cuando configuremos el acceso al servidor de automatización desde el móvil, podremos recibir notificaciones como si los rociadores están encendidos o la puerta está abierta. (estableciendo las reglas correspondientes)

1. Lo primero que tenemos que hacer es acceder a la interfaz de usuario web e ir a la interfaz paper-UI

2. Luego vaya a la pestaña de complementos en la columna de la izquierda. En la barra de navegación superior, vaya a misc.

3. Busque “openHAB Cloud Connector” y presione instalar.

4. Una vez que esté instalado en la columna de navegación de la izquierda, vaya a configuración y luego a la subpestaña de servicios. En el cuadro de openHAB Cloud, haga clic en configurar.

5. En el campo de modo, haga clic en el menú desplegable y seleccione Notificaciones y acceso remoto.

6. En el campo URL base, escriba https://myopenhab.org/ y haga clic en guardar.

7. Ahora vaya a esta URL https://myopenhab.org/login y escriba una dirección de correo electrónico y una contraseña de su elección, esto se conocerá como la cuenta administrador en myopenhab.

8. Puede notar que hay otros dos campos, el campo UUID y el campo secreto, así que vamos a buscarlos. Abra su cliente SSH:

9. Escriba sudo nano / var / lib / openhab2 / uuid y presione enter.

10. Debería abrir un archivo de texto, este es el UUID, así que cópielo y luego péguelo en el campo UUID.

11. Luego, regrese a la ventana ssh y presione control x para salir del documento de texto.

12. Ahora vamos a obtener el secreto, así que escriba sudo nano /var/lib/openhab/openhabcloud/secret y copie el texto del archivo de texto y péguelo en el campo secreto del navegador web.

13. Luego acepte las condiciones de uso y la política de privacidad y haga clic en registrarse.

14. Una vez que esté todo registrado en la página web, podría decir sin conexión en la parte superior derecha. Así que regrese a la ventana de ssh y escriba sudo reboot y presione enter. Su instancia o dispositivo debería reiniciarse.

15. Una vez que se haya reiniciado, actualice la página web myopenhab.org y ahora debería decir en línea.

Su OpenHAB ya esta conectado a myopenhab.org!!