Mesin status di Arduino, dengan game yang bisa kamu mainkan
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
Cepat atau lambat setiap sketch harus melakukan hal berurutan sambil tetap merespons dunia luar: menunggu tombol, lalu menunggu waktu acak, lalu menyalakan lampu, lalu mengukur berapa lama kamu menekan lagi. Jika ditulis dengan delay() dan if bersarang, hasilnya jadi program yang sulit diikuti dan setengah waktunya tuli terhadap masukan. Mesin status adalah jalan keluar standarnya, dan hanya butuh sebuah enum dan satu variabel.
Rangkaian di atas adalah game reaksi di Uno dengan tombol pada pin 2 dan tiga lampu. Programnya punya empat status: READY (lampu merah pada pin 13 menyala, menunggu kamu menekan), ARMED (semua gelap, menunggu waktu acak 0,7 sampai 2 detik), RUNNING (lampu kuning pada pin 12 menyala, pewaktu berjalan) dan DONE (lampu hijau pada pin 11 menunjukkan ronde selesai). Tekan Jalankan, tekan tombol sekali, lalu tunggu kuning.
Mau versi langkah demi langkah? Pelajaran "Satu variabel yang menunjukkan posisimu" membahas ini dengan checkpoint.
Buka pelajaranApa yang Serial Monitor beritahu kepadamu
Sketch ini mencetak setiap perubahan state, jadi Serial Monitor menjadi log dari mesinnya. Satu putaran yang kami mainkan terbaca: "state: READY", "state: ARMED", "state: RUNNING", "reaction: 861 ms", "state: READY". Tekan saat ARMED saja dan kamu dapat "too early", langsung ke DONE, lalu kembali ke READY 1,2 detik kemudian.
Log itulah alasan pertama menulis kode dengan cara ini. Saat ada yang salah, kamu tahu persis di state mana program berada dan apa yang memindahkannya, alih-alih menebak mana dari lima if bersarang yang benar.
Bentuk kodenya
Beri nama state dengan enum, simpan state saat ini di sebuah variabel, dan beri setiap state satu blok yang menyatakan apa yang dilakukannya dan apa yang memindahkannya. Sebuah helper, enter(), mengubah state dan mencatat waktunya, jadi setiap state tahu sudah berapa lama ia aktif tanpa menyimpan timernya sendiri.
Perhatikan apa yang tidak ada di sana. Tidak ada delay() di mana pun. Setiap putaran loop() membaca tombol, memeriksa state, dan kembali dalam hitungan mikrodetik, jadi tombol dibaca ribuan kali per detik di setiap state. Menunggu dilakukan dengan membandingkan millis() dengan waktu saat state dimasuki, pola yang sama seperti halaman blink without delay untuk dua LED.
enum State { READY, ARMED, RUNNING, DONE };
State state = READY;
unsigned long enteredAt = 0;
static void enter(State next) {
state = next;
enteredAt = millis();
}
// in loop(), after reading the button into justPressed:
if (state == READY) {
if (justPressed) {
waitMs = random(700, 2000);
enter(ARMED);
}
} else if (state == ARMED) {
if (justPressed) {
enter(DONE); // too early
} else if (now - enteredAt >= waitMs) {
enter(RUNNING);
}
} else if (state == RUNNING) {
if (justPressed) {
Serial.println(now - enteredAt); // the reaction time
enter(DONE);
}
} else { // DONE
if (now - enteredAt >= 1200) enter(READY);
}Event, bukan level
Mesin bereaksi pada justPressed, yang bernilai benar hanya selama tepat satu putaran loop() saat tombol berubah dari naik ke turun. Jika ia bereaksi pada "tombol sedang ditekan", satu tekanan yang ditahan selama seperempat detik akan terbaca ratusan kali dan membawa mesin langsung melewati READY, ARMED dan masuk ke false start. Mendeteksi edge, dengan debounce 25 milidetik agar contact bounce tidak terhitung sebagai tekanan tambahan, itulah yang membuat satu tekanan menjadi satu event.
Ini bug state machine yang paling umum di meja kerja sungguhan: transisi yang digerakkan oleh level padahal butuh edge. Jika sebuah state tampak dilewati, periksa apa yang menggerakkan mesin.
Gambar dulu sebelum menulis
Sebelum menulis state machine, gambar dulu: satu lingkaran per state dan satu panah per transisi, dengan event yang menyebabkannya ditulis pada panahnya. Untuk game ini berarti empat lingkaran dan lima panah: READY ke ARMED saat ditekan, ARMED ke RUNNING saat waktu tunggu acak habis, ARMED ke DONE saat ditekan (terlalu cepat), RUNNING ke DONE saat ditekan, dan DONE ke READY setelah 1,2 detik. Jika kamu tidak bisa menggambar panah untuk sesuatu yang harus dilakukan program, desainnya kurang sebuah state atau sebuah event, dan jauh lebih murah menemukannya di atas kertas.
Gambar itu juga menjadi daftar tesmu. Setiap panah adalah satu kasus untuk dicoba sekali. Di simulator kamu bisa menjalani kelima panah dalam waktu kurang dari satu menit: tekan sekali lalu tunggu, tekan dua kali dengan cepat, tekan sekali lalu tekan lagi saat kuning menyala. Melihat log serial mencetak setiap transisi saat kamu melakukannya itulah seluruh tesnya. Dua kesalahan yang terlihat lewat cara ini adalah lupa memanggil enter() (sehingga enteredAt basi dan state bertimer berakhir seketika) dan state tanpa jalan keluar.
Bandingkan dengan sketch yang memblokir
Contoh Traffic light di galeri menjalankan penyeberangan pelikan dengan cara lain: urutan lampu yang lurus dengan delay() di antaranya. Ia berfungsi, tapi hanya karena tombol permintaan ada di interrupt; tanpa itu, tekanan saat delay() akan hilang. Buka dengan tombol di bawah dan baca kedua sketch berdampingan.
Menulis ulang penyeberangan sebagai state machine (GREEN, AMBER, WALK, FLASHING) menghilangkan kebutuhan akan interrupt, dan menambah aturan baru, misalnya "tahan hijau setidaknya tiga detik", menjadi satu kondisi tambahan di satu blok alih-alih merombak seluruh loop.
Buka rangkaian ini di editor. Arduino Uno: game reaksi empat state, dirangkai seperti yang berjalan di bagian atas halaman ini. Ubah satu komponen atau nilai lalu jalankan lagi.
Pertanyaan
Haruskah aku pakai switch atau if dan else if?
Keduanya bisa. switch pada variabel state umum dipakai dan membuat compiler memperingatkanmu tentang nilai enum yang lupa kamu tangani, asal kamu ingat break di akhir setiap case. Contohnya memakai if dan else if karena mudah dibaca dalam sketch singkat.
Bagaimana cara menambah state baru?
Tambahkan nama ke enum, tambahkan blok untuknya, lalu tambahkan transisi masuk dan keluar darinya. Tidak ada bagian lain dari program yang perlu berubah, dan justru itulah inti dari pola ini.
Bisakah sebuah state machine berjalan bersama kode lain?
Bisa, asalkan tidak ada yang memblokir di loop(). Beberapa machine bisa berjalan berdampingan, masing-masing dengan variabel state-nya sendiri, karena setiap machine hanya melakukan sedikit pekerjaan per putaran.
Di mana aku menjalankan sesuatu sekali saja saat sebuah state dimulai?
Di transisinya, tepat sebelum atau sesudah memanggil enter(). Contohnya memilih waktu tunggu acak pada saat memasuki ARMED, jadi waktu tunggu dipilih sekali per ronde, bukan di setiap putaran.
Lanjutkan
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.