

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

# Aplikasi demo Bluetooth Energi Rendah
<a name="ble-demo"></a>

**penting**  <a name="deprecation-message-demo"></a>
Demo ini di-host di repositori Amazon-Freertos yang tidak digunakan lagi. Kami menyarankan Anda [mulai di sini](freertos-getting-started-modular.md) ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang sudah ada berdasarkan repositori Amazon-Freertos yang sekarang tidak digunakan lagi, lihat. [Panduan Migrasi Repositori Github Amazon-freertos](github-repo-migration.md)

## Ikhtisar
<a name="ble-demo-overview"></a>

FreeRTOS Bluetooth Low Energy mencakup tiga aplikasi demo:
+ [MQTT melalui Bluetooth Energi Rendah](#ble-demo-mqtt)demo 

  Aplikasi ini menunjukkan cara menggunakan MQTT melalui layanan Bluetooth Low Energy.
+ [Penyediaan Wi-Fi](#ble-demo-wifi)demo

  Aplikasi ini menunjukkan cara menggunakan layanan Penyediaan Wi-Fi Energi Rendah Bluetooth.
+ [Server Atribut Generik](#ble-demo-server)demo

  Aplikasi ini menunjukkan cara menggunakan APIs middleware FreeRTOS Bluetooth Low Energy untuk membuat server GATT sederhana.

**catatan**  
Untuk mengatur dan menjalankan demo FreeRTOS, ikuti langkah-langkahnya. [Memulai dengan FreeRTOS](freertos-getting-started.md)

## Prasyarat
<a name="ble-demo-prereqs"></a>

Untuk mengikuti demo ini, Anda memerlukan mikrokontroler dengan kemampuan Bluetooth Low Energy. Anda juga membutuhkan [SDK iOS untuk perangkat Bluetooth FreeRTOS](freertos-ble-mobile.md#freertos-ble-ios) atau[Android SDK untuk perangkat Bluetooth FreeRTOS](freertos-ble-mobile.md#freertos-ble-android).

### Siapkan AWS IoT dan Amazon Cognito untuk FreerTOS Bluetooth Low Energy
<a name="set-up-ble-demo-aws"></a>

Untuk menghubungkan perangkat Anda ke AWS IoT seluruh MQTT, Anda perlu mengatur dan Amazon AWS IoT Cognito.

**Untuk mengatur AWS IoT**

1. Siapkan AWS akun di [https://aws.amazon.com/](https://aws.amazon.com/).

1. Buka [AWS IoT konsol](https://console.aws.amazon.com/iot/), dan dari panel navigasi, pilih **Kelola**, lalu pilih **Things**.

1. Pilih **Buat**, lalu pilih **Buat satu hal**.

1. Masukkan nama untuk perangkat Anda, lalu pilih **Berikutnya**.

1. Jika Anda menghubungkan mikrokontroler Anda ke cloud melalui perangkat seluler, pilih **Buat sesuatu tanpa sertifikat**. Karena Ponsel SDKs 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 benda tersebut.

1. 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 informasi selengkapnya tentang pengaturan, lihat [Memulai dengan AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html).

**Untuk membuat kumpulan pengguna Amazon Cognito**

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

1. Pilih **Buat kolam pengguna**.

1. Beri nama kumpulan pengguna, lalu pilih **Tinjau default**.

1. Dari panel navigasi, pilih **Klien aplikasi**, lalu pilih **Tambahkan klien aplikasi**.

1. Masukkan nama untuk klien aplikasi, lalu pilih **Buat klien aplikasi**.

1. Dari panel navigasi, pilih **Tinjau**, lalu pilih **Buat kumpulan**.

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

1. 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**.

1. Masukkan nama untuk kolam identitas Anda.

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

1. Pilih **Buat kolam**.

1. 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.

1. Pilih **Edit kolam identitas**. Catat ID kumpulan identitas. Itu harus dari bentuk`us-west-2:12345678-1234-1234-1234-123456789012`.

Untuk informasi selengkapnya tentang pengaturan Amazon Cognito, lihat [Memulai dengan Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-getting-started.html).

**Untuk membuat dan melampirkan kebijakan IAM ke identitas yang diautentikasi**

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

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

1. Pilih tab **JSON**, dan tempel JSON berikut:

------
#### [ JSON ]

****  

   ```
   {
      "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":[
               "*"
            ]
         }
      ]
   }
   ```

------

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

Simpan informasi Anda AWS IoT dan Amazon Cognito di tangan. Anda memerlukan titik akhir dan IDs untuk mengautentikasi aplikasi seluler Anda dengan Cloud. AWS 

### Siapkan lingkungan FreeRTOS Anda untuk Bluetooth Low Energy
<a name="ble-demo-set-up"></a>

Untuk mengatur lingkungan Anda, Anda perlu mengunduh FreeRTOS dengan [Perpustakaan Bluetooth Rendah Energi](freertos-ble-library.md) mikrokontroler di Anda, dan mengunduh serta mengonfigurasi SDK Seluler untuk Perangkat Bluetooth FreeRTOS di perangkat seluler Anda.

**Untuk mengatur lingkungan mikrokontroler Anda dengan FreeRTOS Bluetooth Low Energy**

1. Unduh atau kloning FreeRTOS dari. [GitHub](https://github.com/aws/amazon-freertos) Lihat file [README.md](https://github.com/aws/amazon-freertos/blob/main/README.md) untuk instruksi.

1. Siapkan FreeRTOS di mikrokontroler Anda.

   [Untuk informasi tentang memulai dengan FreeRTOS pada mikrokontroler berkualifikasi FreeRTOS, lihat panduan untuk papan Anda di Memulai dengan FreeRTOS.](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-getting-started.html)
**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](#ble-demo-mqtt) FreeRTOS sepenuhnya di-porting ke perangkat berkemampuan Bluetooth Low Energy berikut:  
[Espressif ESP32 - DevKit C dan ESP-WROVER-KIT](https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_espressif.html)
[Nordik n RF52840 -DK](https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_nordic.html)

## Komponen umum
<a name="ble-demo-common"></a>

Aplikasi demo FreeRTOS memiliki dua komponen umum:
+ Network Manager
+ Aplikasi demo SDK Seluler Energi Rendah Bluetooth

### Network Manager
<a name="ble-demo-network-manager"></a>

Network Manager mengelola koneksi jaringan mikrokontroler Anda. Itu terletak di direktori FreeRTOS Anda di. `demos/network_manager/aws_iot_network_manager.c` Jika Network Manager diaktifkan untuk Wi-Fi dan Bluetooth Low Energy, demo dimulai dengan Bluetooth Low Energy secara default. Jika koneksi Bluetooth Low Energy terganggu, dan papan Anda terganggu Wi-Fi-enabled, Manajer Jaringan beralih ke koneksi Wi-Fi yang tersedia untuk mencegah Anda memutuskan sambungan dari jaringan.

Untuk mengaktifkan jenis koneksi jaringan dengan Network Manager, tambahkan jenis koneksi jaringan ke `configENABLED_NETWORKS` parameter di `vendors/vendor/boards/board/aws_demos/config_files/aws_iot_network_config.h` (di mana *vendor* adalah nama vendor dan *board* adalah nama papan yang Anda gunakan untuk menjalankan demo).

Misalnya, jika Anda mengaktifkan Bluetooth Low Energy dan Wi-Fi, baris yang dimulai dengan `#define configENABLED_NETWORKS` in `aws_iot_network_config.h` berbunyi sebagai berikut:

```
#define  configENABLED_NETWORKS  ( AWSIOT_NETWORK_TYPE_BLE | AWSIOT_NETWORK_TYPE_WIFI )
```

Untuk mendapatkan daftar jenis koneksi jaringan yang saat ini didukung, lihat baris yang dimulai dengan `#define AWSIOT_NETWORK_TYPE` in`aws_iot_network.h`.

### Aplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth
<a name="ble-sdk-app"></a>

[Aplikasi demo FreeRTOS Bluetooth Low Energy Mobile SDK terletak GitHub di [Android SDK untuk Perangkat Bluetooth FreeRTOS di bawah dan `amazon-freertos-ble-android-sdk/app` SDK iOS untuk Perangkat Bluetooth FreeRTOS di bawah](https://github.com/aws/amazon-freertos-ble-android-sdk).](https://github.com/aws/amazon-freertos-ble-ios-sdk) `amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo` Dalam contoh ini, kami menggunakan tangkapan layar dari versi iOS dari aplikasi seluler demo.

**catatan**  
Jika Anda menggunakan perangkat iOS, Anda memerlukan Xcode untuk membangun aplikasi seluler demo. Jika Anda menggunakan perangkat Android, Anda dapat menggunakan Android Studio untuk membuat aplikasi seluler demo.

**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](freertos-ble-mobile.md#freertos-ble-ios) sudah diinstal.

1. Keluarkan perintah berikut dari`amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/`:

   ```
   $ pod install
   ```

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

1. 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](https://console.aws.amazon.com/iot/).

   1. 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 Wilayah dan ID akun Anda.

   1. Pilih **Buat**.

1. Buka`amazon-freertos-ble-ios-sdk/Example/AmazonFreeRTOSDemo/AmazonFreeRTOSDemo/Amazon/AmazonConstants.swift`, dan definisikan ulang variabel berikut:
   + `region`: AWS Wilayah Anda.
   + `iotPolicyName`: Nama AWS IoT kebijakan Anda.
   + `mqttCustomTopic`: Topik MQTT yang ingin Anda publikasikan.

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

   Di bawah`CognitoIdentity`, mendefinisikan ulang variabel berikut:
   + `PoolId`: ID kumpulan identitas Amazon Cognito Anda.
   + `Region`: AWS Wilayah Anda.

   Di bawah`CognitoUserPool`, mendefinisikan ulang 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](freertos-ble-mobile.md#freertos-ble-android) sudah diinstal.

1. 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](https://console.aws.amazon.com/iot/).

   1. 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 Wilayah dan ID akun Anda.

   1. Pilih **Buat**.

1. Buka [ https://github.com/aws/amazon-freertos-ble-android- sdk/blob/master/app/src/main/java/software/amazon/freertos/demo/DemoConstants .java](https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/java/software/amazon/freertos/demo/DemoConstants.java) dan mendefinisikan ulang variabel berikut:
   + `AWS_IOT_POLICY_NAME`: Nama AWS IoT kebijakan Anda.
   + `AWS_IOT_REGION`: AWS Wilayah Anda.

1. Buka [ https://github.com/aws/amazon-freertos-ble-android- sdk/blob/master/app/src/main/res/raw/awsconfiguration .json](https://github.com/aws/amazon-freertos-ble-android-sdk/blob/master/app/src/main/res/raw/awsconfiguration.json). 

   Di bawah`CognitoIdentity`, mendefinisikan ulang variabel berikut:
   + `PoolId`: ID kumpulan identitas Amazon Cognito Anda.
   + `Region`: AWS Wilayah Anda.

   Di bawah`CognitoUserPool`, mendefinisikan ulang 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. [Menginstal emulator terminal](gsg-troubleshooting.md#uart-term)

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

1. 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
   ```

1. Konfirmasikan bahwa mikrokontroler Anda muncul di bawah **Perangkat** di aplikasi demo Bluetooth Low Energy Mobile SDK.  
![\[Halaman manajemen perangkat yang menampilkan ESP32 perangkat dengan pengenal uniknya.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-device-list1.png)
**catatan**  
Semua perangkat dengan FreeRTOS dan layanan informasi perangkat `freertos/.../device_information` () yang berada dalam jangkauan muncul dalam daftar.

1. Pilih mikrokontroler Anda dari daftar perangkat. Aplikasi membuat koneksi dengan papan, dan garis hijau muncul di sebelah perangkat yang terhubung.  
![\[ESP32 ID perangkat ditampilkan.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-device-list2.png)

   Anda dapat memutuskan sambungan dari mikrokontroler Anda dengan menyeret garis ke kiri.  
![\[Halaman perangkat yang menampilkan ID ESP32 perangkat dan ID perangkat lain.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-device-list3.png)

1. Jika diminta, pasangkan mikrokontroler dan perangkat seluler Anda.  
![\[Output konsol menunjukkan pemutusan perangkat BLE, pemutusan layanan MQTT, mulai iklan, koneksi BLE ke perangkat jarak jauh, dan prompt untuk perbandingan numerik.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/pairing-board.png)  
![\[Dialog permintaan pemasangan Bluetooth untuk perangkat "ESP32" menunjukkan kode “465520" untuk mengonfirmasi pada"”. ESP32\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/pairing-mobile.png)

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

**catatan**  
Aplikasi demo Bluetooth Low Energy Mobile SDK menggunakan Amazon Cognito untuk otentikasi pengguna. Pastikan Anda telah menyiapkan pengguna Amazon Cognito dan kumpulan identitas, dan Anda telah melampirkan kebijakan IAM ke identitas yang diautentikasi.

## MQTT melalui Bluetooth Energi Rendah
<a name="ble-demo-mqtt"></a>

Dalam demo MQTT melalui Bluetooth Low Energy, mikrokontroler Anda menerbitkan pesan ke AWS Cloud melalui proxy MQTT.

**Untuk berlangganan topik demo MQTT**

1. Masuk ke AWS IoT konsol.

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

1. Dalam **Subscription topic**, masukkan***thing-name*/example/topic1**, lalu pilih **Subscribe to topic**.

Jika Anda menggunakan Bluetooth Low Energy untuk memasangkan mikrokontroler dengan perangkat seluler Anda, pesan MQTT dirutekan melalui aplikasi demo Bluetooth Low Energy Mobile SDK di perangkat seluler Anda.

**Untuk mengaktifkan demo melalui Bluetooth Low Energy**

1. Buka`vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h`, dan tentukan`CONFIG_MQTT_BLE_TRANSPORT_DEMO_ENABLED`.

1. Buka`demos/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.

1. Pastikan Anda telah memasangkan papan dan perangkat seluler Anda menggunakan. [Aplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth](#ble-sdk-app)

1. Dari daftar **Perangkat** di aplikasi seluler demo, pilih mikrokontroler Anda, lalu pilih **MQTT Proxy untuk membuka pengaturan proxy MQTT**.  
![\[Daftar tiga ESP32 perangkat IDs, dengan opsi MQTT Proxy, Network Config, dan Custom GATT MQTT di bawah ini.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-device-list4.png)

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

## Penyediaan Wi-Fi
<a name="ble-demo-wifi"></a>

Penyediaan Wi-Fi adalah layanan FreeRTOS Bluetooth Low Energy yang memungkinkan Anda mengirim kredenal jaringan Wi-Fi dengan aman dari perangkat seluler ke mikrokontroler melalui Bluetooth Low Energy. Kode sumber untuk layanan Penyediaan Wi-Fi dapat ditemukan di. `freertos/.../wifi_provisioning`

**catatan**  
Demo Penyediaan Wi-Fi saat ini didukung di ESP32 Espressif - C. DevKit

**Untuk mengaktifkan demo**

1. Aktifkan layanan Penyediaan Wi-Fi. Buka`vendors/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 *board* adalah nama papan yang Anda gunakan untuk menjalankan demo).
**catatan**  
Layanan Penyediaan Wi-Fi dinonaktifkan secara default.

1. Konfigurasikan [Network Manager](#ble-demo-network-manager) untuk mengaktifkan Bluetooth Low Energy dan Wi-Fi.

**Untuk menjalankan demo**

1. Bangun dan jalankan proyek demo pada mikrokontroler Anda.

1. Pastikan Anda telah memasangkan mikrokontroler dan perangkat seluler Anda menggunakan. [Aplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth](#ble-sdk-app)

1. Dari daftar **Perangkat** di aplikasi seluler demo, pilih mikrokontroler Anda, lalu pilih **Network Config** untuk membuka pengaturan konfigurasi jaringan.  
![\[Daftar tiga ESP32 perangkat IDs, dengan opsi MQTT Proxy, Network Config, dan Custom GATT MQTT di bawah ini.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-device-list4.png)

1. 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**.  
![\[ESP32 antarmuka manajemen perangkat tidak menunjukkan jaringan yang disimpan, dua jaringan wi-fi terbuka yang dipindai, satu dengan WPA2 keamanan dan RSSI -29, yang lain dengan keamanan terbuka dan RSSI -50.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-network-config1.png)

   Dari daftar **Jaringan yang Dipindai**, pilih jaringan Anda, lalu masukkan SSID dan kata sandi, jika diperlukan.  
![\[Kotak dialog entri kata sandi jaringan Wi-Fi dengan bidang kata sandi kosong, tombol Batalkan dan Simpan.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-wifi-password.png)

   Mikrokontroler terhubung ke dan menyimpan jaringan. Jaringan muncul di bawah **Jaringan Tersimpan**.  
![\[Antarmuka jaringan menunjukkan WiFi jaringan yang disimpan dan dipindai, satu diamankan oleh WPA2, yang lain terbuka, dengan indikator kekuatan sinyal.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-network-config2.png)

Anda dapat menyimpan beberapa jaringan di aplikasi seluler demo. Saat Anda me-restart aplikasi dan demo, mikrokontroler terhubung ke jaringan tersimpan pertama yang tersedia, mulai dari bagian atas daftar **Jaringan Tersimpan**. 

Untuk mengubah urutan prioritas jaringan atau menghapus jaringan, pada halaman **Konfigurasi Jaringan**, pilih **Mode Pengeditan**. Untuk mengubah urutan prioritas jaringan, pilih sisi kanan jaringan yang ingin Anda prioritaskan ulang, dan seret jaringan ke atas atau ke bawah. Untuk menghapus jaringan, pilih tombol merah di sisi kiri jaringan yang ingin Anda hapus.

![\[Layar pengaturan jaringan wifi menampilkan jaringan yang disimpan, opsi pengeditan untuk menghapus atau mengubah prioritas, dan jaringan yang dipindai.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-network-editing.png)


## Server Atribut Generik
<a name="ble-demo-server"></a>

Dalam contoh ini, aplikasi Server Atribut Generik (GATT) demo pada mikrokontroler Anda mengirimkan nilai penghitung sederhana ke file. [Aplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth](#ble-sdk-app)

Menggunakan Bluetooth Low Energy Mobile SDKs, Anda dapat membuat klien GATT Anda sendiri untuk perangkat seluler yang terhubung ke server GATT pada mikrokontroler Anda dan berjalan secara paralel dengan aplikasi seluler demo.

**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 *board* 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.

1. Buka`freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h`, beri komentar`#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED`, dan tentukan`CONFIG_BLE_GATT_SERVER_DEMO_ENABLED`.

**Untuk menjalankan demo**

1. Bangun dan jalankan proyek demo pada mikrokontroler Anda.

1. Pastikan Anda telah memasangkan papan dan perangkat seluler Anda menggunakan. [Aplikasi demo SDK Seluler Energi Rendah FreeRTOS Bluetooth](#ble-sdk-app)

1. Dari daftar **Perangkat** di aplikasi, pilih papan Anda, lalu pilih **MQTT Proxy untuk membuka opsi proxy MQTT**.  
![\[Daftar tiga ESP32 perangkat IDs, dengan opsi MQTT Proxy, Network Config, dan Custom GATT MQTT di bawah ini.\]](http://docs.aws.amazon.com/id_id/freertos/latest/userguide/images/ble-device-list4.png)

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

1. Pilih **Mulai Penghitung** 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`