Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Uji komunikasi perangkat klien Perangkat klien dapat menggunakan perangkat AWS IoT Device SDK untuk menemukan, menghubungkan, dan berkomunikasi dengan perangkat inti. Anda dapat menggunakan klien penemuan Greengrass AWS IoT Device SDK untuk menggunakan [Greengrass discovery API, yang mengembalikan informasi](greengrass-discover-api.md) tentang perangkat inti yang dapat dihubungkan oleh perangkat klien. Respon API mencakup titik akhir broker MQTT untuk untuk terhubung dan sertifikat untuk digunakan untuk memverifikasi identitas setiap perangkat inti. Kemudian, perangkat klien dapat mencoba setiap titik akhir sampai berhasil terhubung ke perangkat inti. Perangkat klien hanya dapat menemukan perangkat inti yang Anda kaitkan. Sebelum Anda menguji komunikasi antara perangkat klien dan perangkat inti, Anda harus mengaitkan perangkat klien ke perangkat inti. Untuk informasi selengkapnya, lihat [Mengaitkan perangkat klien](associate-client-devices.md). API penemuan Greengrass mengembalikan titik akhir broker perangkat inti MQTT yang Anda tentukan. Anda dapat menggunakan [Komponen pendeteksi IP](ip-detector-component.md) untuk mengelola titik akhir ini untuk Anda, atau Anda dapat mengelolanya secara manual untuk setiap perangkat inti. Untuk informasi selengkapnya, lihat [Kelola titik akhir perangkat inti](manage-core-device-endpoints.md). **catatan** Untuk menggunakan API penemuan Greengrass, perangkat klien harus memiliki izin `greengrass:Discover`. Untuk informasi selengkapnya, lihat [AWS IoT Kebijakan minimal untuk perangkat klien](device-auth.md#client-device-minimal-iot-policy). AWS IoT Device SDK Ini tersedia dalam berbagai bahasa pemrograman. Untuk informasi selengkapnya, lihat [AWS IoT Perangkat SDKs](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) di *Panduan AWS IoT Core Pengembang*. **Topics** + [Uji komunikasi (Python)](#test-client-device-communications-python) + [Uji komunikasi (C\$1\$1)](#test-client-device-communications-cpp) + [Uji komunikasi (JavaScript)](#test-client-device-communications-javascript) + [Uji komunikasi (Java)](#test-client-device-communications-java) ## Uji komunikasi (Python) Pada bagian ini, Anda menggunakan sampel penemuan Greengrass di [v2 for Python AWS IoT Device SDK](https://github.com/aws/aws-iot-device-sdk-python-v2) untuk menguji komunikasi antara perangkat klien dan perangkat inti. **penting** Untuk menggunakan AWS IoT Device SDK v2 untuk Python, perangkat harus menjalankan Python 3.6 atau yang lebih baru. **Untuk menguji komunikasi (AWS IoT Device SDK v2 untuk Python)** 1. Unduh dan instal [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2) ke AWS IoT benda yang akan dihubungkan sebagai perangkat klien. Di perangkat klien, lakukan hal berikut: 1. Kloning AWS IoT Device SDK v2 untuk repositori Python untuk mengunduhnya. ``` git clone https://github.com/aws/aws-iot-device-sdk-python-v2.git ``` 1. Instal AWS IoT Device SDK v2 untuk Python. ``` python3 -m pip install --user ./aws-iot-device-sdk-python-v2 ``` 1. Ubah ke folder sampel di AWS IoT Device SDK v2 untuk Python. ``` cd aws-iot-device-sdk-python-v2/samples/greengrass ``` 1. Jalankan sampel aplikasi penemuan Greengrass. Aplikasi ini mengharapkan argumen yang menentukan nama objek perangkat klien, topik MQTT dan pesan yang akan digunakan, dan sertifikat yang mengautentikasi dan mengamankan sambungan. Contoh berikut mengirimkan pesan Hello World ke topik `clients/MyClientDevice1/hello/world`. + Ganti *MyClientDevice1* dengan nama benda perangkat klien. + Ganti *\$1/certs/AmazonRootCA1.pem* dengan jalur ke sertifikat CA root Amazon di perangkat klien. + Ganti *\$1/certs/device.pem.crt* dengan jalur ke sertifikat perangkat di perangkat klien. + Ganti *\$1/certs/private.pem.key* dengan path ke file kunci pribadi pada perangkat klien. + Ganti *us-east-1* dengan AWS Wilayah tempat perangkat klien dan perangkat inti Anda beroperasi. ``` python3 basic_discovery.py \\ --thing_name MyClientDevice1 \\ --topic 'clients/MyClientDevice1/hello/world' \\ --message 'Hello World!' \\ --ca_file ~/certs/AmazonRootCA1.pem \\ --cert ~/certs/device.pem.crt \\ --key ~/certs/private.pem.key \\ --region us-east-1 \\ --verbosity Warn ``` Aplikasi sampel penemuan mengirimkan pesan 10 kali dan terputus. Aplikasi ini juga berlangganan topik yang sama di mana ia menerbitkan pesan. Jika output menunjukkan bahwa aplikasi itu menerima pesan MQTT pada topik, perangkat klien dapat berhasil berkomunikasi dengan perangkat inti. ``` Performing greengrass discovery... awsiot.greengrass_discovery.DiscoverResponse(gg_groups=[awsiot.greengrass_discovery.GGGroup(gg_group_id='greengrassV2-coreDevice-MyGreengrassCore', cores=[awsiot.greengrass_discovery.GGCore(thing_arn='arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore', connectivity=[awsiot.greengrass_discovery.ConnectivityInfo(id='203.0.113.0', host_address='203.0.113.0', metadata='', port=8883)])], certificate_authorities=['-----BEGIN CERTIFICATE-----\ MIICiT...EXAMPLE=\ -----END CERTIFICATE-----\ '])]) Trying core arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore at host 203.0.113.0 port 8883 Connected! Published topic clients/MyClientDevice1/hello/world: {"message": "Hello World!", "sequence": 0} Publish received on topic clients/MyClientDevice1/hello/world b'{"message": "Hello World!", "sequence": 0}' Published topic clients/MyClientDevice1/hello/world: {"message": "Hello World!", "sequence": 1} Publish received on topic clients/MyClientDevice1/hello/world b'{"message": "Hello World!", "sequence": 1}' ... Published topic clients/MyClientDevice1/hello/world: {"message": "Hello World!", "sequence": 9} Publish received on topic clients/MyClientDevice1/hello/world b'{"message": "Hello World!", "sequence": 9}' ``` Jika aplikasi mengeluarkan kesalahan, lihat [Pemecahan masalah penemuan Greengrass](troubleshooting-client-devices.md#greengrass-discovery-issues). Anda juga dapat melihat log Greengrass pada perangkat inti untuk memverifikasi apakah perangkat klien berhasil menghubungkan dan mengirim pesan. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). ## Uji komunikasi (C\$1\$1) Pada bagian ini, Anda menggunakan sampel penemuan Greengrass di [v2 for C\$1\$1AWS IoT Device SDK](https://github.com/aws/aws-iot-device-sdk-cpp-v2) untuk menguji komunikasi antara perangkat klien dan perangkat inti. Untuk membangun AWS IoT Device SDK v2 untuk C\$1\$1, perangkat harus memiliki alat berikut: + C\$1\$1 11 atau yang lebih baru + CMake 3.1 atau yang lebih baru + Salah satu penyusun berikut: + GCC 4.8 atau yang lebih baru + Clang 3.9 atau yang lebih baru + MSVC 2015 atau yang lebih baru **Untuk menguji komunikasi (AWS IoT Device SDK v2 untuk C \$1\$1)** 1. Unduh dan buat [AWS IoT Device SDK v2 untuk C \$1\$1](https://github.com/aws/aws-iot-device-sdk-cpp-v2) ke AWS IoT benda yang akan dihubungkan sebagai perangkat klien. Di perangkat klien, lakukan hal berikut: 1. Buat folder untuk AWS IoT Device SDK v2 untuk ruang kerja C \$1\$1, dan ubah ke folder tersebut. ``` cd mkdir iot-device-sdk-cpp cd iot-device-sdk-cpp ``` 1. Kloning AWS IoT Device SDK v2 untuk repositori C\$1\$1 untuk mengunduhnya. Bendera `--recursive` menentukan untuk men-download submodul. ``` git clone --recursive https://github.com/aws/aws-iot-device-sdk-cpp-v2.git ``` 1. Buat folder untuk keluaran build AWS IoT Device SDK v2 untuk C\$1\$1, dan ubah ke sana. ``` mkdir aws-iot-device-sdk-cpp-v2-build cd aws-iot-device-sdk-cpp-v2-build ``` 1. Membangun AWS IoT Device SDK v2 untuk C \$1\$1. ``` cmake -DCMAKE_INSTALL_PREFIX="~/iot-device-sdk-cpp" -DCMAKE_BUILD_TYPE="Release" ../aws-iot-device-sdk-cpp-v2 cmake --build . --target install ``` 1. Bangun aplikasi sampel penemuan Greengrass di v2 untuk C \$1\$1. AWS IoT Device SDK Lakukan hal-hal berikut: 1. Ubah ke folder sampel penemuan Greengrass di v2 untuk C\$1\$1. AWS IoT Device SDK ``` cd ../aws-iot-device-sdk-cpp-v2/samples/greengrass/basic_discovery ``` 1. Buat folder untuk output build sampel penemuan Greengrass, dan ubah ke itu. ``` mkdir build cd build ``` 1. Bangun sampel aplikasi penemuan Greengrass. ``` cmake -DCMAKE_PREFIX_PATH="~/iot-device-sdk-cpp" -DCMAKE_BUILD_TYPE="Release" .. cmake --build . --config "Release" ``` 1. Jalankan sampel aplikasi penemuan Greengrass. Aplikasi ini mengharapkan argumen yang menentukan nama objek perangkat klien, topik MQTT dan pesan yang akan digunakan, dan sertifikat yang mengautentikasi dan mengamankan sambungan. Contoh berikut berlangganan topik `clients/MyClientDevice1/hello/world` dan menerbitkan pesan yang Anda masukkan pada baris perintah untuk topik yang sama. + Ganti *MyClientDevice1* dengan nama benda perangkat klien. + Ganti *\$1/certs/AmazonRootCA1.pem* dengan jalur ke sertifikat CA root Amazon di perangkat klien. + Ganti *\$1/certs/device.pem.crt* dengan jalur ke sertifikat perangkat di perangkat klien. + Ganti *\$1/certs/private.pem.key* dengan path ke file kunci pribadi pada perangkat klien. + Ganti *us-east-1* dengan AWS Wilayah tempat perangkat klien dan perangkat inti Anda beroperasi. ``` ./basic-discovery \ --thing_name MyClientDevice1 \ --topic 'clients/MyClientDevice1/hello/world' \ --ca_file ~/certs/AmazonRootCA1.pem \ --cert ~/certs/device.pem.crt \ --key ~/certs/private.pem.key \ --region us-east-1 ``` Aplikasi sampel penemuan berlangganan topik dan meminta Anda untuk memasukkan pesan untuk dipublikasikan. ``` Connecting to group greengrassV2-coreDevice-MyGreengrassCore with thing arn arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore, using endpoint 203.0.113.0:8883 Connected to group greengrassV2-coreDevice-MyGreengrassCore, using connection to 203.0.113.0:8883 Successfully subscribed to clients/MyClientDevice1/hello/world Enter the message you want to publish to topic clients/MyClientDevice1/hello/world and press enter. Enter 'exit' to exit this program. ``` Jika aplikasi mengeluarkan kesalahan, lihat [Pemecahan masalah penemuan Greengrass](troubleshooting-client-devices.md#greengrass-discovery-issues). 1. Masukkan pesan, seperti **Hello World\$1**. ``` Enter the message you want to publish to topic clients/MyClientDevice1/hello/world and press enter. Enter 'exit' to exit this program. Hello World! ``` Jika output menunjukkan bahwa aplikasi itu menerima pesan MQTT pada topik, perangkat klien dapat berhasil berkomunikasi dengan perangkat inti. ``` Operation on packetId 2 Succeeded Publish received on topic clients/MyClientDevice1/hello/world Message: Hello World! ``` Anda juga dapat melihat log Greengrass pada perangkat inti untuk memverifikasi apakah perangkat klien berhasil menghubungkan dan mengirim pesan. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). ## Uji komunikasi (JavaScript) Di bagian ini, Anda menggunakan sampel penemuan Greengrass di [AWS IoT Device SDK v2 JavaScript](https://github.com/aws/aws-iot-device-sdk-js-v2) untuk menguji komunikasi antara perangkat klien dan perangkat inti. **penting** Untuk menggunakan AWS IoT Device SDK v2 for JavaScript, perangkat harus menjalankan Node v10.0 atau yang lebih baru. **Untuk menguji komunikasi (AWS IoT Device SDK v2 untuk JavaScript)** 1. Unduh dan instal [AWS IoT Device SDK v2 JavaScript untuk](https://github.com/aws/aws-iot-device-sdk-js-v2) AWS IoT hal yang akan dihubungkan sebagai perangkat klien. Di perangkat klien, lakukan hal berikut: 1. Kloning AWS IoT Device SDK v2 untuk JavaScript repositori untuk mengunduhnya. ``` git clone https://github.com/aws/aws-iot-device-sdk-js-v2.git ``` 1. Instal AWS IoT Device SDK v2 untuk JavaScript. ``` cd aws-iot-device-sdk-js-v2 npm install ``` 1. Ubah ke folder sampel penemuan Greengrass di v2 untuk. AWS IoT Device SDK JavaScript ``` cd samples/node/greengrass/basic_discovery ``` 1. Instal sampel aplikasi penemuan Greengrass. ``` npm install ``` 1. Jalankan sampel aplikasi penemuan Greengrass. Aplikasi ini mengharapkan argumen yang menentukan nama objek perangkat klien, topik MQTT dan pesan yang akan digunakan, dan sertifikat yang mengautentikasi dan mengamankan sambungan. Contoh berikut mengirimkan pesan Hello World ke topik `clients/MyClientDevice1/hello/world`. + Ganti *MyClientDevice1* dengan nama benda perangkat klien. + Ganti *\$1/certs/AmazonRootCA1.pem* dengan jalur ke sertifikat CA root Amazon di perangkat klien. + Ganti *\$1/certs/device.pem.crt* dengan jalur ke sertifikat perangkat di perangkat klien. + Ganti *\$1/certs/private.pem.key* dengan path ke file kunci pribadi pada perangkat klien. + Ganti *us-east-1* dengan AWS Wilayah tempat perangkat klien dan perangkat inti Anda beroperasi. ``` node dist/index.js \ --thing_name MyClientDevice1 \ --topic 'clients/MyClientDevice1/hello/world' \ --message 'Hello World!' \ --ca_file ~/certs/AmazonRootCA1.pem \ --cert ~/certs/device.pem.crt \ --key ~/certs/private.pem.key \ --region us-east-1 \ --verbose warn ``` Aplikasi sampel penemuan mengirimkan pesan 10 kali dan terputus. Aplikasi ini juga berlangganan topik yang sama di mana ia menerbitkan pesan. Jika output menunjukkan bahwa aplikasi itu menerima pesan MQTT pada topik, perangkat klien dapat berhasil berkomunikasi dengan perangkat inti. ``` Discovery Response: {"gg_groups":[{"gg_group_id":"greengrassV2-coreDevice-MyGreengrassCore","cores":[{"thing_arn":"arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore","connectivity":[{"id":"203.0.113.0","host_address":"203.0.113.0","port":8883,"metadata":""}]}],"certificate_authorities":["-----BEGIN CERTIFICATE-----\nMIICiT...EXAMPLE=\n-----END CERTIFICATE-----\n"]}]} Trying endpoint={"id":"203.0.113.0","host_address":"203.0.113.0","port":8883,"metadata":""} [WARN] [2021-06-12T00:46:45Z] [00007f90c0e8d700] [socket] - id=0x7f90b8018710 fd=26: setsockopt() for NO_SIGNAL failed with errno 92. If you are having SIGPIPE signals thrown, you may want to install a signal trap in your application layer. Connected to endpoint={"id":"203.0.113.0","host_address":"203.0.113.0","port":8883,"metadata":""} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":1} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":2} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":3} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":4} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":5} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":6} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":7} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":8} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":9} Publish received. topic:"clients/MyClientDevice1/hello/world" dup:false qos:0 retain:false {"message":"Hello World!","sequence":10} Complete! ``` Jika aplikasi mengeluarkan kesalahan, lihat [Pemecahan masalah penemuan Greengrass](troubleshooting-client-devices.md#greengrass-discovery-issues). Anda juga dapat melihat log Greengrass pada perangkat inti untuk memverifikasi apakah perangkat klien berhasil menghubungkan dan mengirim pesan. Untuk informasi selengkapnya, lihat [Memantau AWS IoT Greengrass log](monitor-logs.md). ## Uji komunikasi (Java) Pada bagian ini, Anda menggunakan sampel penemuan Greengrass di [v2 for Java AWS IoT Device SDK](https://github.com/aws/aws-iot-device-sdk-java-v2) untuk menguji komunikasi antara perangkat klien dan perangkat inti. **penting** Untuk membangun AWS IoT Device SDK v2 untuk Java, perangkat harus memiliki alat berikut: Java 8 atau yang lebih baru, dengan `JAVA_HOME` menunjuk ke folder Java. Apache Maven **Untuk menguji komunikasi (AWS IoT Device SDK v2 untuk Java)** 1. Unduh dan bangun [AWS IoT Device SDK v2 untuk Java](https://github.com/aws/aws-iot-device-sdk-java-v2) ke AWS IoT benda yang akan dihubungkan sebagai perangkat klien. Di perangkat klien, lakukan hal berikut: 1. Kloning AWS IoT Device SDK v2 untuk repositori Java untuk mengunduhnya. ``` git clone https://github.com/aws/aws-iot-device-sdk-java-v2.git ``` 1. Ubah ke folder AWS IoT Device SDK v2 untuk Java. 1. Membangun AWS IoT Device SDK v2 untuk Java. ``` cd aws-iot-device-sdk-java-v2 mvn versions:use-latest-versions -Dincludes="software.amazon.awssdk.crt*" mvn clean install ``` 1. Jalankan sampel aplikasi penemuan Greengrass. Aplikasi ini mengharapkan argumen yang menentukan nama objek perangkat klien, topik MQTT dan pesan yang akan digunakan, dan sertifikat yang mengautentikasi dan mengamankan sambungan. Contoh berikut berlangganan topik `clients/MyClientDevice1/hello/world` dan menerbitkan pesan yang Anda masukkan pada baris perintah untuk topik yang sama. + Ganti kedua instance *MyClientDevice1* dengan nama benda perangkat klien. + Ganti *\$1HOME/certs/AmazonRootCA1.pem* dengan jalur ke sertifikat CA root Amazon di perangkat klien. + Ganti *\$1HOME/certs/device.pem.crt* dengan jalur ke sertifikat perangkat di perangkat klien. + Ganti *\$1HOME/certs/private.pem.key* dengan path ke file kunci pribadi pada perangkat klien. + Ganti *us-east-1* dengan Wilayah AWS tempat perangkat klien dan perangkat inti Anda beroperasi. ``` DISCOVERY_SAMPLE_ARGS="--thing_name MyClientDevice1 \ --topic 'clients/MyClientDevice1/hello/world' \ --ca_file $HOME/certs/AmazonRootCA1.pem \ --cert $HOME/certs/device.pem.crt \ --key $HOME/certs/private.pem.key \ --region us-east-1" mvn exec:java -pl samples/Greengrass/Discovery \ -Dexec.mainClass=greengrass.BasicDiscovery \ -Dexec.args="$DISCOVERY_SAMPLE_ARGS" ``` Aplikasi sampel penemuan berlangganan topik dan meminta Anda untuk memasukkan pesan untuk dipublikasikan. ``` Connecting to group ID greengrassV2-coreDevice-MyGreengrassCore, with thing arn arn:aws:iot:us-east-1:123456789012:thing/MyGreengrassCore, using endpoint 203.0.113.0:8883 Started a clean session Enter the message you want to publish to topic clients/MyClientDevice1/hello/world and press Enter. Type 'exit' or 'quit' to exit this program: ``` Jika aplikasi mengeluarkan kesalahan, lihat [Pemecahan masalah penemuan Greengrass](troubleshooting-client-devices.md#greengrass-discovery-issues). 1. Masukkan pesan, seperti **Hello World\$1**. ``` Enter the message you want to publish to topic clients/MyClientDevice1/hello/world and press Enter. Type 'exit' or 'quit' to exit this program: Hello World! ``` Jika output menunjukkan bahwa aplikasi itu menerima pesan MQTT pada topik, perangkat klien dapat berhasil berkomunikasi dengan perangkat inti. ``` Message received on topic clients/MyClientDevice1/hello/world: Hello World! ``` Anda juga dapat melihat log Greengrass pada perangkat inti untuk memverifikasi apakah perangkat klien berhasil menghubungkan dan mengirim pesan. Lihat informasi yang lebih lengkap di [Memantau AWS IoT Greengrass log](monitor-logs.md).