Belajar

Enum Arduino, pada timer Pomodoro yang tahu sedang berada di sesi mana

Pemula

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: timer Pomodoro dengan sesinya dalam sebuah enumlive0.000 s 0.00x
Tekan Jalankan, lalu tekan tombol skip
Tekan skip untuk memajukan enum: Focus, istirahat singkat, Focus lagi.

enum Phase { FOCUS, SHORT_BREAK, LONG_BREAK }; memberi nama pada bilangan bulat 0, 1 dan 2, serta menjadikan Phase sebuah tipe yang menyimpan salah satunya. Variabel bertipe ini menyatakan status program dengan kata-kata, bukan angka, dan switch padanya memberi setiap status bloknya sendiri.

Rangkaian di atas adalah timer Pomodoro di sebuah Uno: tampilan TM1637, lampu focus merah, lampu break hijau dan dua tombol. Sketch-nya menyimpan sesi dalam Phase phase. Tekan Jalankan, lalu tekan tombol kedua, skip. Serial monitor mencetak "Skipped" dan "Short break (1 session done)", dan lampu hijau menggantikan yang merah. Skip lagi dan ia mencetak "Focus (1 session done)".

Di bawah ini adalah bagaimana nama dipetakan ke angka, mencetak enum berdasarkan nama, enum dengan switch, enum class, dan error yang diberikan enum, masing-masing dijalankan di Uno dengan hasil cetaknya.

Enum dari timer ini

Here are the two lines from the sketch running above. : uint8_t stores a Phase in one byte; without it an enum on the Uno takes 2, the size of an int. The sketch then reads like the method it follows: if (phase == FOCUS), phase = LONG_BREAK. Nothing at run time knows the names. They are for you and for the compiler, which now refuses a phase that is not one of the three.

firmware/uno/examples/pomodoro (enum yang berjalan di atas)
enum Phase : uint8_t { FOCUS, SHORT_BREAK, LONG_BREAK };
Phase phase = FOCUS;

Angka di balik nama

Nama pertama bernilai 0 dan setiap nama setelahnya bertambah satu, kecuali kamu memberinya nilai. Di bawah, Serial.println(c) dengan c diisi BLUE mencetak 2, dan FAST mencetak 50 karena diberi nilai 50. sizeof(Color) mencetak 2. Nilai berguna saat angkanya berarti sesuatu di luar sketch, seperti kecepatan atau byte perintah.

Dua nama bisa berbagi satu nilai, dan sebuah nama bisa diberi nilai nama lain ditambah satu, MEDIUM = SLOW + 15. Nama tanpa nilai terus menghitung dari yang terakhir punya nilai, jadi setelah SLOW = 10, FASTER saja akan menjadi 11. Simpan daftarnya di satu tempat di bagian atas sketch, agar setiap status yang mungkin dimiliki program mudah dibaca sekilas.

Nama adalah angka
enum Color { RED, GREEN, BLUE };
enum Speed { SLOW = 10, MEDIUM = 25, FAST = 50 };

