Apa itu check
Check adalah satu hal yang kamu harapkan dari rangkaian seorang siswa, ditulis dalam satu kalimat: pin 13 berkedip setiap 1000 ms, dengan toleransi 50 ms. Kamu menambahkan beberapa check ke sebuah tugas, dan sejak itu setiap siswa yang menekan Periksa kerjaku akan melihat setiap check ditandai lulus atau gagal dengan angka yang terukur di samping angka yang kamu minta.
Penilaian berjalan di engine sungguhan, di browser tempat tombolnya ditekan. Tidak ada yang dikirim ke mana pun untuk dinilai, tidak ada yang diantrekan, dan daftar yang sama berjalan dengan cara yang sama di komputermu dan di komputer mereka.
Menambahkannya
Di halaman kelas, di bawah sebuah tugas, tekan Check. Kamu melihat apa yang sudah ada di sana, dan menu Tambah check berisi jenis-jenis di bawah ini. Setiap jenis adalah sebuah kalimat dengan bagian kosong: isi bagian kosongnya dan kalimat itulah check-nya.
Dua kolom layak dijelaskan lebih lanjut.
Yang dilihat siswa. Nama yang kamu berikan pada sebuah check adalah semua yang dibaca kelas saat check itu gagal, jadi tulislah sebagai hal yang kamu minta: "Lampu berkedip sekali per detik", bukan "check 1". Kalau dibiarkan kosong, kalimatnya yang dipakai.
Pin-nya. Pin ditulis <part>:<pin>, jadi uno1:13 adalah pin 13 pada board bernama uno1. Kotak pilihan berisi komponen dan pin yang sudah ada di rangkaian awalmu sendiri, jadi biasanya kamu tinggal memilih, tidak perlu mengetik.
Tekan Simpan check saat daftarnya sudah benar. Daftarnya disimpan seluruhnya, jadi menghapus satu check lalu menyimpan adalah cara mengeluarkan sebuah check.
Coba di starter
Di sebelah Simpan ada Coba di starter, dan itulah tombol yang paling penting. Tombol itu menjalankan daftarmu terhadap solusimu sendiri, di tempat, dan menunjukkan tiap check beserta hasil pengukurannya.
Jalankan sebelum kamu memberikan tugasnya. Check yang gagal pada jawabanmu sendiri akan gagal pada tiga puluh jawaban, dan beginilah cara mengetahuinya dalam empat detik, bukan di tengah pelajaran.
Jenis-jenisnya
| Jenis | Yang diukur |
|---|---|
| Sebuah pin high atau low | Level pada sebuah pin pada suatu saat |
| Sebuah pin berkedip | Periode antara satu rising edge dan rising edge berikutnya, dirata-ratakan selama window |
| Sebuah pin membawa PWM | Frekuensi switching, dan duty cycle jika kamu memberikannya |
| Sebuah pin memudar | Seberapa jauh duty PWM bergerak: window dibagi menjadi sepuluh bagian, duty tiap bagian saat pin sedang switching diukur, dan yang tertinggi dikurangi yang terendah harus mencapai rentang yang kamu berikan. Kedipan tidak pernah memudar |
| Serial Monitor mencetak sesuatu | Teks atau regular expression, di mana pun dalam apa yang dicetak board |
| Serial Monitor mencetak hal-hal secara berurutan | Beberapa pola, masing-masing setelah yang sebelumnya |
| Sebuah net berada pada suatu tegangan | Tegangan hasil solve dari net tempat sebuah pin berada |
| Sebuah LED menyala / gelap | Kecerahan milik komponen LED itu sendiri, seperti yang digambar di kanvas |
| Setelah sebuah tombol ditekan | Menekan sebuah tombol, lalu menahan sebuah pin di suatu level setelahnya |
| Board menyajikan halaman | Mengambil path dari server web simulasi milik board sendiri dan mencari teks di halaman itu |
| Sketch berhasil dikompilasi | Apakah sketch siswa terkompilasi atau tidak |
Dua catatan tentang check yang rumit. Check PWM menerima nilai apa pun untuk duty cycle, yang merupakan jawaban yang tepat untuk sketch yang menyapunya: contoh fade punya frekuensi yang layak diperiksa dan bukan satu duty cycle saja. Board menyajikan halaman hanya berarti sesuatu di tempat WiFi disimulasikan, yang hari ini adalah ESP32-C3, ESP32-C6, ESP32 DevKit, NodeMCU, dan Pico W; lihat artikel WiFi untuk tahu jaringan itu apa dan bukan apa.
Apa yang didapat siswa
Di halaman kelas mereka, di bawah tugasnya, ada tombol Periksa tugasku. Tombol itu menjalankan daftarmu pada apa yang mereka kirimkan dan menunjukkan setiap check dengan hasil ukur dan ekspektasinya:
Gagal Lampu berkedip sekali per detik Lampu berkedip setiap 1462 ms. Diharapkan: pin 13 pada uno1 berkedip setiap 1 s, dengan toleransi 50 ms, diamati selama 4 s.
Itulah inti dari cara penulisannya: siswa yang hanya diberi tahu "gagal" tidak belajar apa-apa, sedangkan siswa yang diberi tahu bahwa lampunya berkedip di 1462 ms saat kamu meminta 1000 tahu persis angka mana yang harus dia ubah.
Tidak ada apa pun tentang rangkaianmu yang sampai ke mereka. Mereka melihat nama yang kamu tulis, apa yang diukur rangkaian mereka sendiri, dan apa yang diminta pemeriksaan. Solusimu, hasil jalankanmu sendiri, dan pekerjaan semua orang tetap di tempatnya.
Apa yang kamu dapat kembali
Hasilnya terkirim bersama kiriman tugasnya. Di sisimu:
- dinding kelas menampilkan skor sebagai pil di setiap kartu, jadi kamu bisa melihat seluruh ruangan dalam sekali lihat;
- Yang dikirim kembali menampilkan setiap kiriman dengan skor dan semua pemeriksaannya;
- setiap pemeriksaan yang gagal punya tombol Kutip yang menaruh kalimatnya langsung ke kotak umpan balik.
Ada satu tombol lagi, Grade it, dan tombol itu ada karena satu keterbatasan yang jujur. Hasil siswa adalah apa yang diukur browser mereka. Browser itu milik mereka, dan siswa yang gigih bisa mengirim angka yang tidak pernah dihasilkan browsernya. Grade it menjalankan daftar yang sama pada kiriman yang sama di mesin milikmu, dan panel selalu menyebutkan mana dari keduanya yang sedang ditampilkan. Untuk tugas yang berpengaruh pada nilai, tekan Grade it.
Apa yang bisa dan tidak bisa dilihat sebuah pemeriksaan
Pemeriksaan mengukur simulasi. Itu pengukuran sungguhan dari firmware sungguhan pada model chip yang sesungguhnya, dan ini bukan meja kerja nyata:
- Timing-nya ideal. Jam yang dipakai adalah jam chip seperti yang dijelaskan kontrak board kami. Tidak ada pergeseran kristal, tidak ada suhu, dan tidak ada jitter yang tidak ada dalam model.
- Tidak ada noise analog. Sebuah net membaca tegangan yang dihasilkan solver. Rangkaian yang akan berada di batas aman di breadboard akan terbaca bersih di sini.
- Kecerahan LED adalah milik model, hasil low pass dari arus yang melewatinya, dan itulah yang membuat "menyala" berarti sesuatu di bawah PWM. Ini bukan fotometer.
- Tidak ada komponen mekanis yang diukur. Tidak ada bouncing yang tidak dimodelkan komponen, tidak ada panas, tidak ada kabel yang terlepas.
- Jaringannya disimulasikan. Halaman yang disajikan board berasal dari runtime kami sendiri dan tiga origin
.mokxi; tidak ada internet di belakangnya.
Kalau itu berpengaruh, sampaikan ke kelas. Aturan Mokxi adalah apa pun yang ditampilkan ke siswa harus akurat, atau jujur mengatakan bahwa itu tidak akurat, dan setiap panel hasil di produk memuat kalimat: setiap pemeriksaan di sini mengukur simulasi, bukan meja kerja nyata: timing ideal, tanpa derau analog.
Batasannya
- Dua puluh pemeriksaan dalam satu tugas.
- Sebuah pemeriksaan bisa memantau hingga enam puluh detik waktu simulasi, dan keseluruhan run juga dipotong jauh sebelum itu. Sketch yang menunggu sesuatu yang tidak pernah terjadi akan kembali sebagai kehabisan waktu beserta hasil ukur sampai titik itu, alih-alih membuat halaman macet.
- Kiriman yang sketch-nya sudah diedit dikompilasi dulu sebelum dinilai, dengan compiler yang sama seperti yang dipakai editor. Build pertama di browser mengunduh toolchain, yang ukurannya besar; setelah itu disimpan di cache. Sketch yang gagal dikompilasi tidak pernah dinilai berdasarkan contoh asalnya. Run-nya ditolak, dan hasilnya menjelaskan alasannya.