JGCBusing Manual de Usuario v1.0 Agosto 2012
Tabla de Contenido 1. Introducción... 3 2. JGCBusing. Herramienta Web... 4 2.1. Descripción... 4 2.2. Creación de una configuración desde cero... 8 2.3. Generación del fichero de configuración... 14 2.4. Acceso a configuraciones guardadas... 14 3. JGCBusing. Aplicación Móvil... 15 3.1. Primeros Pasos... 15 3.2. Pantallas de Zonas... 20 3.3. Tipos de Elementos Estáticos... 21 3.4. Tipos de Elementos Informativos... 22 3.5. Tipos de Elementos Operativos... 22 página 2 de 25
1. Introducción JGCBusing es una aplicación para el control de instalaciones que utilizan el protocolo Busing de Ingenium desde un dispositivo móvil de Android. Cada instalación es única. El tipo y número de elementos que se controlan varían de un proyecto a otro. Para facilitar la parametrización de cada instalación, se ha desplegado en el portal de Ingenium una herramienta web de configuración a través de la cual generar de una manera sencilla e intuitiva la configuración particular de cada instalación. Este documento incluye el manual de ambos entornos: la aplicación móvil para el control de la instalación y la herramienta web para su parametrización. La aplicación y por lo tanto, la herramienta que la configura se han desarrollado basándose en las siguientes premisas: Un dispositivo móvil tiene una pantalla de reducidas dimensiones por lo que se ha optado por agrupar los elementos domóticos en conjuntos denominados Zonas (una zona puede ser una habitación, un grupo de habitaciones, una zona como por ejemplo el exterior de la instalación o simplemente grupo de elementos del mismo tipo). Cada Zona estará identificada por un nombre y una imagen. En cada Zona se podrán incluir los Elementos que se quiera (iluminación, persianas, alarmas, sensores, ) Cada Elemento se identifica por un nombre, una imagen, una dirección (el identificativo único que tiene el elemento a controlar en la instalación de Ingenium) y unos datos de configuración que variarán dependiendo del tipo de elemento a controlar. Por lo tanto, la configuración de este entorno se basa en definir Zonas y Elementos asociados a cada Zona. Empezaremos por analizar la herramienta web ya que es la que permite definir la configuración que luego se aplicará en el móvil. página 3 de 25
2. JGCBusing. Herramienta Web Como se indicaba en la introducción, esta herramienta web permite crear el fichero de configuración que utilizará la aplicación móvil para identificar cada elemento de la instalación y poder controlarlo. El primer paso es acceder al portal de Ingenium y, una vez dentro, pulsar el enlace de la aplicación. Imagen 1. Vista de la herramienta 2.1. Descripción La aplicación se divide en cuatro bloques: Menú: Situado en la parte superior izquierda, el menú (Imagen 2) nos permite acceder a los comandos básicos: página 4 de 25
Imagen 2. Menú de la herramienta Comando para cargar un fichero de configuración previamente creado. La configuración que se genera se guardará en un fichero. Si más adelante se quiere realizar modificaciones, con esta opción se puede cargar de nuevo. Una vez finalizada la configuración, con este botón se genera el fichero de configuración. Este fichero se deberá copiar en la tarjeta de memoria del teléfono móvil para poder actualizar la configuración de la aplicación. En caso de que se quiera borra todo lo hecho y empezar de nuevo, con este botón se regresa a la situación inicial. Botón de ayuda. Muestra una pequeña ayuda de la herramienta. Dispone de un enlace a este PDF. Lista de Zonas: Situado en la parte izquierda, muestra las zonas definidas hasta el momento. Existe una Zona inicial que no se puede borrar que es la Principal. Esta zona se corresponde con la pantalla de inicio de la aplicación JGCBusing y en ella se incluyen los accesos al resto de zonas. Imagen 3. Lista de Zonas página 5 de 25
Contenido de la Zona: Bloque situado en la parte derecha que muestra los elementos que se han añadido en cada una de las zonas. Al seleccionar una zona concreta de la Lista de Zonas, en este bloque se muestra su contenido. En la Imagen 4 se puede ver un ejemplo del contenido de la zona Principal (con acceso a cada una de las zonas) y en la Imagen 5 el contenido de una zona concreta. Imagen 4. Contenido de la zona Principal Imagen 5. Contenido de una zona En la parte superior se muestra siempre el nombre de la zona y en la parte inferior un botón de Crear. Este botón permite crear una zona nueva si se ha seleccionado la zona Principal, o un elemento si se ha seleccionado cualquier otra zona. Imagen 4. Contenido de cada zona página 6 de 25
El Bloque Central. Cada vez que se crea o modifica una zona o un elemento, en este bloque se muestran los datos asociados. Dependiendo del objeto que se esté añadiendo (zona o elemento), los datos que se solicitan varían (Imagen 6 para crear una nueva zona; Imagen 7 para crear un nuevo elemento). Imagen 6. Creación de una nueva Zona Imagen 7. Creación de un elemento Ambas pantallas comparten los mismos botones: Botón para crear o modificar una zona o elemento Botón para eliminar una zona o elemento Los botones ocupan una posición en la pantalla. El botón de Subir permite situar el botón que está seleccionado más arriba en la pantalla. Los botones ocupan una posición en la pantalla. El botón de Bajar permite situar el botón que está seleccionado más abajo en la pantalla. En los siguientes apartados se mostrará cómo crear, modificar, eliminar y ordenar zonas y elementos. página 7 de 25
2.2. Creación de una configuración desde cero Conocido el interface de la herramienta vamos a ver paso a paso cómo se crearía una configuración para la aplicación JGCBusing. Como se puede observar en la Imagen 1, al arrancar la aplicación la única zona disponible es la Principal (donde irán los iconos de acceso al resto de zonas), luego el primer paso es crear las zonas en las que se quieren separar los elementos. Pulsando el botón de Crear, accedemos al formulario para crear una zona nueva (Imagen 7). Como se puede observar, cada zona está identificada por dos datos: Nombre: Texto que identifique a la zona. Hay que tener en cuenta que ese texto se muestra en la parte inferior del icono que se seleccione a continuación por lo que si el nombre es demasiado largo, se saldrá de su espacio. Icono: Existe una lista de iconos para representar los distintos espacios o zonas a definir. Seleccionar el más apropiado (Imagen 7). Imagen 7. Creación de una nueva Zona Una vez cumplimentados los datos de Nombre e Icono, pulsar el botón de Grabar para generar la nueva zona (Imagen 8). En nuestro caso hemos creado una zona denominada Exterior para incluir todos los elementos domóticos de la instalación que están en el exterior. página 8 de 25
Imagen 8. Creada la zona Exterior De esta misma manera se crearán todas las zonas que se desee. En caso de que se quiera modificar la posición de un icono (ordenar) o se quiera modificar los datos de una zona (el nombre o el icono), hacer click con el ratón sobre el icono de la zona a modificar (situado a la izquierda de la pantalla) y se mostrarán sus datos para poder modificarlos. Repitiendo estos pasos se crean cada una de las zonas que irán apareciendo en la Lista de Zonas situada a la izquierda. El paso siguiente es incluir en cada zona los elementos a controlar. Para acceder a la zona de cada pantalla hacer click en el botón relativo a la misma de la Lista de Zonas (Imagen 9). En la zona superior derecha de la herramienta se muestra el nombre de la zona que se está editando (en nuestro caso Exterior ). página 9 de 25
Imagen 9. Acceso a la zona Exterior Existen tres tipos de elementos: Estáticos: Son aquellos elementos que al pulsar sobre ellos ejecutan una acción pero que no están asociados a un elemento concreto y no se muestra información de su estado, por ejemplo la ejecución de una escena de una pantalla. Informativos: Son aquellos elementos que muestran información de su estado pero que no se puede interactuar con ellos (por ejemplo un sensor de inundación que muestra si está activado o no, o un sensor crepuscular que muestra la cantidad de luxes que está detectando en cada momento). Operativos: Son elementos que además de mostrar su estado, el usuario puede interactuar (por ejemplo una persiana que el usuario puede subir o bajar además de conocer su estado o una alarma que puede armar o desarmar). Para añadir un nuevo elemento pulsar sobre el botón de Crear. Al igual que ocurría cuando se creaba una zona, en la zona central se muestra el formulario (Imagen 10). En este caso el formulario tiene un conjunto de datos fijos y otro variable en función del tipo de elemento que se está definiendo. Datos comunes a todos los elementos: Nombre: Nombre que se mostrará en el botón asociado a ese elemento. Al igual que sucedía con los nombres de las zonas, el nombre del elemento se página 10 de 25
muestra dentro del icono del elemento así que su longitud no debe ser excesiva. Tipo: Este campo define el tipo de elemento que se quiere controlar. Icono: Icono representativo del elemento a controlar. Los iconos disponibles varían en función del tipo seleccionado. Imagen 10. Creando un nuevo elemento El resto de datos son variables en función del tipo seleccionado. A continuación se incluye una descripción de cada tipo y los datos a introducir. Tipos de Elementos Armado y desarmado Alarma: Elemento operativo asociado al armado y desarmado de la alarma. El único dato a introducir es la dirección de la centralita (habitualmente la 0). Alarma de intrusión: Elemento informativo asociado a la centralita que muestra si la alarma de intrusión está activada o no. El único dato a introducir es la dirección de la centralita (habitualmente la 0). página 11 de 25
Alarma de inundación: Elemento informativo asociado a la centralita que muestra si la alarma de inundación está activada o no (comprueba la salida 6 de la centralita que es la que se asocia por defecto a la alarma de inundación). El único dato a introducir es la dirección de la centralita (habitualmente la 0). Alarma de Incendio o Gas: Elemento informativo asociado a la centralita que muestra si la alarma de incendio o gas está activada o no (comprueba la salida 5 de la centralita que es la que se asocia por defecto a la alarma de inundación). El único dato a introducir es la dirección de la centralita (habitualmente la 0). Control de llamadas de intrusión: Elemento operativo para activar o desactivar las llamadas de la centralita cuando se produce una alarma de intrusión. El único dato a introducir es la dirección de la centralita (habitualmente la 37). Control de llamadas de inundación: Elemento operativo para activar o desactivar las llamadas de la centralita cuando se produce una alarma de inundación. El único dato a introducir es la dirección de la centralita (habitualmente la 37). Control de llamadas de incendio o gas: Elemento operativo para activar o desactivar las llamadas de la centralita cuando se produce una alarma de incendio o gas. El único dato a introducir es la dirección de la centralita (habitualmente la 37). Tomas de Fuerza: Elemento operativo para actuar sobre cualquier toma de fuerza (enchufes, portones motorizados, bombas, sistemas de riego, ). Hay que introducir los datos de dirección del equipo que controla esa toma y el número de salida. Iluminación: Elemento operativo para actuar sobre cualquier línea de iluminación. Hay que introducir los datos de dirección del equipo que controla esa toma y el número de salida. Iluminación regulada: Elemento operativo para actuar sobre cualquier línea de iluminación a la que se le permita regular la intensidad. Hay que introducir los datos de dirección del equipo que controla esa toma y el número de salida. Persiana: Elemento operativo para actuar sobre cualquier persiana, toldo, estor, motorizado. Hay que introducir los datos de dirección del equipo que controla esa toma y el número de salida (1, 3 o 5) y el tipo de equipo (equipo con 6 entradas y 6 salidas, equipo con 4 entradas y 4 salidas o equipo con 2 entradas y 2 salidas). Pantalla: Elemento operativo para acceder a escenas programadas en una pantalla. Hay que introducir la dirección del equipo y, a continuación las escenas que se quieren gestionar. Para introducir las escenas, pulsar sobre el botón. Se abrirá una ventana para introducir un nombre y un número de escena (número que se le asigna cuando se programa la pantalla). Se pueden añadir tantas escenas como se desee. Para eliminar una escena pulsar sobre el botón asociado a la misma. página 12 de 25
Sonda de intrusión: Elemento informativo asociado a un sensor de intrusión y que muestra si está activo o no. El único dato a introducir es la dirección de la sonda. Sonda de inundación: Elemento informativo asociado a un sensor de inundación y que muestra si está activo o no. El único dato a introducir es la dirección de la sonda. Sonda de Incendio o Gas: Elemento informativo asociado a un sensor de gas y que muestra si está activo o no. El único dato a introducir es la dirección de la sonda. Sensor crepuscular: Elemento informativo que muestra la cantidad de luxes detectados por el sensor crepuscular si está en modo umbral y el porcentaje de luz si está en modo lineal. El único dato a introducir es la dirección del sensor. Termostato: Elemento operativo para actuar sobre un termostato independiente o incluido en una pantalla. Con este elemento se puede consultar la temperatura actual y fijar la temperatura deseada. El único dato a introducir es la dirección del termostato o de la pantalla que lo incluye. Comando o escena: Elemento operativo completamente configurable indicado para integradores que conozcan el funcionamiento de los equipos y del protocolo. Puede ser asociado a cualquier tipo de elemento. Hay que introducir la dirección del equipo, dato1 y dato2 (los datos básicos para generar un paquete en el protocolo Busing). Vacío: Elemento especial que simplemente deja un hueco vacío en la pantalla. Se utiliza para ordenar el resto de elementos y dejar espacios vacíos donde se desee. No es necesario introducir ningún dato adicional. Una vez introducidos los datos, con el botón de Grabar se añade el elemento a la zona. Si se quiere modificar, borrar o reordenar, pulsar de nuevo sobre su icono para acceder a sus datos. página 13 de 25
Imagen 11. Elemento creado 2.3. Generación del fichero de configuración El último paso, una vez definidas las zonas y los elementos de cada zona, es generar el fichero de configuración de la aplicación. Con el botón se genera un nuevo fichero de configuración. Este fichero se copia en la tarjeta de memoria del teléfono. Los siguientes pasos se explican con detalle a continuación en el manual de la aplicación JGCBusing. 2.4. Acceso a configuraciones guardadas Las configuraciones que se van realizando se pueden guardar y más adelante volver a acceder a ellas para realizar las modificaciones que se necesiten. Basta con guardar el fichero generado tal y cual se explica en el punto anterior y cuando se necesite volver a ellas con el botón cargar el fichero de nuevo. página 14 de 25
3. JGCBusing. Aplicación Móvil Como se indicó en la introducción, la aplicación JGCBusing permite controlar una instalación domótica que utiliza el protocolo Busing desde cualquier parte del mundo utilizando la red Internet. Las características básicas de esta aplicación son: Multiplataforma. Funciona con cualquier dispositivo móvil que tenga como sistema operativo Android (versión 2.3 o superior) Multi-idioma. La versión actual (1.0) admite los idiomas Inglés y Español (la elección de uno u otro se hace automáticamente en función del idioma seleccionado para el móvil). Multi-instalación: Simplemente seleccionando el fichero de configuración apropiado, la aplicación puede llevar a cabo el control de distintas instalaciones. Soporte Wi-Fi y red móvil. La aplicación se ha diseñado para minimizar al máximo el tráfico entre el móvil y la instalación, aumentando su velocidad de respuesta y minimizando el consumo por transferencia de datos (en el caso de las redes móviles). Parametrizable. La aplicación dispone de una pantalla de configuración para establecer los parámetros básicos de funcionamiento. 3.1. Primeros Pasos Cada vez que se inicia la aplicación, se intenta conectar con el equipo ETHBUS (servidor web de Ingenium al que se conecta la aplicación). La primera vez que se inicia la aplicación no se dispone de la información necesaria para conectarse con la instalación así que después de varios intentos fallidos, se mostrará una pantalla de configuración (Imagen 12). En esta pantalla hay los siguientes botones: Configuración. Botón para cargar un nuevo fichero de configuración generado con la herramienta web explicada anteriormente en este manual. Parametrización. Botón para acceder a los parámetros básicos de conexión de la aplicación. página 15 de 25
Conexión. Botón para realizar la conexión a la instalación. Ayuda. Botón de acceso a una ayuda básica de la aplicación. Imagen 12. Pantalla de acceso El primer paso es establecer los parámetros básicos de conexión. Pulsamos el botón de Parametrización y se abrirá una pantalla (Imagen 13) para configurar: Acceso Wi-Fi: Si se marca esa casilla, la aplicación intentará en primer lugar conectarse a la instalación utilizando la red wi-fi. página 16 de 25
Servidor Wi-Fi: En caso de que la casilla anterior esté marcada en este campo hay que introducir la dirección IP del servidor ETHBUS en la red local. Servidor Móvil: Dirección IP del servidor ETHBUS cuando la conexión se realiza desde Internet. Puerto: Puerto de conexión al ETHBUS. Intentos de conexión: Desplegable para seleccionar el número de intentos de conexión que llevará a cabo la aplicación antes de avisar indicando que no ha sido posible establecer la conexión. Intentos de lectura: Desplegable para establecer el número de intentos de lectura de estado para cada elemento. Pasado ese número de intentos sin obtener el estado de un elemento, la aplicación marca ese elemento como inalcanzable y, por lo tanto, no se puede interactuar con él. Imagen 13. Pantalla de configuración Una vez establecidos dichos parámetros, regresar a la pantalla inicial con el botón del móvil página 17 de 25
Ya está la aplicación preparada para conectarse a la instalación. El paso siguiente es cargar el fichero de configuración generado con la herramienta web y que le va a permitir a la aplicación identificar qué elementos hay en la instalación y su distribución en zonas. El fichero de configuración tiene que ser copiado previamente en la tarjeta de memoria del teléfono. La aplicación está preparada para leer el contenido de esa tarjeta y así poder seleccionar el fichero a cargar. Una vez que se dispone del fichero en la tarjeta, pulsar el botón de Configuración para seleccionarlo. Imagen 14. Selección del fichero de configuración Los ficheros de configuración tienen extensión.jgc. Al pulsar sobre el fichero seleccionado se realiza la carga y se regresa automáticamente a la pantalla anterior. Ya se han establecido los parámetros de conexión y se ha cargado la configuración. Sólo resta pulsar el botón de Conexión para que la aplicación se conecte a la instalación. página 18 de 25
Si el proceso de conexión es correcto, se iniciará la aplicación mostrando la zona Principal definida en la herramienta web (pantalla que contiene los botones para enlazar a cada una de las zonas). Imagen 15. Pantalla inicial de zonas Los botones que aparecen son los que se configuraron en la herramienta web más un botón de ayuda situado siempre en el último lugar. página 19 de 25
3.2. Pantallas de Zonas Todas las pantallas asociadas a las zonas funcionan de manera similar. Cuando se abren se muestra todos los elementos que la componen e inmediatamente se envían los comandos necesarios para conocer el estado de los elementos que la componen. Como se comento en el manual de la herramienta, existen tres tipos de elementos: Estáticos: Son elementos asociados generalmente a escenas de pantallas. No tienen un estado que se pueda comprobar y al hacer click sobre ellos ejecutan la escena que tienen configurada. Informativos: Elementos que sí tienen un estado pero que no se puede hacer click sobre ellos. Por ejemplo un sensor crepuscular que muestra la cantidad de luz existente. Operativos: Son aquellos que sí muestran un estado y además se puede interactuar con ellos. Por ejemplo una farola, que además de conocer si está encendida o no, se puede encender o apagar pulsando sobre ella. Para los elementos estáticos, por lo tanto, no se consulta el estado. En cambio para los otros dos tipos de botones sí es necesario. La aplicación utiliza un código de colores para mostrar al usuario la situación de cada elemento: Rojo: Cada vez que se entra en una zona, todos los elementos informativos y operativos aparecen en rojo indicando que aún no se conoce su estado. Si pasado el número de intentos de lectura establecidos en los parámetros de la aplicación no fuese posible conocer su estado, el botón permanecerá en rojo y no se podrá interactuar con ese elemento. Gris: Color utilizado para todos los elementos estáticos y para el resto de elementos cuando estén desactivados (por ejemplo una luz apagada, un enchufe apagado, una persiana bajada,...) Amarillo: Color utilizado para indicar que una salida está activada. En el caso de los elementos asociados a iluminación regulada y a persianas, el amarillo reflejará el porcentaje de luz o de apertura en el que se encuentra el elemento. En la Imagen 16 se puede ver la pantalla nada más entrar en esa zona. Los botones asociados a iluminación están en rojo porque aún no se ha comprobado su estado. El botón Portón de Garaje está en gris porque está asociado a una escena de una pantalla y, por lo tanto, no es necesario consultar su estado. En la Imagen 17 se ve el estado de cada elemento. Todos los puntos de iluminación están apagados salvo el Almacén que está encendido. página 20 de 25
Imagen 16. Pantalla nada más entrar Imagen 17. Pantalla después de consultar Para regresar a la pantalla de zonas utilizar el botón del móvil. El esquema de funcionamiento es similar en todas las zonas. Primero se muestran todos los elementos configurados. Los que son de tipo estático aparecen directamente en gris. El resto se muestran en rojo hasta que la aplicación pueda obtener su estado o hasta que se superen el número de intentos de lectura sin éxito. 3.3. Tipos de Elementos Estáticos Estos elementos permiten la ejecución de escenas de pantallas u órdenes específicas (configuración avanzada). Ejemplos típicos pueden ser: Ejecución de una escena que apague todas las luces o que baje todas las persianas. Escena que inicie la programación de un sistema de riego.... página 21 de 25
3.4. Tipos de Elementos Informativos Existen varios elementos de tipo informativo: Los botones de Alarma, informan si una alarma se ha disparado o no. Sensores (intrusión, inundación, incendio o gas) que informan si un sensor se ha activado. Sensor crepuscular que indica la cantidad de luz detectada en cada momento. 3.5. Tipos de Elementos Operativos Son los elementos más completos ya que además de poder consultar su estado, se puede interactuar con ellos. Existen varios: Los asociados a iluminación o tomas de fuerza (enchufes, bombas, cámaras,...). Al pulsar sobre ellos invierten el estado (si estaban activos se desactivan y viceversa) cambiando automáticamente el color. Termostatos: El botón del termostato muestra la temperatura actual detectada. Si se hace click en el botón se abre una ventana (Imagen 18) donde se puede ver la temperatura solicitada y la temperatura actual detectada. Situando el dedo sobre la barra del termómetro y moviendo el dedo hacia arriba o hacia abajo se puede modificar la temperatura solicitada. En cuanto se despega el dedo de la pantalla el valor marcado es el que se envía al termostato para que actualice la temperatura solicitada. Imagen 18. Control de un termostato página 22 de 25
Persianas, estores, toldos: Los equipos domóticos que controlan estos elementos disponen de un indicador del porcentaje de apertura (100% si el elemento está completamente abierto y 0% si está cerrado). El botón muestra ese porcentaje utilizando una barra de color amarillo (el botón está completamente amarillo cuando el porcentaje detectado es del 100% y está gris cuando es el 0%). Si se hace click sobre el botón se abre una ventana con tres objetos: dos botones situados a la derecha para subir o bajar completamente la persiana y una persiana a la izquierda. Con el dedo se puede subir o bajar la persiana al porcentaje que se desee. Imagen 19. Regulación persiana Iluminación regulada: Elemento para controlar las líneas de iluminación conectadas a un regulador. Este elemento estará al 0% cuando la luz esté apagada y al 100% cuando esté completamente encendida. El botón muestra ese porcentaje utilizando una barra de color amarillo (el botón está completamente amarillo cuando el porcentaje detectado es del 100% y está gris cuando es el 0%). Si se hace click sobre el botón se abre una ventana con tres objetos: dos botones situados a la derecha para encender o apagar completamente la luz y un mando situado a la izquierda. Con el dedo se puede establecer el porcentaje deseado al igual que se maneja un mando de volumen. Debajo del mando se muestra en todo momento el porcentaje de iluminación fijado. página 23 de 25
Imagen 20. Regulación Iluminación Escenas: Elemento para poder acceder a las escenas de una pantalla domótica. Al hacer click sobre él se abre una ventana con un botón por cada una de las escenas que se hayan definido en el fichero de configuración. Basta pulsar sobre cualquiera de ellos para que la aplicación envíe la orden de ejecución de la misma. Imagen 21. Escenas de una pantalla página 24 de 25
Armado y desarmado: Elemento especial que permite el armado y desarmado de la alarma de la instalación. Se mostrará en amarillo si el sistema de alarma está armado y listo, y en gris si está desarmado. Si se hace click sobre él ejecutará la acción opuesta al estado en el que se encuentra (armará la alarma si está desarmada o la desarmará si está armada). Control de llamadas: Elementos para poder activar o desactivar las llamadas de teléfono que realiza la centralita cuando se detecta algún tipo de alarma. Si el botón está gris significa que esas llamadas no se efectuarán y amarillo en caso contrario. Si se hace click sobre él ejecutará la acción opuesta al estado en el que se encuentra. página 25 de 25