Aplikasi demo Bluetooth Energi Rendah

Untuk mengatur AWS IoT

1. Siapkan AWS akun di https://aws.amazon.com/.

2. Buka AWS IoT konsol, dan dari panel navigasi, pilih Kelola, lalu pilih Things.

3. Pilih Buat, lalu pilih Buat satu hal.

4. Masukkan nama untuk perangkat Anda, lalu pilih Berikutnya.

5. Jika Anda menghubungkan mikrokontroler Anda ke cloud melalui perangkat seluler, pilih Buat sesuatu tanpa sertifikat. Karena SDK Seluler menggunakan Amazon Cognito untuk otentikasi perangkat, Anda tidak perlu membuat sertifikat perangkat untuk demo yang menggunakan Bluetooth Low Energy.

   Jika Anda menghubungkan mikrokontroler Anda ke cloud secara langsung melalui Wi-Fi, pilih Buat sertifikat, pilih Aktifkan, lalu unduh sertifikat, kunci publik, dan kunci pribadi.

6. Pilih hal yang baru saja Anda buat dari daftar barang terdaftar, lalu pilih Interact dari halaman benda Anda. Catat titik akhir AWS IoT REST API.

Untuk membuat kumpulan pengguna Amazon Cognito

1. Buka konsol Amazon Cognito, dan pilih Kelola Kumpulan Pengguna.

2. Pilih Buat kolam pengguna.

3. Beri nama kumpulan pengguna, lalu pilih Tinjau default.

4. Dari panel navigasi, pilih Klien aplikasi, lalu pilih Tambahkan klien aplikasi.

5. Masukkan nama untuk klien aplikasi, lalu pilih Buat klien aplikasi.

6. Dari panel navigasi, pilih Tinjau, lalu pilih Buat kumpulan.

   Catat ID kumpulan yang muncul di halaman Pengaturan Umum kumpulan pengguna Anda.

7. Dari panel navigasi, pilih Klien aplikasi, lalu pilih Tampilkan detail. Catat ID klien aplikasi dan rahasia klien aplikasi.

Untuk membuat kumpulan identitas Amazon Cognito

1. Buka konsol Amazon Cognito, dan pilih Kelola Kolam Identitas.

2. Masukkan nama untuk kolam identitas Anda.

3. Perluas penyedia Autentikasi, pilih tab Cognito, lalu masukkan ID kumpulan pengguna dan ID klien aplikasi Anda.

4. Pilih Buat kolam.

5. Perluas Detail Tampilan, dan catat dua nama peran IAM. Pilih Izinkan untuk membuat peran IAM untuk identitas yang diautentikasi dan tidak diautentikasi untuk mengakses Amazon Cognito.

6. Pilih Edit kolam identitas. Catat ID kumpulan identitas. Itu harus dari bentukus-west-2:12345678-1234-1234-1234-123456789012.

Untuk membuat dan melampirkan kebijakan IAM ke identitas yang diautentikasi

1. Buka konsol IAM, dan dari panel navigasi, pilih Peran.

2. Temukan dan pilih peran identitas yang diautentikasi, pilih Lampirkan kebijakan, lalu pilih Tambahkan kebijakan sebaris.

3. Pilih tab JSON, dan tempel JSON berikut:

   {
      "Version":"2012-10-17",
      "Statement":[
         {
            "Effect":"Allow",
            "Action":[
               "iot:AttachPolicy",
               "iot:AttachPrincipalPolicy",
               "iot:Connect",
               "iot:Publish",
               "iot:Subscribe",
               "iot:Receive",
               "iot:GetThingShadow",
               "iot:UpdateThingShadow",
               "iot:DeleteThingShadow"
            ],
            "Resource":[
               "*"
            ]
         }
      ]
   }

4. Pilih Kebijakan tinjauan, masukkan nama untuk kebijakan tersebut, lalu pilih Buat kebijakan.

Untuk mengatur lingkungan mikrokontroler Anda dengan FreeRTOS Bluetooth Low Energy

1. Unduh atau kloning FreeRTOS dari. GitHub Lihat file README.md untuk instruksi.

