Aprender

Struct en Arduino, en tres lámparas que parpadean cada una a su propio ritmo

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: tres lámparas, cada una un structen vivo0.000 s 0.00x
Mantén presionado el botón
Cada lámpara guarda su pin, su ritmo, cuándo cambió por última vez y si está encendida, en un solo Lamp.

Un struct le da un nombre a varios valores que van juntos. struct Lamp { int pin; unsigned long everyMs; bool on; }; crea un nuevo tipo llamado Lamp, y cada Lamp que hagas lleva su propio pin, ritmo y estado. Lee o asigna un miembro con un punto, como en red.pin o red.on = true, y guarda una lista completa de ellos en un solo arreglo de structs.

El circuito de arriba es de tres lámparas en un Uno, cada una parpadeando a su propio ritmo. Presiona Ejecutar. El monitor serie imprime "lamp on pin 13 every 250 ms", luego lo mismo para los pines 12 y 11 a 400 y 650 ms, y "sizeof(Lamp) = 11". El sketch guarda el pin, el ritmo, el último cambio y el estado de cada lámpara en un struct, y loop() recorre el arreglo.

Abajo verás cómo definir y llenar un struct, devolver dos valores desde una función, pasar uno por referencia, qué tamaño tiene, cómo guardarlo en EEPROM y los errores que la gente encuentra primero, cada uno ejecutado en un Uno con lo que imprimió.

¿Quieres la versión paso a paso? La lección "Cosas que van juntas" te guía por esto con puntos de control.

Abrir la lección

Defínelo y luego crea algunos

Aquí está el struct del sketch que corre arriba, y el arreglo que crea tres de ellos. Los valores entre cada par de llaves llenan los miembros en el orden en que están escritos: el pin, el ritmo, la última vez que cambió y si está encendida. Así, lamps[1].everyMs es 400 y lamps[2].pin es 11.

Adding a fourth lamp is one more line in the list. loop() counts the array with sizeof(lamps) / sizeof(lamps[0]), so it picks the new lamp up without another change. Four loose arrays of pins, rates, last-change times and states would need an edit in four places.

Una definición de struct termina con punto y coma después de su llave de cierre. Si lo omites, la compilación se detiene: clang dice expected ';' after struct, y GCC dice expected ';' after struct definition.

firmware/uno/examples/cppstruct (las lámparas que corren arriba)
struct Lamp {
  int pin;
  unsigned long everyMs;
  unsigned long last;
  bool on;
};

Lamp lamps[] = {
  {LAMP_A, 250, 0, false},
  {LAMP_B, 400, 0, false},
  {LAMP_C, 650, 0, false},
};

Devuelve dos valores desde una función

Una función devuelve un valor, pero ese valor puede ser un struct, que es la respuesta habitual a "cómo devuelvo dos valores desde una función". El sketch de abajo encuentra el más bajo y el más alto de cinco lecturas en una sola pasada y entrega ambos en un Range. Imprimió "low 471, high 530".

El más bajo y el más alto, en un solo Range
struct Range {
  int low;
  int high;
};

Range rangeOf(const int list[], int count) {
  Range r = {list[0], list[0]};
  for (int i = 1; i < count; i++) {
    if (list[i] < r.low) r.low = list[i];
    if (list[i] > r.high) r.high = list[i];
  }
  return r;
}

void setup() {
  Serial.begin(9600);
  int readings[] = {512, 498, 530, 471, 505};
  Range r = rangeOf(readings, 5);
  Serial.print("low ");
  Serial.print(r.low);
  Serial.print(", high ");
  Serial.println(r.high);
}

