Lecciones y el juego de aprendizaje

C de varios archivos: headers, macros y compilaci贸n

Qu茅 pasa entre presionar Ejecutar y tener un programa en el chip, y cada trampa en el camino de un archivo a cincuenta.

C贸mo funciona

Multi-file C: headers, macros and builds follows C desde cero. Seis lecciones corren en el banco de c贸digo: un Arduino Uno con una l谩mpara roja en el pin 13, amarilla en el 12, verde en el 11 y un bot贸n en el pin 2. El proyecto pasa a un ESP32-C3.

Cada lecci贸n abre un sketch de un solo archivo que funciona. Lo ejecutas, lees el monitor serie y luego lo haces crecer: t煤 mismo agregas el segundo y el tercer archivo desde la barra de pesta帽as (fuel.cpp, rover.h, telemetry.cpp, config.h), y las verificaciones leen lo que la placa imprime una vez que tus archivos compilan y se enlazan. Varios pasos te piden romper la compilaci贸n a prop贸sito primero, para que conozcas cada error del enlazador sabiendo exactamente qu茅 lo caus贸.

Las lecciones

  1. Muchos archivos, un programa: preprocesar, compilar cada archivo por separado, enlazar. Declaraciones frente a definiciones, un segundo archivo, y el undefined symbol que aparece cuando dos archivos no est谩n de acuerdo.
  2. Headers y guardas: un rover dividido en rover.h y rover.cpp, qu茅 pega realmente un #include, un header le铆do dos veces y la guarda que lo evita, y por qu茅 el cuerpo de una funci贸n en un header necesita inline.
  3. Macros y sus trampas: un cuadrado que olvida sus par茅ntesis, un m谩ximo que lee un sensor dos veces, # y do { } while (0), y cu谩ndo una funci贸n hace el trabajo mejor.
  4. Compilaci贸n condicional: #if y #ifdef, l铆neas de depuraci贸n que no cuestan nada cuando est谩n apagadas, una compuerta de versi贸n, el chip para el que se compila, y un valor por omisi贸n que un proyecto puede cambiar.
  5. extern y static: enlazado y duraci贸n. Una global que otro archivo alcanza con extern, static a nivel de archivo que mantiene un nombre privado, y una local static que recuerda.
  6. Banderas de compilaci贸n: un sketch que lee su propia compilaci贸n (-std, -mmcu, -Os, -fno-exceptions), un header de configuraci贸n en lugar de banderas -D, y el enlazador descartando c贸digo que nada llama, medido en el registro de compilaci贸n.

El proyecto: un mismo c贸digo para dos placas

Una baliza que compila sin cambios para el Uno y el ESP32-C3. El mismo archivo imprime int is 2 bytes en uno y int is 4 bytes en el otro, y la misma suma da 0 en el Uno y 65536 en el C3. Haces la suma portable con uint16_t, mueves cada diferencia de placa a un board.h protegido por guardas, y luego lo haces tuyo: una tercera placa, una bandera de funci贸n, o un header de depuraci贸n.

Lo que las placas hacen distinto

  • El compilador del Uno define __AVR__ y el del C3 define __riscv. El curso prueba esas, porque el compilador las define en cada compilaci贸n; los nombres propios de la compilaci贸n de Arduino, como ARDUINO_AVR_UNO, vienen encima.
  • Un int es de 2 bytes en el Uno y de 4 en el C3, un puntero igual, y un double solo es de 4 bytes en el Uno.
  • En el Uno una cadena se copia a la RAM al arrancar, as铆 que el texto cuesta RAM adem谩s de flash. El registro de compilaci贸n muestra ambas.
  • El Ejecutar de Mokxi, como el IDE de Arduino, usa un conjunto fijo de banderas del compilador (-Os, C++17, sin excepciones). Los proyectos definen sus propias opciones en un header de configuraci贸n incluido primero, que funciona igual con cualquier herramienta de compilaci贸n.

Despu茅s de este curso

C++ moderno para microcontroladores reemplaza muchas de estas macros con constexpr, enum class y plantillas, y Punteros y memoria en C profundiza en lo que el enlazador coloca en cada parte de la RAM.