2. Siapkan FreeRTOS di mikrokontroler Anda.

   Untuk informasi tentang memulai dengan FreeRTOS pada mikrokontroler berkualifikasi FreeRTOS, lihat panduan untuk papan Anda di Memulai dengan FreeRTOS.

   catatan

   Anda dapat menjalankan demo pada mikrokontroler Bluetooth Low Energy dengan FreeRTOS dan porting FreeRTOS Bluetooth Low Energy library. Saat ini, proyek demo MQTT melalui Bluetooth Energi Rendah FreeRTOS sepenuhnya di-porting ke perangkat berkemampuan Bluetooth Low Energy berikut:

   • Espressif ESP32- DevKit C dan ESP-WROVER-KIT

   • Nordik NRF52840-dk

Untuk mengonfigurasi aplikasi demo SDK iOS

Saat Anda menentukan variabel konfigurasi, gunakan format nilai placeholder yang disediakan dalam file konfigurasi.

1. Konfirmasikan bahwa SDK iOS untuk perangkat Bluetooth FreeRTOS sudah diinstal.

2. Keluarkan perintah berikut dariamazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/:

   $ pod install

3. Buka amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo.xcworkspace proyek dengan Xcode, dan ubah akun pengembang penandatanganan ke akun Anda.

4. Buat AWS IoT kebijakan di wilayah Anda (jika Anda belum melakukannya).

   catatan

   Kebijakan ini berbeda dengan kebijakan IAM yang dibuat untuk identitas yang diautentikasi Amazon Cognito.

   1. Buka konsol AWS IoT.

   2. Di panel navigasi, pilih Aman, pilih Kebijakan, lalu pilih Buat. Masukkan nama untuk mengidentifikasi kebijakan Anda. Di bagian Tambahkan pernyataan, pilih Mode lanjutan. Salin dan tempel JSON berikut ke jendela editor kebijakan. Ganti aws-region dan aws-account dengan AWS Region dan ID akun Anda.

      {
          "Version": "2012-10-17",
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": "iot:Connect",
                  "Resource":"arn:aws:iot:region:account-id:*"
              }, 
              {
                  "Effect": "Allow",
                  "Action": "iot:Publish",
                  "Resource": "arn:aws:iot:region:account-id:*"
              },
              {
                   "Effect": "Allow",
                   "Action": "iot:Subscribe",
                   "Resource": "arn:aws:iot:region:account-id:*"
              },
              {
                   "Effect": "Allow",
                   "Action": "iot:Receive",
                   "Resource": "arn:aws:iot:region:account-id:*"
              }
          ]
      }

   3. Pilih Buat.

5. Bukaamazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Amazon/AmazonConstants.swift, dan definisikan ulang variabel-variabel berikut:

   • region: AWS Wilayah Anda.

   • iotPolicyName: Nama AWS IoT kebijakan Anda.

   • mqttCustomTopic: Topik MQTT yang ingin Anda publikasikan.

6. Buka amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Support/awsconfiguration.json.

   Di bawahCognitoIdentity, mendefinisikan kembali variabel-variabel berikut:

   • PoolId: ID kumpulan identitas Amazon Cognito Anda.

   • Region: AWS Wilayah Anda.

   Di bawahCognitoUserPool, mendefinisikan kembali variabel-variabel berikut:

   • PoolId: ID kumpulan pengguna Amazon Cognito Anda.

   • AppClientId: ID klien aplikasi Anda.

   • AppClientSecret: Rahasia klien aplikasi Anda.

   • Region: AWS Wilayah Anda.

Untuk mengonfigurasi aplikasi demo Android SDK

Saat Anda menentukan variabel konfigurasi, gunakan format nilai placeholder yang disediakan dalam file konfigurasi.

1. Konfirmasikan bahwa Android SDK untuk perangkat Bluetooth FreeRTOS sudah diinstal.

