Mensajería - IoT Platform - Centro de documentación de Alibaba Cloud

El motor de reglas de IoT Platform reenvía a sus servidores los mensajes de registro, anulación de registro y envío de datos provenientes de dispositivos de puerta de enlace JT/T 808. También puede usar las suscripciones del lado del servidor mediante Advanced Message Queuing Protocol (AMQP) para enviar mensajes de envío de datos.

Notas de uso

Al configurar las reglas de reenvío de datos, tenga en cuenta lo siguiente:

Solo la nueva versión de la función de reenvío de datos es compatible con dispositivos de puerta de enlace. Para obtener más información, consulte Configure a data forwarding parser.
Los dispositivos agregados a puertas de enlace en la nube JT/T 808 no pueden suscribirse a temas. Tampoco es posible reenviar datos desde estos dispositivos hacia un tema.
Para usar el reenvío de datos con dispositivos de puerta de enlace en la nube JT/T 808, agregue temas de los siguientes tipos como origen de datos: Custom, Device Status Change Notification y Device Changes Throughout Lifecycle. Si agrega un tema personalizado como origen de datos, especifique el identificador del fabricante, el modelo del dispositivo y el identificador del dispositivo en el nombre del tema. Para obtener más información, consulte Create a data source.
Las suscripciones del lado del servidor solo admiten los tipos de mensaje Device Upstream Notification, Device Status Change Notification y Device Changes Throughout Lifecycle. Para obtener más información, consulte Configure AMQP server-side subscription.

Registro de dispositivos

Tema: /sys/${productKey}/${deviceName}/device/identity/register.

payload: {
    "createTime": 1669968170000,
    "deviceId": "device05",
    "deviceModel": "model1",
    "deviceName": "manufactor_model1_device05",
    "instanceId": "iotx-o****",
    "iotId": "PkhDL********00101",
    "licensePlateColour": "1",
    "licensePlateNumber": "Zhe A****",
    "manufacturer": "manufactor",
    "productKey": "a16h****",
    "status": "register",
    "tenantId": "58CAC7******37C956"
}

Parámetro	Tipo	Descripción
payload	Object	El contenido del mensaje de registro del dispositivo.
createTime	Long	La hora de inicio del registro del dispositivo.
deviceId	String	El identificador del dispositivo registrado por el usuario.
deviceModel	String	El modelo del dispositivo registrado por el usuario.
deviceName	String	El DeviceName. Formato: `${manufacturer}_${deviceModel}_${deviceId}`.
instanceId	String	El identificador de la instancia a la que pertenece el dispositivo.
iotId	String	El identificador único del dispositivo en IoT Platform.
licensePlateColour	String	El color de la placa. El valor debe cumplir con los requisitos del protocolo JT/T 808. Para obtener más información, consulte JT/T 808-2019.
licensePlateNumber	String	El número de placa.
manufacturer	String	El identificador del fabricante del dispositivo.
productKey	String	El identificador único del producto al que pertenece el dispositivo.
status	String	El estado del dispositivo. Establezca el valor en `register`, lo cual indica que el dispositivo está registrado.
tenantId	String	El identificador del usuario al que pertenece el dispositivo.

Envío del estado del dispositivo

Tema: /sys/${productKey}/${deviceName}/device/status/notify.

Formato de los datos que envía un dispositivo cuando se conecta:

{
    "protocol": "jt808",
    "status":"online",
    "iotId":"4z819VQHk6VSLmmBJfrf00107e****",
    "productKey":"al12345****",
    "deviceName":"deviceName1234",
    "time":"2018-08-31 15:32:28.205",
    "utcTime":"2018-08-31T07:32:28.205Z",
    "lastTime":"2018-08-31 15:32:28.195",
    "utcLastTime":"2018-08-31T07:32:28.195Z",
    "clientIp":"192.0.2.1"
}

Formato de los datos que envía un dispositivo cuando se desconecta:

{
    "protocol": "jt808",
    "status":"offline",
    "iotId":"4z819VQHk6VSLmmBJfrf00107e****",
    "offlineReasonCode":427,
    "productKey":"al12345****",
    "deviceName":"deviceName1234",
    "time":"2018-08-31 15:32:28.205",
    "utcTime":"2018-08-31T07:32:28.205Z",
    "lastTime":"2018-08-31 15:32:28.195",
    "utcLastTime":"2018-08-31T07:32:28.195Z",
    "clientIp":"192.0.2.1"
}

