Bài học và trò chơi học tập

C nhiều file: header, macro và bản build

Điều gì xảy ra giữa lúc bấm Chạy và một chương trình chạy trên chip, cùng mọi bẫy trên hành trình từ một file lên đến năm mươi file.

Cách hoạt động

Multi-file C: headers, macros and builds follows C từ con số không. Sáu bài học chạy trên bàn code: một Arduino Uno với đèn đỏ ở chân 13, vàng ở chân 12, xanh lá ở chân 11 và một nút nhấn ở chân 2. Dự án chuyển sang ESP32-C3.

Mỗi bài mở một sketch một file chạy được. Bạn chạy nó, đọc Serial Monitor, rồi mở rộng dần: chính bạn thêm file thứ hai và thứ ba từ thanh tab (fuel.cpp, rover.h, telemetry.cpp, config.h), và các bước kiểm tra đọc những gì bo mạch in ra khi các file của bạn build và link thành công. Vài bước yêu cầu bạn cố tình làm hỏng bản build trước, để bạn gặp từng lỗi linker khi biết rõ nguyên nhân.

Các bài học

  1. Nhiều file, một chương trình: tiền xử lý, biên dịch từng file riêng, rồi link. Khai báo đối chiếu với định nghĩa, một file thứ hai, và lỗi undefined symbol bạn nhận được khi hai file không thống nhất.
  2. Header và guard: một rover tách thành rover.h và rover.cpp, #include thực ra dán gì vào, một header bị đọc hai lần và guard chặn chuyện đó, và vì sao thân hàm trong header cần inline.
  3. Macro và các bẫy của chúng: một hàm bình phương quên ngoặc, một hàm max đọc cảm biến hai lần, # và do { } while (0), và khi nào một hàm làm việc đó tốt hơn.
  4. Biên dịch có điều kiện: #if và #ifdef, các dòng debug không tốn gì khi tắt, một cổng kiểm tra phiên bản, chip mà bản build dành cho, và một mặc định mà dự án có thể ghi đè.
  5. extern và static: liên kết và thời gian sống. Một biến toàn cục mà file khác với tới bằng extern, static ở cấp file giữ tên ở riêng tư, và một biến static cục bộ nhớ được.
  6. Cờ build: một sketch đọc chính bản build của nó (-std, -mmcu, -Os, -fno-exceptions), một header cấu hình thay cho các cờ -D, và linker vứt code không ai gọi, đo được trong log biên dịch.

Dự án: một mã nguồn cho hai bo mạch

Một đèn hiệu beacon build không đổi cho cả Uno và ESP32-C3. Cùng một file in int is 2 bytes trên bo này và int is 4 bytes trên bo kia, và cùng một phép cộng ra 0 trên Uno và 65536 trên C3. Bạn làm phép cộng di động được với uint16_t, chuyển mọi khác biệt của bo mạch vào một board.h có guard, rồi biến nó thành của bạn: một bo mạch thứ ba, một cờ tính năng, hay một header debug.

Những gì các bo mạch làm khác nhau

  • Trình biên dịch của Uno định nghĩa __AVR__ và của C3 định nghĩa __riscv. Khóa học kiểm tra những tên đó, vì trình biên dịch đặt chúng trong mọi bản build; các tên riêng của bản build Arduino, như ARDUINO_AVR_UNO, nằm trên nữa.
  • int là 2 byte trên Uno và 4 trên C3, con trỏ cũng vậy, còn double chỉ 4 byte trên Uno.
  • Trên Uno, một chuỗi được chép vào RAM lúc khởi động, nên văn bản tốn cả RAM lẫn flash. Log biên dịch cho thấy cả hai.
  • Chạy của Mokxi, giống Arduino IDE, dùng một bộ cờ trình biên dịch cố định (-Os, C++17, không ngoại lệ). Dự án tự đặt tùy chọn của mình trong một header cấu hình được include đầu tiên, cách này hoạt động như nhau với mọi công cụ build.

Sau khóa học này

C++ hiện đại cho vi điều khiển thay nhiều macro này bằng constexpr, enum class và template, còn Con trỏ và bộ nhớ trong C đi sâu vào việc linker đặt cái gì ở đâu trong RAM.