AWS IoT Wireless

2024/06/06 - AWS IoT Wireless - 1 updated api methods

Changes  Adds support for wireless device to be in Conflict FUOTA Device Status due to a FUOTA Task, so it couldn't be attached to a new one.

ListWirelessDevices (updated) Link ΒΆ
Changes (response)
{'WirelessDeviceList': {'FuotaDeviceStatus': {'Device_exist_in_conflict_fuota_task'}}}

Lists the wireless devices registered to your AWS account.

See also: AWS API Documentation

Request Syntax

client.list_wireless_devices(
    MaxResults=123,
    NextToken='string',
    DestinationName='string',
    DeviceProfileId='string',
    ServiceProfileId='string',
    WirelessDeviceType='Sidewalk'|'LoRaWAN',
    FuotaTaskId='string',
    MulticastGroupId='string'
)
type MaxResults

integer

param MaxResults

The maximum number of results to return in this operation.

type NextToken

string

param NextToken

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

type DestinationName

string

param DestinationName

A filter to list only the wireless devices that use this destination.

type DeviceProfileId

string

param DeviceProfileId

A filter to list only the wireless devices that use this device profile.

type ServiceProfileId

string

param ServiceProfileId

A filter to list only the wireless devices that use this service profile.

type WirelessDeviceType

string

param WirelessDeviceType

A filter to list only the wireless devices that use this wireless device type.

type FuotaTaskId

string

param FuotaTaskId

The ID of a FUOTA task.

type MulticastGroupId

string

param MulticastGroupId

The ID of the multicast group.

rtype

dict

returns

Response Syntax

{
    'NextToken': 'string',
    'WirelessDeviceList': [
        {
            'Arn': 'string',
            'Id': 'string',
            'Type': 'Sidewalk'|'LoRaWAN',
            'Name': 'string',
            'DestinationName': 'string',
            'LastUplinkReceivedAt': 'string',
            'LoRaWAN': {
                'DevEui': 'string'
            },
            'Sidewalk': {
                'AmazonId': 'string',
                'SidewalkId': 'string',
                'SidewalkManufacturingSn': 'string',
                'DeviceCertificates': [
                    {
                        'SigningAlg': 'Ed25519'|'P256r1',
                        'Value': 'string'
                    },
                ],
                'DeviceProfileId': 'string',
                'Status': 'PROVISIONED'|'REGISTERED'|'ACTIVATED'|'UNKNOWN'
            },
            'FuotaDeviceStatus': 'Initial'|'Package_Not_Supported'|'FragAlgo_unsupported'|'Not_enough_memory'|'FragIndex_unsupported'|'Wrong_descriptor'|'SessionCnt_replay'|'MissingFrag'|'MemoryError'|'MICError'|'Successful'|'Device_exist_in_conflict_fuota_task',
            'MulticastDeviceStatus': 'string',
            'McGroupId': 123
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      The token to use to get the next set of results, or null if there are no additional results.

    • WirelessDeviceList (list) --

      The ID of the wireless device.

      • (dict) --

        Information about a wireless device's operation.

        • Arn (string) --

          The Amazon Resource Name of the resource.

        • Id (string) --

          The ID of the wireless device reporting the data.

        • Type (string) --

          The wireless device type.

        • Name (string) --

          The name of the resource.

        • DestinationName (string) --

          The name of the destination to which the device is assigned.

        • LastUplinkReceivedAt (string) --

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

          Note

          Theis value is only valid for 3 months.

        • LoRaWAN (dict) --

          LoRaWAN device info.

          • DevEui (string) --

            The DevEUI value.

        • Sidewalk (dict) --

          The Sidewalk account credentials.

          • AmazonId (string) --

            The Sidewalk Amazon ID.

          • SidewalkId (string) --

            The sidewalk device identification.

          • SidewalkManufacturingSn (string) --

            The Sidewalk manufacturing series number.

          • DeviceCertificates (list) --

            The sidewalk device certificates for Ed25519 and P256r1.

            • (dict) --

              List of sidewalk certificates.

              • SigningAlg (string) --

                The certificate chain algorithm provided by sidewalk.

              • Value (string) --

                The value of the chosen sidewalk certificate.

          • DeviceProfileId (string) --

            Sidewalk object used by list functions.

          • Status (string) --

            The status of the Sidewalk devices, such as provisioned or registered.

        • FuotaDeviceStatus (string) --

          The status of a wireless device in a FUOTA task.

        • MulticastDeviceStatus (string) --

          The status of the wireless device in the multicast group.

        • McGroupId (integer) --

          Id of the multicast group.