Berinteraksilah dengan perangkat klien dalam komponen - AWS IoT Greengrass

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Berinteraksilah dengan perangkat klien dalam komponen

Anda dapat mengembangkan komponen Greengrass kustom yang berinteraksi dengan perangkat klien yang terhubung ke perangkat inti. Misalnya, Anda dapat mengembangkan komponen yang melakukan hal berikut:

  • Bertindaklah atas pesan MQTT dari perangkat klien dan kirim data ke tujuan AWS Cloud.

  • Kirim pesan MQTT ke perangkat klien untuk melakukan tindakan.

Perangkat klien terhubung ke dan berkomunikasi dengan perangkat inti melalui komponen broker MQTT yang berjalan pada perangkat inti. Secara default, perangkat klien hanya dapat berkomunikasi satu sama lain melalui MQTT, dan komponen Greengrass tidak dapat menerima pesan MQTT ini atau mengirim pesan ke perangkat klien.

Komponen Greengrass menggunakan antarmuka publish/subscribe lokal untuk berkomunikasi di perangkat inti. Untuk berkomunikasi dengan perangkat klien dalam komponen Greengrass, konfigurasikan komponen jembatan MQTT untuk melakukan hal berikut:

  • Relai pesan MQTT dari perangkat klien ke publish/subscribe lokal.

  • Relai pesan MQTT dari publish/subscribe lokal ke perangkat klien.

Anda juga dapat berinteraksi dengan bayangan perangkat klien dalam komponen Greengrass. Untuk informasi selengkapnya, lihat Berinteraksi dengan dan menyinkronkan bayangan perangkat klien.

Konfigurasikan dan deploy komponen jembatan MQTT

Komponen jembatan MQTT mengonsumsi daftar pemetaan topik yang masing-masing menentukan sumber pesan dan tujuan pesan. Untuk berkomunikasi dengan perangkat klien, deploy komponen jembatan MQTT, dan tentukan setiap sumber dan tujuan topik dalam konfigurasi komponen.

Untuk men-deploy komponen jembatan MQTT ke perangkat inti atau kelompok perangkat inti, buat deployment yang mencakup komponen aws.greengrass.clientdevices.mqtt.Bridge. Tentukan pemetaan topik,mqttTopicMapping, pada konfigurasi komponen jembatan MQTT dalam deployment.

Contoh berikut mendefinisikan deployment yang mengonfigurasi komponen jembatan MQTT untuk merelai topik clients/MyClientDevice1/hello/world dari perangkat klien ke broker publish/subscribe lokal. Pembaruan konfigurasi merge memerlukan objek JSON berserial. Untuk informasi selengkapnya, lihat Perbarui konfigurasi komponen.

Console
{ "mqttTopicMapping": { "HelloWorldPubsub": { "topic": "clients/MyClientDevice1/hello/world", "source": "LocalMqtt", "target": "Pubsub" } } }
AWS CLI
{ "components": { "aws.greengrass.clientdevices.mqtt.Bridge": { "version": "2.0.0", "configurationUpdate": { "merge": "\"mqttTopicMapping\":{\"HelloWorldPubsub\":{\"topic\":\"clients/MyClientDevice1/hello/world\",\"source\":\"LocalMqtt\",\"target\":\"Pubsub\"}}}" } } ... } }

Anda dapat menggunakan wildcard topik MQTT untuk menyampaikan pesan pada topik yang cocok dengan filter topik. Jika Anda menggunakan jembatan MQTT v2.2.0 atau yang lebih baru, Anda dapat menggunakan wildcard topik MQTT di filter topik saat broker sumber menerbitkan/berlangganan lokal. Untuk informasi lebih lanjut, lihat konfigurasi komponen jembatan MQTT.

Terima pesan MQTT dari perangkat klien

Anda dapat berlangganan topik publish/subscribe lokal yang dikonfigurasi untuk komponen jembatan MQTT untuk menerima pesan dari perangkat klien.

Untuk menerima pesan MQTT dari perangkat klien dalam komponen kustom

  1. Konfigurasikan dan deploy komponen jembatan MQTT untuk menyampaikan pesan dari topik MQTT di mana perangkat klien mempublikasikan ke topik publish/subscribe lokal.

  2. Gunakan antarmuka IPC publish/subscribe lokal untuk berlangganan topik di mana jembatan MQTT merelai pesan. Untuk informasi selengkapnya, lihat Pesan lokal publikasi/berlangganan dan SubscribeToTopic.

Tutorial hubungkan dan uji perangkat klien mencakup bagian di mana Anda mengembangkan komponen yang berlangganan pesan dari perangkat klien. Untuk informasi selengkapnya, lihat Langkah 4: Kembangkan komponen yang berkomunikasi dengan perangkat klien.

Kirim pesan MQTT ke perangkat klien

Anda dapat mempublikasikan topik publish/subscribe lokal yang dikonfigurasi untuk komponen jembatan MQTT untuk menerima pesan dari perangkat klien.

Untuk mempublikasikan pesan MQTT ke perangkat klien dalam komponen kustom

  1. Konfigurasikan dan deploy komponen jembatan MQTT untuk menyampaikan pesan dari topik publish/subscribe lokal ke topik MQTT tempat perangkat klien berlangganan.

  2. Gunakan antarmuka IPC publish/subscribe lokal untuk mempublikasikan topik di mana jembatan MQTT merelai pesan. Selengkapnya, lihat Pesan lokal publikasi/berlangganan dan PublishToTopic.