Arduino struct, em três lâmpadas que piscam em ritmos próprios
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
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 aulaDefina, 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.
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".
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;.
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.
#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.
Continuar
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.