Skip to Content

Comando BS IoT

Configuración de sensores Bluetooth Low Energy (BLE) con soporte para múltiples tipos de dispositivos.


¿Para qué sirve?

Caso de usoDescripción
🌡️ Monitoreo ambientalLectura de temperatura, humedad y presión con sensores BLE
⛽ Control de combustibleSensores Escort TD para nivel de combustible wireless
🚪 Detección de puertasSensores magnéticos BLE para estado de puertas
🏃 Detección de movimientoSensores PIR y acelerómetros BLE
📊 Telemetría avanzadaIntegració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,outval

Respuesta

RBSaab,id,type,time,distance,outval;attrkeyvalue_0,...attrkeyvalue_N

Parámetros

ParámetroDescripción
aaÍndice del sensor (00 a 03)
bEstado del sensor (E = habilitar, D = deshabilitar, * = limpiar configuración)
idDirección MAC del dispositivo BLE en formato hexadecimal (12 caracteres)
typeTipo 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
timeTiempo en segundos sin actualización para considerar la señal en falso
distanceDistancia en metros para sensores como iBeacon
outvalValor a mostrar cuando la lectura no es válida
attrkeyvalueAtributo del sensor, clave:valor

Señales Asociadas

SeñalÍndiceUso condicionalFlancos
BSaa00-03SI+ Flanco positivo, - Flanco negativo

Tipos de Sensores Disponibles

Sensores iBeacon y Eddystone

TipoNombreAtributos
0Sensor AutomáticoSin atributos específicos
1iBeaconuuid, major, minor, tx_power, rssi, distance
2Eddystone UIDnamespace, instance, rssi
3Eddystone TLMbatt, temp, adv_cnt, sec_cnt
43 Ejes Acelerómetrox, y, z, batt, ranging_data, adv_int, sr, full_scale, mt, rssi

Sensores Rinho BLE

TipoNombreAtributos
5Información del Dispositivobattery, adv_int, ranging_data, dv_prop_ind, switch_s_ind, fwt, fw, rssi
6Botón MKaccX, accY, accZ, batt, triggerStatus, triggerCount, deviceId, rssi
7Temperatura y Humedadtemp, hum, battery, ranging_data, adv_int, device_type, rssi
8PIR (Infrarrojo Pasivo)door_status, battery, delay_response_status, sensor_sensitivity, detection_status, major, minor, rssi
9Sensor de Puerta (MK Door)door_status, delay_response, sensor_sensitivity, detection_status, batt, major, minor, rssi
10MK Sensor Infomag_st, mot_st, mag_cnt, mot_cnt, x, y, z, temp, hum, batt, tag, rssi

Sensor MOKO S02R (ToF)

TipoNombreAtributos
11MOKO S02R (ToF)dist, batt, rssi, type, age

El sensor MOKO S02R mide distancia por Time-of-Flight (ToF) y expone dos lecturas principales:

AtributoDescripciónUnidad
distDistancia medida por ToFmilímetros (mm)
battTensión de batería del sensormilivoltios (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=NA

Consulta de lecturas:

>QBS00.dist< // Distancia en mm >QBS00.batt< // Batería en mV

Soporte para el sensor MOKO S02R (tipo 11) disponible desde el firmware v1.09.23.


Sensores Escort BLE

TipoNombreAtributos
30Escort TD (Combustible)fuel_lvl, batt, temp, fw, opmode, rssi
31Escort TT (Temperatura)temp, batt, fw, rssi
32Escort TL (Temperatura y Luz)temp, lum, batt, fw, rssi
33Escort DU (Ángulo)mode, event, tilt, roll, pitch, batt, fw, rssi
34Escort TH (Temperatura, Humedad y Luz)temp, lum, hum, press, mode, batt, fw, rssi
35Escort 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)

TipoNombreAtributos
40Teltonika 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.

AtributoDescripciónUnidad
tempTemperatura, con 2 decimales. 0.00 si el sensor no la transmite°C
humHumedad relativa. 255 = el sensor no la transmite%
magImán: 1 = detectado, 0 = no detectado. 255 = sin sensor magnético-
mov1 = en movimiento, 0 = quieto-
mcntContador acumulado de eventos de movimiento (0-32767)-
pitchInclinación (cabeceo)grados
rollInclinación (rolido)grados
battTensión de la pila. 0 = el sensor no la transmitemV
lowbat1 = 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)

TipoNombreAtributos
50Technoton 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).

AtributoDescripciónUnidad
freqFrecuencia de medición. Para los modelos que no transmiten litros: se convierte con la calibración del tanqueHz
tempTemperatura. -99 = no disponible°C
dtcMáscara de fallas del sensor (ver manual del fabricante)-
lvlNivel. -1 = el sensor no lo transmitemm
volVolumen. -1 = el sensor no lo transmiteL
fwVersió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 litros

Cadena 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)

TipoNombreAtributos
60Eurosens Degree BT, modo inclinaciónx, y, z, st, ev, cev, temp, sn, rssi, type, age, bat, lowbat
61Eurosens Degree BT, modo hormigonerarpm, y, z, st, min, starts, temp, sn, rssi, type, age, bat, lowbat
62Eurosens Degree BT, modo pluma / excavadorax, y, z, st, work, min, temp, sn, rssi, type, age, bat, lowbat
63Eurosens 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.

AtributoTipoDescripción
x60, 62Ángulo X, en grados (-90 a +90)
rpm61RPM del tambor (con signo)
y, z60-62Ángulos Y y Z, en grados (-90 a +90)
st60-62Byte de estado del sensor, crudo
ev / cev60Cantidad de eventos simples / eventos complejos (cadenas)
min61, 62Minutos de giro del tambor (61) / minutos de operación (62)
starts61Arranques del tambor
work620 = parado, 1 = trabajando
temp60-62Temperatura, °C
sn60-62Número de serie de la etiqueta, en decimal (4294967295 = sin cargar)
bat60-62Nivel de batería, de 0 a 7
lowbat60-62Alarma 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.

AtributoDescripciónUnidad
kpaPresión del fuelle (un decimal)kPa
kgPeso calculado por el sensorkg
loadCarga%
tempTemperatura°C
battBatería%
lock1 = sensor bloqueado-
msgContador de mensajes transmitidos por el sensor-
snNú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 sensor

En 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

💾Firmware:v1.00.00
💾Firmware v1.00.00
SP-IOT
SM-IOT
ZE-IOT
Tipo 40 desde v1.09.24; tipo 50 desde v1.09.27; tipos 60-63 desde v1.09.28

Ver También

Última actualización