Aprender

Arduino struct, em três lâmpadas que piscam em ritmos próprios

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: três lâmpadas, cada uma um structao vivo0.000 s 0.00x
Segure o botão
Cada lâmpada guarda seu pino, seu ritmo, quando mudou pela última vez e se está acesa, em um único Lamp.

Um struct dá um nome só a vários valores que pertencem juntos. struct Lamp { int pin; unsigned long everyMs; bool on; }; cria um novo tipo chamado Lamp, e cada Lamp que você cria carrega seu próprio pino, ritmo e estado. Leia ou altere um membro com um ponto, como em red.pin ou red.on = true, e guarde uma lista inteira deles em um array de structs.

O circuito acima é de três lâmpadas em um Uno, cada uma piscando no seu ritmo. Aperte Rodar. O monitor serial imprime "lamp on pin 13 every 250 ms", depois o mesmo para os pinos 12 e 11 a 400 e 650 ms, e "sizeof(Lamp) = 11". O sketch guarda o pino, o ritmo, a última mudança e o estado de cada lâmpada em um struct, e loop() percorre o array.

Abaixo está como definir e preencher um struct, retornar dois valores de uma função, passar um por referência, qual o tamanho de um, salvar um na EEPROM e os erros que as pessoas encontram primeiro, cada um rodando em um Uno com o que imprimiu.

Quer a versão passo a passo? A aula "Coisas que pertencem juntas" percorre isso com checkpoints.

Abrir a aula

Defina, depois crie alguns

Aqui está o struct do sketch que roda acima, e o array que cria três deles. Os valores em cada par de chaves preenchem os membros na ordem em que estão escritos: o pino, o ritmo, a última vez que mudou e se está aceso. Assim, lamps[1].everyMs é 400 e lamps[2].pin é 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.

Uma definição de struct termina com ponto e vírgula depois da chave de fechamento. Esqueça e a compilação para: o clang diz expected ';' after struct, e o GCC diz expected ';' after struct definition.

firmware/uno/examples/cppstruct (as lâmpadas rodando acima)
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},
};

Retornar dois valores de uma função

Uma função retorna um valor, mas esse valor pode ser um struct, que é a resposta usual para "como retorno dois valores de uma função". O sketch abaixo acha o menor e o maior de cinco leituras em uma passada só e devolve os dois em um Range. Imprimiu "low 471, high 530".

Menor e maior, em um único 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 no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Passe por referência para alterá-lo

Um struct entregue a uma função é copiado, como um int. O toggleCopy() abaixo inverte sua própria cópia e a lâmpada de quem chamou continua apagada, então a primeira linha imprimiu 0. Coloque & depois do tipo e a função recebe a própria lâmpada de quem chamou: toggle() imprimiu 1.

Uma referência também evita copiar um struct grande, o que importa com 2 KB de RAM. Quando a função só lê o struct, diga isso com const: void show(const Lamp &lamp). Com um ponteiro para um struct, use uma seta em vez do ponto: Lamp *p = &lamps[1]; p->on = false;.

Uma cópia, depois a lâmpada em si
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 no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Qual o tamanho de um 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.

Salvar um struct na EEPROM

EEPROM.put() escreve um struct inteiro, byte por byte, e EEPROM.get() lê de volta para uma variável do mesmo tipo. O sketch abaixo salvou duas configurações e leu de volta como "brightness 180, mode 2". O struct tem 3 bytes, então a próxima coisa salva pode começar no endereço 3. Em uma placa de verdade esses bytes sobrevivem a uma queda de energia, o que faz do struct a forma organizada de guardar configurações.

Duas configurações em um único 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 no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Os erros que as pessoas encontram primeiro

Valores demais: um Lamp que recebeu cinco valores tendo quatro membros parou a compilação com excess elements in struct initializer. O GCC diz too many initializers for 'Lamp'.

Usado antes de existir: um struct precisa ser definido acima da primeira linha que o usa. Com struct Reading escrito abaixo de setup(), a linha em setup() que criava um parou com unknown type name 'Reading', e o GCC diz 'Reading' was not declared in this scope. Mova a definição para o topo do sketch, abaixo das linhas #include.

Comparar dois: if (a == b) com dois Lamp parou com invalid operands to binary expression ('Lamp' and 'Lamp'); o GCC diz no match for 'operator=='. O C++ não compara structs por você. Compare os membros que interessam, a.pin == b.pin && a.on == b.on, ou coloque essa linha em uma função.

Abra este circuito no editor. Arduino Uno: três lâmpadas, cada uma um struct, ligadas como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Perguntas

O que é um struct no Arduino?

Um tipo que você mesmo cria e que agrupa vários valores sob um nome, como um pino, uma taxa e um estado para uma lâmpada. É C++ puro, então funciona em toda placa que o Arduino suporta, e cada variável desse tipo tem sua própria cópia de cada membro.

Como faço um array de structs?

Defina o struct e depois declare um array dele com um par de chaves por elemento: Lamp lamps[] = {{13, 250, 0, false}, {12, 400, 0, false}}; Leia um membro com lamps[i].pin dentro de um for.

Como retorno dois valores de uma função no Arduino?

Retorne um struct que guarde os dois, como rangeOf() faz com um mínimo e um máximo aqui. Ou passe as variáveis por referência, com um & depois de cada tipo, e deixe a função alterá-las.

Qual a diferença entre um struct e uma classe?

Só quem pode ver os membros por padrão. Os membros de um struct são públicos, a menos que você diga o contrário, e os de uma classe são privados. Ambos podem guardar funções além de valores; código Arduino tende a usar struct para grupos simples de valores.

Por que meu sketch diz que o struct não foi declarado?

O struct está definido abaixo da linha que o usa pela primeira vez. Mova a definição para o topo do sketch, acima de setup() e de qualquer função que receba ou retorne um.

Fontes

De onde vêm as informações desta página

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.