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

Tutorial: Menginstal Device SDK dan menjalankan aplikasi sampel untuk Device Shadows

Bagian ini menunjukkan bagaimana Anda dapat menginstal perangkat lunak yang diperlukan dan AWS IoT Device SDK untuk Python dan menjalankan aplikasi shadow.py sampel untuk mengedit dokumen Shadow dan mengontrol status bayangan.

Sebelum Anda menjalankan tutorial ini:

Anda harus mengatur Akun AWS, mengonfigurasi perangkat Raspberry Pi Anda, dan membuat AWS IoT sesuatu dan kebijakan yang memberikan izin perangkat untuk menerbitkan dan berlangganan topik cadangan MQTT dari layanan Device Shadow. Untuk informasi selengkapnya, lihat Tutorial: Mempersiapkan Raspberry Pi Anda untuk menjalankan aplikasi bayangan.

Anda juga harus menginstal Git, Python, dan AWS IoT Device SDK untuk Python. Tutorial ini dibangun di atas konsep yang disajikan dalam tutorialHubungkan Raspberry Pi atau perangkat lain. Jika Anda belum mencoba tutorial itu, kami sarankan Anda mengikuti langkah-langkah yang dijelaskan dalam tutorial itu untuk menginstal file sertifikat dan SDK Perangkat dan kemudian kembali ke tutorial ini untuk menjalankan aplikasi shadow.py sampel.

Tutorial ini membutuhkan waktu sekitar 20 menit untuk menyelesaikannya.

Langkah 1: Jalankan aplikasi sampel shadow.py

Sebelum menjalankan aplikasi shadow.py contoh, Anda memerlukan informasi berikut selain nama dan lokasi file sertifikat yang Anda instal.

Masukkan nilai dan amati pembaruan di dokumen Shadow

Anda dapat memasukkan nilai di terminal untuk menentukan desired nilai, yang juga memperbarui nil reported ainya. Katakanlah Anda memasukkan warna yellow di terminal. reportedNilai juga diperbarui ke warnayellow. Berikut ini menunjukkan pesan yang ditampilkan di terminal:

Enter desired value:
yellow
Changed local shadow value to 'yellow'.
Updating reported shadow value to 'yellow'...
Update request published.
Finished updating reported shadow value to 'yellow'.

Saat Anda menerbitkan permintaan pembaruan ini AWS IoT , membuat bayangan klasik default untuk sumber daya benda. Anda dapat mengamati permintaan pembaruan yang Anda publikasikan ke desired nilai reported dan di AWS IoT konsol dengan melihat dokumen Shadow untuk sumber daya benda yang Anda buat (misalnya,My_light_bulb). Untuk melihat pembaruan di dokumen Shadow:

Dokumen Shadow harus terlihat mirip dengan berikut ini, menunjukkan desired nilai reported dan yang disetel ke warnayellow. Anda melihat nilai-nilai ini di bagian Status bayangan dokumen.

{
"desired": {
  "welcome": "aws-iot",
  "color": "yellow"
},
"reported": {
  "welcome": "aws-iot",
  "color": "yellow"
}
}

Anda juga melihat bagian Metadata yang berisi informasi stempel waktu dan nomor versi permintaan.

Anda dapat menggunakan versi dokumen status untuk memastikan Anda memperbarui versi terbaru dari dokumen Shadow perangkat. Jika Anda mengirim permintaan pembaruan lain, nomor versi bertambah 1. Saat Anda menyediakan versi dengan permintaan pembaruan, layanan menolak permintaan dengan kode respons konflik HTTP 409 jika versi dokumen status saat ini tidak cocok dengan versi yang disediakan.

{
"metadata": {
  "desired": {
    "welcome": {
      "timestamp": 1620156892
    },
    "color": {
      "timestamp": 1620156893
    }
  },
  "reported": {
    "welcome": {
      "timestamp": 1620156892
    },
    "color": {
      "timestamp": 1620156893
    }
  }
},
"version": 10
}        

Untuk mempelajari lebih lanjut tentang dokumen Shadow dan mengamati perubahan informasi status, lanjutkan ke tutorial berikutnya Tutorial: Berinteraksi dengan Device Shadow menggunakan aplikasi sampel dan klien uji MQTT seperti yang dijelaskan di Langkah 4: Tinjau hasil dan langkah selanjutnya bagian tutorial ini. Secara opsional, Anda juga dapat mempelajari tentang kode shadow.py sampel dan bagaimana menggunakan protokol MQTT di bagian berikut.

Langkah 2: Tinjau aplikasi sampel SDK Perangkat shadow.py