void loop() {
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Pásalo por referencia para cambiarlo

Un struct que se pasa a una función se copia, igual que un int. toggleCopy() abajo voltea su propia copia y la lámpara del que llama queda apagada, así que la primera línea imprimió 0. Pon & después del tipo y la función recibe la lámpara misma del que llama: toggle() imprimió 1.

Una referencia también evita copiar un struct grande, lo cual importa con 2 KB de RAM. Cuando la función solo lee el struct, dilo con const: void show(const Lamp &lamp). Con un puntero a un struct, usa una flecha en lugar del punto: Lamp *p = &lamps[1]; p->on = false;.

Una copia, y luego la lámpara misma
struct Lamp {
  int pin;
  bool on;
};

void toggleCopy(Lamp lamp) {
  lamp.on = !lamp.on;
}

void toggle(Lamp &lamp) {
  lamp.on = !lamp.on;
}

void setup() {
  Serial.begin(9600);
  Lamp red = {13, false};
  toggleCopy(red);
  Serial.println(red.on);
  toggle(red);
  Serial.println(red.on);
}

void loop() {
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

¿Qué tamaño tiene un struct?

sizeof(Lamp) printed 11 on the Uno: 2 bytes for the int, 4 each for the two unsigned longs and 1 for the bool. The Uno’s chip packs members one after another with no gaps. The same struct printed 16 on an ESP32-C3, where an int is 4 bytes and members are lined up on 4-byte boundaries. Count the bytes before sending a struct from one board to another.

Guarda un struct en EEPROM

EEPROM.put() escribe un struct completo, byte por byte, y EEPROM.get() lo lee de vuelta en una variable del mismo tipo. El sketch de abajo guardó dos ajustes y los leyó como "brightness 180, mode 2". El struct ocupa 3 bytes, así que lo siguiente que se guarde puede empezar en la dirección 3. En una placa real esos bytes sobreviven a un corte de energía, lo que hace del struct la forma ordenada de conservar ajustes.

Dos ajustes en un solo put()
#include <EEPROM.h>

struct Settings {
  int brightness;
  byte mode;
};

void setup() {
  Serial.begin(9600);
  Settings saved = {180, 2};
  EEPROM.put(0, saved);

  Settings back;
  EEPROM.get(0, back);
  Serial.print("brightness ");
  Serial.print(back.brightness);
  Serial.print(", mode ");
  Serial.println(back.mode);
  Serial.println(sizeof(Settings));
}

void loop() {
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Los errores que la gente encuentra primero

Demasiados valores: un Lamp al que se le dieron cinco valores cuando tiene cuatro miembros detuvo la compilación con excess elements in struct initializer. GCC dice too many initializers for 'Lamp'.

Se usa antes de que exista: un struct tiene que estar definido antes de la primera línea que lo usa. Con struct Reading escrito debajo de setup(), la línea de setup() que creaba uno se detuvo con unknown type name 'Reading', y GCC dice 'Reading' was not declared in this scope. Mueve la definición al inicio del sketch, debajo de las líneas #include.

Comparar dos: if (a == b) con dos Lamp se detuvo con invalid operands to binary expression ('Lamp' and 'Lamp'); GCC dice no match for 'operator=='. C++ no compara structs por ti. Compara los miembros que te interesen, a.pin == b.pin && a.on == b.on, o pon esa línea en una función.

Abre este circuito en el editor. Arduino Uno: tres lámparas, cada una un struct, conectadas tal como se ejecutan arriba en esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Preguntas

¿Qué es un struct en Arduino?

Un tipo que tú mismo creas y que agrupa varios valores bajo un solo nombre, como un pin, una velocidad y un estado para una lámpara. Es C++ puro, así que funciona en todas las placas que admite Arduino, y cada variable de ese tipo tiene su propia copia de cada miembro.

¿Cómo hago un arreglo de structs?

Define el struct y luego declara un arreglo de ese tipo con un par de llaves por elemento: Lamp lamps[] = {{13, 250, 0, false}, {12, 400, 0, false}}; Lee un miembro con lamps[i].pin dentro de un ciclo for.

¿Cómo regreso dos valores de una función de Arduino?

Regresa un struct que contenga ambos, como lo hace rangeOf() con un mínimo y un máximo aquí. O pasa las variables por referencia, con un & después de cada tipo, y deja que la función les asigne valores.

¿Cuál es la diferencia entre un struct y una clase?

Solo quién puede ver los miembros por defecto. Los miembros de un struct son públicos salvo que digas lo contrario, y los de una clase son privados. Ambos pueden contener funciones además de valores; el código de Arduino suele usar struct para grupos simples de valores.

¿Por qué mi sketch dice que el struct no fue declarado?

El struct está definido debajo de la línea que lo usa por primera vez. Mueve la definición al inicio del sketch, encima de setup() y de cualquier función que reciba o regrese uno.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.