void setup() {
  Serial.begin(9600);
  Color c = BLUE;
  Serial.println(c);
  Serial.println(FAST);
  Serial.println(sizeof(Color));
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Mencetak enum berdasarkan nama

Serial.println() mencetak angkanya, bukan namanya. Untuk mencetak nama, simpan nama-nama dalam array dengan urutan yang sama dan gunakan enum sebagai indeks: sketch di bawah mencetak "green". Sketch Pomodoro melakukannya dengan fungsi yang mengembalikan "Focus", "Short break" atau "Long break", yang lebih aman saat nilai diberikan manual, karena nama-nama tidak lagi cocok dengan posisi dalam array.

Enum sebagai indeks
enum Color { RED, GREEN, BLUE };
const char *colorNames[] = {"red", "green", "blue"};

void setup() {
  Serial.begin(9600);
  Color c = GREEN;
  Serial.println(colorNames[c]);
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

enum dan switch

Switch pada enum adalah bentuk biasa dari state machine: satu case per status, masing-masing mengerjakan tugasnya dan memilih status berikutnya. Kalau satu status dilewatkan, compiler akan menyadarinya. Sketch di bawah punya tiga lampu dan hanya dua case; clang memperingatkan enumeration value 'YELLOW' not handled in switch, dan sketch mencetak "red" dan "green" lalu tidak ada apa-apa, karena mencapai YELLOW tanpa case untuknya. Tambahkan case-nya, atau default: dengan sengaja.

Switch dengan satu status hilang
enum Light { RED, GREEN, YELLOW };
Light light = RED;

void setup() {
  Serial.begin(9600);
}

void loop() {
  switch (light) {
    case RED:
      Serial.println("red");
      light = GREEN;
      break;
    case GREEN:
      Serial.println("green");
      light = YELLOW;
      break;
  }
  delay(100);
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

enum class: nama yang tetap di kotaknya sendiri

Nama enum biasa dimiliki seluruh sketch, dan diam-diam berubah menjadi int. enum class mencegah keduanya: tulis tipe sebelum setiap nama, Mode::Blink, dan bandingkan hanya dengan Mode lain. Sketch di bawah mencetak "blinking", dan (int)m mencetak 1.

Harganya, ia tidak bisa dipakai sebagai angka. Serial.println(m) berhenti dengan no matching member function for call to 'println', dan if (m == 1) dengan invalid operands to binary expression ('Mode' and 'int'), clang tidak menambahkan implicit conversion untuk scoped enum. GCC bilang no match for 'operator=='. Cast saja, seperti (int)m, saat kamu benar-benar mau angkanya.

enum class
enum class Mode { Off, Blink, On };

void setup() {
  Serial.begin(9600);
  Mode m = Mode::Blink;
  if (m == Mode::Blink) {
    Serial.println("blinking");
  }
  Serial.println((int)m);
}

void loop() {
}

Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.

Error yang diberikan enum

Nama yang sudah dipakai Arduino: enum Level { LOW, MEDIUM, HIGH }; berhenti dengan expected identifier, dua kali, karena LOW dan HIGH sudah didefinisikan sebagai 0 dan 1 sebelum sketch-mu dimulai. Pilih nama lain, seperti LEVEL_LOW, atau gunakan enum class.

Nama yang sama di dua enum: OFF di enum Light dan Fan memberikan redefinition of enumerator 'OFF'; GCC bilang 'OFF' conflicts with a previous declaration. Nama enum biasa berbagi satu ruang, jadi beri awalan atau gunakan enum class.

Menghitungnya: c++ pada Color berhenti dengan cannot increment expression of enum type 'Color', dan Color c = 2; dengan cannot initialize a variable of type 'Color' with an rvalue of type 'int'; GCC bilang invalid conversion from 'int' to 'Color'. Lanjutkan dengan cast, c = (Color)((c + 1) % 3);, yang berjalan 0, 1, 2 dan kembali ke 0.

Buka rangkaian ini di editor. Arduino Uno: timer Pomodoro dengan sesinya dalam sebuah enum, dirangkai seperti yang berjalan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.

Buka rangkaian ini

Pertanyaan

Apa itu enum di Arduino?

Daftar nama untuk bilangan bulat yang sekaligus membuat tipe baru. Inilah cara sebuah sketch memberi nama pada status, mode atau item menu agar kode menulis FOCUS, bukan 0.

Bagaimana cara mencetak nama enum?

Simpan nama-nama dalam array const char * dengan urutan yang sama dan cetak colorNames[c], atau tulis fungsi dengan switch yang mengembalikan namanya. Serial.println() sendirian mencetak angkanya.

Apakah enum lebih baik dari #define untuk status?

Ya. Enum memberikan tipe sungguhan, jadi compiler bisa menolak nilai yang bukan status dan memperingatkan saat switch melewatkan satu. Nama dari #define hanyalah teks yang disisipkan sebelum kompilasi.

Apa bedanya enum dan enum class?

Nama enum biasa terlihat di mana-mana dan berubah menjadi int dengan sendirinya. Enum class menyimpan namanya di balik tipenya, Mode::On, dan butuh cast untuk menjadi angka, jadi dua enum bisa sama-sama punya OFF.

Sumber

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.