Parámetros

Parámetro	Tipo	Descripción
protocol	String	Si utiliza una puerta de enlace en la nube JT/T 808, establezca el valor en `jt808`.
status	String	El estado del dispositivo. `online`: conectado. `offline`: desconectado.
iotId	String	El identificador único del dispositivo en IoT Platform.
offlineReasonCode	Integer	El código de error cuando el dispositivo se desconecta. Device behavior error codes.
productKey	String	El identificador único del producto al que pertenece el dispositivo.
deviceName	String	El nombre del dispositivo.
lastTime	String	Obsoleto. Ya no se utiliza.
utcLastTime	String	Obsoleto. Ya no se utiliza.
time	String	La hora en que el dispositivo se conectó o se desconectó. Los mensajes no se ordenan según la hora de conexión o desconexión. Ordénelos por el valor de time. Por ejemplo, si recibe a continuación los tres mensajes siguientes: Conectado: `2018-08-31 10:02:28.195`. Desconectado: `2018-08-31 10:01:28.195`. Desconectado: `2018-08-31 10:03:28.195`. Estos tres mensajes indican que el dispositivo se desconectó, luego se conectó y después volvió a desconectarse.
utcTime	String	La hora UTC en que el dispositivo se conectó o se desconectó.
clientIp	String	La dirección IP pública del dispositivo.

Envío de datos del dispositivo

Tema: /sys/${productKey}/${deviceName}/device/message/uplink.

payload: {
    header:{
        messageId:"",
        version:"",
        phone:"",
        serialNumber:""
    },
    body:{
        data:"dGVzdDEyMw==",
        type: 65
    }
}

Parámetro	Tipo	Descripción
payload	Object	El mensaje que envía el dispositivo, el cual incluye los parámetros header y body. El contenido puede ser datos de paso directo, estadísticas de ubicación o datos GPS.
header	Object	El encabezado del mensaje. messageId: el identificador del mensaje. version: la versión del protocolo. phone: el número telefónico. serialNumber: el número de serie del mensaje. Valores válidos: de 0 a 65535. El dispositivo incrementa este número en uno por cada mensaje que envía. Los valores de los parámetros messageId, version y phone deben cumplir con los requisitos del protocolo JT/T 808. Para obtener más información, consulte JT/T 808-2019.
body	Object	El cuerpo del mensaje. data: el contenido del mensaje, codificado en Base64. type: el tipo de mensaje de paso directo. En este ejemplo, `65` representa `0x41`, lo cual indica que se usa el puerto serie 1 para el paso directo de datos. El cuerpo del mensaje debe cumplir con los requisitos del protocolo JT/T 808. Para obtener más información, consulte JT/T 808-2019.

Anulación de registro del dispositivo

Tema: /sys/${productKey}/${deviceName}/device/identity/unregister.

payload: {
    "createTime": 1669968170000,
    "deviceId": "device05",
    "deviceModel": "model1",
    "deviceName": "manufactor_model1_device05",
    "instanceId": "iotx-o****",
    "iotId": "PkhDL********00101",
    "licensePlateColour": "1",
    "licensePlateNumber": "Zhe A****",
    "manufacturer": "manufactor",
    "productKey": "a16h****",
    "status": "register",
    "tenantId": "58CAC7******37C956"
}

Parámetro	Tipo	Descripción
payload	Object	El contenido del mensaje de anulación de registro del dispositivo.
createTime	Long	La hora de inicio de la anulación de registro del dispositivo.
deviceId	String	El identificador del dispositivo.
deviceModel	String	El modelo del dispositivo.
deviceName	String	El DeviceName. Formato: `${manufacturer}_${deviceModel}_${deviceId}`.
instanceId	String	El identificador de la instancia a la que pertenece el dispositivo.
iotId	String	El identificador único del dispositivo en IoT Platform.
licensePlateColour	String	El color de la placa. El valor debe cumplir con los requisitos del protocolo JT/T 808. Para obtener más información, consulte JT/T 808-2019.
licensePlateNumber	String	El número de placa.
manufacturer	String	El identificador del fabricante del dispositivo.
productKey	String	El identificador único del producto al que pertenece el dispositivo.
status	String	El estado del dispositivo. Establezca el valor en `unregister`, lo cual indica que se anuló el registro del dispositivo.
tenantId	String	El identificador del usuario al que pertenece el dispositivo.