IoTWireless / Client / create_wireless_device

create_wireless_device#

IoTWireless.Client.create_wireless_device(**kwargs)#

Provisions a wireless device.

See also: AWS API Documentation

Request Syntax

response = client.create_wireless_device(
    Type='Sidewalk'|'LoRaWAN',
    Name='string',
    Description='string',
    DestinationName='string',
    ClientRequestToken='string',
    LoRaWAN={
        'DevEui': 'string',
        'DeviceProfileId': 'string',
        'ServiceProfileId': 'string',
        'OtaaV1_1': {
            'AppKey': 'string',
            'NwkKey': 'string',
            'JoinEui': 'string'
        },
        'OtaaV1_0_x': {
            'AppKey': 'string',
            'AppEui': 'string',
            'GenAppKey': 'string'
        },
        'AbpV1_1': {
            'DevAddr': 'string',
            'SessionKeys': {
                'FNwkSIntKey': 'string',
                'SNwkSIntKey': 'string',
                'NwkSEncKey': 'string',
                'AppSKey': 'string'
            },
            'FCntStart': 123
        },
        'AbpV1_0_x': {
            'DevAddr': 'string',
            'SessionKeys': {
                'NwkSKey': 'string',
                'AppSKey': 'string'
            },
            'FCntStart': 123
        },
        'FPorts': {
            'Fuota': 123,
            'Multicast': 123,
            'ClockSync': 123,
            'Positioning': {
                'ClockSync': 123,
                'Stream': 123,
                'Gnss': 123
            },
            'Applications': [
                {
                    'FPort': 123,
                    'Type': 'SemtechGeolocation',
                    'DestinationName': 'string'
                },
            ]
        }
    },
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    Positioning='Enabled'|'Disabled'
)
Parameters:
  • Type (string) –

    [REQUIRED]

    The wireless device type.

  • Name (string) – The name of the new resource.

  • Description (string) – The description of the new resource.

  • DestinationName (string) –

    [REQUIRED]

    The name of the destination to assign to the new wireless device.

  • ClientRequestToken (string) –

    Each resource must have a unique client request token. If you try to create a new resource with the same token as a resource that already exists, an exception occurs. If you omit this value, AWS SDKs will automatically generate a unique client request.

    This field is autopopulated if not provided.

  • LoRaWAN (dict) –

    The device configuration information to use to create the wireless device.

    • DevEui (string) –

      The DevEUI value.

    • DeviceProfileId (string) –

      The ID of the device profile for the new wireless device.

    • ServiceProfileId (string) –

      The ID of the service profile.

    • OtaaV1_1 (dict) –

      OTAA device object for v1.1 for create APIs

      • AppKey (string) –

        The AppKey value.

      • NwkKey (string) –

        The NwkKey value.

      • JoinEui (string) –

        The JoinEUI value.

    • OtaaV1_0_x (dict) –

      OTAA device object for create APIs for v1.0.x

      • AppKey (string) –

        The AppKey value.

      • AppEui (string) –

        The AppEUI value.

      • GenAppKey (string) –

        The GenAppKey value.

    • AbpV1_1 (dict) –

      ABP device object for create APIs for v1.1

      • DevAddr (string) –

        The DevAddr value.

      • SessionKeys (dict) –

        Session keys for ABP v1.1

        • FNwkSIntKey (string) –

          The FNwkSIntKey value.

        • SNwkSIntKey (string) –

          The SNwkSIntKey value.

        • NwkSEncKey (string) –

          The NwkSEncKey value.

        • AppSKey (string) –

          The AppSKey value.

      • FCntStart (integer) –

        The FCnt init value.

    • AbpV1_0_x (dict) –

      LoRaWAN object for create APIs

      • DevAddr (string) –

        The DevAddr value.

      • SessionKeys (dict) –

        Session keys for ABP v1.0.x

        • NwkSKey (string) –

          The NwkSKey value.

        • AppSKey (string) –

          The AppSKey value.

      • FCntStart (integer) –

        The FCnt init value.

    • FPorts (dict) –

      List of FPort assigned for different LoRaWAN application packages to use

      • Fuota (integer) –

        The Fport value.

      • Multicast (integer) –

        The Fport value.

      • ClockSync (integer) –

        The Fport value.

      • Positioning (dict) –

        FPort values for the GNSS, stream, and ClockSync functions of the positioning information.

        • ClockSync (integer) –

          The Fport value.

        • Stream (integer) –

          The Fport value.

        • Gnss (integer) –

          The Fport value.

      • Applications (list) –

        Optional LoRaWAN application information, which can be used for geolocation.

        • (dict) –

          LoRaWAN application configuration, which can be used to perform geolocation.

          • FPort (integer) –

            The Fport value.

          • Type (string) –

            Application type, which can be specified to obtain real-time position information of your LoRaWAN device.

          • DestinationName (string) –

            The name of the position data destination that describes the AWS IoT rule that processes the device’s position data for use by AWS IoT Core for LoRaWAN.

  • Tags (list) –

    The tags to attach to the new wireless device. Tags are metadata that you can use to manage a resource.

    • (dict) –

      A simple label consisting of a customer-defined key-value pair

      • Key (string) – [REQUIRED]

        The tag’s key value.

      • Value (string) – [REQUIRED]

        The tag’s value.

  • Positioning (string) – FPort values for the GNSS, stream, and ClockSync functions of the positioning information.

Return type:

dict

Returns:

Response Syntax

{
    'Arn': 'string',
    'Id': 'string'
}

Response Structure

  • (dict) –

    • Arn (string) –

      The Amazon Resource Name of the new resource.

    • Id (string) –

      The ID of the new wireless device.

Exceptions

  • IoTWireless.Client.exceptions.ValidationException

  • IoTWireless.Client.exceptions.ResourceNotFoundException

  • IoTWireless.Client.exceptions.AccessDeniedException

  • IoTWireless.Client.exceptions.ConflictException

  • IoTWireless.Client.exceptions.InternalServerException

  • IoTWireless.Client.exceptions.ThrottlingException