DRIVER BT
(Programas externos)
DESCRIPCIÓN
Aplicación para lectura de dispositivos Bluetooth con PDAs, desde programas externos
a nuestra aplicación GESTIMAQ MÁQUINAS PDA. En caso de ser usuario de la
aplicación GESTIMAQ MÁQUINAS PDA no es necesaria la instalación de este software,
ya que la lectura de los dispositivos se realiza desde la misma aplicación.
FUNCIONALIDAD
El programa puede ser invocado desde cualquier aplicación que corra en dispositivos
PDA bajo Windows mobile 5 o superior. (Consultar otras versiones)
La ruta de ubicación del software es \Archivos de programa\BTGTMQ\DriGes.vce
Antes de ejecutar cada llamada a la aplicación-driver se deberá crear/modificar un
fichero de texto en el directorio raíz, con los parámetros requeridos para la conexión con
el dispositivo actual. (Ver fichero de entrada).
Como resultado se obtendrá un fichero de salida con los datos de lectura y conexión con
el dispositivo Bluetooth previamente especificado en el fichero de entrada. (Ver fichero
de salida).
Es aconsejable que su aplicación borre el fichero de salida, una vez importado los datos,
ya que esto puede ayudarle a conocer el momento en que la aplicación BT-Driver ha
finalizado y poder así comenzar, desde su aplicación, la importación de los datos del
fichero de salida. (El fichero OUTGTMQ.TXT se crea (o modifica) para devolver los datos
de la conexión realizada, por lo que esta funcionalidad puede servir para indicar en que
momento debe comenzar la importación de los datos del fichero de salida).
La aplicación, en cada llamada, puede actuar de forma diferente según las necesidades
del usuario. Las diferentes formas de actuación de BT-Driver serán especificadas
mediante el parámetro insertado en el campo C4 del fichero de entrada. Este parámetro
de acción y permisos indica lo siguiente:
“1” Indica que el usuario, en caso de error de comunicaciones, podrá introducir
manualmente los contadores en la propia aplicación BT-Driver, indicándose en el
fichero de salida contadores introducidos, tipo de lectura realizada manualmente, tipo de
error, fecha, hora, etc.
“2” Indica que el usuario, en caso de error de comunicaciones, no podrá introducir
manualmente los contadores pero sí reintentar las conexiones, desde la propia aplicación
BT-Driver. El fichero de salida, en este caso, si no se efectúa la lectura automática, sólo
indicará el tipo de error, fecha y hora de intento de conexión. En caso de error, su
aplicación debería permitir la introducción manual de contadores.
“3” Indica que se devuelva el control a la aplicación principal en caso de error, es decir,
termina la ejecución de Bt-Driver sin posibilidad de efectuar lectura manual de
contadores ni reintentos de conexión, especificándose únicamente en este caso en el
fichero de salida, el tipo de error, fecha y hora de intento de conexión. En este caso es
aconsejable que su aplicación permita reintentar la llamada a Bt-Driver por si el fallo de
conexión hubiera sido debido a distancia, interferencias, etc.
“9” La aplicación se abrirá en la pantalla de configuración de contadores iniciales del
dispositivo, permitiendo que el usuario introduzca manualmente los contadores que se
han de grabar como iniciales. En el fichero de salida se reflejarán los contadores
introducidos en el dispositivo, fecha y hora de configuración y por último el resultado
de configuración en C10 del fichero de salida.
FICHERO DE ENTRADA
Fichero con datos obligatorios para conexión con dispositivo bluetooth:
Nombre de Fichero: INGTMQ.TXT
Ubicación: Directorio raíz
Formato: Texto
Número de registros: 2 únicos y obligatorios (cabecera y datos)
Numero de campos: 10
Limitador de campo en registro de cabecera: ninguno
Limitador de campo en registro de datos: “ (dobles comillas)
Separador de campos en registros de cabecera y de datos: , (coma)
1. Registro de cabecera:
Nombres de los campos. Introducir exactamente igual, sin espacios en blanco, la
siguiente cadena
C1,C2,C3,C4,C5,C6,C7,C8,C9,C10
2. Registro de datos:
Campo 1: DIRECCIÓN del dispositivo incluyendo el signo “:”
Campo 2: „3554’
Campo 3: CÓDIGO DE SEGURIDAD proporcionado con el paquete.
Campo 4: PARÁMETRO DE ACCIÓN Y PERMISOS de la aplicación. (Ver funcionalidad)
Campo 5: Tipo de PDA. Valores: 8 para modelo HP hx2190 ; 6 para mod. HP ipaq 114
Resto de campos: Cadena vacía (separada por comas y limitada por doble comillas)
Ejemplo de fichero para conexión con Dispositivo 00:45:3f:46:78:4e, PIN 123456789,
Código de seguridad proporcionado 2524 y parámetro 1 que habilita reintentos y
lectura manual desde la propia aplicación BT-Driver, en caso de error. Mod. hx22190.
INGTMQ.TXT
C1,C2,C3,C4,C5,C6,C7,C8,C9,C10
“00:45:3f:46:78:4e”,”1234567890”,”2524”,”1”,”8”,””,””,””,””,””
Ejemplo para realizar configuración de contadores en dispositivo Bluetooth:
C1,C2,C3,C4,C5,C6,C7,C8,C9,C10
“00:45:3f:46:78:4e”,”1234567890”,”2524”,”9”,”8”,””,””,””,””,””
FICHERO DE SALIDA
Fichero que contiene el resultado de lectura y datos de conexión con el dispositivo:
Nombre de Fichero: OUTGTMQ.TXT
Ubicación: Directorio raíz
Formato: Texto
Número de registros: 2 (cabecera y datos)
Numero de campos: 10
Limitador de campo en registro de cabecera: ninguno
Limitador de campo en registro de datos: “ (dobles comillas)
Separador de campos en registros de cabecera y de datos: , (coma)
1. Registro de cabecera:
Nombre de los campos para su identificación (código)
C1,C2,C3,C4,C5,C6,C7,C8,C9,C10
2. Registro de datos:
Contendrá los datos y resultados de la conexión (separados por comas y en el mismo
orden que el registro de cabecera)
(C1) Contador de Entradas
(C2) Contador de Salidas
(C3) Número de desconexiones del dispositivo
(C4) Tiempo global de funcionamiento del dispositivo (hh:mm)
(C5) Tipo de lectura realizada. Valores: 0 = Sin lectura ; 1 = Bluetooth ; 2 = Manual
(C6) Tipo de Error. Valores: 0 = Sin error ; 1 = Error conexión ; 2 = El dispositivo no
ha respondido ; 3 = Error especifico del dispositivo indicando que ha sufrido manipulación
(C7) Número de reintentos blandos
(C8) Número de reintentos duros
(C9) Fecha y Hora de la lectura (Bluetooth o Manual) (dd/mm/aa hh:mm:ss)
(C10) Resultado de configuración de contadores internos. Valores: 0 = No se ha
conseguido configurar los contadores ; 1 = Configuración correcta
Ejemplos de fichero de salida de datos
OUTGTMQ.TXT
Conexión correcta y lectura de datos sin reintentos
C1,C2,C3,C4,C5,C6,C7,C8,C9,C10
“8465241”,”7325121”,”7”,”125:40”,”1”,”0”,”1”,”0”,”19/01/09 10:45:27”,”0”
Lectura manual por fallo de conexión con dispositivo después de 3 reintentos blandos y
1 duro.
C1,
C2,
C3, C4,
C5, C6, C7, C8, C9,
C10
“8944241”,”6325120”,”8”,”1740:54”,”2”,”1”,”3”,”1”,”19/01/09 12:47:35”,”0”
(Los espacios en blanco en el registro de cabecera de este ejemplo han sido introducidos
manualmente en este documento para ajustar el nombre del campo a su contenido)
Configuración por el usuario de contadores iniciales del dispositivo y realizada con
éxito (C10 = 1).
C1,C2,C3,C4,C5,C6,C7,C8,C9,C10
“7592315”,”5632511”,””,””,””,””,””,””,”19/01/09 10:45:27”,”1”
0
