Arduino struct, pada tiga lampu yang berkedip dengan laju masing-masing
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
struct memberi satu nama untuk beberapa nilai yang saling terkait. struct Lamp { int pin; unsigned long everyMs; bool on; }; membuat tipe baru bernama Lamp, dan setiap Lamp yang kamu buat membawa pin, laju, dan statusnya sendiri. Baca atau atur satu member dengan titik, seperti red.pin atau red.on = true, dan simpan daftar lengkapnya dalam satu array of structs.
Rangkaian di atas adalah tiga lampu pada Uno, masing-masing berkedip dengan lajunya sendiri. Tekan Jalankan. Serial Monitor mencetak "lamp on pin 13 every 250 ms", lalu hal yang sama untuk pin 12 dan 11 pada 400 dan 650 ms, dan "sizeof(Lamp) = 11". Sketch menyimpan pin, laju, perubahan terakhir, dan status tiap lampu dalam satu struct, dan loop() menelusuri array-nya.
Di bawah ini cara mendefinisikan dan mengisi struct, mengembalikan dua nilai dari sebuah fungsi, mengirimnya lewat referensi, seberapa besar ukurannya, menyimpannya ke EEPROM, dan error yang pertama kali dijumpai orang, masing-masing dijalankan di Uno beserta hasil cetaknya.
Mau versi langkah demi langkah? Pelajaran "Things that belong together" membahas ini dengan checkpoint.
Buka pelajaranDefinisikan dulu, lalu buat beberapa
Ini struct pada sketch yang berjalan di atas, dan array yang membuat tiga lampu. Nilai di setiap pasangan kurung kurawal mengisi member sesuai urutan penulisannya: pin, laju, waktu terakhir berubah, dan apakah menyala. Jadi lamps[1].everyMs adalah 400 dan lamps[2].pin adalah 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.
Definisi struct diakhiri titik koma setelah kurung kurawal penutupnya. Kalau hilang, build berhenti: clang bilang expected ';' after struct, dan GCC bilang 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},
};Mengembalikan dua nilai dari satu fungsi
Fungsi mengembalikan satu nilai, tapi nilai itu bisa berupa struct, yang merupakan jawaban umum untuk "bagaimana mengembalikan dua nilai dari sebuah fungsi". Sketch di bawah menemukan nilai terendah dan tertinggi dari lima pembacaan dalam satu kali jalan dan mengembalikan keduanya dalam sebuah Range. Hasilnya tercetak "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() {
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Kirim lewat referensi untuk mengubahnya
Struct yang dikirim ke fungsi akan disalin, seperti int. toggleCopy() di bawah membalik salinannya sendiri dan lampu milik pemanggil tetap mati, jadi baris pertama mencetak 0. Tulis & setelah tipenya dan fungsi mendapat lampu milik pemanggil itu sendiri: toggle() mencetak 1.
Referensi juga menghemat penyalinan struct besar, yang penting dengan RAM 2 KB. Saat fungsi hanya membaca struct, katakan saja dengan const: void show(const Lamp &lamp). Dengan pointer ke struct, pakai panah alih-alih titik: 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() {
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Seberapa besar sebuah 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.
Simpan struct ke EEPROM
EEPROM.put() menulis satu struct utuh, byte demi byte, dan EEPROM.get() membacanya kembali ke variabel dengan tipe yang sama. Sketch di bawah menyimpan dua pengaturan dan membacanya kembali sebagai "brightness 180, mode 2". Struct-nya 3 byte, jadi penyimpanan berikutnya bisa mulai di alamat 3. Di board sungguhan byte tersebut bertahan dari mati listrik, menjadikan struct cara rapi untuk menyimpan pengaturan.
#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() {
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Error yang pertama kali dijumpai orang
Terlalu banyak nilai: Lamp yang diberi lima nilai padahal punya empat member menghentikan build dengan excess elements in struct initializer. GCC bilang too many initializers for 'Lamp'.
Dipakai sebelum ada: struct harus didefinisikan di atas baris pertama yang menggunakannya. Dengan struct Reading ditulis di bawah setup(), baris di setup() yang membuatnya berhenti dengan unknown type name 'Reading', dan GCC bilang 'Reading' was not declared in this scope. Pindahkan definisinya ke bagian atas sketch, di bawah baris #include.
Membandingkan dua: if (a == b) dengan dua Lamp berhenti dengan invalid operands to binary expression ('Lamp' and 'Lamp'); GCC bilang no match for 'operator=='. C++ tidak membandingkan struct untukmu. Bandingkan member yang kamu butuhkan, a.pin == b.pin && a.on == b.on, atau taruh baris itu dalam sebuah fungsi.
Buka rangkaian ini di editor. Arduino Uno: tiga lampu, masing-masing sebuah struct, disambungkan seperti yang dijalankan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.
Pertanyaan
Apa itu struct di Arduino?
Tipe yang kamu buat sendiri yang mengelompokkan beberapa nilai dalam satu nama, misalnya sebuah pin, laju, dan status untuk satu lampu. Ini C++ biasa, jadi bisa dipakai di semua board yang didukung Arduino, dan setiap variabel bertipe ini punya salinannya sendiri untuk setiap member.
Bagaimana cara membuat array dari struct?
Definisikan struct-nya, lalu deklarasikan array dari struct itu dengan satu pasang kurung kurawal per elemen: Lamp lamps[] = {{13, 250, 0, false}, {12, 400, 0, false}}; Baca sebuah member dengan lamps[i].pin di dalam loop for.
Bagaimana mengembalikan dua nilai dari sebuah fungsi Arduino?
Kembalikan sebuah struct yang menyimpan keduanya, seperti rangeOf() dengan nilai rendah dan tinggi di sini. Atau lempar variabelnya by reference, dengan & setelah setiap tipe, dan biarkan fungsinya mengisinya.
Apa bedanya struct dan class?
Hanya siapa yang bisa melihat membernya secara bawaan. Member struct bersifat public kecuali kamu bilang lain, dan member class bersifat private. Keduanya bisa menyimpan fungsi maupun nilai; kode Arduino biasanya memakai struct untuk kelompok nilai sederhana.
Kenapa sketch-ku bilang struct tidak dideklarasikan?
Struct-nya didefinisikan di bawah baris yang pertama kali memakainya. Pindahkan definisinya ke bagian atas sketch, di atas setup() dan di atas fungsi apa pun yang menerima atau mengembalikan struct itu.
Lanjutkan
Asal fakta di halaman ini
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.