Menggunakan CMake dengan FreerTos

penting

Halaman ini mengacu pada repositori Amazon-Freertos yang tidak digunakan lagi. Kami menyarankan Anda mulai di sini ketika Anda membuat proyek baru. Jika Anda sudah memiliki proyek FreeRTOS yang sudah ada berdasarkan repositori Amazon-Freertos yang sekarang sudah tidak digunakan lagi, lihat. Panduan Migrasi Repositori Github Amazon-freertos

Anda dapat menggunakan CMake untuk menghasilkan file build proyek dari kode sumber aplikasi Freertos, dan untuk membangun dan menjalankan kode sumber.

Anda juga dapat menggunakan IDE untuk mengedit, men-debug, mengkompilasi, mem-flash, dan menjalankan kode pada perangkat yang memenuhi syarat Freertos. Setiap panduan Memulai khusus papan mencakup instruksi untuk menyiapkan IDE untuk platform tertentu. Jika Anda lebih suka bekerja tanpa IDE, Anda dapat menggunakan alat pengeditan dan debugging kode pihak ketiga lainnya untuk mengembangkan dan men-debug kode Anda, dan kemudian menggunakan CMake untuk membangun dan menjalankan aplikasi.

Papan berikut mendukung CMake:

• Espressif ESP32- C DevKit

• Espressif ESP-WROVER-KIT

• Kit Konektivitas IoT Infineon XMC4800

• Kit Pemula Marvell MW320 AWS IoT

• Kit Pemula Marvell MW322 AWS IoT

• Microchip Curiosity PIC32MZEF Bundel

• Kit Pengembangan Nordik NRF52840 DK

• STMicroelectronicsSTM32L4 Kit Penemuan IoT Node

• Texas Instrumen CC3220SF-LAUNCHXL

• Simulator Microsoft Windows

Lihat topik di bawah ini untuk informasi lebih lanjut tentang menggunakan CMake dengan FreerTos.

Prasyarat

Pastikan mesin host Anda memenuhi prasyarat berikut sebelum melanjutkan:

• Rantai alat kompilasi perangkat Anda harus mendukung sistem operasi mesin. CMake mendukung semua versi Windows, macOS, dan Linux

  Subsistem Windows untuk Linux (WSL) tidak didukung. Gunakan CMake asli di mesin Windows.

• Anda harus menginstal CMake versi 3.13 atau lebih tinggi.

  Anda dapat mengunduh distribusi biner CMake dari CMake.org.

  catatan

  Jika Anda mengunduh distribusi biner CMake, pastikan Anda menambahkan CMake yang dapat dieksekusi ke variabel lingkungan PATH sebelum Anda menggunakan CMake dari baris perintah.

  Anda juga dapat mengunduh dan menginstal CMake menggunakan pengelola paket, seperti homebrew di macOS, dan scoop atau chocolatey di Windows.

  catatan

  Versi paket CMake yang disediakan di manajer paket untuk banyak distribusi Linux. out-of-date Jika manajer paket distribusi Anda tidak menyediakan versi terbaru CMake, Anda dapat mencoba manajer paket alternatif, seperti linuxbrew ataunix.

• Anda harus memiliki sistem build asli yang kompatibel.

  CMake dapat menargetkan banyak sistem build asli, termasuk GNU Make atau Ninja. Baik Make dan Ninja dapat diinstal dengan manajer paket di Linux, macOS dan Windows. Jika Anda menggunakan Make di Windows, Anda dapat menginstal versi mandiri dari Equation, atau Anda dapat menginstal MinGW, yang dibuat bundel.

  catatan

  Make executable di MinGW disebutmingw32-make.exe, bukan. make.exe

  Kami menyarankan Anda menggunakan Ninja, karena lebih cepat daripada Make dan juga menyediakan dukungan asli untuk semua sistem operasi desktop.

Mengembangkan aplikasi FreeRTOS dengan editor kode pihak ketiga dan alat debugging

Anda dapat menggunakan editor kode dan ekstensi debugging atau alat debugging pihak ketiga untuk mengembangkan aplikasi untuk FreeRTOS.

Jika, misalnya, Anda menggunakan Visual Studio Code sebagai editor kode Anda, Anda dapat menginstal ekstensi Cortex-Debug VS Code sebagai debugger. Ketika Anda selesai mengembangkan aplikasi Anda, Anda dapat memanggil alat baris perintah CMake untuk membangun proyek Anda dari dalam VS Code. Untuk informasi selengkapnya tentang menggunakan CMake untuk membangun aplikasi Freertos, lihat. Membangun FreeRTOS dengan CMake

