Cómo integrar Mother Sense en eedomus

• En este tutorial explicamos cómo integrar Mother Sense en eedomus para disfrutar de sus interesantes y atípicas funcionalidades en un entorno Z-Wave.

En Domótica Doméstica os hemos hablado en múltiples ocasiones de Mother Sense, un controlador domótico atípico que permite hacer cosas atípicas y tan diversas como monitorizar el sueño, medir la temperatura ambiente, controlar la toma de medicamentos, saber en todo momento cuando los miembros de la familia están o no en casa, y muchas cosas más.

Hace unas semanas, os informamos de que la plataforma Sense había lanzado una API para su controlador Mother, lo que en teoría nos iba a permitir integrar Mother en otros sistemas domóticos, y especialmente en sistemas basados en Z-Wave.

Pues bien, ya podemos decir con gran satisfacción que hemos integrado nuestro Mother Sense en eedomus  y eso es precisamente lo que os vamos a explicar hoy en este nuevo artículo, con la esperanza de que les sirva no sólo a los usuarios de eedomus, sino a los de cualquier otro controlador que permita implementar llamadas http.

Creación de una cuenta de desarrollador en la plataforma Sense

Lo primero que debemos hacer para poder utilizar la API de Mother es darnos de alta como desarrollador. Si poseemos un controlador Mother, conseguiremos el alta en muy pocos días, solicitando el acceso en esta URL: https://sen.se/developers/

Si no somos usuarios registrados de Mother, también nos puede interesar darnos de alta como desarrollador, no para integrar Mother en otro sistema en ese caso, obviamente, sino porque no hay que olvidar que Sense es ante todo, mas allá de Mother, una plataforma integradora de objetos conectados cuyo fin es poder explotar desde un mismo entorno los datos recogidos por distintos dispositivos que tienen que ver con lo que se da en llamar el Internet de las Cosas.

Una vez que tengamos acceso a nuestra cuenta de desarrollador, nos iremos a la pestaña llamada “Documentación” (cuya lectura recomiendo para entender el funcionamiento de la API), para encontrar, en el apartado titulado “For Users”, el “User Name” que nos han asignado, así como nuestro “Password”, los cuales apuntaremos en un lugar seguro ya que los necesitaremos más adelante. Aprovecho para comentar que ese User Name es distinto al usuario que hemos creado al registrar nuestro controlador Mother. La contraseña, en cambio, es la misma para Mother que para la API.

Hecho lo anterior, pegaremos en nuestro navegador de Internet la siguiente URL: https://apis.sen.se/v2/nodes/?page=1  y nos identificaremos con el User Name y el Password conseguidos en el punto anterior.

Nada más identificarnos, tendremos acceso en pantalla a un archivo de intercambio de datos en formato JSON, llamado “Node List”, en el cual buscaremos en primer lugar el apartado reservado al “Cookie” de nuestro Mother que queramos integrar en nuestro controlador domótico.

Recuerdo que los “Cookies” son pequeños sensores polivalentes que transmiten todo tipo de información al controlador Mother. Cuando instalamos Mother, debemos dar de alta los distintos “Cookies” de los que disponemos y ponerles un nombre. No será complicado pues hacer una búsqueda en nuestro fichero “Node List” para encontrar el “Cookie” que estemos buscando.

En nuestro ejemplo de hoy, nuestro “Cookie” se llama “Cookie de Philippe” y tiene asignadas dos aplicaciones concretas en Mother: podómetro (Motion) y detección de presencia (Presence). Suponiendo que lo que nos interesa es integrar en nuestro controlador eedomus ese “Cookie” para determinar cuando una persona está en casa o fuera de ella, una vez encontrado el “Cookie” en cuestión en el fichero “Node List”, buscaremos la variable “Presence”.

En la línea del fichero llamada “url”, copiaremos la URL a partir de “apis” y hasta el final (en la imagen superior viene parcialmente tapada).

