A product consists of multiple devices of the same type. After you create a product, you must create devices for the product. You can create one or more devices at a time. This article describes how to create a device at a time.

Procedure

  1. Log on to the IoT Platform console.
  2. In the left-side navigation pane, choose Devices > Devices.
  3. On the Devices page, click Add Device.
  4. In the Add Device dialog box, set the parameters as required and click OK.
    Add Device dialog box
    Parameter Description
    Products Select a product. The device to be created derives the features and properties of the specified product.
    Note If the product is associated with another platform, make sure that your account has sufficient activation codes to create a device.
    DeviceName The DeviceName of the device. The DeviceName must be unique within the product. Each DeviceName must be 4 to 32 characters in length and can contain letters, digits, hyphens (-), underscores (_), at signs (@), periods (.),and colons (:).
    Note You can leave the DeviceName parameter unspecified. If you do not specify this parameter, IoT Platform generates a globally unique identifier (GUID) as the DeviceName.
    Alias The alias of the device. Each alias must be 4 to 64 characters in length and can contain letters, digits, and underscores (_).

Results

After the device is created, a message appears to indicate that the device is created. In the message, you can view and copy the information about the device certificate. A device certificate consists of a ProductKey, a DeviceName, and a DeviceSecret. A device certificate is the credential that a device uses to communicate with IoT Platform. We recommend that you keep your device certificates confidential.

Parameter Description
ProductKey The ProductKey of the product to which the device belongs. The ProductKey is the GUID that is issued by IoT Platform to the product.
DeviceName The DeviceName of the device, which is the unique identifier of the device within the product. A combination of the DeviceName and ProductKey is used as the device identifier. IoT Platform authenticates the device and communicates with the device based on the device identifier.
DeviceSecret The DeviceSecret that is issued by IoT Platform for device authentication and encryption. It must be used in combination with the DeviceName.

View device information. For more information, see Manage devices.

Activate the device. After the device is created, the status of the device is Inactive. Inactive

For more information, see Link SDK documentation.

Connect the device to IoT Platform. For more information about best practices, see the following articles:

Related API operations

Operation Registers a device in a product.
RegisterDevice Registers a device.