All Products
Search

This Product

    IoT Platform:Create a gateway for China Telecom AEP devices

    Document Center

    IoT Platform:Create a gateway for China Telecom AEP devices

    Last Updated:Jun 20, 2026

    After you develop a device and create an application on the China Telecom AEP platform, create a gateway in IoT Platform and associate it with an existing product to integrate devices from the AEP platform.

    Procedure

    1. Log in to the IoT Platform console.
    2. On the Overview page, click the Exclusive Enterprise Edition instance iot-cn-z2q1***.
      Important Only Exclusive Enterprise Edition instances support connecting China Telecom Narrowband Internet of Things (NB-IoT) devices through a gateway.
    3. In the left-side navigation pane, go to Devices > Gateway and click Add Gateway.
    4. Configure the parameters and click OK.
      Parameter Description
      Gateway name Enter a unique name for the gateway. The name must be 4 to 30 characters long and can contain Chinese characters, Japanese characters, letters, digits, and underscores (_). Each Chinese or Japanese character counts as two characters.
      Protocol Select China Telecom NB-IoT.
      Associated Product Select a method to associate a product. In this example, select Select Product and choose NBProduct1.
      • Select Product: Select a product that you created in IoT Platform.
      • Product Variables: Specify a variable in the ${Variable name} format.

        The system parses the value of the specified field from the received message body and uses the value as the ProductName to associate the message with the corresponding product in IoT Platform.

        For example, if you specify ${Model}, the system parses the Model field. If the value is SmartWaterMeter, the system associates the message with the product named SmartWaterMeter in IoT Platform.

      Note Ensure the product exists in IoT Platform and that its name matches the product name on the China Telecom AEP platform.
      Associate Device Specify a variable in the ${Variable name} format.

      The platform parses the value of a specified field, such as a device ID, from the received message body and uses the value as the DeviceName. The platform then automatically creates a corresponding device under the associated product, such as NBProduct1.

      For example, if you specify ${deviceId}, the system parses the deviceId field. If the value is 15008261001, the system automatically creates a device with the DeviceName 15008261001 under the associated product.
      AppId The AppId and AppSecret parameters correspond to the App Key and App Secret of the application on the China Telecom AEP platform.

      For more information about how to create an application, see Develop a device and add an application on the China Telecom AEP platform.
      AppSecret
    5. In the gateway list, find the gateway you just created and copy its gateway URL.
      The gateway URL is in the format iot-cn-<InstanceID>.iothub.aliyuncs.com.
    6. On the China Telecom AEP platform, choose Product Center from the left-side navigation pane. Find and click the product NBProduct1. On the product page, click the Subscriptions tab.
    7. In the upper-right corner, click Create Subscription. In the dialog box that appears, select all message types, set the subscription URL protocol to https, enter the subscription address, and then click OK.
      The subscription URL must be in the format ${gateway URL}:443. For example: iot-cn-n***.iothub.aliyuncs.com:443.
    8. On the AEP-Online Debugging page for the device nbdevice, send a water usage data report.
      If the page has expired, go to the Device Management tab to bring the device online again. For more information, see Step 6 in Develop a device and add an application on the China Telecom AEP platform. In the Device behavior simulation area, select Data Reporting for Service Type and Business Data Reporting for Service. On the Configuration tab, set Water Usage to 0.90 and initiate the report. The Device log area on the right displays the data reporting record and the Report succeeded status.
    9. Return to your Exclusive Enterprise Edition instance in the IoT Platform console. Go to Devices > Products. Find the product NBProduct1 and click Manage Devices in the Actions column.
      The system automatically creates a device named 15008261001 under the product NBProduct1. The device name is the device ID from the China Telecom AEP platform. The device status is Online, and the enablement status is Enabled.

      You can find the device ID of the device nbdevice on the China Telecom AEP platform.

      On the Device Management page of the China Telecom AEP platform, find the device nbdevice and click the View authentication information icon in the Actions column. The dialog box that appears shows the IMEI (321456123456098), device ID (15008261001), Communication protocol (LWM2M), and Authentication method (IMEI Authentication).