Comando BS IoT
Configuración de sensores Bluetooth Low Energy (BLE) con soporte para múltiples tipos de dispositivos.
¿Para qué sirve?
| Caso de uso | Descripción |
|---|---|
| 🌡️ Monitoreo ambiental | Lectura de temperatura, humedad y presión con sensores BLE |
| ⛽ Control de combustible | Sensores Escort TD para nivel de combustible wireless |
| 🚪 Detección de puertas | Sensores magnéticos BLE para estado de puertas |
| 🏃 Detección de movimiento | Sensores PIR y acelerómetros BLE |
| 📊 Telemetría avanzada | Integración de múltiples sensores en un solo dispositivo |
Descripción
El comando BS permite configurar hasta 4 sensores BLE en dispositivos IoT. Soporta una amplia variedad de tipos de sensores incluyendo iBeacon, Eddystone, sensores Rinho, sensores Escort, el sensor de combustible Technoton DUT-E y los sensores Eurosens Degree BT y DPS Bt.
Para cada sensor configurado se crea automáticamente una señal BSaa que puede utilizarse en el motor de eventos.
Características
- 4 sensores - Índices 00-03 configurables independientemente
- Más de 20 tipos de sensores - iBeacon, Eddystone, Rinho, Escort, Technoton, Eurosens
- Consulta de atributos - Lectura individual de valores específicos
- Timeout configurable - Control de estado por tiempo sin actualización
- Integración con reglas - Uso en motor de eventos
Comandos
Configuración
SBSaab,id,type,time,distance,outvalRespuesta
RBSaab,id,type,time,distance,outval;attrkeyvalue_0,...attrkeyvalue_NParámetros
| Parámetro | Descripción |
|---|---|
aa | Índice del sensor (00 a 03) |
b | Estado del sensor (E = habilitar, D = deshabilitar, * = limpiar configuración) |
id | Dirección MAC del dispositivo BLE en formato hexadecimal (12 caracteres) |
type | Tipo de sensor BLE (ver lista de tipos). Con 0 el equipo acepta el tipo que detecte; con otro valor, el sensor se actualiza solo si el tipo detectado coincide |
time | Tiempo en segundos sin actualización para considerar la señal en falso |
distance | Distancia en metros para sensores como iBeacon |
outval | Valor a mostrar cuando la lectura no es válida |
attrkeyvalue | Atributo del sensor, clave:valor |
Señales Asociadas
| Señal | Índice | Uso condicional | Flancos |
|---|---|---|---|
BSaa | 00-03 | SI | + Flanco positivo, - Flanco negativo |
Tipos de Sensores Disponibles
Sensores iBeacon y Eddystone
| Tipo | Nombre | Atributos |
|---|---|---|
| 0 | Sensor Automático | Sin atributos específicos |
| 1 | iBeacon | uuid, major, minor, tx_power, rssi, distance |
| 2 | Eddystone UID | namespace, instance, rssi |
| 3 | Eddystone TLM | batt, temp, adv_cnt, sec_cnt |
| 4 | 3 Ejes Acelerómetro | x, y, z, batt, ranging_data, adv_int, sr, full_scale, mt, rssi |
Sensores Rinho BLE
| Tipo | Nombre | Atributos |
|---|---|---|
| 5 | Información del Dispositivo | battery, adv_int, ranging_data, dv_prop_ind, switch_s_ind, fwt, fw, rssi |
| 6 | Botón MK | accX, accY, accZ, batt, triggerStatus, triggerCount, deviceId, rssi |
| 7 | Temperatura y Humedad | temp, hum, battery, ranging_data, adv_int, device_type, rssi |
| 8 | PIR (Infrarrojo Pasivo) | door_status, battery, delay_response_status, sensor_sensitivity, detection_status, major, minor, rssi |
| 9 | Sensor de Puerta (MK Door) | door_status, delay_response, sensor_sensitivity, detection_status, batt, major, minor, rssi |
| 10 | MK Sensor Info | mag_st, mot_st, mag_cnt, mot_cnt, x, y, z, temp, hum, batt, tag, rssi |
Sensor MOKO S02R (ToF)
| Tipo | Nombre | Atributos |
|---|---|---|
| 11 | MOKO S02R (ToF) | dist, batt, rssi, type, age |
El sensor MOKO S02R mide distancia por Time-of-Flight (ToF) y expone dos lecturas principales:
| Atributo | Descripción | Unidad |
|---|---|---|
dist | Distancia medida por ToF | milímetros (mm) |
batt | Tensión de batería del sensor | milivoltios (mV) |
Estos valores están disponibles a través de QBS, EVAL y de la auto-detección BSW.
Configuración (tipo 11):
>SBS00E,A1B2C3D4E5F6,11,0,0,NA<
// Índice 00, Habilitado (E), MAC del sensor
// 11 → MOKO S02R (ToF)
// time=0, distance=0, outval=NAConsulta de lecturas:
>QBS00.dist< // Distancia en mm
>QBS00.batt< // Batería en mVSoporte para el sensor MOKO S02R (tipo 11) disponible desde el firmware v1.09.23.
Sensores Escort BLE
| Tipo | Nombre | Atributos |
|---|---|---|
| 30 | Escort TD (Combustible) | fuel_lvl, batt, temp, fw, opmode, rssi |
| 31 | Escort TT (Temperatura) | temp, batt, fw, rssi |
| 32 | Escort TL (Temperatura y Luz) | temp, lum, batt, fw, rssi |
| 33 | Escort DU (Ángulo) | mode, event, tilt, roll, pitch, batt, fw, rssi |
| 34 | Escort TH (Temperatura, Humedad y Luz) | temp, lum, hum, press, mode, batt, fw, rssi |
| 35 | Escort TH (con Pantalla) | temp, lum, hum, di, mode, batt, fw, rssi |
Además de los atributos listados, cada tipo agrega al final type (tipo detectado) y age (segundos desde la última lectura, hasta 255).
Sensor Teltonika EYE (tipo 40)
| Tipo | Nombre | Atributos |
|---|---|---|
| 40 | Teltonika EYE Sensor (BTSMP1) | temp, hum, mag, mov, mcnt, pitch, roll, batt, lowbat, rssi, type, age |
Sensor BLE multipropósito a pila: temperatura, humedad, imán, movimiento e inclinación. Transmite en broadcast (sin emparejamiento) y el equipo lo detecta solo. Qué mediciones envía depende de lo que tenga habilitado el sensor desde la app del fabricante.
| Atributo | Descripción | Unidad |
|---|---|---|
temp | Temperatura, con 2 decimales. 0.00 si el sensor no la transmite | °C |
hum | Humedad relativa. 255 = el sensor no la transmite | % |
mag | Imán: 1 = detectado, 0 = no detectado. 255 = sin sensor magnético | - |
mov | 1 = en movimiento, 0 = quieto | - |
mcnt | Contador acumulado de eventos de movimiento (0-32767) | - |
pitch | Inclinación (cabeceo) | grados |
roll | Inclinación (rolido) | grados |
batt | Tensión de la pila. 0 = el sensor no la transmite | mV |
lowbat | 1 = pila baja | - |
>SBS00E,7CD9F4123456,40,0,0,NA<
>QBS00.temp< // Temperatura en °C
>QBS00.mag< // 1 = imán detectado (puerta cerrada, por ejemplo)Soporte para el Teltonika EYE Sensor (tipo 40) desde el firmware v1.09.24.
Sensor de combustible Technoton DUT-E (tipo 50)
| Tipo | Nombre | Atributos |
|---|---|---|
| 50 | Technoton DUT-E S7 / DUT-E 2Bio S7 (combustible) | freq, temp, dtc, lvl, vol, fw, rssi, type, age |
Varilla capacitiva de nivel de combustible con BLE, que transmite la medición en broadcast (sin emparejamiento).
| Atributo | Descripción | Unidad |
|---|---|---|
freq | Frecuencia de medición. Para los modelos que no transmiten litros: se convierte con la calibración del tanque | Hz |
temp | Temperatura. -99 = no disponible | °C |
dtc | Máscara de fallas del sensor (ver manual del fabricante) | - |
lvl | Nivel. -1 = el sensor no lo transmite | mm |
vol | Volumen. -1 = el sensor no lo transmite | L |
fw | Versión de firmware del sensor | - |
lvl y vol solo llegan de los modelos que los calculan (con el perfil del tanque cargado en el sensor); si no, valen -1, que se distingue de un tanque vacío (0).
>SBS00E,001A4F6A1EC7,50,0,0,NA<
>QBS00.vol< // Volumen en litrosCadena completa del sensor: freq:6609.58,temp:16,dtc:0,lvl:6.4,vol:6.4,fw:6,rssi:-70,type:50,age:0.
Soporte para el Technoton DUT-E (tipo 50) desde el firmware v1.09.27.
Sensores Eurosens (tipos 60 a 63)
| Tipo | Nombre | Atributos |
|---|---|---|
| 60 | Eurosens Degree BT, modo inclinación | x, y, z, st, ev, cev, temp, sn, rssi, type, age, bat, lowbat |
| 61 | Eurosens Degree BT, modo hormigonera | rpm, y, z, st, min, starts, temp, sn, rssi, type, age, bat, lowbat |
| 62 | Eurosens Degree BT, modo pluma / excavadora | x, y, z, st, work, min, temp, sn, rssi, type, age, bat, lowbat |
| 63 | Eurosens DPS Bt (presión de fuelle neumático) | kpa, kg, load, temp, batt, lock, msg, sn, rssi, type, age |
Degree BT (inclinómetro, tipos 60, 61 y 62)
El Degree BT mide ángulos y tiene tres modos de trabajo, que se eligen con la app del fabricante. Cada modo es un tipo distinto porque cambia lo que significan los campos, no su posición. El equipo reconoce el modo por el nombre que anuncia el sensor: DegreeT o DegreeMT → 60, DegreeMI → 61, DegreeEX → 62.
| Atributo | Tipo | Descripción |
|---|---|---|
x | 60, 62 | Ángulo X, en grados (-90 a +90) |
rpm | 61 | RPM del tambor (con signo) |
y, z | 60-62 | Ángulos Y y Z, en grados (-90 a +90) |
st | 60-62 | Byte de estado del sensor, crudo |
ev / cev | 60 | Cantidad de eventos simples / eventos complejos (cadenas) |
min | 61, 62 | Minutos de giro del tambor (61) / minutos de operación (62) |
starts | 61 | Arranques del tambor |
work | 62 | 0 = parado, 1 = trabajando |
temp | 60-62 | Temperatura, °C |
sn | 60-62 | Número de serie de la etiqueta, en decimal (4294967295 = sin cargar) |
bat | 60-62 | Nivel de batería, de 0 a 7 |
lowbat | 60-62 | Alarma de batería baja del sensor (0 / 1) |
bat y lowbat salen del byte st: con un st de 217, bat = 5 y lowbat = 0.
>SBS01E,A1B2C3D4E5F6,60,60,0,NA<
// Degree BT en modo inclinación, señal en falso tras 60 s sin datos
>QBS01.x< // Ángulo X
>QBS01.bat< // Nivel de batería (0-7)Si se cambia el modo del Degree desde la app del fabricante, el tipo cambia: un SBS con el tipo anterior deja de actualizarse. Configure el tipo del modo en uso, o 0 (automático) para que el equipo tome el que detecte.
DPS Bt (presión de fuelle, tipo 63)
El DPS Bt mide la presión del fuelle de la suspensión neumática, para pesaje a bordo. El peso y el porcentaje de carga los calcula el propio sensor con la calibración que se le carga desde la app del fabricante: el equipo los informa tal cual.
| Atributo | Descripción | Unidad |
|---|---|---|
kpa | Presión del fuelle (un decimal) | kPa |
kg | Peso calculado por el sensor | kg |
load | Carga | % |
temp | Temperatura | °C |
batt | Batería | % |
lock | 1 = sensor bloqueado | - |
msg | Contador de mensajes transmitidos por el sensor | - |
sn | Número de serie de la etiqueta | - |
>SBS02E,A1B2C3D4E5F6,63,60,0,NA<
>QBS02.kpa< // Presión del fuelle en kPa
>QBS02.kg< // Peso calculado por el sensorEn el motor de eventos, MBS(aa;n) lee los atributos por posición (el primero es el 0). Por eso los atributos nuevos de un tipo se agregan siempre al final, después de age, como bat y lowbat del Degree BT: las reglas ya instaladas no se corren.
Soporte para los Eurosens Degree BT (tipos 60, 61 y 62) y DPS Bt (tipo 63) desde el firmware v1.09.28.
Ejemplo de Configuración y Consulta
Configuración:
>SBS01E,A1B2C3D4E5F6,30,60,10,INVALID<Significado:
- Índice 01, Habilitado (E)
- MAC: A1B2C3D4E5F6
- Tipo 30 (Escort TD - Combustible)
- Timeout: 60 segundos
- Distancia: 10 metros
- Valor inválido: INVALID
Consulta del Nivel de Combustible:
>QBS01.fuel_lvl<Respuesta:
>432;ID=865413053386354;*25<Compatibilidad
Ver También
- Comando BE IoT - Disparadores iBeacon
- Comando BSW IoT - Auto-detección Wildcard
- Motor de Eventos - Configuración de reglas