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
- Muchos archivos, un programa: preprocesar, compilar cada archivo por separado, enlazar. Declaraciones frente a definiciones, un segundo archivo, y el
undefined symbolque aparece cuando dos archivos no est谩n de acuerdo. - Headers y guardas: un rover dividido en
rover.hyrover.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 necesitainline. - Macros y sus trampas: un cuadrado que olvida sus par茅ntesis, un m谩ximo que lee un sensor dos veces,
#ydo { } while (0), y cu谩ndo una funci贸n hace el trabajo mejor. - Compilaci贸n condicional:
#ify#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. - extern y static: enlazado y duraci贸n. Una global que otro archivo alcanza con
extern,statica nivel de archivo que mantiene un nombre privado, y una local static que recuerda. - 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, comoARDUINO_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.