Le moteur de règles d'IoT Platform transfère les messages d'enregistrement, de désenregistrement et de soumission de données des appareils passerelle JT/T 808 vers vos serveurs. Vous pouvez également utiliser les abonnements côté serveur AMQP (Advanced Message Queuing Protocol) pour pousser les messages de soumission de données.
Notes d'utilisation
Lorsque vous configurez des règles de transfert de données, tenez compte des points suivants :
Seule la nouvelle version de la fonctionnalité de transfert de données prend en charge les appareils passerelle. Pour plus d'informations, consultez la rubrique Configurer un analyseur de transfert de données.
Les appareils ajoutés aux passerelles cloud JT/T 808 ne peuvent pas s'abonner à des topics. Il est impossible de transférer les données des appareils de passerelle cloud JT/T 808 vers un topic.
Pour utiliser le transfert de données avec les appareils de passerelle cloud JT/T 808, ajoutez des topics des types suivants comme source de données : Custom, Device Status Change Notification et Device Changes Throughout Lifecycle. Pour ajouter un topic personnalisé comme source de données, spécifiez l'ID du fabricant, le modèle d'appareil et l'ID d'appareil dans le nom du topic. Pour plus d'informations, consultez la rubrique Créer une source de données.
Les abonnements côté serveur prennent uniquement en charge les types de messages Device Upstream Notification, Device Status Change Notification et Device Changes Throughout Lifecycle. Pour plus d'informations, consultez la rubrique Configurer un abonnement côté serveur AMQP.
Enregistrement d'appareil
Topic : /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"
}
**Parameter**
|
**Type**
|
**Description**
| | --- | --- | --- | |
payload
|
Object
|
Contenu du message d'enregistrement de l'appareil.
| |
createTime
|
Long
|
Heure de début de l'enregistrement de l'appareil.
| |
deviceId
|
String
|
ID d'appareil enregistré par l'utilisateur.
| |
deviceModel
|
String
|
Modèle d'appareil enregistré par l'utilisateur.
| |
deviceName
|
String
|
DeviceName. Format : `${manufacturer}_${deviceModel}_${deviceId}`.
| |
instanceId
|
String
|
ID de l'instance à laquelle l'appareil appartient.
| |
iotId
|
String
|
Identifiant unique de l'appareil dans IoT Platform.
| |
licensePlateColour
|
String
|
Couleur de la plaque d'immatriculation. La valeur doit être conforme aux exigences du protocole JT/T 808. Pour plus d'informations, consultez le document [JT/T 808-2019](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20221220/mdsf/JT-T%20808-2019.pdf).
| |
licensePlateNumber
|
String
|
Numéro de plaque d'immatriculation.
| |
manufacturer
|
String
|
ID du fabricant de l'appareil.
| |
productKey
|
String
|
Identifiant unique du produit auquel l'appareil appartient.
| |
status
|
String
|
Statut de l'appareil. Définissez la valeur sur `register`, ce qui indique que l'appareil est enregistré.
| |
tenantId
|
String
|
ID de l'utilisateur auquel l'appareil appartient.
|
Soumission du statut de l'appareil
Topic : /sys/${productKey}/${deviceName}/device/status/notify.
-
Format des données soumises par un appareil lors de sa mise en ligne :
{ "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" } -
Format des données soumises par un appareil lors de sa mise hors ligne :
{ "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" }
Paramètres
|
Parameter |
Type |
Description |
|
protocol |
String |
Si vous utilisez une passerelle cloud JT/T 808, définissez la valeur sur |
|
status |
String |
Statut de l'appareil.
|
|
iotId |
String |
Identifiant unique de l'appareil dans IoT Platform. |
|
offlineReasonCode |
Integer |
Code d'erreur lorsque l'appareil passe hors ligne. Codes d'erreur de comportement des appareils. |
|
productKey |
String |
Identifiant unique du produit auquel l'appareil appartient. |
|
deviceName |
String |
Nom de l'appareil. |
|
lastTime |
String |
Obsolète. Plus utilisé. |
|
utcLastTime |
String |
|
|
time |
String |
Heure à laquelle l'appareil est passé en ligne ou hors ligne. Les messages ne sont pas triés par heure de mise en ligne/hors ligne. Triez-les selon la valeur time. Par exemple, vous recevez les trois messages suivants dans l'ordre :
Ces trois messages indiquent que l'appareil est passé hors ligne, puis en ligne, puis à nouveau hors ligne. |
|
utcTime |
String |
Heure UTC à laquelle l'appareil est passé en ligne ou hors ligne. |
|
clientIp |
String |
Adresse IP publique de l'appareil. |
Soumission de données d'appareil
Topic : /sys/${productKey}/${deviceName}/device/message/uplink.
payload: {
header:{
messageId:"",
version:"",
phone:"",
serialNumber:""
},
body:{
data:"dGVzdDEyMw==",
type: 65
}
}
|
Parameter |
Type |
Description |
|
payload |
Object |
Message soumis par l'appareil, incluant les paramètres header et body. Le contenu peut être des données en transit, des statistiques de localisation ou des données GPS. |
|
header |
Object |
En-tête du message.
Les valeurs des paramètres messageId, version et phone doivent être conformes aux exigences du protocole JT/T 808. Pour plus d'informations, consultez le document JT/T 808-2019. |
|
body |
Object |
Corps du message.
Le corps du message doit être conforme aux exigences du protocole JT/T 808. Pour plus d'informations, consultez le document JT/T 808-2019. |
Désenregistrement d'appareil
Topic : /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"
}
**Parameter**
|
**Type**
|
**Description**
| | --- | --- | --- | |
payload
|
Object
|
Contenu du message de désenregistrement de l'appareil.
| |
createTime
|
Long
|
Heure de début du désenregistrement de l'appareil.
| |
deviceId
|
String
|
ID de l'appareil.
| |
deviceModel
|
String
|
Modèle de l'appareil.
| |
deviceName
|
String
|
DeviceName. Format : `${manufacturer}_${deviceModel}_${deviceId}`.
| |
instanceId
|
String
|
ID de l'instance à laquelle l'appareil appartient.
| |
iotId
|
String
|
Identifiant unique de l'appareil dans IoT Platform.
| |
licensePlateColour
|
String
|
Couleur de la plaque d'immatriculation. La valeur doit être conforme aux exigences du protocole JT/T 808. Pour plus d'informations, consultez le document [JT/T 808-2019](https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20221220/mdsf/JT-T%20808-2019.pdf).
| |
licensePlateNumber
|
String
|
Numéro de plaque d'immatriculation.
| |
manufacturer
|
String
|
ID du fabricant de l'appareil.
| |
productKey
|
String
|
Identifiant unique du produit auquel l'appareil appartient.
| |
status
|
String
|
Statut de l'appareil. Définissez la valeur sur `unregister`, ce qui indique que l'appareil est désenregistré.
| |
tenantId
|
String
|
ID de l'utilisateur auquel l'appareil appartient.
|