Batteriestatus

Das Batteriestatus-Objekt repräsentiert den Status einer Gerätebatterie. Dieses Objekt wird normalerweise verwendet, um den Batteriestand über die updateDeviceBattery-Methode des device-Objekts zu aktualisieren, üblicherweise als Teil eines LoRaWAN- oder MQTT-Datenkonvertierungs-Skripts.

Eigenschaften

type (int enum)

Die type-Eigenschaft gibt den Batterietyp an. Die möglichen Werte für diese Eigenschaft sind wie folgt:

• batteryType.default (1): Dies ist der Standardwert für diese Eigenschaft, der normalerweise verwendet wird, wenn das Gerät eine einzelne Batterie hat.
• batteryType.primary (2): Wenn das Gerät mehr als eine Batterie hat, gibt dieser Wert an, dass es sich um die Hauptbatterie handelt.
• batteryType.secondary (3): Wenn das Gerät mehr als eine Batterie hat, gibt dieser Wert an, dass es sich um die Sekundärbatterie handelt.
• batteryType.backup (4): Wenn das Gerät mehr als eine Batterie hat, gibt dieser Wert an, dass es sich um die Backup-Batterie handelt.

Beispiele

Dieses Beispiel zeigt, wie ein Batteriestand von 72 % für die Hauptbatterie und 68 % für die Sekundärbatterie bei einem Gerät gemeldet wird, das sowohl eine Haupt- als auch eine Sekundärbatterie hat.

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

percentage (int) Die percentage-Eigenschaft gibt den Batterieladeprozentsatz an (0-100 %).

Beispiele

Dieses Beispiel zeigt, wie ein Batteriestand von 72 % für die Hauptbatterie und 68 % für die Sekundärbatterie bei einem Gerät gemeldet wird, das sowohl eine Haupt- als auch eine Sekundärbatterie hat.

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

voltage (double) Die voltage-Eigenschaft ermöglicht die Angabe der Batteriespannung.

Beispiele

Dieses Beispiel zeigt, wie eine Batteriespannung von 2,95 V für ein Gerät gemeldet wird, das eine einzelne Batterie hat.

myDevice.updateDeviceBattery({ voltage: 2.95 });

state (int enum)

Die state-Eigenschaft ermöglicht die Angabe des Batteriestatus. Die möglichen Werte für diese Eigenschaft sind wie folgt:

• batteryState.ok (1): gibt an, dass die Batterieladung es dem Gerät ermöglicht, normal zu funktionieren.
• batteryState.low (2): gibt an, dass die Batterieladung niedrig ist und ersetzt werden sollte.

Wenn der Batteriestatus nicht gemeldet wird, nimmt die Plattform den ok-Status an.

Beispiele

Dieses Beispiel zeigt, wie ein niedriger Batteriestatus für ein Gerät gemeldet wird, das eine einzelne Batterie hat.

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