GetBlue: manual de usuario

GetBlue automatiza las tareas de adquisición de datos y ofrece características de comunicación manual para dispositivos Android®. GetBlue captura los datos del dispositivo y los muestra o los procesa. Dos características destacadas de GetBlue son la posibilidad de rellenar una hoja de cálculo de Google y emular la entrada de usuario con los datos del dispositivo (pe. escaneando un código de barras con un escaner Bluetooth directamente en una app). GetBlue puede también utilizarse como un "proxy" entre dispositivos y protocolos.

Introducción

Bluetooth SPP / TCP Kommunikation für Android

GetBlue ofrece versátiles funciones de captura de datos para dispositivos Android con la versión 1.6 o superior. GetBlue captura automáticamente los datos desde orígenes de datos regulables como dispositivos Bluetooth SPP (soporta clientes Bluetooth y servidores Bluetooth), HTTP o TCP/IP y desde apps de escáner de cámara. Los datos recogidos se muestran, registran, almacenan, reenvían, o se introducen como la entrada de usuario virtual en otras apps. En este contexto se llama datasink al colector de los datos capturados.

Soporta comunicación bidireccional. Si se configura, las respuestas del datasink (como códigos de estado HTTP) son enviadas de vuelta al origen de datos.

En general GetBlue funciona como un conmutador cruzado o Proxy. Transfiere los datos entre distintos terminales independientemente del protocolo de los dispositivos utilizados (pe. recibir datos de un escáner de código de barras con Bluetooth SPP y enviar los datos mediante sockets TCP/IP a la aplicación servidor). Si es necesario, GetBlue puede funcionar como los llamados teclado virtual (keyboard wedge): en este caso, se utiliza GetBlue para emular la entrada de usuario con los datos capturados del dispositivo. Los datos recibidos son introducidos simulando las pulsaciones del teclado en apps de terceros.

Dispone de GetBlue con un simple archivo APK. Este archivo APK contiene el servicio del sistema que es responsable de la comunicación del dispositivo en segundo plano y una interfaz para la configuración y tareas de captura de datos manual. El servicio del sistema está disponible como SDK para terceros. Eche un vistazo a la sección concesión de licencias para más detalles.

Lo esencial

Para la captura automática de datos con GetBlue necesita configurar algunas opciones fundamentales. Los ajustes más importantes son los orígenes de datos (pe. un lector de código de barras por Bluetooth) y el destino datasink (pe. una hoja de cálculo de Google Docs).

Una vez se ha iniciado la captura de datos, los datos del dispositivo son recogidos por el servicio de GetBlue en segundo plano. Este servicio del sistema es invisible al usuario y garantiza la conectividad ininterrumpida con el dispositivo, el servicio intenta reconectar automáticamente en caso de desconexión. El servicio también es responsable de reenviar los datos recibidos del origen de datos al datasink de destino configurado de manera correcta.

Abrir una conexión de un origen de datos o un datasink se realiza según las políticas de apertura. Se puede configurar el número de reintentos así como el intervalo entre reintentos. Tras abrir con éxito la conexión, GetBlue divide los datos recibidos del origen de datos en paquetes (ver políticas de lectura).

Un paquete de datos se define por

  • el número máximo de bytes (tamaño del paquete),
  • el tiempo necesario para recibirlo (medido desde el primer byte del paquete)
  • o por un secuencia de caracteres delimitadora (que es una expresión regular).

Si al menos uno de los tres parámetros se cumple, GetBlue asume que el paquete está completo y lo envía al datasink. GetBlue queda listo para recibir el próximo paquete de datos.

Orígenes de datos soportados

