DocsICP FilingConsole
Documentation
Home Page IoT Platform (Deprecated) User Guide Value-added services Voice messaging service Communication using the Thing Specification Language model Event reporting

Event reporting

Updated at:
Copy as MD
Product
My Favorites

Broadcast devices use Thing Specification Language (TSL) model events to report their operational status to IoT Platform, such as task completion. After the broadcast service pushes speech content to a broadcast device, the device must report the TSL model events described in this topic.

Event list

Event name

Function

Required

Corpus update results

Report the result of the corpus push.

Yes

Cell site information

Reports the cell site information of the device.

No

View event definitions

  1. Log on to the IoT Platform console.

  2. In the top-left corner of the console, select the China (Shanghai) region.

  3. On the Instance Overview tab, find your instance under All Environments and click the instance card.

  4. In the navigation pane on the left, choose Device Management > Products.

  5. In the product list, find the product for your broadcast device and click View in the Actions column.

  6. On the Product Details page, click the Function Definition tab.

  7. Find the desired event type and click View in the Actions column. The identifier, event type, and output parameters for the feature are displayed.

Event definition details

Speech content update result

After the device downloads the pushed speech content, it must use this event to report the download result to IoT Platform. This allows IoT Platform to update the download status.

For more information about the speech content push service, see Speech content push.

Feature

Description

Identifier

SpeechUpdateResponse.

Event type

Information. This event type indicates a general notification from a device, such as the completion of a task.

Note

  • Alerting: The device reports an alert for an exception that occurs during operation.

  • Fault: The device reports a fault that occurs during operation.

Output parameters

  • Corpus Push Identifier:

    This ID must be the same as the Task ID input parameter in the service invocation. It informs IoT Platform which specific speech content push service call this event report corresponds to.

  • Corpus update results:

    Feedback corpus push results:

    • 0: The corpus was successfully pushed.

    • 1: A local file processing error occurred.

    • 2: The device failed to download the pushed speech content.

    • 4: The device corpus is being updated.

  • Corpus update errors:

    Reports specific error information to IoT Platform that occurred during the speech content push. Customize this message as needed.

Cell site information

This event reports the cell site information of the device.

Feature

Description

Identifier

LocationInfo.

Event type

Information. This event type indicates a general notification from a device.

Output parameters

  • IMEI of the mobile module: The International Mobile Equipment Identity (IMEI) of the connected module.

  • MAC address of the mobile module: The MAC address of the module.

  • Mobile User Identifier: The ICCID of the IoT card.

  • Nearby cell site information: Information about nearby cell sites, obtained from the communication module.

  • Is CDMA.

    • 1: Yes.

    • 0: No.

  • Connected cell site information: Information about the connected cell site, obtained from the communication module.

Topic details

The topic for event reporting is /sys/${productkey}/${deviceName}/thing/event/${tsl.event.identifier}/post.

Where:

  • Replace ${productkey} and ${deviceName} with the ProductKey and DeviceName of your device.

  • ${tsl.event.identifier}: The event identifier. For example, the identifier for the result of a corpus update is SpeechUpdateResponse.

Previous：Service invocationNext：Property reporting