Arduino kodunda hata ayıklama, Serial yazdırmalarından kesme noktalarına
Başlangıç
Ya da tüm dersleri gör.
- 526parça tezgahta
- 46kart şu an çalışıyor
- 1.00xgerçek zamanlı, her kartta
Arduino'nun ekranı yoktur, bu yüzden bir kod bozulduğunda ne düşündüğünü göremezsin. Klasik Uno ve Nano, Arduino IDE'de adım adım da çalıştırılamaz: IDE'nin hata ayıklayıcısı belirli yeni kartları destekler ve çoğu sınıf ile kitin kullandığı AVR kartlarını değil. Bu yüzden çoğu kişi Serial.print ile hata ayıklar ve bilinçli kullanınca iyi çalışır.
Bu sayfa önce bir hatayı daraltma yöntemi, sonra üç araç sunuyor: yazdırma, çizdirme ve kartı bir satırda durdurma. Yukarıdaki devre, A0'da bir potansiyometre ve 9 numaralı pinde bir LED'i olan bir Uno; üçünü de göstermek için bu yeterli, üstelik sadece bir Uno'da görünen gerçek bir hatayı da içeriyor.
Hatanın peşine düşmeden önce onu küçült
Beklentini ve onun yerine ne olduğunu birer cümleyle yaz. "Düğmeyi çevirdikçe LED parlaklaşmalı, ama önce parlıyor, sonra sönüyor, sonra yine parlıyor" test edebileceğin bir hatadır; "çalışmıyor" değildir.
Sonra sorunu daralt. Önce kablolamayı koddaki pin numaralarıyla karşılaştır, çünkü bu hataların büyük kısmını yakalar. İlgisiz her şeyi yorum satırına çevir ya da şüpheli parçayı yeni bir koda kopyala. Bir seferde tek şeyi değiştir ve yeniden çalıştır. On satırda varlığını sürdüren hata, bulacağın bir hatadır; aynı hata üç yüz satırda tahmin yürütmedir.
Serial.print, bilinçli kullanınca
Portu setup() içinde Serial.begin ile başlat ve gerçek bir kartta seri monitörü aynı baud hızına ayarla, yoksa anlamsız karakterler görürsün. setup() sonunda bir kez bir şey yazdır. O satır tekrar tekrar görünüyorsa kart sıfırlanıyor demektir; bu genelde bir motorun veya servonun beslemeyi düşürdüğü anlamına gelir.
Her değere etiket ver, yani çıplak bir 0 yerine button: pressed gibi. Bir şey her loop() geçişinde değil, değiştiğinde yazdırılsın; her geçişte yazdırmak monitörü okunamayacak kadar hızlı doldurur. Yazdırmaları bir makroya sar, böylece hata geri geldiğinde tek tek silinip yeniden yazılmak yerine tek bir yerden kapatılabilirler.
#define DEBUG 1
#if DEBUG
#define DEBUG_PRINT(x) Serial.print(x)
#define DEBUG_PRINTLN(x) Serial.println(x)
#else
#define DEBUG_PRINT(x)
#define DEBUG_PRINTLN(x)
#endif
const int BUTTON_PIN = 2;
int lastState = HIGH;
void setup() {
Serial.begin(115200);
pinMode(BUTTON_PIN, INPUT_PULLUP);
DEBUG_PRINTLN("setup done"); // printed again on every reset
}
void loop() {
int state = digitalRead(BUTTON_PIN);
if (state != lastState) { // print on a change, not on every pass
DEBUG_PRINT("button: ");
DEBUG_PRINTLN(state == LOW ? "pressed" : "released");
lastState = state;
}
}Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.
Yazdırma zaman alır
9600 baud'da her karakterin gönderilmesi yaklaşık bir milisaniye sürer, yani 20 karakterlik bir satır yaklaşık 20 milisaniyeye mal olur. Gerçek bir Uno ilk 64 baytı bir iletim tamponunda saklar ama her geçişte yazdıran bir kod onu hızla doldurur ve sonra her karakterde bekler. On iki kat hızlı olan 115200 baud'u kullan ve daha az yazdır.
Bir yazdırma eklemenin bazen bir hatayı yok etmesinin sebebi de budur. Kodu yavaşlatmak hatayı düzeltiyorsa sorun zamanlamayla ilgilidir: bir buton çok hızlı okunmuş, bir sensör hazır olmadan okunmuş ya da bir kesme ana döngüyle yarışıyordur. Bu bir ipucudur, çözüm değil. Bir kesme işleyicisinin içinde hiç yazdırma; orada bir bayrak ayarla ve loop() içinden yazdır.
Hazır örnek: negatife dönen ortalama
İşte gerçek bir hata. Kod, potansiyetrenin okumalarını yumuşatmak için 64 okumanın ortalamasını alır. Yukarıdaki karartıcı devresiyle düğme 100'deyken total:6400 average:100 yazdırır, bu doğrudur. Düğmeyi ortaya, 512'ye çevir ve total:-32768 average:-512 yazdırır. En üstte, 1023'te, total:-64 average:-1 yazdırır.
Yazdırmalar sebebi görünür kılar: toplam yanlış, yani sorun ortalamada değil. Bir Uno'da int 16 bittir ve en fazla 32.767 tutar; 64 adet 1023 okuması 65.472 eder, yani toplam negatife sarar. Aynı kod, int 32 bit olan bir ESP32'de çalışır; bir hatayı rastgeleymiş gibi gösteren tam da bu tür bir farktır. Çözüm long total = 0;. Toplamı yazdırmasan yalnızca kötü bir ortalama görür ve muhtemelen yanlış yere bakardın.
const int SENSOR_PIN = A0;
void setup() {
Serial.begin(115200);
}
void loop() {
int total = 0; // the bug: make this long
for (int i = 0; i < 64; i++) {
total += analogRead(SENSOR_PIN);
}
Serial.print("total:");
Serial.print(total);
Serial.print(" average:");
Serial.println(total / 64);
delay(250);
}Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.
Sayıları okumak yerine çiz
Zamanla değişen bir değer çizgi olarak daha kolay değerlendirilir. Arduino IDE'nin Serial Plotter'ı ve Mokxi'nin Çizim sekmesi aynı biçimi okur: boşluk veya virgülle ayrılmış, tek satırdaki sayılar, her biri isteğe bağlı olarak name:value biçiminde etiketli. Yukarıdaki hazır örnek zaten bu biçimde yazdırıyor, o yüzden Çizim sekmesini aç ve kadranı çevir; toplamın tam ortada negatif sayılara nasıl katlandığını izleyebilirsin.
Bir okumanın yanına eşiği reading:512 threshold:600 biçiminde yazdırmak eşiği düz bir çizgi olarak çizer; bir sensörün onu tam ne zaman geçtiğini ve kenarın dibinde ne kadar gürültülü olduğunu net görürsün. Bu, "ışığımda alacakaranlıkta neden yanıp sönüyor" sorusuna tek bakışta cevap verir.
Kartı bir satırda durdur
Mokxi'de herhangi bir kartı, Uno dahil, bir kesme noktasıyla durdurabilirsin, çünkü çip USB ile bağlı değil, simüle ediliyor. Bir satır numarasının solundaki oluğa tıkla ve kırmızı bir nokta belirir; Çalıştır'a bas ve kart o satır çalışmadan önce durur. Tüm devre onunla birlikte durur, yani LED tam o andaki parlaklığında kalır ve sen bakarken millis() sıçramaz.
Hata Ayıklama sekmesi sonra kartın nerede durduğunu, yazmaçlarını ve global değişkenler için bir izleme listesini gösterir. Üstünden geç, satırları tek tek çalıştırır. İzleme listesi yalnızca globalleri okur, o yüzden hata ayıklarken ilgilendiğin değişkeni global yapmak işe yarayabilir. ESP32 ve ESP8266'da Duraklat ve izleme listesi çalışır ama kesme noktaları çalışmaz, çünkü tarayıcı derleyicisi bu iki çip için derleme yapamaz. Aşağıdaki kesme noktası örneği bunu bir ESP32-C3 üzerinde adım adım anlatır.
Bu devreyi düzenleyicide aç. Arduino Uno: bir kadran ve bir LED, bu sayfanın üstünde çalıştığı gibi kablolanmış. Bir parçayı ya da değeri değiştir ve yeniden çalıştır.
Devreyi açSorular
Arduino Uno'yu kesme noktalarıyla hata ayıklayabilir miyim?
Arduino IDE'nin hata ayıklayıcısıyla olmaz, çünkü AVR kartlarını desteklemiyor. ATmega328P'de tek kablolu bir hata ayıklama arayüzü olan debugWIRE var ama ayrı bir donanım hata ayıklayıcısı gerektiriyor. Mokxi'de kesme noktaları doğrudan simüle edilmiş Uno üzerinde çalışır.
Seri monitörüm neden anlamsız karakterler gösteriyor?
Gerçek bir kartta, monitörün baud hızı Serial.begin ile eşleşmiyordur. İkisini de 115200 gibi aynı sayıya ayarla.
Serial.print ekleyince hatam neden kayboluyor?
Yazdırma kodu yavaşlattığı için hata zamanlamaya bağlıdır: çok erken yapılan bir okuma, eksik bir öngeçirme (debounce) veya bir kesme ile paylaşılan bir değişken.
Bitmiş bir koddaki hata ayıklama yazdırmalarını bırakmalı mıyım?
Onları silmek yerine yukarıdaki gibi bir DEBUG makrosuyla kapat. Açıkken zaman ve bellek harcarlar, kapalıyken hiçbir şey harcamazlar.
Devam et
Bu sayfadaki bilgiler nereden geliyor
Bunu gerçekten kur
Düzenleyiciyi aç, bir değeri değiştir ve sayının onunla birlikte değiştiğini izle. Kurulacak bir şey yok, hesaba da gerek yok.