Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Memulai dengan Simulator Perangkat Windows Tutorial ini memberikan instruksi untuk memulai dengan FreeRTOS Windows Device Simulator. Sebelum memulai, Anda harus mengonfigurasi AWS IoT dan mengunduh FreeRTOS Anda untuk menghubungkan perangkat Anda ke Cloud. AWS Lihat [Langkah pertama](freertos-prereqs.md) untuk instruksi. Dalam tutorial ini, jalur ke direktori unduhan FreeRTOS disebut sebagai. `{{freertos}}` FreeRTOS dirilis sebagai file zip yang berisi pustaka FreeRTOS dan contoh aplikasi untuk platform yang Anda tentukan. Untuk menjalankan sampel pada mesin Windows, unduh pustaka dan sampel yang di-porting untuk dijalankan di Windows. Kumpulan file ini disebut sebagai simulator FreeRTOS untuk Windows. **catatan** Tutorial ini tidak dapat berhasil dijalankan pada instans Windows Amazon EC2. ## Siapkan lingkungan pengembangan Anda 1. Instal versi terbaru [Npcap](https://npcap.com/). Pilih "WinPcap API-compatible mode” selama instalasi. 1. Instal [Microsoft Visual Studio](https://www.visualstudio.com/downloads). Visual Studio versi 2017 dan 2019 diketahui berfungsi. Semua edisi versi Visual Studio ini didukung (Komunitas, Profesional, atau Perusahaan). Selain IDE, instal **pengembangan Desktop dengan komponen C\+\+**. Instal SDK Windows 10 terbaru. Anda dapat memilih ini di bawah bagian **Opsional** **pengembangan Desktop dengan komponen C \+\+**. 1. Pastikan Anda memiliki koneksi Ethernet terprogram yang aktif. 1. [(Opsional) Jika Anda ingin menggunakan sistem CMake-based build untuk membangun proyek Freertos Anda, instal CMake versi terbaru.](https://cmake.org/download/) FreeRTOS membutuhkan CMake versi 3.13 atau yang lebih baru. ## Memantau pesan MQTT di cloud Sebelum menjalankan proyek demo FreeRTOS, Anda dapat mengatur klien MQTT di konsol untuk memantau pesan AWS IoT yang dikirim perangkat Anda ke Cloud. AWS **Untuk berlangganan topik MQTT dengan AWS IoT Klien MQTT** 1. Masuk ke [konsol AWS IoT](https://console.aws.amazon.com/iotv2/) tersebut. 1. Di panel navigasi, pilih **Uji**, lalu pilih klien **pengujian MQTT untuk membuka klien** MQTT. 1. Dalam **Subscription topic**, masukkan**{{your-thing-name}}/example/topic**, lalu pilih **Subscribe to topic**. Ketika proyek demo berhasil berjalan di perangkat Anda, Anda melihat “Hello World\!” dikirim beberapa kali ke topik yang Anda berlangganan. ## Bangun dan jalankan proyek demo FreeRTOS Anda dapat menggunakan Visual Studio atau CMake untuk membangun proyek FreerTos. ### Membangun dan menjalankan proyek demo FreeRTOS dengan Visual Studio IDE 1. Muat proyek ke Visual Studio. Di Visual Studio, dari menu **File**, pilih **Buka**. Pilih **File/Solution**, navigasikan ke `projects/pc/windows/visual_studio/aws_demos/aws_demos.sln` file, lalu pilih **Buka**. 1. Targetkan ulang proyek demo. Proyek demo yang disediakan tergantung pada Windows SDK, tetapi tidak memiliki versi Windows SDK yang ditentukan. Secara default, IDE mungkin mencoba membangun demo dengan versi SDK yang tidak ada di mesin Anda. Untuk mengatur versi Windows SDK, klik kanan `aws_demos` dan kemudian pilih **Retarget** Projects. Ini membuka jendela **Review Solution Actions**. **Pilih versi Windows SDK yang ada di mesin Anda (nilai awal di dropdown baik-baik saja), lalu pilih OK.** 1. Membangun dan menjalankan proyek. Dari menu **Build**, pilih **Build Solution**, dan pastikan solusi dibuat tanpa kesalahan atau peringatan. Pilih **Debug**, **Mulai Debugging** untuk menjalankan proyek. Pada proses pertama, Anda harus [memilih antarmuka jaringan](#win-network-interface). ### Membangun dan menjalankan proyek demo FreerTOS dengan CMake Kami menyarankan Anda menggunakan GUI CMake alih-alih alat baris perintah CMake untuk membangun proyek demo untuk Windows Simulator. Setelah Anda menginstal CMake, buka GUI CMake. Di Windows, Anda dapat menemukan ini dari menu Start di bawah **CMake, CMake** **(cmake-gui**). 1. Atur direktori kode sumber FreeRTOS. Di GUI, atur direktori kode sumber FreeRTOS `{{freertos}}` () **untuk Di mana** kode sumbernya. Tetapkan `{{freertos}}/build` **untuk Dimana membangun binari**. 1. Konfigurasikan Proyek CMake. Di GUI CMake, pilih **Add Entry**, dan pada jendela **Add Cache Entry**, atur nilai berikut: **Nama** AFR\_BOARD **Tipe** STRING **Nilai** pc.windows **Deskripsi** (Opsional) 1. Pilih **Konfigurasikan** Jika CMake meminta Anda untuk membuat direktori build, pilih **Ya**, lalu pilih generator di bawah **Tentukan generator untuk proyek ini**. Kami merekomendasikan menggunakan Visual Studio sebagai generator, tetapi Ninja juga didukung. (Perhatikan bahwa saat menggunakan Visual Studio 2019, platform harus disetel ke Win32 alih-alih pengaturan defaultnya.) Jaga agar opsi generator lainnya tidak berubah dan pilih **Selesai**. 1. Hasilkan dan Buka Proyek CMake. Setelah Anda mengonfigurasi proyek, GUI CMake menunjukkan semua opsi yang tersedia untuk proyek yang dihasilkan. Untuk keperluan tutorial ini, Anda dapat meninggalkan opsi pada nilai defaultnya. Pilih **Generate** untuk membuat solusi Visual Studio, lalu pilih **Open Project** untuk membuka proyek di Visual Studio. Di Visual Studio, klik kanan `aws_demos` proyek dan pilih **Set as StartUp Project**. Ini memungkinkan Anda untuk membangun dan menjalankan proyek. Pada proses pertama, Anda harus [memilih antarmuka jaringan](#win-network-interface). Untuk informasi selengkapnya tentang menggunakan CMake dengan FreerTos, lihat. [Menggunakan CMake dengan FreerTos](getting-started-cmake.md) ### Konfigurasikan antarmuka jaringan Anda Pada proses pertama proyek demo, Anda harus memilih antarmuka jaringan yang akan digunakan. Program ini menghitung antarmuka jaringan Anda. Temukan nomor untuk antarmuka Ethernet terprogram Anda. Outputnya akan terlihat seperti ini: ``` 0 0 [None] FreeRTOS_IPInit 1 0 [None] vTaskStartScheduler 1. rpcap://\Device\NPF_{AD01B877-A0C1-4F33-8256-EE1F4480B70D} (Network adapter 'Intel(R) Ethernet Connection (4) I219-LM' on local host) 2. rpcap://\Device\NPF_{337F7AF9-2520-4667-8EFF-2B575A98B580} (Network adapter 'Microsoft' on local host) The interface that will be opened is set by "configNETWORK_INTERFACE_TO_USE", which should be defined in FreeRTOSConfig.h ERROR: configNETWORK_INTERFACE_TO_USE is set to 0, which is an invalid value. Please set configNETWORK_INTERFACE_TO_USE to one of the interface numbers listed above, then re-compile and re-start the application. Only Ethernet (as opposed to Wi-Fi) interfaces are supported. ``` Setelah Anda mengidentifikasi nomor untuk antarmuka Ethernet terprogram Anda, tutup jendela aplikasi. Pada contoh sebelumnya, nomor yang akan digunakan adalah`1`. Buka `FreeRTOSConfig.h` dan atur `configNETWORK_INTERFACE_TO_USE` ke nomor yang sesuai dengan antarmuka jaringan terprogram Anda. **penting** Hanya antarmuka Ethernet yang didukung. Wi-Fi tidak didukung. ## Pemecahan masalah ### Memecahkan masalah umum pada Windows Anda mungkin mengalami kesalahan berikut saat mencoba membangun proyek demo dengan Visual Studio: ``` Error "The Windows SDK version X.Y was not found" when building the provided Visual Studio solution. ``` Proyek harus ditargetkan ke versi Windows SDK yang ada di komputer Anda. Untuk informasi pemecahan masalah umum tentang memulai dengan FreeRTOS, lihat. [Pemecahan masalah memulai](gsg-troubleshooting.md)