2. Buat AWS IoT kebijakan di wilayah Anda (jika Anda belum melakukannya).

   catatan

   Kebijakan ini berbeda dengan kebijakan IAM yang dibuat untuk identitas yang diautentikasi Amazon Cognito.

   1. Buka konsol AWS IoT.

   2. Di panel navigasi, pilih Aman, pilih Kebijakan, lalu pilih Buat. Masukkan nama untuk mengidentifikasi kebijakan Anda. Di bagian Tambahkan pernyataan, pilih Mode lanjutan. Salin dan tempel JSON berikut ke jendela editor kebijakan. Ganti aws-region dan aws-account dengan AWS Region dan ID akun Anda.

      {
          "Version": "2012-10-17",
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": "iot:Connect",
                  "Resource":"arn:aws:iot:region:account-id:*"
              }, 
              {
                  "Effect": "Allow",
                  "Action": "iot:Publish",
                  "Resource": "arn:aws:iot:region:account-id:*"
              },
              {
                   "Effect": "Allow",
                   "Action": "iot:Subscribe",
                   "Resource": "arn:aws:iot:region:account-id:*"
              },
              {
                   "Effect": "Allow",
                   "Action": "iot:Receive",
                   "Resource": "arn:aws:iot:region:account-id:*"
              }
          ]
      }

   3. Pilih Buat.

3. Buka https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/java/software/amazon/freertos/demo/ DemoConstants .java dan definisikan ulang variabel berikut:

   • AWS_IOT_POLICY_NAME: Nama AWS IoT kebijakan Anda.

   • AWS_IOT_REGION: AWS Wilayah Anda.

4. Buka https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/res/raw/awsconfiguration.json.

   Di bawahCognitoIdentity, mendefinisikan kembali variabel-variabel berikut:

   • PoolId: ID kumpulan identitas Amazon Cognito Anda.

   • Region: AWS Wilayah Anda.

   Di bawahCognitoUserPool, mendefinisikan kembali variabel-variabel berikut:

   • PoolId: ID kumpulan pengguna Amazon Cognito Anda.

   • AppClientId: ID klien aplikasi Anda.

   • AppClientSecret: Rahasia klien aplikasi Anda.

   • Region: AWS Wilayah Anda.

Untuk menemukan dan membangun koneksi aman dengan mikrokontroler Anda melalui Bluetooth Low Energy

1. Untuk memasangkan mikrokontroler dan perangkat seluler Anda dengan aman (langkah 6), Anda memerlukan emulator terminal serial dengan kemampuan input dan output (seperti TeraTerm). Konfigurasikan terminal untuk terhubung ke papan Anda dengan koneksi serial seperti yang diinstruksikan. Memasang emulator terminal

2. Jalankan proyek demo Bluetooth Low Energy di mikrokontroler Anda.

3. Jalankan aplikasi demo Bluetooth Low Energy Mobile SDK di perangkat seluler Anda.

   Untuk memulai aplikasi demo di Android SDK dari baris perintah, jalankan perintah berikut:

   $ ./gradlew installDebug

4. Konfirmasikan bahwa mikrokontroler Anda muncul di bawah Perangkat di aplikasi demo Bluetooth Low Energy Mobile SDK.

   

   catatan

   Semua perangkat dengan FreeRTOS dan layanan informasi perangkat freertos/.../device_information () yang berada dalam jangkauan muncul dalam daftar.

5. Pilih mikrokontroler Anda dari daftar perangkat. Aplikasi membuat koneksi dengan papan, dan garis hijau muncul di sebelah perangkat yang terhubung.

   

   Anda dapat memutuskan sambungan dari mikrokontroler Anda dengan menyeret garis ke kiri.

   

6. Jika diminta, pasangkan mikrokontroler dan perangkat seluler Anda.

   Papan FreeRTOS

   

   Perangkat seluler

   

   Jika kode untuk perbandingan numerik sama pada kedua perangkat, pasangkan perangkat.

Untuk berlangganan topik demo MQTT

1. Masuk ke AWS IoT konsol.

2. Di panel navigasi, pilih Uji, lalu pilih klien pengujian MQTT untuk membuka klien MQTT.

3. Dalam Subscription topic, masukkanthing-name/example/topic1, lalu pilih Subscribe to topic.

Untuk mengaktifkan demo melalui Bluetooth Low Energy

1. Bukavendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h, dan tentukanCONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED.

