Información técnica para integradores que desean conectar con lectores Baqueano


Los lectores Baqueano permiten la conexión via Bluetooth con otros dispositivos, para integrarse con aplicaciones de terceros.
Cada vez que se lea un animal, el lector enviará al dispositivo conectado el IDE completo, en el formato de 15 dígitos.


Valores importantes

Title
Valor
Bluetooth
BLE v4.2
Nombre dispositivo
Baqueano BLE xxx
GATT - Id Servicio serial
0000fff0-0000-1000-8000-00805f9b34fb
GATT - Id característica lectura
0000fff1-0000-1000-8000-00805f9b34fb
Pin Bluetooth
0000
Formato IDE
ASCII 15 dígitos + CR


Perfiles de conexión

El lector tiene un módulo Bluetooth BLE v4.2 y publicita los siguientes perfiles:

Perfil HID (teclado)

Este modo permite que el lector aparezca para el otro dispositivo como un periférico, como si fuera un teclado. No importa que aplicación esté abierta, siempre que ésta tenga el foco en un campo de texto, se escribirá automáticamente el IDE leído en el lector.

Los lectores Baqueanos vendidos hasta el primer semestre de 2025 inclusive, no soportan la conexión HID a macOS ni iOS. Los lectores posteriores a esa fecha si serán compatibles con HID en macOs y iOS. Para confirmar, revisar en la etiqueta trasera del dispositivo si el número serial contiene una "e":SN: H20-eXXXX Check Mark Button SN: H20-XXXX Cross Mark 

Perfil GATT

Para conectar con este perfil, el dispositivo debe inciar la conexión con el lector.
Si se solicita PIN, este es 0000.
El lector figurará con el nombre "Baqueano BLE {SN}", siendo "{SN}" el nro serial del lector. Ej "Baqueno BLE 1780".El lector publicita un servicio serial con una característica de lectura, la cual soporta noficiaciones:
  • Id del servicio: 0000fff0-0000-1000-8000-00805f9b34fb
  • Id de la característica: 0000fff1-0000-1000-8000-00805f9b34fb

Por el momento, el lector no recibe comandos de ningún tipo desde aplicaciónes de terceros.


Formato del IDE

El IDE leído se envía en formato ASCII y con un caracter de CR al final ("\r"). Del identificador se envían sus 15 caracteres, sin espacios ni otros separadores entre el código de país y el identificador de animal.Ej:
858000012345678\r


Configuración del lector

Para que un dispositivo pueda conectarse a un lector y luego recibir el IDE, se deben realizar algunos pasos en el lector.


1 - Configurar el modo adecuado de Bluetooth (una sola vez)

Previo a establecer la conexión, en el lector se debe seleccionar el modo adecuado de Bluetooth. Para ésto, acceder a Menu / Bluetooth, y seleccionar el modo "PC/Android".
Este modo también permite que un teléfono iOS se conecte al lector, por lo que el nombre no es del todo correcto. Es probable que en próximas versiones se cambie este nombre.

Cuando un dispositivo se conecta satisfactoriamente al lector, se encenderá el led Azul del lector. Además, la barra de estado de la pantalla principal mostrará el ícono de Bluetooth.


2 - Seleccionar alguna tarea que envíe IDE en tiempo real (en cada sesión creada)

En el lector Baqueano, a las acciones que suceden luego de leer un IDE, se le llaman tareas.
Al crear una sesión, el lector muestra una pantalla que indica "Elija tarea".
Existe una tarea especial que se llama "IDE [ícono de Bluetooth]", que es la que envía el IDE al dispositivo.
También existen combinaciones de esta tarea con otras tareas como por ejemplo "IDE [ícono de Bluetooth]+tarea de registro".

En versiones más antiguas del firmware del lector, esta tarea tenía otros nombres como "IDExBluetooth" o "Envío de IDE".
Lo importante a tener en cuenta es que no alcanza con que el lector esté conectado con otro dispositivo. Para que el lector envíe el IDE, tiene que seleccionarse alguna de las tareas mencionadas .



Soporte para integraciones

Por requerimientos de integraciónes, comunicarse con
Product Manager