GetBlue es capaz de capturar datos de los siguientes dispositivos o terminales:

  • Bluetooth SPP y Bluetooth RFCOMM
    Pueden utilizarse todos los dispositivos Bluetooth que soportan Serial Port Profile (como los escáneres de código de barras SPP o RFCOMM). GetBlue soporta modo Bluetooth cliente y servidor, por lo que es posible conectar con dispositivos así como con PC.
  • TCP (texto sin formato)
    Cualquier dispositivo que provea un socket raw TCP/IP. Soporta conexiones TCP/IP en modo cliente y servidor.
  • USB (puerto serie)
  • HTTP
    Cualquier aplicación HTTP que soporte peticiones HTTP GET o HTTP POST. Los parámetros de la petición son configurables.
  • Escáneres de cámara
    GetBlue le ofrece la posibilidad de utilizar apps de escáner de código de barras de terceros.
  • Introducción manual de datos
    Pueden introducirse manualmente comandos del dispositivo.

Colectores de datos soportados

Los datos capturados pueden reenviarse a los siguientes colectores de datos (datasinks):

  • Pantalla
    Cambia entre visualización en HEX o ASCII.
  • Otro dispositivo Bluetooth SPP
    Son posibles clientes Bluetooth así como servidores Bluetooth.
  • TCP/IP (texto sin formato)
    Permite clientes TCP así como servidores TCP.
  • HTTP
    Métodos GET y POST con parámetros ajustables.
  • Teclado
  • Archivo
    Cualquier archivo de la tarjeta SD.
  • Hoja de cálculo de Google Docs
    Los datos capturados son subidos inmediatamente a una hoja de cálculo de Google Docs.
  • Apps de terceros
    Utilice el teclado GetBlue como pulsaciones virtuales para introducir los datos capturados en cualquier app que acepte la entrada de usuario (modo teclado virtual keyboard wedge).
Pantalla principal

Pantalla principal

En la parte superior de la pantalla principal (vista datos), GetBlue muestra los datos recibidos como caracteres ASCII o en formato hexadecimal (mirar opciones de la pantalla principal). En la parte inferior de la pantalla (vista del registro), GetBlue muestra un registro con información, avisos y mensajes de error.

  • Opciones disponibles en la vista de datos

    Con un toque sobre la vista de datos se abre el menú que ofrece los comandos contextuales:

    Copiar línea

    Copiar la línea seleccionada en el portapapeles.

    Copiar todo

    Copiar todos los datos en el portapapeles.

    Guardar en archivo

    Guarda los datos recibidos en un archivo.

    Enviar a

    Envía la línea seleccionada a otra aplicación (pe. Gmail, Google Buzz, una etiqueta NFC, etc.).

    Limpiar

    Limpia la vista.

  • Opciones disponibles en la vista de registro

    Haciendo tap sobre la vista del registro se abre un menú que ofrece comandos contextuales:

    Limpiar

    Limpia el registro.

  • Botones disponibles
    Iniciar/Parar

    Inicia o detiene la adquisición de datos. Si está iniciada, GetBlue recibe los datos de un origen de datos y los reenvía a un datasink. Los datos capturados se muestran siempre en la vista de datos de la pantalla principal.

    Enviar datos

    Enviar manualmente los datos introducidos a un dispositivo conectado.

  • Comandos de menú disponibles
    Ajustes

    Ajusta el origen de datos, datasink, políticas de apertura, política de lectura, ajustes de la pantalla principal y opciones de comunicación bidireccional. En la sección acerca de tiene acceso a este manual de usuario, al copyright así como a la información de la versión.

    Conmutar registro

    Este comando le permite esconder o mostrar la vista de registro.

    Salir

    Este comando cierra GetBlue y elimina el servicio que es parte de GetBlue en segundo plano de la memoria.

Dispositivos de entrada

Dispositivos de entrada (Origen de datos)

Después de iniciar la captura de datos con el botón Inicio en la pantalla principal, GetBlue abre la conexión según la políticas de apertura, monitorea el origen de datos en busca de datos, los lee, los procesa según lo especificado en política de lectura y los envía al datasink especificado.

