Battery status

El objeto battery status representa el estado de una batería de un dispositivo. Este objeto normalmente se utiliza para actualizar el nivel de batería a través del método updateDeviceBattery del objeto device, usualmente como parte de un script de conversión de datos LoRaWAN o MQTT.

Propiedades

### type (int enum)

La propiedad type indica el tipo de batería. Los valores posibles para esta propiedad, son los siguientes:

• batteryType.default (1): es el valor por defecto para esta propiedad, normalmente utilizado cuando el dispositivo tiene una única batería.
• batteryType.primary (2): cuando el dispositivo tiene más de una batería, este valor indica que se trata de la batería principal.
• batteryType.secondary (3): cuando el dispositivo tiene más de una batería, este valor indica que se trata de la batería secundaria.
• batteryType.backup (4): cuando el dispositivo tiene más de una batería, este valor indica que se trata de la batería de respaldo.

Ejemplos

Este ejemplo muestra cómo informar un nivel de batería del 72% para la batería principal, y del 68% para la batería secundaria, en un dispositivo que dispone de batería primaria y secundaria.

myDevice.updateDeviceBattery
(
	[ 
		{ type: batterytype.primary, percentage: 72 }, 
		{ type: batteryType.secondary, percentage: 68} 
	]
);

### percentage (int) La propiedad percentage indica el porcentaje de carga de la batería (0-100%).

Ejemplos

Este ejemplo muestra cómo informar un nivel de batería del 72% para la batería principal, y del 68% para la batería secundaria, en un dispositivo que dispone de batería primaria y secundaria.

myDevice.updateDeviceBattery
(
	[ 
		{ type: batterytype.primary, percentage: 72 }, 
		{ type: batteryType.secondary, percentage: 68} 
	]
);

### voltage (double) La propiedad voltage permite indicar el voltaje de la batería.

Ejemplos

Este ejemplo muestra cómo informar un voltaje de batería de 2.95V para un dispositivo que tiene una única batería.

myDevice.updateDeviceBattery({ voltage: 2.95 });

### state (int enum)

La propiedad state permite indicar el estado de la batería. Los valores posibles para esta propiedad son los siguientes:

• batteryState.ok (1): indica que la carga de batería permite que el dispositivo funcione normalmente.
• batteryState.low (2): indica que la carga de batería es baja y debería ser reemplazada.

Si no se informa el estado de batería, la plataforma asumirá el estado ok.

Ejemplos

Este ejemplo muestra cómo informar un estado de batería baja para un dispositivo que tiene una única batería.

myDevice.updateDeviceBattery({ voltage: 2.95, state: batteryState.low });