Bagian ini meninjau shadow.py contoh aplikasi dari AWS IoT Device SDK v2 untuk Python yang digunakan dalam tutorial ini. Di sini, kami akan meninjau bagaimana terhubung AWS IoT Core dengan menggunakan MQTT dan MQTT melalui protokol WSS. P AWS ustaka runtime umum (AWS-CRT) menyediakan dukungan protokol komunikasi tingkat rendah dan disertakan dengan Device SDK v2 AWS IoT untuk Python.

Sementara tutorial ini menggunakan MQTT dan MQTT melalui WSS, AWS IoT mendukung perangkat yang menerbitkan permintaan HTTPS. Untuk contoh program Python yang mengirim pesan HTTP dari perangkat, lihat contoh kode HTTPS menggunakan pustaka Python. requests

Untuk informasi tentang bagaimana Anda dapat membuat keputusan berdasarkan informasi tentang protokol mana yang akan digunakan untuk komunikasi perangkat Anda, tinjauMemilih protokol aplikasi untuk komunikasi perangkat Anda.

MQTT

Sam shadow.py pel panggilan mtls_from_path (ditampilkan di sini) mqtt_connection_builder untuk membuat koneksi AWS IoT Core dengan menggunakan protokol MQTT. mtls_from_pathmenggunakan X.509 sertifikat dan TLS v1.2 untuk mengotentikasi perangkat. Pust AWS aka -CRT menangani detail tingkat yang lebih rendah dari koneksi itu.

mqtt_connection = mqtt_connection_builder.mtls_from_path(
  endpoint=args.endpoint,
  cert_filepath=args.cert,
  pri_key_filepath=args.key,
  ca_filepath=args.ca_file,
  client_bootstrap=client_bootstrap,
  on_connection_interrupted=on_connection_interrupted,
  on_connection_resumed=on_connection_resumed,
  client_id=args.client_id,
  clean_session=False,
  keep_alive_secs=6
)

Sam shadow.py pel juga memang websockets_with_default_aws_signing gil mqtt_connection_builder untuk membuat koneksi dengan AWS IoT Core menggunakan protokol MQTT melalui WSS. MQTT over WSS juga menggunakan parameter yang sama dengan MQTT dan mengambil parameter tambahan ini:

Berlangganan topik dan acara Shadow

Sam shadow.py pel mencoba untuk membuat koneksi dan menunggu untuk terhubung sepenuhnya. Jika tidak terhubung, perintah akan mengantri. Setelah terhubung, sampel berlangganan acara delta dan memperbarui dan mendapatkan pesan, dan menerbitkan pesan dengan tingkat Kualitas Layanan (QoS) 1 (mqtt.QoS.AT_LEAST_ONCE).

Ketika perangkat berlangganan pesan dengan QoS level 1, broker pesan menyimpan pesan yang berlangganan perangkat hingga dapat dikirim ke perangkat. Pialang pesan mengirim ulang pesan sampai menerima PUBACK respons dari perangkat.

Untuk informasi lebih lanjut tentang protokol MQTT, lihat Tinjau protokol MQTT danMQTT.

Untuk informasi selengkapnya tentang bagaimana MQTT, MQTT melalui WSS, sesi persisten, dan level QoS yang digunakan dalam tutorial ini, lihat. Tinjau aplikasi contoh SDK Perangkat pubsub.py

Langkah 3: Memecahkan masalah dengan aplikasi sampel shadow.py

Saat Anda menjalankan aplikasi shadow.py sampel, Anda akan melihat beberapa pesan ditampilkan di terminal dan prompt untuk memasukkan desired nilai. Jika program menimbulkan kesalahan, maka untuk men-debug kesalahan, Anda dapat mulai dengan memeriksa apakah Anda menjalankan perintah yang benar untuk sistem Anda.

Dalam beberapa kasus, pesan kesalahan mungkin menunjukkan masalah koneksi dan terlihat mirip dengan: Host name was invalid for dns resolution atauConnection was closed unexpectedly. Dalam kasus seperti itu, berikut adalah beberapa hal yang dapat Anda periksa:

Langkah 4: Tinjau hasil dan langkah selanjutnya

Langkah selanjutnya

Anda sekarang dapat menjalankan aplikasi shadow.py sampel dan menggunakan Device Shadows untuk mengontrol status. Anda dapat mengamati pembaruan pada dokumen Shadow di Kon AWS IoT sol dan mengamati peristiwa delta yang ditanggapi aplikasi sampel. Menggunakan klien uji MQTT, Anda dapat berlangganan topik bayangan yang dicadangkan dan mengamati pesan yang diterima oleh topik saat menjalankan program sampel. Untuk informasi selengkapnya tentang cara menjalankan tutorial ini, lihatTutorial: Berinteraksi dengan Device Shadow menggunakan aplikasi sampel dan klien uji MQTT.