Instal AWS IoT Device SDK untuk Python - AWS IoT Greengrass

AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

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

Instal AWS IoT Device SDK untuk Python

Perangkat klien dapat menggunakanAWS IoT Device SDKuntuk Python untuk berkomunikasi denganAWS IoTdanAWS IoT Greengrassperangkat inti (menggunakan bahasa pemrograman Python). Untuk informasi lebih lanjut, termasuk persyaratan, lihatAWS IoT Device SDKuntuk PythonReadmedi atas GitHub.

Pada langkah ini, Anda menginstal SDK dan mendapatkanbasicDiscovery.pyfungsi sampel yang digunakan oleh perangkat klien simulasi pada komputer Anda.

  1. Untuk menginstal SDK pada komputer anda, dengan semua komponen yang diperlukan, pilih sistem operasi Anda:

    Windows
    1. Buka prompt perintah yang ditinggikan dan jalankan perintah berikut:

      python --version

      Jika tidak ada informasi versi dikembalikan atau jika nomor versi kurang dari 2.7 untuk Python 2 atau kurang dari 3.3 untuk Python 3, ikuti petunjuk di Mengunduh Python untuk menginstal Python 2.7+ or Python 3.3+. Untuk informasi lebih lanjut, lihat Menggunakan Python pada Windows.

    2. Unduh AWS IoT Device SDK untuk Python sebagai zip file dan mengekstraksi ke lokasi yang sesuai pada komputer Anda.

      Buat catatan tentang path file ke aws-iot-device-sdk-python-master folder yang berisi setup.py file. Pada langkah selanjutnya, path file ini ditunjukkan oleh path-to-SDK-folder.

    3. Dari prompt perintah yang ditinggikan, jalankan yang berikut ini:

      cd path-to-SDK-folder python setup.py install
    macOS
    1. Buka jendela Terminal dan jalankan perintah berikut:

      python --version

      Jika tidak ada informasi versi dikembalikan atau jika nomor versi kurang dari 2.7 untuk Python 2 atau kurang dari 3.3 untuk Python 3, ikuti petunjuk di Mengunduh Python untuk menginstal Python 2.7+ or Python 3.3+. Untuk informasi lebih lanjut, lihat Menggunakan Python pada Macintosh.

    2. Di jendela Terminal, jalankan perintah berikut untuk menentukan versi OpenSSL:

      python >>>import ssl >>>print ssl.OPENSSL_VERSION

      Buat catatan nilai versi OpenSSL.

      catatan

      Jika Anda menjalankan Python 3, gunakan print(ssl.OPENSSL_VERSION).

      Untuk menutup Python shell, jalankan perintah berikut:

      >>>exit()

      Jika versi OpenSSL adalah 1.0.1 atau yang lebih baru, lewati ke langkah c. Jika tidak, ikuti langkah-langkah berikut:

      1. Dari jendela Terminal, jalankan perintah berikut untuk menentukan apakah komputer menggunakan Simple Python Version Management:

        which pyenv

      Jika path file dikembalikan, kemudian pilih tab Menggunakan pyenv ini. Jika tidak ada yang dikembalikan, pilih tab Tidak menggunakan pyenv ini.

      Using pyenvNot using pyenv
      Using pyenv
      1. Lihat Phyton Releases for Mac OS X (atau serupa) untuk menentukan versi Python stabil terbaru. Pada contoh berikut, nilai ini ditunjukkan oleh versi terbaru Python.

      2. Dari jendela Terminal, jalankan perintah berikut:

        pyenv install latest-Python-version pyenv global latest-Python-version

        Sebagai contoh, jika versi terbaru untuk Python 2 adalah 2.7.14, maka perintah ini adalah:

        pyenv install 2.7.14 pyenv global 2.7.14
      3. Tutup lalu buka kembali jendela Terminal lalu jalankan perintah berikut:

        python >>>import ssl >>>print ssl.OPENSSL_VERSION

        Versi OpenSSL harus setidaknya 1.0.1. Jika versi kurang dari 1.0.1, maka pembaruan gagal. Periksa nilai versi Python yang digunakan dalam pyenv install dan pyenv global perintahkan dan coba lagi.

      4. Jalankan perintah berikut untuk keluar dari Python shell:

        exit()
      Not using pyenv
      1. Dari jendela Terminal, jalankan perintah berikut untuk menentukan apakah brew diinstal:

        which brew

        Jika path file tidak dikembalikan, instal brew sebagai berikut:

        /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
        catatan

        Ikuti petunjuk penginstalan. Unduh untuk alat baris perintah Xcode dapat memakan waktu lama.

      2. Jalankan perintah berikut:

        brew update brew install openssl brew install python@2

        Untuk Python AWS IoT Device SDK membutuhkan OpenSSL versi 1.0.1 (atau yang lebih baru) dikompilasi dengan Python executable. Perintah brew install python menginstal sebuah python2 executable yang memenuhi persyaratan ini. Executable python2 diinstal di /usr/local/bin direktori, yang harus menjadi bagian dari PATH variabel lingkungan. Untuk mengonfirmasi, jalankan perintah berikut:

        python2 --version

        Jika python2 informasi versi tersedia, lewati ke langkah selanjutnya. Jika tidak, secara permanen menambahkan /usr/local/bin jalur ke PATH dengan menambahkan baris berikut ke profil shell Anda:

        export PATH="/usr/local/bin:$PATH"

        Sebagai contoh, jika Anda menggunakan .bash_profile atau belum memiliki profil shell, jalankan perintah berikut dari jendela Terminal:

        echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile

        Selanjutnya, sumber profil shell Anda dan konfirmasikan bahwa python2 --version menyediakan informasi versi. Sebagai contoh, jika Anda menggunakan .bash_profile, jalankan perintah berikut:

        source ~/.bash_profile python2 --version

        python2 informasi versi harus dikembalikan.

      3. Tambahkan baris berikut ke profil shell Anda:

        alias python="python2"

        Sebagai contoh, jika Anda menggunakan .bash_profile atau belum memiliki profil shell, jalankan perintah berikut:

        echo 'alias python="python2"' >> ~/.bash_profile
      4. Selanjutnya, sumber profil shell Anda. Sebagai contoh, jika Anda menggunakan .bash_profile, jalankan perintah berikut:

        source ~/.bash_profile

        Memanggil python menjalankan Python executable yang berisi versi OpenSSL yang dibutuhkan (python2) .

      5. Jalankan perintah berikut:

        python import ssl print ssl.OPENSSL_VERSION

        Versi OpenSSL harus 1.0.1 atau yang lebih baru.

      6. Untuk keluar dari Python shell, jalankan perintah berikut:

        exit()
    3. Jalankan perintah berikut untuk menginstal AWS IoT Device SDK untuk Python:

      cd ~ git clone https://github.com/aws/aws-iot-device-sdk-python.git cd aws-iot-device-sdk-python sudo python setup.py install
    UNIX-like system
    1. Dari jendela terminal, jalankan perintah berikut:

      python --version

      Jika tidak ada informasi versi dikembalikan atau jika nomor versi kurang dari 2.7 untuk Python 2 atau kurang dari 3.3 untuk Python 3, ikuti petunjuk di Mengunduh Python untuk menginstal Python 2.7+ or Python 3.3+. Untuk informasi lebih lanjut, lihat Menggunakan Python pada platform Unix.

    2. Di terminal, jalankan perintah berikut untuk menentukan versi OpenSSL:

      python >>>import ssl >>>print ssl.OPENSSL_VERSION

      Buat catatan nilai versi OpenSSL.

      catatan

      Jika Anda menjalankan Python 3, gunakan print(ssl.OPENSSL_VERSION).

      Untuk menutup Python shell, jalankan perintah berikut:

      exit()

      Jika versi OpenSSL adalah 1.0.1 atau yang lebih baru, lewati ke langkah selanjutnya. Jika tidak, jalankan perintah untuk memperbarui OpenSSL untuk distribusi Anda (sebagai contoh, sudo yum update openssl, sudo apt-get update, dan sebagainya).

      Konfirmasikan bahwa versi OpenSSL adalah 1.0.1 atau yang lebih baru dengan menjalankan perintah berikut:

      python >>>import ssl >>>print ssl.OPENSSL_VERSION >>>exit()
    3. Jalankan perintah berikut untuk menginstal AWS IoT Device SDK untuk Python:

      cd ~ git clone https://github.com/aws/aws-iot-device-sdk-python.git cd aws-iot-device-sdk-python sudo python setup.py install
  2. Setelah AWS IoT Device SDK untuk Python yang diinstal, arahkan ke samples folder dan buka greengrass folder.

    Untuk tutorial ini, Anda menyalin basicDiscovery.py fungsi sampel yang menggunakan sertifikat dan kunci yang diunduh di Membuat perangkat klien dalamAWS IoT Greengrasskelompok.

  3. SalinbasicDiscovery.pyke folder yang berisi HelloWorld_Publisher dan HelloWorld_Subscriber sertifikat dan kunci perangkat.