create_wireless_device¶

IoTWireless.Client.create_wireless_device(**kwargs)¶

Provisions a wireless device.

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

Table Of Contents

create_wireless_device¶