IoTWireless / Client / get_wireless_device_statistics

get_wireless_device_statistics#

IoTWireless.Client.get_wireless_device_statistics(**kwargs)#

Gets operating information about a wireless device.

See also: AWS API Documentation

Request Syntax

response = client.get_wireless_device_statistics(
    WirelessDeviceId='string'
)
Parameters:

WirelessDeviceId (string) –

[REQUIRED]

The ID of the wireless device for which to get the data.

Return type:

dict

Returns:

Response Syntax

{
    'WirelessDeviceId': 'string',
    'LastUplinkReceivedAt': 'string',
    'LoRaWAN': {
        'DevEui': 'string',
        'FPort': 123,
        'DataRate': 123,
        'Frequency': 123,
        'Timestamp': 'string',
        'Gateways': [
            {
                'GatewayEui': 'string',
                'Snr': 123.0,
                'Rssi': 123.0
            },
        ]
    },
    'Sidewalk': {
        'Rssi': 123,
        'BatteryLevel': 'normal'|'low'|'critical',
        'Event': 'discovered'|'lost'|'ack'|'nack'|'passthrough',
        'DeviceState': 'Provisioned'|'RegisteredNotSeen'|'RegisteredReachable'|'RegisteredUnreachable'
    }
}

Response Structure

  • (dict) –

    • WirelessDeviceId (string) –

      The ID of the wireless device.

    • LastUplinkReceivedAt (string) –

      The date and time when the most recent uplink was received.

    • LoRaWAN (dict) –

      Information about the wireless device’s operations.

      • DevEui (string) –

        The DevEUI value.

      • FPort (integer) –

        The FPort value.

      • DataRate (integer) –

        The DataRate value.

      • Frequency (integer) –

        The device’s channel frequency in Hz.

      • Timestamp (string) –

        The date and time of the metadata.

      • Gateways (list) –

        Information about the gateways accessed by the device.

        • (dict) –

          LoRaWAN gateway metatdata.

          • GatewayEui (string) –

            The gateway’s EUI value.

          • Snr (float) –

            The SNR value.

          • Rssi (float) –

            The RSSI value.

    • Sidewalk (dict) –

      MetaData for Sidewalk device.

      • Rssi (integer) –

        The RSSI value.

      • BatteryLevel (string) –

        Sidewalk device battery level.

      • Event (string) –

        Sidewalk device status notification.

      • DeviceState (string) –

        Device state defines the device status of sidewalk device.

Exceptions

  • IoTWireless.Client.exceptions.ValidationException

  • IoTWireless.Client.exceptions.AccessDeniedException

  • IoTWireless.Client.exceptions.ResourceNotFoundException

  • IoTWireless.Client.exceptions.InternalServerException

  • IoTWireless.Client.exceptions.ThrottlingException