Menggunakan CMake dengan 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:

Lihat topik di bawah ini untuk informasi selengkapnya tentang cara menggunakan CMake dengan FreeRTOS.

Prasyarat

Pastikan mesin host Anda memenuhi prasyarat berikut sebelum melanjutkan:

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 cara menggunakan CMake untuk membangun aplikasi FreeRTOS, lihatMembangun FreeRTOS dengan CMake.

Untuk debugging, Anda dapat memberikan Kode VS 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 compiler yang ingin Anda gunakan. Di FreeRTOS, kami menyediakan file toolchain default difreertos/tools/cmake/toolchains. Cara untuk menyediakan file ini ke CMake tergantung pada apakah Anda menggunakan antarmuka baris perintah CMake atau GUI. Untuk lebih jelasnya, ikutiMenghasilkan file build (alat baris perintah CMake) petunjuk di bawah ini. Untuk informasi lebih lanjut tentang cross-compiling di CMake, lihat CrossCompilingdi wiki CMake resmi.

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:

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

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

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

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, sehingga Anda tidak perlu menggunakan nama lengkap vendor dan papan untukVENDOR danBOARD pilihan. Nama sebagian bekerja, asalkan ada satu pertandingan. 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 menggunakanCMAKE_TOOLCHAIN_FILE opsi jika Anda ingin menggunakan file toolchain yang tidak terletak di direktori defaultcmake/toolchains. Misalnya:

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

Jika file toolchain tidak menggunakan path absolut untuk compiler Anda, dan Anda tidak menambahkan compiler Anda ke variabelPATH lingkungan, CMake mungkin tidak dapat menemukannya. Untuk memastikan bahwa CMake menemukan file toolchain Anda, Anda dapat menggunakanAFR_TOOLCHAIN_PATH opsi tersebut. Opsi ini mencari jalur direktori toolchain yang ditentukan dan subfolder toolchain di bawahbin. Misalnya:

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

Untuk mengaktifkan debugging, aturCMAKE_BUILD_TYPE kedebug. Dengan opsi ini diaktifkan, CMake menambahkan tanda 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 mengaturCMAKE_BUILD_TYPE torelease untuk menambahkan bendera optimasi ke opsi kompilasi.

Menghasilkan file build (CMake GUI)

Anda dapat menggunakan CMake GUI untuk menghasilkan file build FreeRTOS.

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 as your native build system, 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. Misalnya:

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.