RSSI status

The RSSI status object represents the signal level of a wireless connection of a device. This object is normally used to update the signal level through the updateDeviceRssi method of the device object, usually as part of a LoRaWAN or MQTT data conversion script.

Properties

type (int enum)

The type property indicates the connection type. The possible values for this property are as follows:

• rssiType.default (1): this is the default value for this property, normally used when the device has a single type of wireless connection.
• rssiType.wiFi (2): indicates that the connection type is Wi-Fi.
• rssiType.loRaWan (3): indicates that the connection type is LoRaWAN.
• rssiType.cellular (4): indicates that the connection type is cellular.
• rssiType.zigBee (5): indicates that the connection type is ZigBee.
• rssiType.rF (1): indicates that the connection type is some other type.

Examples

This example shows how to report a signal level of 72% for the cellular interface, and 68% for the Wi-Fi interface, on a device that has both interface types.

myDevice.updateDeviceRssi
(
	[
		{ type: rssiType.cellular, quality: 72 },
		{ type: rssiType.wiFi, quality: 68 }
	]
);

quality (int) The quality property indicates the connection quality, as a percentage (0-100%).

Examples

This example shows how to report a signal level of 72% for the cellular interface, and 68% for the Wi-Fi interface, on a device that has both interface types.

myDevice.updateDeviceRssi
(
	[
		{ type: rssiType.cellular, quality: 72 },
		{ type: rssiType.wiFi, quality: 68 }
	]
);

strength (int) The strength property allows indicating the signal level as attenuation, in dBm.

Examples

This example shows how to report a signal level with an attenuation of -68 dBm, on a device with a single communication interface.

myDevice.updateDeviceRssi({ strength: -68 });