Untuk debugging, Anda dapat memberikan VS Code dengan konfigurasi debug yang mirip dengan berikut ini:

"configurations": [
    {
        "name": "Cortex Debug",
        "cwd": "${workspaceRoot}",
        "executable": "./build/st/stm32l475_discovery/aws_demos.elf",
        "request": "launch",
        "type": "cortex-debug",
        "servertype": "stutil"
    }
]

Membangun FreeRTOS dengan CMake

CMake menargetkan sistem operasi host Anda sebagai sistem target secara default. Untuk menggunakannya untuk kompilasi silang, CMake memerlukan file toolchain, yang menentukan kompiler yang ingin Anda gunakan. Di FreeRTOS, kami menyediakan file toolchain default di. freertos/tools/cmake/toolchains Cara menyediakan file ini ke CMake tergantung pada apakah Anda menggunakan antarmuka baris perintah CMake atau GUI. Untuk lebih jelasnya, ikuti Menghasilkan file build (alat baris perintah CMake) petunjuk di bawah ini. Untuk informasi selengkapnya tentang kompilasi silang di CMake, lihat CrossCompilingdi wiki resmi CMake.

Untuk membangun proyek berbasis CMAKE

1. Jalankan CMake untuk menghasilkan file build untuk sistem build asli, seperti Make atau Ninja.

   Anda dapat menggunakan alat baris perintah CMake atau GUI CMake untuk membuat file build untuk sistem build asli Anda.

   Untuk informasi tentang membuat file build FreeRTOS, lihat dan. Menghasilkan file build (alat baris perintah CMake) Menghasilkan file build (CMake GUI)

2. Panggil sistem build asli untuk membuat proyek menjadi executable.

   Untuk informasi tentang membuat file build FreeRTOS, lihat. Membangun FreeRTOS dari file build yang dihasilkan

Menghasilkan file build (alat baris perintah CMake)

Anda dapat menggunakan alat baris perintah CMake (cmake) untuk menghasilkan file build untuk FreeRTOS. Untuk menghasilkan file build, Anda perlu menentukan papan target, kompiler, dan lokasi kode sumber dan direktori build.

Anda dapat menggunakan opsi berikut untuk cmake:

• -DVENDOR- Menentukan papan target.

• -DCOMPILER- Menentukan compiler.

• -S— Menentukan lokasi kode sumber.

• -B— Menentukan lokasi file build yang dihasilkan.

catatan

Kompiler harus dalam PATH variabel sistem, atau Anda harus menentukan lokasi kompiler.

Misalnya, jika vendornya adalah Texas Instruments, dan papannya adalah CC3220 Launchpad, dan kompilernya adalah GCC untuk ARM, Anda dapat mengeluarkan perintah berikut untuk membangun file sumber dari direktori saat ini ke direktori bernama: build-directory

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory

catatan

Jika Anda menggunakan Windows, Anda harus menentukan sistem build asli karena CMake menggunakan Visual Studio secara default. Sebagai contoh:

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory -G Ninja

Atau:

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory -G "MinGW Makefiles"

Ekspresi reguler ${VENDOR}.* dan ${BOARD}.* digunakan untuk mencari papan yang cocok, jadi Anda tidak perlu menggunakan nama lengkap vendor dan papan untuk BOARD opsi VENDOR dan opsi. Nama sebagian berfungsi, asalkan ada satu kecocokan. Misalnya, perintah berikut menghasilkan file build yang sama dari sumber yang sama:

cmake -DVENDOR=ti -DCOMPILER=arm-ti -S . -B build-directory

cmake -DBOARD=cc3220 -DCOMPILER=arm-ti -S . -B build-directory

cmake -DVENDOR=t -DBOARD=cc -DCOMPILER=arm-ti -S . -B build-directory

Anda dapat menggunakan CMAKE_TOOLCHAIN_FILE opsi jika Anda ingin menggunakan file toolchain yang tidak terletak di direktori cmake/toolchains default. Sebagai contoh:

cmake -DBOARD=cc3220 -DCMAKE_TOOLCHAIN_FILE='/path/to/toolchain_file.cmake' -S . -B build-directory

Jika file toolchain tidak menggunakan jalur absolut untuk kompiler Anda, dan Anda tidak menambahkan kompiler Anda ke variabel PATH lingkungan, CMake mungkin tidak dapat menemukannya. Untuk memastikan bahwa CMake menemukan file toolchain Anda, Anda dapat menggunakan opsi iniAFR_TOOLCHAIN_PATH. Opsi ini mencari jalur direktori toolchain yang ditentukan dan subfolder toolchain di bawahnya. bin Sebagai contoh:

