Pelajaran dan game belajarnya

C multi-file: header, makro dan build

Apa yang terjadi antara menekan Jalankan dan program di chip, serta setiap jebakan di perjalanan dari satu file menjadi lima puluh.

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

  1. Banyak file, satu program: praproses, kompilasi tiap file secara terpisah, link. Deklarasi lawan definisi, file kedua, dan undefined symbol yang muncul saat dua file tidak sepakat.
  2. Header dan guard: rover yang dipecah menjadi rover.h dan rover.cpp, apa yang sebenarnya ditempel #include, header yang dibaca dua kali dan guard yang mencegahnya, serta kenapa isi fungsi di header butuh inline.
  3. Makro dan jebakannya: kuadrat yang lupa kurungnya, nilai maksimum yang membaca sensor dua kali, # dan do { } while (0), dan kapan fungsi lebih tepat untuk pekerjaan itu.
  4. Kompilasi bersyarat: #if dan #ifdef, baris debug yang tak berbiaya saat dimatikan, gerbang versi, chip yang menjadi target build, dan nilai bawaan yang bisa ditimpa proyek.
  5. extern dan static: linkage dan masa hidup. Variabel global yang dijangkau file lain dengan extern, static di tingkat file yang membuat nama tetap privat, dan static lokal yang mengingat.
  6. 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, seperti ARDUINO_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.