Saltar al contenido principal
CloudStudio

Actualizar estado de RSSI y nivel de batería

Reportar el estado de RRSI y/o nivel de batería de un dispositivo

Este método no almacena un histórico del estado, solamente toma el último reportado y lo muestra en la plataforma. Es decir, si en un primer request se reportaron 3 baterías, y en el segundo request se reporta solo una, entonces se asume que el dispositivo ahora tiene una sola batería. Lo mismo ocurre con los RRSI. Si se envían arrays vacíos, entonces se asumirá que no hay registro de nivel de batería ni de RSSI y se borrará lo reportado anteriormente.

La integración por MQTT de estado de RRSI y nivel de batería lleva la siguiente estructura:

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"deviceID": 1,
	"battery": [
		{
			"type": 2,
			"percentage": 30,
			"voltage": 3.5
		},
		{
			"type": 3,
			"percentage": 100,
			"voltage": 5
		}
	],
	"rssi": [
		{
			"type": 2,
			"quality": 100,
			"strength": -40
		}
	],
	"mqttMethod": "UpdateDeviceStatus",
	"mqttRID": "tkrs34"
}

Más información acerca de las peticiones y topics en la sección de integración por MQTT

Parámetros

NombreDescripciónTipo de datos
accessTokenToken de acceso con permisos para actualizar información del endpoint. Vea esta página para más información.text
deviceIDIdentificador único del dispositivo o dirección del dispositivo con formato [deviceAddress] (Ej: [device-1234]). Estos valores pueden verse en la página de administración de dispositivos.number
batteryLista de los estados de las distintas baterías que tiene el dispositivo. Se pueden enviar 1 o varias. Puede encontrar la descripción de las propiedades de este parámetros más abajo.array
rssiLista de los estados de las distintas conexiones inalámbricas que tiene el dispositivo. Se pueden enviar 1 o varias. Puede encontrar la descripción de las propiedades de este parámetros más abajo.array
mqttMethodMétodo correspondiente del servicio, en este caso UpdateDeviceStatustext
mqttRIDIdentificador opcional para la petición, en caso de que se desee obtener una respuesta de confirmación.text

Parámetro array “battery”

En cada uno de los elementos de este array se debe reportar, al menos, “percentage” o “voltage”. Type es obligatorio.

NombreDescripciónTipo de datos
typeTipo de batería que se está reportando. Los tipos permitidos son:0: Desconocido. Si se envía este valor, se cambiará automáticamente a 11: Por defecto2: Primaria3: Secundaria4: BackupNo se pueden repetir tipos en un mismo array.number
percentageValor numérico del porcentaje restante de la batería.number
voltageValor numérico del voltaje actual de la batería.number

Parámetro array “rssi”

En cada uno de los elementos de este array se debe reportar, al menos, “quality” o “strength”. Type es obligatorio.

NombreDescripciónTipo de datos
typeRepresenta un tipo de tecnología inalámbrica en la que se puede medir RSSI. Los valores permitidos son:0: Desconocido. Si se envía este valor, se cambiará automáticamente a 11: Por defecto2: WiFi3: LoRaWAN4: Cellular (2G/3G/4G/5G/Cat-M/NB-IoT/etc)5: ZigBee6: Custom RFNo se pueden repetir tipos en un mismo array.number
qualityValor numérico que representa la calidad de la señal. De 0 a 100. Si este valor no es informado, pero el parámetro “strength” si, el valor de este parámetro será auto calculadonumber
strengthValor numérico que representa la intensidad de la señal en dBm (negativo). Si el valor informado es positivo, se cambiará su signo. Si este valor no es informado, pero el parámetro “quality” si, el valor de este parámetro será auto calculado.number

Última actualización

En esta página