Están soportados los siguientes orígenes de datos:

  • Ninguno

    Seleccione Ninguno si necesita probar la conectividad con un datasink.

  • Bluetooth

    GetBlue soporta modo Bluetooth cliente así como Bluetooth servidor.

    Cliente Bluetooth

    Utilice el modo cliente si necesita conectar con un dispositivo que envía los datos por sí mismo (como un escáner de código de barras Bluetooth).

    Si el modo cliente está seleccionado enumera los dispositivos Bluetooth dentro del alcance (como alternativa puede introducir directamente la dirección Bluetooth del cliente). Tenga en cuenta por favor: ¡Necesita emparejar su dispositivo Bluetooth con su smartphone! Se recomienda hacerlo antes de iniciar GetBlue.

    Servidor Bluetooth

    Utilice el modo servidor si otro dispositivo cliente Bluetooth está conectado a su teléfono (pe. si quiere conectar desde un PC con Microsoft Windows con su teléfono, el PC normalmente actúa como cliente). En modo servidor ningún dispositivo especificado puede seleccionarse. Por favor, tenga en cuenta que se recomienda emparejar su dispositivo Bluetooth antes de activar el modo Bluetooth servidor.

  • USB (puerto serie)

  • TCP (texto sin formato)

    GetBlue soporta modo cliente TCP/IP y servidor TCP/IP.

    Cliente TCP/IP

    utilice el modo cliente si necesita conectar con un servidor TCP. Indique el nombre host o dirección IP del dispositivo TCP/IP y ajuste el puerto con el que GetBlue deberá conectar.

    Servidor TCP/IP

    Utilice el modo servidor si otro cliente TCP/IP cliente (pe. un cliente telnet) se conecta a su teléfono. en el modo servidor TCP/IP la dirección IP de su teléfono se muestra como sólo de lectura. Tan solo necesitará indicar un puerto al que su cliente deberá conectarse.

  • HTTP

    Especifique el nombre de Host (o dirección IP) / puerto del servidor HTTP al que GetBlue debe conectarse. Además seleccione que método HTTP GET (por defecto) o HTTP POST utilizará para las peticiones.

  • Camera Scanner

    Cuando selecciona esta entrada, GetBlue muestra un diálogo con las apps de escáner de código de barras de terceros. Deberá seleccionar una aplicación de escáner o elegir Preguntar siempre. En este caso GetBlue preguntará por el escáner de cámara a utilizar.

Dispositivo de salida

Dispositivo de salida (Datasink)