Integración del “Cookie” y la variable elegidos en eedomus

Una vez conseguida la URL que necesitamos, nos iremos al portal eedomus, nos identificaremos y crearemos un sensor http, para lo cual nos iremos a Configuración/Añadir o eliminar un periférico/Añadir otro tipo de periférico/HTTP – Sensor/Crear, y crearemos nuestro nuevo periférico como lo solemos hacer con cualquier módulo domótico, añadiendo los datos específicos que vamos a ver a continuación.

En el apartado 1 de la imagen superior, elegiremos un icono para nuestro nuevo periférico, le pondremos un nombre, lo asignaremos a una de las habitaciones de nuestra casa, etc., como hacemos con cualquier otro periférico.

En el apartado 2, indicaremos una URL con el siguiente formato (usaremos la URL conseguida en la primera parte de este tutorial, procedente de la APi de Mother, que completaremos como indicamos a continuación):

En rojo los datos que debemos adaptar a nuestro caso concreto y que hemos conseguido en el primer paso de este tutoríal.

En el apartado 3, pondremos exactamente lo siguiente: /root/objects/objects/data/code

En la casilla “Frecuencia de la petición”, nosotros hemos puesto 1 para que nuestro controlador eedomus consulte la API de Mother cada minuto, pero se puede variar esa frecuencia

Luego, desplegaremos los parámetros expertos de nuestro módulo sensor http, para ajustarlos como indicamos a continuación:

Aquí lo único imprescindible que debemos hacer es ticar la casilla “Convertir JSON a XML” ya que el fichero de la API de Mother que estamos consultando, como hemos visto anteriormente, es un fichero JSON que es necesario convertir a XML para que lo pueda leer correctamente eedomus.

Hecho lo anterior, sólo nos quedará crear los valores adecuados en nuestro sensor http, para lo cual pulsaremos primero en “Guardar y seguir editando” y luego en la pestaña “Valores”.

Dado que el “Cookie” que hemos elegido devolverá el valor 404 si su portador está ausente y 200 si está en casa, crearemos los siguientes valores, con el texto que queramos y los iconos que hayas elegido.

Ya está, hemos terminado. A partir de ese instante, nos será muy fácil crear escenas domóticas basadas en la presencia o ausencia en casa de distintos miembros de la familia. Por ejemplo, podríamos activar la alarma o apagar la calefacción si nuestra eedomus determina que no hay nadie en casa ya que no detecta ningún “Cookie” de Mother (en ese caso, lo mejor es colgar los “Cookies” a las llaves de cada miembro de la familia, en forma de llavero).

Hay que precisar que los “Cookies” transmiten la información que recogen a Mother cada X minutos (frecuencia de refresco comprendida entre 5 y 10 minutos según la aplicación de Mother de la que se trate). Por tanto, si integramos esa detección de presencia de Mother en un controlador domótico, puede pasar un período de tiempo de varios minutos entre el momento en que un miembro de la familia entra en casa y el momento en que nuestros controladores Mother y eedomus se enteran.

Quizá no debamos pues implementar escenas del tipo “enciende las luces de casa cuando llego”, ya que ese encendido de luces se podría demorar varios minutos. En cambio, parece un sistema ideal para activar escenas de forma automática cuando un miembro concreto de la familia o todos abandonan la casa (alarma, calefacción, apagado de luces, simulación de presencia, etc.).

Ni que decir tiene que podemos integrar en nuestro controlador eedomus no sólo esa funcionalidad de detección de presencia de Mother, sino todas las que ofrece, como la medición de temperatura, la apertura de puertas y muchas más. En próximos artículos explicaremos cómo hacerlo, siendo el proceso el mismo que el que acabamos de ver, pero cambiando las variables y los valores.

Si os interesa el controlador polivalente Mother, podéis adquirirlo con un importante descuento en la tienda online de nuestro partner domboo, pinchando en la siguiente imagen.