Untuk apa
LED yang berkedip memberi tahu kamu bahwa board masih hidup. Tapi tidak memberi tahu kamu berapa nilai count saat lampu padam, atau apakah percabangan yang baru kamu tulis dijalankan. Debug bisa: tekan Jalankan, hentikan board di satu baris, dan baca register serta variabelmu sendiri pada saat itu.
Saat board dihentikan, semuanya ikut berhenti. LED mempertahankan tingkat terangnya, servo tetap di sudutnya, timer chip berhenti di posisinya. Jadi saat kamu menekan Lanjutkan, millis() berlanjut dari instruksi yang sedang kamu lihat, bukan melompat maju sesuai lamanya kamu membaca.
Memasang breakpoint
Klik di gutter sempit di sebelah kiri nomor baris. Titik merah akan muncul, dan board akan berhenti sebelum baris itu dijalankan: apa yang kamu lihat di layar belum terjadi.
Tekan Jalankan. Board yang punya breakpoint selalu dikompilasi dari file yang ada di depanmu, walaupun bagian Firmware board itu menyebut program bawaan. Breakpoint ada di satu baris kode ini, dan program bawaan dikirim tanpa informasi yang menyatakan instruksi mana yang milik satu baris.
Klik titiknya lagi untuk melepasnya. Hapus semua di tab Debug melepas semua breakpoint di board itu sekaligus.
Tab assembly punya gutter yang sama dan bekerja dengan cara yang sama. Breakpoint di satu baris file .S berhenti di baris itu, karena nomor baris yang dicatat build adalah milik tab itu sendiri, bukan milik salinan hasil preproses.
Titik berongga
Titik berongga berarti breakpoint ada di tempat kamu meletakkannya dan tidak melakukan apa pun: compiler tidak menghasilkan instruksi untuk baris itu. Baris kosong, komentar, deklarasi tanpa kode, dan baris yang dilipat optimizer semuanya terlihat seperti ini. Pindahkan ke baris berikutnya yang melakukan sesuatu.
Bilah di sebelah Jalankan
Jeda menghentikan board di mana pun posisinya. Tombol itu berubah menjadi Lanjutkan, yang membiarkannya berjalan lagi.
Step over menjalankan satu baris source, termasuk pemanggilannya: satu baris yang memanggil delay(500) memakan 500 ms waktu simulasi dan sisa rangkaian mengalaminya seluruhnya, karena memang begitulah yang sebenarnya terjadi.
Step into berjalan sampai baris berikutnya yang dicapai board, yaitu baris pertama dari fungsi yang dipanggil baris saat ini.
Sebuah step bisa dipotong pendek oleh breakpoint yang lebih jauh, dan board berhenti di situ dan memberi tahu. Satu-satunya breakpoint yang tidak pernah memotong pendek sebuah step adalah tempat step itu dimulai: interupsi yang terjadi pada saat itu (timer, pin, atau tick yang dihitung millis()) menjalankan handler-nya lalu mengembalikan board tepat ke baris tempatmu berada, dan berhenti di situ berarti penekanan tombolnya tidak berpengaruh sama sekali.
Step out berwarna abu-abu, dan tooltip-nya menjelaskan alasannya: step itu harus mencari tahu ke mana fungsi saat ini kembali, dan debugger tidak membaca call stack. Letakkan breakpoint di baris setelah pemanggilan sebagai gantinya.
Step instruction, di bagian Disassembly pada tab Debug, menjalankan tepat satu instruksi mesin, bukan satu baris penuh.
Di HP, bilahnya pindah ke tab Debug, di mana ada ruang untuknya.
Tab Debug
Di sebelah Serial Monitor di bagian bawah jendela (tab tersendiri di sheet pada HP), berisi lima hal.
Di mana board berhenti, dalam satu baris: file dan barisnya, alamatnya, dan alasan berhentinya: breakpoint, step, atau Jeda. Saat tabel baris tidak mencakup alamat itu, yang ditampilkan adalah alamatnya dan diberi tahu begitu, bukan menyebut baris yang belum pasti. "Di dalam sketch.ino:14" berarti board ada di tengah baris itu, bukan di awalnya, dan sorotan di panel kode digambar lebih samar untuk menandainya.
Register, dengan nama yang dipakai core itu sendiri: a0 dan sp di ESP32-C3, r24 dan sreg di Uno. Nilainya dibaca dari core saat board berhenti, jadi itu yang disimpannya sekarang, bukan yang disimpannya sebelumnya. pc ada di urutan pertama, dan itu instruksi yang akan dijalankan berikutnya.
Register status juga dieja di sebelah angkanya, karena delapan bit bukan satu nilai. Di AVR, sreg menampilkan flag-nya sebagai ITHSVNZC, dengan titik untuk setiap flag yang clear, jadi berhenti tepat setelah cp langsung memperlihatkan apakah cabang akan diambil. Di board ARM, xpsr menampilkan N Z C V Q dengan cara yang sama.
Disassembly adalah kode mesin di sekitar titik berhenti. Setiap baris adalah satu instruksi: alamatnya, byte-nya, instruksinya dengan ejaan yang dipakai llvm-objdump, dan baris source tempat ia mulai, yang berupa tombol yang membawamu ke baris itu di panel kode. Instruksi yang akan dijalankan ditandai. Step instruction, di bagian atas seksi itu, menjalankan satu instruksi itu lalu menggambar ulang daftarnya.
Inilah tampilan yang tepat untuk tab .S: baris yang kamu tulis ada di sebelah byte hasil assembly-nya. Tampilan ini juga bekerja baik di sketch, memperlihatkan apa yang dibuat compiler dari satu baris C++. Board yang belum dibuild dari file-nya akan memberi tahu hal itu, karena belum ada program untuk dibaca sampai kamu menekan Jalankan.
Watch menerima nama variabel global. Mulailah mengetik dan ia menawarkan yang dimiliki program-mu. Setiap baris menampilkan tipe seperti yang dicatat compiler dan berapa byte tipe itu, lalu nilainya, dibaca dari memori board pada setiap kali berhenti. Nama yang tidak dimiliki program akan diberi tahu begitu, bukan menampilkan nol. Struct atau array menampilkan byte-nya, alamat rendah lebih dulu, karena itu byte-byte, bukan satu angka.
Breakpoint mendaftar semua breakpoint di board ini beserta alamat yang ditemukannya. Klik salah satu untuk langsung menuju lokasinya di kode.
Apa yang dilakukan Serial Monitor selagi itu berlangsung
Tidak ada yang berubah. Semua yang board cetak sebelum berhenti masih ada di sana, dan apa pun yang dicetak setelah kamu melanjutkan akan muncul di bawahnya. Menghentikan sebuah board bukan berarti menghentikan jalannya program.
Dua board
Setiap board punya breakpoint-nya sendiri, daftar pantauannya sendiri dan kondisi berhentinya sendiri. Debug bekerja pada board yang ditampilkan pane kode, yaitu board yang disebut oleh pemilih di atas tab.
Board mana saja yang didukung
Semuanya. Setiap board yang ada di Mokxi bisa di-debug: ESP32-C3 dan ESP32-C6, ESP32 dan ESP8266, Arduino Uno, Nano, Mega, Leonardo dan Uno R4 Minima, ATtiny85, Raspberry Pi Pico dan Pico W, STM32 Black Pill dan Blue Pill, BBC micro:bit dan Seeed XIAO SAMD21.
Registernya adalah register yang dimiliki core board itu sendiri, dengan nama yang dipakai dokumentasinya sendiri: a0 dan sp di ESP32-C3, r24 dan sreg di AVR, r0, lr dan xpsr di apa pun yang ber-ARM, a0 sampai a15 di board Xtensa (ESP32, ESP32-S3 dan ESP8266). Jadi yang kamu baca di panel adalah yang akan kamu baca di komponen aslinya.
Step out berwarna abu-abu di setiap board, karena alasan yang diberikan tooltip-nya.
Bar bisa tetap berwarna abu-abu karena alasan yang tidak berhubungan dengan board mana yang dipakai: belum ada yang berjalan, atau komponen yang ditampilkan pane kode tidak menjalankan program sama sekali (resistor tidak bisa dihentikan). Board yang benar-benar tidak bisa dijangkau debug akan menyebut namanya sendiri ("Debug belum mendukung mega1."), dan sekarang tidak ada board yang seperti itu lagi. Board yang terjangkau tidak pernah berwarna abu-abu karena tidak ada breakpoint: Jeda langsung bisa dipakai saat board berjalan, ada breakpoint maupun tidak.
Related
- Editor kode dan kompilasi
- Menulis assembly
- Jalankan dan Serial Monitor
- Tidak ada yang muncul di Serial Monitor
- Cara debug kode Arduino: metode, Serial print dan plotter, dengan contoh lengkap