El término datasink se refiere al punto final al que se envían los datos capturados desde el origen de datos. Están disponibles los siguientes datasinks:

  • Ninguno

    Seleccione esta opción si necesita probar la conectividad de un origen de datos. Los datos capturados tan solo son mostrados en la sección datos de la pantalla principal. Ningún otro proceso se realiza con los datos.

  • Bluetooth

    Seleccione Bluetooth si necesita reenviar los datos recibidos del origen de datos a otro dispositivo Bluetooth. Soporta modo cliente Bluetooth así como servidor Bluetooth. Para más información mire orígenes de datos Bluetooth.

  • TCP (texto sin formato)

    Seleccione TCP si necesita reenviar los datos recibidos del origen de datos mediante un socket TCP/IP. Los paquetes de datos no son modificados, como son recibidos del origen de datos. Está disponible el modo cliente TCP y servidor TCP. Para más información mire TCP/IP orígenes de datos.

  • HTTP

    Indique la URI (nombre de Host o dirección IP, puerto opcional) del servidor HTTP al que GetBlue enviará los datos capturados. Proporcione cualquier parámetro estático (como ID de usuario) de esta URI. Separe el puerto opcional cin una coma (pe. http://172.16.100.1:8080?myparam=something).

    Utilizar el método POST

    Seleccione si debe usar el método HTTP GET (por defecto) o HTTP POST para reenviar los datos.

    Parámetro Datos

    Los datos se reenvían utilizando este nombre libremente ajustable. Por defecto es "Datos".

    Parámetro Marca de tiempo

    La marca de tiempo de los datos recibidos se envía al datasink destino utilizando este nombre de parámetro configurable libremente. Por defecto es "Timestamp".La marca de tiempo contiene la hora del sistema en milisegundos desde el 1 de enero de 1970 00:00:00 UTC.

  • Teclado

    Seleccione teclado si quiere que GetBlue funcione como un programa de enlace. En este modo de operación GetBlue inserta los datos recibidos en apps de terceros. Esto lo realiza simulando las pulsaciones mediante el teclado GetBlue.

    Por favor tenga en cuenta: Necesita activar el teclado GetBlue y el método de entrada GetBlue para ello:

    1. primero active el Teclado GetBlue en los Ajustes de Android (confirmando la advertencia de seguridad),
    2. después active el método de entrada Teclado GetBlue. Haga esto con un toque prolongado en cualquier campo de edición y seleccione el método de entrada Teclado GetBlue.
    Sonido al pulsar tecla

    Ajusta si al pulsar una tecla debería producir un sonido para mejor confirmación.

    Vibrar al pulsar tecla

    Ajusta si al pulsar una tecla debería producirse una pequeña vibración para mejor confirmación.

    Prefijo de datos por defecto

    Si lo necesita, el paquete de datos recibido desde el origen de los datos puede ajustarse por delante con la secuencia de caracteres deseada. Utilice los siguientes marcadores de posición para controlar el cursor o el foco antes de la introducción de los datos recibidos: ${ENTER} o ${E}, ${TAB}/${T}, ${DOWN}/${D}, ${UP}/${U}, ${LEFT}/${L} , ${RIGHT}/${R}. El prefijo de datos por defecto solo se aplica si no se ha especificado ningún prefijo para la aplicación (ver más abajo).

    Sufijo de datos por defecto

    Si lo necesita, el paquete de datos recibido desde el origen de los datos puede ajustarse por detrás con la secuencia de caracteres que desee. Utilice los siguientes marcadores de posición para controlar el cursor o el foco tras la inserción de los datos recibidos: ${ENTER} o ${E}, ${TAB}/${T}, ${DOWN}/${D}, ${UP}/${U}, ${LEFT}/${L} , ${RIGHT}/${R}. El sufijo de datos por defecto solo se aplica si no se ha especificado ningún sufijo para la aplicación (ver más abajo).

    Prefijo/Sufijo de aplicación

    El prefijo y sufijo de la aplicación controla el comportamiento del teclado GetBlue según la aplicación de destino. Esta opción es útil si utiliza el teclado GetBlue con diferentes aplicaciones destino que necesiten diferentes ajustes para los movimientos del cursor o selección del foco.

    Para crear nuevas políticas de aplicación pulsar sobre el botón Agregar política de aplicación. Luego seleccione la aplicación de destino e introduzca los prefijos y sufijos específicos. Además puede seleccionar si los datos deberían enviarse como simples cadenas de datos o como pulsaciones de teclado. Se recomienda la simulación de teclas para navegadores o aplicaciones de destino RDP.

    Para modificar o borrar una política existente (pe. políticas predefinidas para el navegador de Android) tan solo haga un toque prolongado sobre la entrada.

    Activar Teclado GetBlue

    Es un acceso directo para abrir Ajustes de Android -> Idioma y teclado .

  • Archivo

    Seleccione la opción archivo si quiere guardar los datos capturados en un archivo en su tarjeta SD.

    Guardar datos planos

    Los datos recibidos del origen de datos se escriben en el fichero "tal cual"; si lo selecciona no se añadirán marcas de tiempo

  • Hoja de cálculo de Google

    Seleccione esta entrada si desea guardar los datos del dispositivo directamente en una hoja de cálculo de Google. Indique su cuenta de usuario de Google Docs y su contraseña, el nombre de la hoja de cálculo y un nombre opcional de hoja de trabajo. Los datos recibidos del origen de datos se reenvían inmediatamente a su hoja de cálculo (se necesita conexión a Internet).

    Cuenta de Google

    La dirección de correo electrónico utilizada para acceder a su cuenta de Google Docs. La dirección de correo se utiliza exclusivamente para acceder a la hoja de cálculo especificada debajo. ¡No se utiliza con ningún otro propósito y no se envía a TEC-IT!

    Contraseña

    Es la contraseña de su cuenta Google Docs. Se utiliza exclusivamente para acceder a la hoja de cálculo especificada a continuación. ¡No se utiliza con ningún otro propósito, no se envía a TEC-IT!

    Nombre de documento / Hoja de cálculo

    El nombre de una hoja de cálculo existente en Google Docs.
    GetBlue no puede crear hojas de cálculo, es necesario que haya creado una hoja de cálculo vacía manualmente. Para ello, regístrese en Google Docs, haga clic en Crear nuevo y seleccione Hoja de cálculo. Luego guarde la hoja de cálculo vacía seleccionando Archivo y Guardar desde el menú. El nombre utilizado debe introducirse en GetBlue. Si el nombre no concuerda recibirá un error cuando inicie la adquisición de datos.

    Nombre de la Hoja de trabajo de la Hoja de cálculo

    El nombre de la hoja de trabajo donde se guardarán los datos. Si no especifica ninguno la hoja de trabajo se denominará GetBlue Demo.

Comunicación bidireccional

Esta opción le permite establecer una comunicación bidireccional entre el origen de datos y el datasink. Selecciónelo para indicar a GetBlue que envíe la respuesta del datasink (si lo hay) al origen de datos.

Ejemplo: GetBlue captura datos del dispositivo (pe. desde un escáner Bluetooth de código de barras) y reenvía los datos a un servidor TCP actuando como datasink. El servidor TCP reconoce los datos con una respuesta la cual es dirigida de vuelta al dispositivo origen de datos.

Ejecutar por defecto

Utilizando esta opción puede iniciar automáticamente GetBlue al encender su dispositivo. Dispone de 3 opciones:

No abrir

GetBlue debe iniciarse manualmente.

Adquisición en segundo plano

El servicio GetBlue se inicia con la última configuración, conecta con el origen de datos y el datasink e inicia la operación.

Solamente servicio

El servicio GetBlue se inicia sin confirmación. Los usuarios de GetBlue SDK (más detalles disponibles en peticiones) pueden configurar los parámetros de comunicación e iniciar y parar la recogida de datos de forma programada.

Ajustes

Política de apertura del dispositivo

Utilice esta configuración para ajustar el comportamiento al abrir una conexión con un origen de datos o un datasink.

Tiempo de espera de reintento

Si una conexión abierta falla, GetBlue espera el número de milisegundos especificados antes de reintentar.

Reintentos

El número total de reintentos cuando se abre una conexión. Si no se establece la conexión después del número de reintentos especificados se genera un error.

Política de lectura de datos

Utilice estos parámetros para indicar a GetBlue como organizar los datos recibidos.

GetBlue agrupa automáticamente los datos recibidos en paquetes de datos. Un paquete de datos se define por el tiempo necesario para ser revivido, por el número total de bytes o, finalmente, por una expresión regular. Puede combinar estos ajustes como lo necesite.

Tiempo de espera

Es el tiempo máximo (en milisegundos) para recibir el paquete de datos. Todos los bytes recibidos durante este tiempo se entregan en un solo paquete.

Tamaño

El número máximo de bytes para un paquete de datos.

Separador

Una expresión regular que coincide con la secuencia de caracteres utilizada para marcar el final del paquete de datos.

Incluir separador

Si está seleccionado, la secuencia de separación es incluida como parte del paquete de datos. Si no está marcado, la secuencia del separador es eliminada de los datos capturados.

Opciones de la pantalla principal

Opciones de la pantalla principal

Estos ajustes controlan el comportamiento de la pantalla principal.

Hexadecimal

Normalmente los datos recibidos se muestran como caracteres ASCII. Seleccione esta opción para mostrar los datos en hexadecimal.

Filas de datos

Especifica el número máximo de filas de datos mostradas en la vista de datos. El valor 0 indica que no hay límite.

Tamaño de fuente de datos

Especifica el tamaño de la fuente de la vista datos. El valor por defecto es 14.

Tamaño de fuente de registro

Especifica el tamaño de la fuente de la vista de registro. El valor por defecto es 14.

Mostrar detalles de registro

Seleccione entre información de registro básica o detallada.

Mostrar respuesta

Utilice esta opción para seleccionar si la respuesta del datasink debe mostrarse (si existe) en la vista de datos. La respuesta se muestra con otro color.

Acerca de

Acerca de

Esta opción proporciona comandos para visualizar el manual de usuario, la versión del programa y la información del copyright. Además puede mostrar su información de licencia o introducir una licencia manualmente.

Manual de usuario

Este comando muestra esta página web en su navegador. Por favor contacte con nosotros en caso de dudas, sugerencias o si quiere informar de algún error.

Vídeos YouTube

Este comando abre el canal YouTube de TEC-IT con vídeos de adquisición de datos relevantes.

Licencia

Este comando abre un dialogo que muestra el estado actual de su licencia. En este diálogo también tiene posibilidad de activar la licencia GetBlue manualmente introduciendo una licencia certificada. Esta característica es útil para activar la licencia sin acceder a Android Market o para licencias a granel.

Acerca de

Muestra la versión del programa actual, una nota de copyright y créditos de terceros.

Enviar datos de forma manual

Enviar datos manualmente

Esta función le permite enviar datos introducidos manualmente a los dispositivos conectados (un origen de datos o un datasink). Esta función es especialmente útil para hacer pruebas y enviar comandos de control. Los botones Enviar al Origen y Enviar al Datasink solo están habilitados si se configuró un terminal apropiado en los Ajustes.

Puede seleccionar entre entrada normal (texto ASCII, por defecto) o entrada HEX. En este último caso GetBlue solo acepta caracteres hexadecimales como entrada (0..9, A-F).

El botón Historial proporciona acceso a los últimos valores introducidos.

Tenga en cuenta que cuando envía un comando HTTP GET a un servidor web recibirá gran cantidad de datos como respuesta.

Concesión de licencias

GetBlue puede licenciarse via Android Market (pago por uso) o aplicando un certificado de licencia manualmente. Un certificado de licencia manual es ideal para usuarios sin acceso a Android Market o para activar licencias a granel. Con el fin de poder activar la licencia de GetBlue sin Android Market necesita descargar GetBlue APK desde http://www.tec-it.com (la versión disponible en Android Market no puede licenciarse manualmente).

GetBlue APK de tec-it.com necesita permisos adicionales como acceso al IMEI pero ofrece las siguientes características para activar la licencias:

  • Activar licencia utilizando el IMEI
  • Activar licencia utilizando ID de dispositivo de Android
  • Activar licencia con otras apps instaladas (nombres de paquete)
    Para licencias a granel vinculando GetBlue o GetBlue SDK con su app
  • Una licencia puede ser válida indefinidamente o por un periodo limitado (fecha de expiración)
Un certificado de licencia manual se instala abriendo los Ajustes de GetBlue. Desplácese abajo a la sección Acerca de y haga tap en Licencias. Utilice el botón Manual... para pegar el certificado en el campo de edición de la clave de licencia.

Hay licencias disponibles para GetBlue (entrada GUI + servicio del sistema para la captura de datos) o para el GetBlue SDK (sin entrada GUI, solo el servicio). Por favor, contacte con nosotros para un precio al por mayor, solicitud de licencia general o para adquirir uno o mas certificados de licencia.