Pesan - IoT Platform

Anda dapat menggunakan fitur penerusan data dari mesin aturan di IoT Platform untuk mengirim pesan perangkat gateway JT/T 808 ke server Anda. Pesan-pesan tersebut mencakup pendaftaran perangkat, pembatalan pendaftaran perangkat, dan pengiriman data. Langganan server sisi Advanced Message Queuing Protocol (AMQP) digunakan untuk mengirim pesan pengiriman data ke server Anda. Topik ini menjelaskan cara menggunakan mesin aturan untuk meneruskan pesan serta memberikan panduan terkait topik yang diperlukan dan tipe data.

Catatan Penggunaan

Saat mengonfigurasi aturan penerusan data, perhatikan hal-hal berikut:

Anda hanya dapat menggunakan versi baru dari fitur penerusan data untuk mengonfigurasi aturan penerusan data untuk perangkat gateway. Untuk informasi lebih lanjut, lihat Konfigurasikan parser penerusan data.
Perangkat yang ditambahkan ke cloud gateway JT/T 808 tidak dapat berlangganan topik. Data perangkat cloud gateway JT/T 808 tidak dapat diteruskan ke topik.
Jika Anda ingin menggunakan penerusan data untuk perangkat cloud gateway JT/T 808, Anda dapat menambahkan topik jenis berikut sebagai sumber data: Custom, Device Status Change Notification, dan Device Changes Throughout Lifecycle. Jika Anda ingin menambahkan topik kustom sebagai sumber data, Anda harus menentukan ID produsen, model perangkat, dan ID perangkat dalam nama topik. Untuk informasi lebih lanjut, lihat Buat sumber data.
Anda dapat menggunakan langganan server-sisi untuk mendorong data hanya dari tipe Device Upstream Notification, Device Status Change Notification, dan Device Changes Throughout Lifecycle. Untuk informasi lebih lanjut, lihat Konfigurasikan langganan server-sisi AMQP.

Pendaftaran Perangkat

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

payload: {
    "createTime": 1.669.968.170.000,
    "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	Tipe	Deskripsi
payload	Objek	Konten pesan pendaftaran perangkat.
createTime	Long	Waktu mulai pendaftaran perangkat.
deviceId	String	ID perangkat yang didaftarkan oleh pengguna.
deviceModel	String	Model perangkat yang didaftarkan oleh pengguna.
deviceName	String	Nama Perangkat. Format: `${manufacturer}_${deviceModel}_${deviceId}`.
instanceId	String	ID instance tempat perangkat berada.
iotId	String	Pengenal unik perangkat di IoT Platform.
licensePlateColour	String	Warna pelat nomor. Nilainya harus memenuhi persyaratan protokol JT/T 808. Untuk informasi lebih lanjut, lihat JT/T 808-2019.
licensePlateNumber	String	Nomor pelat kendaraan.
manufacturer	String	ID produsen perangkat.
productKey	String	Pengenal unik produk tempat perangkat berada.
status	String	Status perangkat. Atur nilainya menjadi `register`, yang menunjukkan bahwa perangkat telah terdaftar.
tenantId	String	ID pengguna tempat perangkat berada.

Mengirim status perangkat

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

Format data yang dikirim oleh perangkat saat perangkat online:

{
    "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 data yang dikirim oleh perangkat saat perangkat offline:

{
    "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"
}

Parameter

Parameter	Tipe	Deskripsi
protocol	String	Jika Anda menggunakan cloud gateway JT/T 808, atur nilainya menjadi `jt808`.
status	String	Status perangkat. Nilai yang valid: offline
iotId	String	Pengenal unik perangkat di IoT Platform.
offlineReasonCode	Integer	Kode kesalahan yang dikembalikan saat perangkat offline. Untuk informasi lebih lanjut, lihat Kode kesalahan yang terkait dengan perilaku perangkat.
productKey	String	Pengenal unik produk tempat perangkat berada.
deviceName	String	Nama Perangkat dari perangkat.
lastTime	String	Parameter ini tidak lagi valid.
utcLastTime	String	Parameter ini tidak lagi valid.
time	String	Waktu ketika perangkat online atau offline. Pesan yang dikembalikan tidak disortir berdasarkan waktu. Anda perlu mengurutkan pesan secara manual. Sebagai contoh, Anda menerima pesan berikut secara berurutan: Waktu online: 2018-08-31 10:02:28.195 Waktu offline: 2018-08-31 10:01:28.195 Waktu offline: 2018-08-31 10:03:28.195 Pesan sebelumnya menunjukkan bahwa perangkat terputus, tersambung kembali, lalu terputus lagi.
utcTime	String	Waktu ketika perangkat online atau offline. Waktu dalam format UTC.
clientIp	String	Alamat IP publik perangkat.

Pengiriman data perangkat

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

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

Parameter	Tipe	Deskripsi
payload	Objek	Pesan yang dikirim oleh perangkat. Pesan mencakup parameter header dan body. Isi pesan dapat berupa data pass-through, statistik lokasi, atau data GPS.
header	Objek	Header yang dikirim oleh perangkat. messageId: ID pesan. version: versi protokol. phone: nomor telepon. serialNumber: nomor seri pesan. Nilai valid: 0 hingga 65535. Perangkat menambah nomor seri satu untuk setiap pesan yang dikirim oleh perangkat. Nilai parameter messageId, version, dan phone harus memenuhi persyaratan protokol JT/T 808. Untuk informasi lebih lanjut, lihat JT/T 808-2019.
body	Objek	Badan pesan yang dikirim oleh perangkat. data: isi pesan. Isi tersebut dikodekan dalam Base64. type: tipe pesan pass-through. Dalam contoh ini, `65` merepresentasikan `0x41`, yang menunjukkan bahwa Port Serial 1 digunakan untuk melewati data. Badan pesan harus memenuhi persyaratan protokol JT/T 808. Untuk informasi lebih lanjut, lihat JT/T 808-2019.

Pembatalan Pendaftaran Perangkat

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

payload: {
    "createTime": 1.669.968.170.000,
    "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	Tipe	Deskripsi
payload	Objek	Konten pesan pembatalan pendaftaran perangkat.
createTime	Long	Waktu mulai pembatalan pendaftaran perangkat.
deviceId	String	ID perangkat.
deviceModel	String	Model perangkat.
deviceName	String	Nama Perangkat. Format: `${manufacturer}_${deviceModel}_${deviceId}`.
instanceId	String	ID instance tempat perangkat berada.
iotId	String	Pengenal unik perangkat di IoT Platform.
licensePlateColour	String	Warna pelat nomor. Nilainya harus memenuhi persyaratan protokol JT/T 808. Untuk informasi lebih lanjut, lihat JT/T 808-2019.
licensePlateNumber	String	Nomor pelat kendaraan.
manufacturer	String	ID produsen perangkat.
productKey	String	Pengenal unik produk tempat perangkat berada.
status	String	Status perangkat. Atur nilainya menjadi `unregister`, yang menunjukkan bahwa perangkat telah dibatalkan pendaftarannya.
tenantId	String	ID pengguna tempat perangkat berada.