Updated on 2025-07-29 GMT+08:00

Creating a Product

On the IoT platform, a product is a collection of devices with the same capabilities or features.

Procedure

  1. Access the IoTDA service page and click Access Console. Click the target instance card.
  2. Choose Products in the navigation pane and click Create Product on the left. Set the parameters as prompted and click OK.

    Set Basic Info

    Resource Space

    Select a resource space from the drop-down list box. If a resource space does not exist, create it first.

    Product Name

    Define a product name. The product name must be unique in the same resource space. The value can contain up to 64 characters. Only letters, digits, and special characters (_?'#().,&%@!-) are allowed.

    Protocol

    • MQTT: The device data format can be binary or JSON. If the binary format is used, the codec must be deployed.
    • LwM2M over CoAP: Used only by NB-IoT devices with limited resources (including storage and power consumption). The data format is binary, requiring the codec for device-platform interaction.
    • HTTPS: A secure communication protocol based on HTTP and encrypted using SSL.
    • Modbus: Devices that access the platform with Modbus via IoT edge nodes (or child devices that connect to the platform through gateways) are indirectly connected devices. For details about the differences between directly connected devices and indirectly connected devices, see Gateways and Child Devices.
    • HTTP (TLS-encrypted), ONVIF, OPC UA, OPC DA, TCP, UDP, and other protocols: IoT Edge is used for connection.

    Data Type

    • JSON: JSON is used for the communication protocol between the platform and devices.
    • Binary: You need to develop a codec on the IoTDA console to convert binary code data reported by devices into JSON data. The devices can communicate with the platform only after the JSON data delivered by the platform is parsed into binary code.

    Encoding Format

    When protocol_type is set to MQTT and data_format is set to binary, set this parameter to specify the encoding format of messages reported by devices.

    • UTF-8 (default value): converts binary code streams into Unicode strings.
    • BASE64: converts binary code streams into Base64 strings.

    Industry

    Set this parameter based on service requirements.

    Device Type

    Set this parameter based on service requirements.

    Advanced Settings

    Product ID

    Set a unique identifier for the product. If this parameter is specified, the platform uses the specified product ID. If this parameter is not specified, the platform allocates a product ID.

    Description

    Provide a description for the product. Set this parameter based on service requirements.

    You can click More > Delete to delete a product that is no longer used. After the product is deleted, its resources such as the product models and codecs will be cleared. Exercise caution when deleting a product.

Follow-Up Procedure

  1. In the product list, click the name of a product to access its details page. On the product details page displayed, you can view basic product information, such as the product ID, product name, device type, data format, resource space, and protocol type.
    Figure 1 Product details
  2. On the product details page, you can develop a product model, develop a codec, perform online debugging, and customize topics.