Import device credentials for a JT/T 808 gateway product that uses one-party verification. IoT Platform uses these credentials to register and authenticate physical devices when they connect.
Prerequisites
You have added a cloud gateway and created a gateway product that uses the JT/T 808 protocol and one-party verification. For more information, see Create a gateway product (JT/T 808).
Background information
-
For a cloud gateway that uses third-party authentication, when a device connects for the first time, IoT Platform uses the manufacturer, deviceModel, and deviceId request parameters from the FC authentication function to create a device name in the
${manufacturer}_${deviceModel}_${deviceId}format. The device is then automatically created and authenticated. -
After you create a gateway that uses one-party verification, import device verification information into IoT Platform to create gateway devices.
The Overview of cloud gateways for the JT/T 808 protocol describes how JT/T 808 cloud gateways connect devices to IoT Platform.
Batch add devices
-
Log on to the IoT Platform console.
-
On the Instance Overview page, click the target Enterprise instance of the Exclusive Edition.
-
In the left-side navigation pane, choose . Find the gateway product that you created and click Manage Devices in the Actions column.
-
On the Devices page, click Batch Add.
-
In the Batch Add Devices dialog box, click Download .csv Template.
-
In the template file, enter the manufacturer ID, terminal model, and terminal ID for each device, then save the file.
ImportantA single file can contain a maximum of 10,000 device records. Do not import duplicate devices.
Parameter
Type
Required
Description
manufacturer ID
String
Yes
The manufacturer ID.
Must be 4 to 32 characters in length and can contain letters, digits, hyphens (-), underscores (_), at signs (@), periods (.), and colons (:).
terminal model
String
Yes
The terminal model.
Must be 4 to 32 characters in length and can contain letters, digits, hyphens (-), underscores (_), at signs (@), periods (.), and colons (:).
terminal ID
String
Yes
The terminal ID.
Must be 4 to 32 characters in length and can contain letters, digits, hyphens (-), underscores (_), at signs (@), periods (.), and colons (:).
-
Return to the Batch add devices dialog box, click Upload File to upload the completed file, and then click OK.
After the file is uploaded, a green check mark and a Parsing completed message appear, and the Total devices count is displayed. To upload a different file, click Re-upload.
If the list of devices contains invalid information, an error message appears. Click Download Invalid List, review the invalid entries, correct them, and then upload the file again.
Invalid entries may be related to fields such as
manufacturer ID,terminal model, andterminal ID. Modify the fields as prompted and then re-upload the file.
Results
After you import the device credentials, IoT Platform creates a device for each entry. The device name is the concatenation of manufacturer ID, terminal model, and terminal ID in the format ${manufacturer ID}_${terminal model}_${terminal ID}. The devices appear in the device list. For example, DeviceName is Aaaa01_Bbbb01_Cccc01, the device belongs to the gateway product, the node type is Device, the device status is unactivated, and the device is enabled by default.
Next steps
After you create the cloud gateway devices, update the endpoint for each device:
-
If a device has a configured endpoint, create a CNAME record that maps its hostname to the cloud gateway URL. For more information, see Alibaba Cloud DNS.
-
If a device has no configured endpoint, set the cloud gateway URL as its endpoint.
To obtain the cloud gateway URL, see View cloud gateway information.
For information about how devices connected to a cloud gateway communicate with IoT Platform, see messaging.