Cara kerjanya
Multi-file C: headers, macros and builds follows C dari nol. Enam pelajaran berjalan di meja kerja kode: Arduino Uno dengan lampu merah di pin 13, kuning di 12, hijau di 11 dan satu tombol di pin 2. Proyeknya pindah ke ESP32-C3.
Setiap pelajaran membuka sketch satu file yang siap jalan. Kamu menjalankannya, membaca Serial Monitor, lalu mengembangkannya: kamu menambahkan file kedua dan ketiga sendiri dari tab bar (fuel.cpp, rover.h, telemetry.cpp, config.h), dan pemeriksaannya membaca apa yang dicetak board setelah file-mu berhasil dibuild dan ter-link. Beberapa langkah memintamu merusak build dengan sengaja dulu, jadi kamu bertemu setiap error linker saat tahu persis apa penyebabnya.
Pelajarannya
- Banyak file, satu program: praproses, kompilasi tiap file secara terpisah, link. Deklarasi lawan definisi, file kedua, dan
undefined symbolyang muncul saat dua file tidak sepakat. - Header dan guard: rover yang dipecah menjadi
rover.hdanrover.cpp, apa yang sebenarnya ditempel#include, header yang dibaca dua kali dan guard yang mencegahnya, serta kenapa isi fungsi di header butuhinline. - Makro dan jebakannya: kuadrat yang lupa kurungnya, nilai maksimum yang membaca sensor dua kali,
#dando { } while (0), dan kapan fungsi lebih tepat untuk pekerjaan itu. - Kompilasi bersyarat:
#ifdan#ifdef, baris debug yang tak berbiaya saat dimatikan, gerbang versi, chip yang menjadi target build, dan nilai bawaan yang bisa ditimpa proyek. - extern dan static: linkage dan masa hidup. Variabel global yang dijangkau file lain dengan
extern,staticdi tingkat file yang membuat nama tetap privat, dan static lokal yang mengingat. - Flag build: sketch yang membaca build-nya sendiri (
-std,-mmcu,-Os,-fno-exceptions), header config menggantikan flag-D, dan linker yang membuang kode yang tak pernah dipanggil, terukur di log build.
Proyeknya: satu basis kode untuk dua board
Sebuah beacon yang di-build tanpa perubahan untuk Uno dan ESP32-C3. File yang sama mencetak int is 2 bytes di satu board dan int is 4 bytes di board lain, dan penjumlahan yang sama memberi 0 di Uno dan 65536 di C3. Kamu membuat penjumlahan itu portabel dengan uint16_t, memindahkan semua perbedaan board ke board.h ber-guard, lalu menjadikannya milikmu: board ketiga, feature flag, atau header debug.
Apa yang board-board lakukan secara berbeda
- Compiler Uno mendefinisikan
__AVR__dan compiler C3 mendefinisikan__riscv. Kursus ini menguji nama-nama itu, karena compiler mengaturnya di setiap build; nama milik build Arduino sendiri, sepertiARDUINO_AVR_UNO, datang di atasnya. - int itu 2 byte di Uno dan 4 di C3, pointer sama saja, dan double hanya 4 byte di Uno.
- Di Uno sebuah string disalin ke RAM saat menyala, jadi teks memakan RAM selain flash. Log build menunjukkan keduanya.
- Jalankan di Mokxi, seperti Arduino IDE, memakai satu set flag compiler tetap (
-Os, C++17, tanpa exception). Proyek menyetel opsinya sendiri di header config yang di-include paling awal, yang bekerja sama dengan alat build apa pun.
Setelah kursus ini
C++ modern untuk mikrokontroler menggantikan banyak makro ini dengan constexpr, enum class dan template, dan Pointer dan memori di C membahas dalam-dalam ke mana linker menaruh segalanya di RAM.