Memulai dengan Simulator Perangkat Windows

Tutorial ini memberikan petunjuk untuk memulai dengan FreeRTOS Windows Device Simulator.

Sebelum memulai, Anda harus mengonfigurasiAWS IoT dan mengunduh FreeRTOS Anda untuk menghubungkan perangkat Anda keAWS Cloud. Lihat Langkah pertama untuk instruksi. Dalam tutorial ini, path ke direktori download FreeRTOS disebut sebagaifreertos.

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 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. Pilih "Mode yangWinPcap kompatibel dengan API” selama instalasi.

2. Instal Microsoft Visual Studio.

   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 Windows 10 SDK terbaru. Anda dapat memilih ini di bawah bagian Opsional pengembangan Desktop dengan komponen C ++.

3. Pastikan Anda memiliki koneksi Ethernet aktif.

4. (Opsional) Jika Anda ingin menggunakan sistem build berbasis CMake untuk membangun proyek FreeRTOS, instal versi terbaru CMake. FreeRTOS memerlukan CMake versi 3.13 atau yang lebih baru.

Memantau pesan MQTT di cloud

Sebelum Anda menjalankan proyek demo FreeRTOS, Anda dapat mengatur klien MQTT diAWS IoT konsol untuk memantau pesan yang dikirim perangkat Anda keAWS Cloud.

Untuk berlangganan topik MQTT dengan klienAWS IoT MQTT

1. Masuk ke konsol AWS IoT tersebut.

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

3. Di Topik berlanggananyour-thing-name/example/topic, masukkan, lalu pilih Berlangganan topik.

Ketika proyek demo berhasil berjalan pada 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 membuat project FreeRTOS.

Membangun dan menjalankan proyek demo FreeRTOS dengan Visual Studio IDE

1. Memuat proyek ke Visual Studio.

   Di Visual Studio, dari menu File, pilih Buka. Pilih File/Solution, navigasikan keprojects/pc/windows/visual_studio/aws_demos/aws_demos.sln file, lalu pilih Buka.

2. Menargetkan ulang proyek demo.

   Proyek demo yang disediakan bergantung pada Windows SDK, tetapi tidak memiliki versi Windows SDK yang ditentukan. Secara default, IDE mungkin mencoba membuat demo dengan versi SDK yang tidak ada di komputer Anda. Untuk mengatur versi Windows SDK, klik kananaws_demos dan kemudian pilih Retarget Proyek. Ini akan membuka jendela Review Solution Actions. Pilih versi Windows SDK yang ada di komputer Anda (nilai awal dalam dropdown baik-baik saja), dan kemudian pilih OK.

3. Bangun dan jalankan proyek.

   Dari menu Build, pilih Build Solution, dan pastikan solusi dibuat tanpa kesalahan atau peringatan. Pilih Debug, Mulai Debugging untuk menjalankan proyek. Pada saat pertama, Anda harus memilih antarmuka jaringan.

Membangun dan menjalankan proyek demo FreeRTOS dengan CMake

Kami menyarankan Anda menggunakan CMake GUI bukan alat baris perintah CMake untuk membangun proyek demo untuk Windows Simulator.

Setelah Anda menginstal CMake, buka CMake GUI. 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 Dimana kode sumbernya.

   Ditetapkanfreertos/build untuk Dimana untuk membangun biner.

2. Konfigurasikan Proyek CMake.

   Di CMake GUI, pilih Add Entry, dan pada jendela Add Cache Entry, atur nilai berikut:

   Nama

   AFR_BOARD

   Tipe

   STRING

   Nilai

   pc.jendela

   Deskripsi

   (Opsional)

3. Pilih Configure (Konfigurasikan). Jika CMake meminta Anda untuk membuat direktori build, pilih Ya, lalu pilih generator di bawah Tentukan generator untuk proyek ini. Sebaiknya gunakan Visual Studio sebagai generator, tetapi Ninja juga didukung. (Perhatikan bahwa saat menggunakan Visual Studio 2019, platform harus diatur ke Win32 alih-alih pengaturan defaultnya.) Jaga agar opsi generator lainnya tidak berubah dan pilih Selesai.

4. Hasilkan dan Buka Proyek CMake.

   Setelah Anda mengkonfigurasi proyek, CMake GUI menampilkan semua opsi yang tersedia untuk proyek yang dihasilkan. Untuk tujuan tutorial ini, Anda dapat meninggalkan opsi pada nilai default mereka.

   Pilih Generate untuk membuat solusi Visual Studio, dan kemudian pilih Open Project untuk membuka proyek di Visual Studio.

   Di Visual Studio, klik kananaws_demos proyek dan pilih Set as StartUp Project. Hal ini memungkinkan Anda untuk membangun dan menjalankan proyek. Pada saat pertama, Anda harus memilih antarmuka jaringan.

Untuk informasi selengkapnya tentang menggunakan CMake dengan FreeRTOS, lihatMenggunakan CMake dengan FreerTos.

Konfigurasikan antarmuka jaringan Anda

Pada proyek demo pertama, Anda harus memilih antarmuka jaringan yang akan digunakan. Program ini menghitung antarmuka jaringan Anda. Temukan nomor untuk antarmuka Ethernet terprogram Anda. Output-nya 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 adalah1.

BukaFreeRTOSConfig.h dan aturconfigNETWORK_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 galat 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, lihatMemulai masalah saat memulai.