Actualizar estado de RRSI 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
| Nombre | Descripción | Tipo de datos |
|---|---|---|
| accessToken | Token de acceso con permisos para actualizar información del endpoint. Vea esta página para más información. | text |
| deviceID | Identificador ú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 |
| battery | Lista 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 |
| rssi | Lista 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 |
| mqttMethod | Método correspondiente del servicio, en este caso UpdateDeviceStatus | text |
| mqttRID | Identificador 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.
| Nombre | Descripción | Tipo de datos |
|---|---|---|
| type | Tipo 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 |
| percentage | Valor numérico del porcentaje restante de la batería. | number |
| voltage | Valor 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.
| Nombre | Descripción | Tipo de datos |
|---|---|---|
| type | Representa 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 |
| quality | Valor 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 calculado | number |
| strength | Valor 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 |
Recibir comandos
Comandos Flujo básico de integración de comandos El gateway, dispositivo o endpoint deberá estar escuchando por comandos suscribiendose al siguiente topic:...
Actualizar ubicación de un dispositivo
Reportar la ubicación geográfica de un dispositivo La actualización de la ubicación del dispositivo por MQTT lleva la siguiente estructura: { "accessToken":...