PRUEBA Y ACTIVACIÓN DEL BIOS AlarmDuinoSMS MEGA v1.55
2
ÍNDICE
EL FIRMWARE AlarmDuinoSMS MEGA
3
CIRCUITO DE PRUEBA
5
DIAGRAMAS COMPLETOS DE LA ALARMA
6
CARGA DEL BIOS AlarmDuinoSMS EN UNA TARJETA Arduino MEGA 2560
6
ESTADO DE LA ALARMA DESPUÉS DE CARGAR EL BIOS POR PRIMERA VEZ
10
COMUNICACIÓN CON EL BIOS DESDE EL MONITOR SERIAL
11
OPERACIÓN BÁSICA DE LA ALARMA
15
Administración de la alarma
15
Cambio del administrador
18
Borrado de la memoria de datos
20
Número máximo de usuarios
22
Adición de usuarios
22
Borrado de usuarios
22
Activación de la alarma
22
Desactivación de la alarma
23
Habilitación de los detectores de carga y PIR
23
COMANDOS DE OPERACIÓN Y PROGRAMACIÓN
24
SOLICITUD DE LICENCIA DE ACTIVACIÓN DEL BIOS
27
RECEPCIÓN E INSTALACIÓN DEL ARCHIVO DE LICENCIA
30
ACTIVACIÓN DEL BIOS
32
INHABILITACIÓN DEL ACCESO AL BIOS DESDE EL MONITOR SERIAL
37
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
3
EL FIRMWARE AlarmDuinoSMS MEGA Es un software embebido desarrollado totalmente en México que se carga en la tarjeta Arduino MEGA 2560 y que le permite realizar la función BIOS (Basic Input Output System – Sistema Básico de Entrada y Salida) de una alarma vecinal o comunitaria vía celular, que se activa mediante un SMS o una llamada desde un teléfono fijo o móvil. Sus características son: 1.
Permite el monitoreo dos señales digitales de entrada de nivel TTL (Transistor Transistor Logic – Lógica Transistor a Transistor): una proveniente de un detector de carga y otra que se genera desde un detector de movimiento o de presencia
2.
Genera dos señales de salida de nivel TTL: una que se utiliza para activar una sirena y la otra que se genera para activar una lámpara de emergencia. La señal que activa la lámpara puede programarse para que sea fija o parapadeante
3.
Permite el registro de 20 hasta 200 números de teléfono (fijo o móvil) de las personas que van a utilizar la alarma (usuarios). El número máximo de usuarios es programable. Además, permite el registro de 4 números adicionales:
4.
*
Administrador (móvil)
*
Emergencia (fijo o móvil)
*
Transmisión de datos en red (móvil)
*
Recepción de datos en red (móvi)
Al registrar el número de cada usuario, se puede añadir una información adicional de hasta 190 caracteres como máximo para el caso de 20 usuarios o de 10 caracteres como máximo para el caso de 200 usuarios. Cuando se programa este parámetro, el BIOS te indica el tamaño de este espacio que puedes utilizar para introducir algun dato personal del usuario como su nombre o domicilio
5.
Puede activarse por una llamada telefónica desde cualquier número fijo o móvil registrado en su memoria. Cuando la alarma recibe la llamada, cuelga inmediatamente para no generar costo para quien realiza la llamada
6.
También se activa cuando la alarma detecta la señal del detector de presencia o bien cuando recibe un SMS de cualquier usuario registrado en su memoria. Inclusive desde otro equipo igual cuando se conecta en red. Al activar la sirena y la lámpara estroboscópica, la alarma
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
4
también enviará a todos los usuarios un mensaje de alerta 7.
Cuando el usuario activa la alarma por SMS, puede incluir en él una breve descripción de por qué ha activado la alarma. Esto permitirá que todos los usuarios sepan el motivo de ello
8.
Para la comunicación a través de la red de telefonía móvil, la alarma requiere del módulo SIM900 Quad-Band GSM/GPRS Shield para Arduino de TyneSine con su correspondiente tarjeta SIM. En la figura 1 se muestra una imagen de esta tarjeta
Figura 1. Módulo GSM de TyneSine
9.
Se opera y configura a través de 17 comandos u órdenes vía SMS desde cualquier teléfono móvil de los cuales: -
1 es público
-
1 es para cualquier vecino registrado
-
2 son para vecinos con privilegios
-
13 son exclusivos para el administrador
El administrador tiene acceso a todos los comandos. A los comandos con acceso privilegiado pueden acceder vecinos que son designados de esa manera por el administrador 10.
El BIOS puede probarse en modo de evaluación, lo cual permitirá el acceso a TODOS los comandos con los que se opera la alarma pero únicamente desde el monitor serial de la aplicación de escritorio que se incluye en el paquete, ya que para funcionar con el módulo GSM Shield, requerirá de una licencia de activación del BIOS, que el interesado en este proyecto deberá solicitar al desarrollador del firmware. Consulta “SOLICITUD DE LICENCIA DE ACTIVACIÓN DEL BIOS” que se encuentra más adelante en este texto
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
5
CIRCUITO DE PRUEBA Para probar el BIOS AlarmDuinoSMS requieres de una tarjeta Arduino MEGA 2560, la cual puede ser original o compatible como se muestra en la figura 2.
Figura 2. Tarjeta Arduino MEGA compatible con la original
Sin embargo, NO ES NECESARIO que tengas el GSM Shield ya que, desde la consola incluida en el programa de activación, puedes probar TODOS y CADA UNO de los comandos con los que la alarma funciona. De esta forma podrás activar y desactivar la alarma así como también configurarla para su funcionamiento real. En la figura 3 se muestra el circuito de prueba con el cual podrás probar las características de la alarma. En ese circuito, al oprimir el pulsador P1 se simulará la generación de señal del detector PIR de presencia o de movimiento. Al oprimir el pulsador P2 se simulará la generación de la señal del detector de carga cuando se desconecta la fuente de alimentación de la batería. El LED L1 simula la sirena y el LED L2 simula la lámpara estroboscópica de emergencia.
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
6
Figura 3. Circuito de prueba para el BIOS AlarmDuinoSMS MEGA en la tarjeta Arduino MEGA 2560
DIAGRAMAS COMPLETOS DE LA ALARMA El diagrama de la figura 3 es sólo el de un circuito de prueba. El diagrama electrónico completo, la lista de materiales y el instructivo técnico de cómo armarla se obtiene a través de un documento protegido mediante DRM (Digital Rights Management) el cual se proporciona junto con la licencia de activación del BIOS. En el apartado “ACTIVACIÓN DEL BIOS DE LA ALARMA” que aparece más adelante en este texto se detalla cómo obtenerla.
CARGA DEL BIOS AlarmDuinoSMS EN UNA TARJETA Arduino MEGA 2560 1.
Instala tu tarjeta Arduino MEGA 2560 utilizando el software original de Arduino
2.
Descomprime
en
la
unidad
C:
de
tu
PC
el
contenido
“ProyexDuino_20170124.zip” que descargaste del blog:
programaciondearduinoconlenguajedeplc.blogspot.mx
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
de
la
carpeta
7
De tal manera que quede ahí como: C:\ProyexDuino
3.
Conecta a tu PC la tarjeta Arduino MEGA. Dentro la carpeta cuyo nombre aparece de arriba, ubica y ejecuta la aplicación “JOGATECHProyex.exe” que es el programa que se utilizará para cargar y activar el BIOS en tu tarjeta Arduino MEGA . Al ejecutarse, aparecerá la ventana principal del programa
4.
Después aparecerá un cuadro de diálogo en donde podrás seleccionar la versión Windows que estás utilizando para correr el programa. Oprime “Aceptar”
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
8
5.
En el menú principal del programa, selecciona la opción “Firmware”->”Carga …”
6.
Aparecerá el cuadro de diálogo
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
9
7.
En el campo “Puerto” escribe el número de puerto que Windows asignó a tu tarjeta Arduino. Activa también la casilla “Esperar inicialización del BIOS antes de detectar”
8.
Oprime el combo “Firmware”. Aparecerá una lista de las aplicaciones firmware disponibles en “ProyexDuino”. Selecciona “AlarmDuinoSMS_MEGA”
9.
Oprime “Cargar”. Aparecerá el mensaje
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
10
Puesto que es la primera vez que vas a cargar el firmware en tu tarjeta, oprime “Sí”. Aparecerá una ventana indicando la carga del firmware. Si la carga fue exitosa aparecerá el cuadro de diálogo:
Una vez cargado el BIOS, el LED “Lámpara de emergencia” de la figura 3 se encenderá. Esto significa que el programa de arranque ha iniciado. Durante este proceso, el BIOS inicializa variables internas del programa y verifica si hay comunicación con el módulo GSM. Puesto que en modo de prueba, no tienes conectado el módulo GSM a tu tarjeta Arduino, el LED “Sirena” se encenderá y después de algunos segundos, ambos LED’s se apagarán (en el producto final, la sirena de la alarma sonaría por dos segundos aproximadamente indicando que hubo una falla de comunicación con el módulo GSM).
ESTADO DE LA ALARMA DESPUES DE CARGAR EL BIOS POR PRIMERA VEZ 1.
El BIOS no está activado
2.
Toda la memoria está en 0’s. No hay números registrados del teléfono del administrador; de emergencia; de la red y tampoco de los usuarios
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
11
3.
El detector de carga está inhabilitado. Esto significa que si oprimes el pulsador P1 en el circuito de prueba, simulando que la alarma se ha desconectado de la fuente de alimentación, este evento no se notificará al administrador
4.
El detector de presencia PIR está inhabilitado. Esto significa que si oprimes el pulsador P2 en el circuito de prueba, simulando que ha habido una detección de presencia, este evento no se notificará al administrador
5.
Las notificaciones a todos los usuarios están desactivadas. Esto significa que si hubiera usuarios a quien notificar sobre algún evento de alarma no se les avisaría mediante SMS cuando la alarma detectara algún evento de alarma
6.
La notificación a dispositivos en red está desactivada. Esto significa que si esta alarma estuviera conectada en red con otros equipos iguales, no se les notificaría de algún evento de alerta que ocurriera en su ámbito de alcance
7.
La sirena está en modo SONORO y se activará por 5 minutos en caso de algún evento de alarma
8.
El número máximo de usuarios que se pueden registrar en la alarma es de 100
9.
El estrobo está desactivado. Esto significa que la lámpara de emergencia que estás utilizando en tu alarma tiene esta característica propia. En caso de que utilices una lámpara fija y deseas que ésta parpadee cuando se active la alarma, deberás habilitar esta característica
COMUNICACIÓN CON EL BIOS DESDE EL MONITOR SERIAL 1.
Si no has salido del programa después de cargar el BIOS, ve al paso 2. Si no, en el menú principal del programa Selecciona la opción “Firmware”->”Detección …”
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
12
Aparecerá un cuadro de diálogo. Introduce el valor del puerto de comunicación para Arduino y activa la casilla “Esperar inicialización del BIOS antes de detectar”
2.
Oprime “Salir”. En el menú principal, selecciona la opción “Firmware”->”Monitor serial …”
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
13
Aparecerá un cuadro de diálogo desde el cual podrás interactuar con el BIOS. Casi inmediatamente, aparecerán algunos mensajes que el monitor recibió del BIOS de la alarma cuando se abre la comunicación serial
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
14
OBSERVACIONES a.
El BIOS aparece como “NO ACTIVADO” por lo cual únicamente podrás enviar y recibir mensajes utilizando el monitor serial. Cuando aparece “ACTIVADO”, podrás comunicarte con el BIOS tanto con el monitor serial como o por medio del módulo GSM utilizando mensajes desde tu teléfono móvil. En este último caso, asegúrate de tener saldo en la tarjeta SIM de la alarma una vez que hayas activado el BIOS. Además, a través del monitor serial podrás visualizar los mensajes que lleguen al módulo GSM. De esa forma podrás comprobar el funcionamiento del mismo
b.
En los apartados que siguen, se utilizará el monitor serial para simular tu teléfono móvil desde el cual envías mensajes a la alarma. En el campo “Mensaje a enviar”, anota el texto que deseas enviar. El mensaje puede estar escrito en minúsculas o en mayúsculas. En el campo “Número de teléfono” deberás anotar el número del teléfono desde el cual se envían los mensajes. Es a través de este campo que, mediante el monitor serial, se realiza la simulación del número que envía el mensaje. Sin embargo, la interacción de la consola con el BIOS es real por lo que NO HAY SIMULACIÓN A TRAVÉS DE LA PC del funcionamiento de la alarma
c.
Cuando el BIOS no está activado, podrás acceder a todos los comandos del BIOS desde el monitor serial. Es por ello que aparece la leyenda: Acceso desde el monitor serial: SI
Por otro parte, cuando el BIOS está activado, tu mismo(a) podrás inhabilitar el acceso a la consola (consulta la sección “INHABILITACIÓN DEL ACCESO AL BIOS DESDE EL MONITOR SERIAL”) Cuando esto es así, el acceso a los comandos del BIOS podrá realizarse únicamente desde el teléfono móvil del administrador
d.
La longitud máxima de caracteres que puedes introducir en el campo “Mensaje a enviar” del monitor serial está limitada a 34 caracteres aproximadamente. Sin embargo, cuando el BIOS
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
15
está activado y puedes acceder a él desde tu móvil, no hay esta restricción en los mensajes que enviés desde tu teléfono
OPERACIÓN BÁSICA DE LA ALARMA
Administración de la alarma Cuando el BIOS se carga por primera vez en tu tarjeta, toda la memoria de datos se borra automáticamente. Esto incluye por supuesto el área de memoria en donde está registrado el número telefónico del adminsitrador. Por tanto, cualquier usuario puede tomar el control de la alarma; esto es, puede administar la alarma. Para especificar quien va a ser el administrador de la alarma por primera vez o después de que se han borrado todos los datos por parte del administrador (este procedimiento se detalla más adelante) se utilizan los siguientes pasos: 1.
Escribe la palabra “administrar” seguida de la palabra “alarma” y a continuación anota también el número telefónico asociado a la tarjeta SIM que tendría el módulo GSM y que en el BIOS de la alarma corresponderá al número de identificación de la misma. En este caso, para la prueba, anota cualquier número con 10 dígitos
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
16
2.
En el campo “Número de teléfono” anota el número de teléfono desde el cual se envían los mensajes. En este caso, corresponderá al número de la persona que va a enviar el mensaje; esto es, quien va a ser el administrador
3.
Oprime “Enviar”. El BIOS responderá
*** MONITOR SER *** Mensaje recibido en la alarma: administrar alarma 1122334455 1234567890 *** MONITOR SER *** Mensaje enviado desde la alarma: BIENVENIDO(A)! Usted es el(la) nuevo(a) administrador(a) de la alarma 1234567890 *** MONITOR SER *** Mensaje enviado desde la alarma:
Todos
los
acentos
de
los
mensajes
que
usted
reciba
de
la
alarma
se
han
omitido
intencionalmente 1234567890 *** MONITOR SER *** Mensaje enviado desde la alarma: Cuando la sirena llegue a activarse, se apagara despues de 5 minuto(s) 1234567890
El mensaje que se recibiría en el teléfono móvil tendría la apariencia que se muestra en la siguiente figura Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
17
OBSERVACIONES a.
La palabra “administrar” es un comando u orden que le indica a la alarma quién va a administrarla. Este comando va seguido de dos parámetros: la palabra “alarma” y el número telefónico que tiene la tarjeta SIM del módulo GSM/GPRS que utiliza la alarma
b.
Cuando en el receptor de la consola aparecezca la leyenda *** MONITOR SER *** Mensaje recibido en la alarma:
Es un aviso de que el BIOS ha recibido un mensaje. Se desplegará el mensaje recibido y el número del teléfono de origen que envió el mensaje y que correspondería al que tu enviarías a la alarma desde tu teléfono móvil Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
18
c.
Cuando en el receptor del monitor serial, aparezca la leyenda *** MONITOR SER *** Mensaje enviado desde la alarma:
Es un aviso de que el BIOS ha enviado uno o varios mensajes a los destinos señalados y que corresponderían a los que recibirías en tu teléfono o en los de tus vecinos vía SMS
d.
Las palabras entre signos de comparación “<” y “>” que aparecen en el receptor del monitor serial solamente se utilizan para señalar el comienzo del mensaje que se recibió o se envió, así como el número origen o destino del mensaje. Para el caso de los mensajes que se envían, no aparecerán en el teléfono móvil cuando éstos se reciban como se muestra arriba en la captura de pantalla de un teléfono real
e.
La persona que haya enviado el mensaje “administrar alarma” y que recibió el mensaje de confirmación descrito arriba, será la única persona que podrá administrar la alarma, por lo cual nadie más podrá hacerlo en lo posterior. Esto es así, ya que después de que el BIOS se carga por primera vez, al recibir este mensaje, la alarma registra en su memoria el número de quien envió el mensaje (que corresponde al del campo “Número de teléfono” en el monitor serial) y lo toma como el administrador. Si deseas cambiar este número, consulta el siguiente apartado “Cambio del administrador”
Cambio del administrador Una vez que se ha establecido el administrador de la alarma, solamente él puede cambiar la administración de la alarma. Para ello, se deberá realizar lo siguiente: 1.
Escribe la palabra “administrar” seguida del número de teléfono del nuevo administrador escrito dos veces. En el ejemplo que se muestra el nuevo número del administrador por el cual se quiere cambiar el actual es “2233445566”
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
19
2.
Después de enviarlo, en el monitor serial se recibirán los mensajes:
*** MONITOR SER *** Mensaje recibido en la alarma: administrar 2233445566 2233445566 1234567890 *** MONITOR SER *** Mensaje enviado desde la alarma: La administracion de la alarma esta ahora a cargo de 2233445566 1234567890
Esto implica que ahora el nuevo administrador con el número “2233445566” es quien tiene acceso a las funciones de la alarma. Este mensaje lo recibirá todavía el administrador antiguo de la alarma pero ya no podrá acceder a ella como administrador
OBSERVACIONES a.
En el modo de prueba del BIOS, en caso de que ya no recuerdes el número que escribiste por primera vez para simular el número del administrador desde donde se originan los mensajes, deberás realizar un borrado de la memoria de la alarma. Consulta el apartado “Borrado de la
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
20
memoria de datos” para que borres todos los datos de la memoria del BIOS y puedas volver a ingresar y especificar un nuevo número de teléfono para el administrador, pues ya no habrá otra forma de que puedas acceder a los comandos del BIOS de la alarma
b.
Si el BIOS ya está activado e inhabilitas el acceso desde la consola (consulta la sección “INHABILITACIÓN DEL ACCESO AL BIOS DESDE EL MONITOR SERIAL”), solamente podrás acceder al sistema desde el número de teléfono con el cual ingresaste por primera vez con el comando “administrar alarma”. Además, tampoco podrás borrar la memoria de datos. Por tanto el sistema estará bloqueado para cualquier otro número y la única forma será recargar el BIOS de la alarma a tu tarjeta Arduino. Sin embargo, esto hará que se pierdan los códigos de activación del BIOS. Esta es una medida de protección que tiene el firmware para que no pueda utilizarse por alguien no autorizado en caso de robo o extravío de la tarjeta Arduino o de la alarma como producto terminado
Borrado de la memoria de datos 1.
En el menú principal del programa de activación, selecciona la opción “Firmware”->”Detección
…”
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
21
2.
En el menú principal del programa, selecciona la opción “Firmware”->”Detectar” y anota en el cuadro de diálogo el número de puerto de comunicación. También activa la casilla “Esperar inicialización del BIOS antes de detectar”
3.
Oprime “Salir”. Selecciona ahora la opción “Firmware”->”Borrado de datos”. Aparecerá un cuadro de diálogo
4.
Oprime “Sí”. Se iniciará el proceso de detección del BIOS y después de algunos segundos aparecerá el cuadro de diálogo
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
22
Número máximo de usuarios Por defecto, el número máximo de usuarios que se pueden registrar en la alarma es de 100, permitiendo una introducción de 30 caracteres como máximo por cada registro que puedes utilizar para hacer una descripción opcional de cada usuario (nombre, dirección, etc). Sin embargo, este valor lo puedes modificar a cualquier otro entre 20 y 200. Solamente considera que a mayor número de usuarios, el BIOS disminuirá el número de caracteres permitidos que puedes introducir para hacer la descripción de cada usuario. Utiliza el comando “usuarios registros” para ver el valor actual de este parámetro o modificarlo a tu necesidad. Sin embargo, la modificación del número máximo de usuarios solamente puede hacerse cuando no hay usuarios registrados o cuando se ha borrado la memoria de datos. Para mayores detalles de cómo utilizar de este comando consulta la tabla 1 de la sección “COMANDOS DE OPERACIÓN Y PROGRAMACIÓN”
Adición de usuarios Utiliza el comando “usuario” para agregar un nuevo usuario a la lista de vecinos registrados que pueden acceder a la alarma. Al registrar cada número de teléfono puedes especificar un parámetro opcional para añadir privilegios a ese número. Por ejemplo, puedes indicar si ese número puede recibir notificaciones o bien si al igual que el administrador puede desactivar la alarma. Consulta la tabla 1 de la sección “COMANDOS DE OPERACIÓN Y PROGRAMACIÓN” para mayores detalles de este comando.
Borrado de usuarios Utiliza el comando “borrar” para eliminar el número de un usuario de la lista de vecinos que pueden acceder a la alarma. Consulta la tabla 1 de la sección “COMANDOS DE OPERACIÓN Y PROGRAMACIÓN” para mayores detalles de este comando.
Activación de la alarma La activación de la alarma; esto es, el encendido de la sirena y de la lámpara de emergencia, puede realizarse de tres formas: Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
23
1.
Mediante una llamada telefónica al número de la alarma
2.
Mediante un SMS utilizando el comando “activar” o “1”
3.
Mediante la señal proveniente del detector PIR. En este caso, el detector PIR del BIOS deberá estar habilitado (consulta la tabla 1)
En la activación de la alarma por SMS puedes agregar, de forma opcional, un mensaje al comando “activar” para indicar el motivo por el cual se activa la alarma. Consulta la tabla 1 de la sección “COMANDOS DE OPERACIÓN Y PROGRAMACIÓN” para mayores detalles de este comando.
Desactivación de la alarma Para desactivar la alarma; esto es, el apagado de la sirena y de la lámpra de emergencia, puede realizarse de dos formas: 1.
Utiliza el comando SMS “desactivar” o “0”
2.
Mediante una llamada telefónica del administrador o de algún usuario con privilegios
Consulta la tabla 1 de la sección “COMANDOS DE OPERACIÓN Y PROGRAMACIÓN” para mayores detalles de este comando.
Habilitación de los detectores de carga y PIR Si en tu alarma vas a incluir los circuitos de detección de carga y PIR, deberás actívarlos utilizando los comandos correspondientes. Consulta la tabla 1 de la sección “COMANDOS DE OPERACIÓN Y PROGRAMACIÓN” para mayores detalles de este comando. Cuando el detector de carga está habilitado, el BIOS enviará un SMS de alerta únicamente al administrador de que se ha detectado una conexión/desconexión de la línea de alimentación de la alarma. Cuando el detector PIR está habilitado, el BIOS enviará un SMS de alerta al administrador y a todos los usuarios que puedan recibir notificaciones.
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
24
COMANDOS DE OPERACIÓN Y PROGRAMACIÓN En la tabla 1 se muestran todos los comandos que se utilizan para operar y programar la alarma. Puedes utilizar letras minúsculas y/o mayúsculas.
Tabla 1. Lista de comandos para programar y operar el BIOS AlarmDuinoSMS Comando
administrar
activar
detector
desactivar firmware estado
notificar
usuario
Descripción Especifica el número de teléfono que administrará la alarma Especifica el cambio del número del administrador Activa la sirena y la lámpara de emergencia
Parámetro 1 alarma
Parámetro 2 dddddddddd
Público dddddddddd
dddddddddd
(sin parámetro) ó Motivo por el cual se activa la alarma (opcional) carga
(sin parámetro)
Activa o desactiva la bandera “detección del PIR” (detector de presencia) Desactiva la sirena y la lámpara de la alarma
pir
(sin parámetro) no
(sin parámetro)
(sin parámetro)
Obtiene la versión del BIOS de la alarma Obtiene el estado de la alarma Habilita o inhabilita las notificaciones de alerta al número de un vecino
(sin parámetro)
(sin parámetro)
(sin parámetro)
(sin parámetro)
dddddddddd
(sin parámetro) no
Obtiene el estado de la notificaciones a los vecinos Activa o desactiva las notificaciones de alerta a los demás vecinos que pueden recibir notificaciones Obtiene el estado de la notificación a la red Activa o desactiva la notificación en red Agrega un número telefónico a la lista de usuarios. El número se considera que es móvil. Opcionalmente se agrega una breve descripción del usuario. El usuario únicamente podrá activar la alarma pero no podrá recibir mensajes de notificación Agrega un número a la lista e indica que es un número fijo. Opcionalmente se agrega una breve
usuarios
Activa o desactiva la bandera “detección de carga”
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
Acceso
(sin parámetro) no
Administrador - Administrador - Cualquier Vecino - Administrador - Vecino con privilegios - Administrador - Vecino con privilegios - Administrador - Vecino con privilegios Administrador Administrador Administrador
red
?
dddddddddd
(sin parámetro) no (sin parámetro) Descripción del usuario
administrar alarma 0123456789 administrar 1122334455 1122334455 activar activar hay una persona sospechosa frente a mi casa detector carga detector carga no detector pir detector pir no Desactivar
firmware estado notificar 1122334455 notificar 2233445566 no notificar usuarios ?
? (sin parámetro) no
Ejemplo(s)
Administrador
notificar usuarios notificar usuarios no
notificar red ? Administrador
notificar red notificar red no usuario 1122334455 usuario 2233445566 Sr. Juan usuario 3344556677 Casa 32-A Sra. Juana
Administrador
f
dddddddddd Administrador
usuario f 2233445566 usuario f 4455667788 Sr. Pedro
25
buscar
borrar
emergencia
red
duracion
usuarios
mudo
estrobo
descripción del usuario Agrega un número a la lista e indica que podrá recibir notificaciones (es un número móvil). Opcionalmente se agrega una breve descripción del usuario Agrega un número a la lista e indica que el usuario tiene privilegios: recibir notificaciones; desactivar la alarma y desactivar el detector PIR. Opcionalmente se agrega una breve descripción del usuario Verifica si un usuario se encuentra registrado en la alama Borra el número de usuario de la lista Borra todos los números de usuarios de la lista Borra el número del administrador Borra los números TX y RX de la red Borra la memoria de la alarma Obtiene el número de emergencia de la alarma Pone el número de emergencia de la alarma Obtiene los números TX y RX de la red Pone los números TX y RX de la red Prueba la red Obtiene la duración de activación de la sirena Pone la duración de la activación de la sirena Obtiene el número de usuarios actualmente registrados en la lista Habilita o inhabilita a todos los usuarios para recibir notificaciones Obtiene el número máximo de registros que se pueden utilizar para guardar la información de los números de los vecinos Obtiene el estado de la bandera “mudo” de la sirena Activa o desactiva la bandera “mudo” de la sirena Obtiene el estado de la bandera “estrobo” de la lámpara de emergencia
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
n
usuario n 6677889900 usuario n 3344556677 Casa #18 int. B
dddddddddd
Administrador
p
usuario p 4455667788 usuario p 5566778899 Esposa
dddddddddd
Administrador
dddddddddd
buscar 1122334455
(sin parámetro) Administrador
dddddddddd
(sin parámetro)
usuarios
(sin parámetro)
administrador
(sin parámetro)
red
(sin parámetro)
memoria
(sin parámetro)
?
(sin parámetro)
dddddddddd
(sin parámetro)
?
(sin parámetro)
tttttttttt
rrrrrrrrrr
probar ?
(sin parámetro) (sin parámetro)
valor (en minutos)
(sin parámetro)
?
(sin parámetro)
Administrador Administrador Administrador Administrador Administrador Administrador Administrador Administrador Administrador Administrador Administrador Administrador
borrar 1122334455 borrar usuarios borrar administrador borrar red borrar memoria emergencia ? emergencia 1234567890 red ? red 112233445566 223344556677 red probar duracion ? duracion 10 usuarios ?
Administrador notificar
registros
(sin paramétro) no
Administrador
usuarios notificar usuarios notificar no usuarios registros ? usuarios registros 150
? n Administrador
?
mudo ?
(sin parámetro) Administrador
(sin parámetro) no
(sin parámetro)
?
(sin parámetro)
Administrador
mudo mudo no estrobo ?
Administrador
26 Activa o desactiva la bandera “estrobo” de la lámpara de emergencia Obtiene el estado de la bandera de acceso al BIOS desde el monitor serial Habilita o inhabilita el acceso al BIOS desde el monitor serial
monitor
(sin parámetro) no
(sin parámetro)
?
(sin parámetro)
Administrador
estrobo estrobo no monitor ?
Administrador (sin parámetro) No
(sin parámetro) Administrador
monitor monitor no
OBSERVACIONES a.
Con el monitor serial puedes probar todos los comandos de la tabla 1 con el circuito de la figura 3, excepto el comando “red probar” ya que únicamente será posible probarlo con el módulo GSM instalado. Además, el comando “monitor” no está disponible si el BIOS no está activado
b.
Un vecino sin previlegios es aquél que únicamente puede activar la alarma ya sea mediante un mensaje SMS o mediante una llamada telefónica
c.
Un vecino con privilegios además de poder activar la alarma como se menciona en el punto anterior también puede: -
Desactivar la alarma mediante un comando SMS
-
Desactivar el detector PIR
-
Desactivar la alarma mediante una llamada telefónica
El BIOS reconoce también tres comandos rápidos. Estos se enumeran en la tabla 2 Tabla 2. Comandos rápidos Comando
Descripción
Parámetro 1
Parámetro 2
(sin parámetro) Motivo por el cual se accionó la alarma (opcional)
(sin parámetro)
Desactiva la alarma
(sin parámetro)
(sin parámetro)
Obtiene el estado de la alarma
(sin parámetro)
(sin parámetro)
Activa la alarma 1
- Administrador - Cualquier vecino
0 ?
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
Acceso
- Administrador - Vecino con privilegios - Administrador
Ejemplo(s) 1 1 Hay una persona sospechosa frente a mi casa 0
?
27
SOLICITUD DE LICENCIA DE ACTIVACIÓN DEL BIOS Para activar el BIOS de tu tarjeta Arduino MEGA con el propósito de utilizarla para construir tu propia alarma y activarla desde tu móvil requieres, además del módulo GSM, de una licencia de activación la cual se solicita al desarrollador vía e-mail. Esta licencia te permitirá utilizar el BIOS en tu tarjeta Arduino con el módulo GSM sin restricciones. Esta licencia se solicita de forma electrónica a través de una solicitud de licencia que se genera desde el programa “JOGATECHProyex”. Para generarla sigue los siguientes pasos (no requieres conexión a Internet): 1.
Conecta tu tarjeta Arduino MEGA en donde cargaste el BIOS AlarmDuinoMEGA y conecta el circuito de prueba de la figura 3. Detecta la tarjeta con el programa y haz un borrado de la memoria de datos
2.
Selecciona ahora en el menú principal la opción “Licencias”->”Solicitar licencia de activación de primera vez …”
3.
Aparecerá un cuadro de diálogo. Selecciona la opción “AlarmDuinoSMS MEGA”
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
28
4.
Oprime “Generar”. Aparecerá un aviso
Puesto que es la primera vez que vas a solicitar la licencia, oprime “Sí”
5.
En el circuito de prueba, se activará el LED L2 que simula la lámpara de emergencia. Esto significa que la rutina de inicialización del BIOS ha iniciado. Puesto que no hay módulo GSM, el LED L1 también encenderá y después de 2 segundos aproximadamente se apagará. Recuerda que este LED simula la sirena. A continuación aparecerá la ventana
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
29
6.
Oprime “Aceptar”. Aparecerá un cuadro de diálogo en donde se muestra resaltado el nombre del archivo que se generó y que contiene la solicitud de licencia. Te sugiero que no modifiques su nombre
Únicamente selecciona la carpeta en donde guardarás la solicitud. Si lo deseas, puedes guardar el archivo en la carpeta C:\ProyexDuino\Solicitudes
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
30
7.
Oprime “Guardar”. Aparecerá el cuadro de diálogo
Envía el archivo al correo que aparece en el cuadro de diálogo que se genera en el programa o en la ventana “Acerca de” para que el desarrollador te proporcione el archivo de licencia.
OBSERVACIÓN La solicitud de licencia que generaste es válida ÚNICAMENTE para la tarjeta en la que se generó el códido de preactivación y para la computadora que utilizaste para crear la solicitud
RECEPCIÓN E INSTALACIÓN DEL ARCHIVO DE LICENCIA La licencia para activar el BIOS es un archivo DLL que recibes del desarrollador y que contiene un código de referencia que te permitirá activar el BIOS AlarmDuinoSMS desde la PC que utilizaste para generar la solicitud de la misma. Su nombre es: JOGATECHLicencias.DLL
Este archivo es único para tu PC y para la tarjeta que preactivaste. Además, deberás copiarlo en la carpeta C:\ProyexDuino\DLL
Puesto que ahí ya existe un archivo con el mismo nombre, simplemente deja que Windows lo sobreescriba. Como se había comentado antes, el archivo DLL contiene una código de referencia que es básicamente un sello digital para la copia del BIOS que está alojada en tu tarjeta Arduino. Para visualizar esta clave, entra a la aplicación JOGATECHProyex y selecciona la opción “Licencias”Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
31
>”Seleccionar …”. Aparecerá un cuadro de diálogo mostrándote información sobre la licencia que adquiriste
Se te sugiere encarecidamente que después de que hayas activado el BIOS, etiquetes tu tarjeta Arduino con esa clave. Por otro lado, además del archivo DLL, recibirás también un enlace privado para que descargues de Google un documento electrónico (extensión DRMB) que contiene toda la información técnica (diagrama completo de la alarma con el circuito detector de carga y detector PIR; dibujo del PCB del circuito actuador de la sirena, la lámpara y de los detectores; lista de componentes y tips de fabricación) que requieres para ensamblar tu propia alarma vecinal vía celular utilizando el BIOS AlarmDuinoSMS de tal manera que tu producto tenga la apariencia que se muestra en la figura 5.
Figura 5. Apariencia final de la alarma vecinal vía celular que utiliza el BIOS AlarmDuinoSMS Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
32
En la figura, la alarma que se muestra también se activa mediante un detector de presencia por PIR. Sin embargo, con la información técnica que recibas, en lugar del detector, puedes adaptar un timbre inalámbrico que puede servir como botón de pánico o bien cualquier otro dispositivo inalámbrico opcional que puedas utilizar para activar la alarma de forma remota. El vídeo de la operación y programación de la alarma de la figura está en el enlace: https:/www.youtube.com/watch?v=JMfVRV0tGpY&t=2s
Ahora bien, una vez que descargues la información técnica, podrás visualizar su contenido únicamente mediante el visor que viene integrado en la aplicación “JOGATECHProyex” el cual puede abrirse solamente en el mismo equipo que utilizaste para generar la licencia.
ACTIVACIÓN DEL BIOS Una vez que hayas recibido el archivo de licencia ya puedes activar el BIOS AlarmDuinoSMS que grabaste en tu tarjeta Arduino MEGA 2560. Sin embargo, la licencia de activación sólo te permite activar una sola copia del BIOS; en este caso, en la que anteriormente se grabó el código de preactivación que se creó en tu tarjeta Arduino cuando generaste la solicitud de licencia por primera vez. Port tanto, después de que el BIOS haya sido activado, la licencia de activación ya no te será útil para activar otra copia. De hecho, tampoco te será útil si con ella intentas activar una nueva copia del BIOS en una tarjeta Arduino MEGA que ya tenía el BIOS activado pero que después utilizaste para cargar otros programas con el IDE original de Arduino o mediante otros programas. Para activar la copia del BIOS utilizando la licencia que recibiste sigue los siguientes pasos: 1.
Conecta tu tarjeta Arduino con el BIOS AlarmDuinoSMS. Después selecciona la opción “Firmware”->”Activación estática …”
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
33
2.
Aparecerá un cuadro de diálogo. Introduce el valor del puerto COM y activa la casilla
3.
Oprime “Activar”. Después algunos segundos, aparecerá un cuadro de diálogo indicando que se detectó el BIOS AlarmDuinoSMS
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
34
4.
Oprime “Aceptar”. Aparecerá otro cuadro de diálogo
5.
Oprime “Sí”. Aparecerá una ventana indicándote que ya comenzó la activación. Después de algunos segundos, aparecerá otro cuadro de diálogo.
6.
Oprime “Aceptar”. Iniciará un proceso de validación de la activación del BIOS. Primero se realizará la detección de la tarjeta, apareciendo algunos segundos después el cuadro de diálogo
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
35
7.
Finalmente se verificará que la activación haya sido correcta
8.
Oprime “Aceptar”. La activación del BIOS en en tu tarjeta ha concluído
9.
Selecciona la opción “Firmware->“Monitor serial …”. Aparecerá el cuadro de diálogo del monitor serial con mensajes en el receptor en donde se mostrará que el BIOS ya está activado
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
36
OBSERVACIONES a.
La activación estática significa que en la tarjeta Arduino, el BIOS no debe borrarse o volver a grabarse ya que se perderían los códigos de preactivación y de activación en su memoria
b.
Si intentas activar el BIOS en una tarjeta en la que ya se había activado ese firmware, aparecerá el cuadro de diálogo
c.
Si intentas activar el BIOS en una tarjeta para la cual no has generado el código de preactivación, o en la que recargaste el BIOS después de que en ella ya estaba una copia activada pero que después la borraste de forma accidental, o que cargaste en ella otro programa con el IDE de Arduino o mediante otros programas, aparecerá el cuadro de diálogo
En este caso, deberás solicitar otra licencia y realizar el pago correspondiente si deseas volver a utilizar tu tarjeta Arduino MEGA para el proyecto que se ha descrito en este documento
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
37
INHABILITACIÓN DEL ACCESO AL BIOS DESDE EL MONITOR SERIAL Una vez que has activado el BIOS y vas a utilizarlo como producto terminado en tu propia alarma, puedes cancelar su acceso desde el monitor serial utilizando el comando “monitor no”. Sin embargo, ten en cuenta que ya no podrás acceder a él desde esa utilidad ni tampoco podrás borrar los datos de su memoria desde la aplicación “JOGATECH. Por tanto, solamente podrás acceder a él desde el teléfono móvil cuyo número diste de alta por primera vez al configurar el administrador de la alarma. Para acceder nuevamente al monitor serial, envía desde el teléfono del administrador el comando “monitor”. Esto te permitirá también borrar la memoria de datos de la alarma desde el monitor serial de JOGATECHProyex.
Versión 1.0 Fecha de creación: 8/1/2017 Última revisión: 28/1/2017
