Belajar

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
Arduino Uno: tiga lampu, masing-masing sebuah structlive0.000 s 0.00x
Tahan tombolnya
Setiap lampu menyimpan pin, laju, kapan terakhir berubah, dan apakah menyala, dalam satu Lamp.

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 pelajaran

Definisikan 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.

firmware/uno/examples/cppstruct (lampu yang berjalan di atas)
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".

Terendah dan tertinggi, dalam satu 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() {
}

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;.

Salinan dulu, lalu lampunya sendiri
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.

Dua pengaturan dalam satu 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() {
}

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.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.