2. Bukademos/include/aws_clientcredential.h, dan konfigurasikan clientcredentialMQTT_BROKER_ENDPOINT dengan titik akhir AWS IoT broker. Konfigurasikan clientcredentialIOT_THING_NAME dengan nama benda untuk perangkat pengontrol mikro BLE. Titik akhir AWS IoT broker dapat diperoleh dari AWS IoT konsol dengan memilih Pengaturan di panel navigasi kiri, atau melalui CLI dengan menjalankan perintah:. aws iot describe-endpoint --endpoint-type=iot:Data-ATS

   catatan

   Titik akhir AWS IoT broker dan nama benda keduanya harus berada di wilayah yang sama di mana identitas cognito dan kumpulan pengguna dikonfigurasi.

Untuk menjalankan demo

1. Bangun dan jalankan proyek demo pada mikrokontroler Anda.

2. Pastikan Anda telah memasangkan papan dan perangkat seluler Anda menggunakan. Aplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth

3. Dari daftar Perangkat di aplikasi seluler demo, pilih mikrokontroler Anda, lalu pilih MQTT Proxy untuk membuka pengaturan proxy MQTT.

   

4. Setelah Anda mengaktifkan proxy MQTT, pesan MQTT muncul pada thing-name/example/topic1 topik, dan data dicetak ke terminal UART.

Untuk mengaktifkan demo

1. Aktifkan layanan Penyediaan Wi-Fi. Bukavendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h, dan atur #define IOT_BLE_ENABLE_WIFI_PROVISIONING ke 1 (di mana vendor adalah nama vendor dan papan adalah nama papan yang Anda gunakan untuk menjalankan demo).

   catatan

   Layanan Penyediaan Wi-Fi dinonaktifkan secara default.

2. Konfigurasikan Network Manager untuk mengaktifkan Bluetooth Low Energy dan Wi-Fi.

Untuk menjalankan demo

1. Bangun dan jalankan proyek demo pada mikrokontroler Anda.

2. Pastikan Anda telah memasangkan mikrokontroler dan perangkat seluler Anda menggunakan. Aplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth

3. Dari daftar Perangkat di aplikasi seluler demo, pilih mikrokontroler Anda, lalu pilih Network Config untuk membuka pengaturan konfigurasi jaringan.

   

4. Setelah Anda memilih Network Config untuk papan Anda, mikrokontroler mengirimkan daftar jaringan di sekitarnya ke perangkat seluler. Jaringan Wi-Fi yang tersedia muncul dalam daftar di bawah Jaringan yang Dipindai.

   

   Dari daftar Jaringan yang Dipindai, pilih jaringan Anda, lalu masukkan SSID dan kata sandi, jika diperlukan.

   

   Mikrokontroler terhubung ke dan menyimpan jaringan. Jaringan muncul di bawah Jaringan Tersimpan.

   

Untuk mengaktifkan demo

1. Aktifkan demo Bluetooth Low Energy GATT. Di vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h (di mana vendor adalah nama vendor dan papan adalah nama papan yang Anda gunakan untuk menjalankan demo), tambahkan #define IOT_BLE_ADD_CUSTOM_SERVICES ( 1 ) ke daftar pernyataan define.

   catatan

   Demo Bluetooth Low Energy GATT dinonaktifkan secara default.

2. Bukafreertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h, beri komentar#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED, dan tentukanCONFIG_BLE_GATT_SERVER_DEMO_ENABLED.

Untuk menjalankan demo

1. Bangun dan jalankan proyek demo pada mikrokontroler Anda.

2. Pastikan Anda telah memasangkan papan dan perangkat seluler Anda menggunakan. Aplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth

3. Dari daftar Perangkat di aplikasi, pilih papan Anda, lalu pilih MQTT Proxy untuk membuka opsi proxy MQTT.

   

4. Kembali ke daftar Perangkat, pilih papan Anda, lalu pilih Custom GATT MQTT untuk membuka opsi layanan GATT kustom.

5. Pilih Start Counter untuk mulai menerbitkan data ke topik your-thing-name/example/topic MQTT.

   Setelah Anda mengaktifkan proxy MQTT, Hello World dan pesan penghitung tambahan muncul pada topik. your-thing-name/example/topic