cmake -DBOARD=cc3220 -DCMAKE_TOOLCHAIN_FILE='/path/to/toolchain_file.cmake' -DAFR_TOOLCHAIN_PATH='/path/to/toolchain/' -S . -B build-directory

Untuk mengaktifkan debugging, atur CMAKE_BUILD_TYPE kedebug. Dengan opsi ini diaktifkan, CMake menambahkan flag debug ke opsi kompilasi, dan membangun FreerTOS dengan simbol debug.

# Build with debug symbols
cmake -DBOARD=cc3220 -DCOMPILER=arm-ti -DCMAKE_BUILD_TYPE=debug -S . -B build-directory

Anda juga dapat mengatur CMAKE_BUILD_TYPE to release untuk menambahkan flag optimasi ke opsi kompilasi.

Menghasilkan file build (CMake GUI)

Anda dapat menggunakan GUI CMake untuk menghasilkan file build FreerTos.

Untuk menghasilkan file build dengan GUI CMake

1. Dari baris perintah, masalah cmake-gui untuk memulai GUI.

2. Pilih Browse Source dan tentukan input sumber, lalu pilih Browse Build dan tentukan output build.

   

3. Pilih Konfigurasi, dan di bawah Tentukan generator build untuk proyek ini, temukan dan pilih sistem build yang ingin Anda gunakan untuk membangun file build yang dihasilkan. jika Anda tidak melihat jendela pop up, Anda mungkin menggunakan kembali direktori build yang ada. Dalam hal ini, hapus cache CMake dengan memilih Hapus Cache dari menu File.

   

4. Pilih Tentukan file toolchain untuk kompilasi silang, lalu pilih Berikutnya.

5. Pilih file toolchain (misalnya,freertos/tools/cmake/toolchains/arm-ti.cmake), dan kemudian pilih Selesai.

   Konfigurasi default untuk FreeRTOS adalah papan templat, yang tidak menyediakan target lapisan portabel apa pun. Akibatnya, sebuah jendela muncul dengan pesan .

   catatan

   Jika Anda melihat kesalahan berikut:

   CMake Error at tools/cmake/toolchains/find_compiler.cmake:23 (message):
   Compiler not found, you can specify search path with AFR_TOOLCHAIN_PATH.

   Ini berarti kompiler tidak ada dalam variabel PATH lingkungan Anda. Anda dapat mengatur AFR_TOOLCHAIN_PATH variabel di GUI untuk memberi tahu CMake di mana Anda menginstal kompiler Anda. Jika Anda tidak melihat AFR_TOOLCHAIN_PATH variabel, pilih Tambah Entri. Di jendela pop up, di bawah Nama, ketikAFR_TOOLCHAIN_PATH. Di bawah Compiler Path ketik jalur ke kompiler Anda. misalnya,. C:/toolchains/arm-none-eabi-gcc

6. GUI sekarang akan terlihat seperti ini:

   

   Pilih AFR_BOARD, pilih papan Anda, lalu pilih Konfigurasi lagi.

7. Pilih Hasilkan. CMake menghasilkan file sistem build (misalnya, file makefiles atau ninja), dan file-file ini muncul di direktori build yang Anda tentukan pada langkah pertama. Ikuti petunjuk di bagian selanjutnya untuk menghasilkan gambar biner.

Membangun FreeRTOS dari file build yang dihasilkan

Membangun dengan sistem build asli

Anda dapat membangun FreeRTOS dengan sistem build asli dengan memanggil perintah sistem build dari direktori binari keluaran.

Misalnya, jika direktori keluaran file build Anda<build_dir>, dan Anda menggunakan Make sebagai sistem build asli, jalankan perintah berikut:

cd <build_dir>
make -j4

Membangun dengan CMake

Anda juga dapat menggunakan alat baris perintah CMake untuk membangun FreerTos. CMake menyediakan lapisan abstraksi untuk memanggil sistem build asli. Sebagai contoh:

cmake --build build_dir

Berikut adalah beberapa kegunaan umum lainnya dari mode build alat baris perintah CMake:

# Take advantage of CPU cores.
cmake --build build_dir --parallel 8

# Build specific targets.
cmake --build build_dir --target afr_kernel

# Clean first, then build.
cmake --build build_dir --clean-first

Untuk informasi selengkapnya tentang mode build CMake, lihat dokumentasi CMake.