Öğren

Arduino fonksiyonları: bir kez yaz, her yerden çağır

Ücretsiz kurmaya başla

Ya da tüm dersleri gör.

  • 526parça tezgahta
  • 46kart şu an çalışıyor
  • 1.00xgerçek zamanlı, her kartta
Arduino Uno: üç lamba, bir flaş fonksiyonucanlı0.000 s 0.00x
Çalıştır'a bas ve lambaları izle
flash(pin, times, onMs) bir kez yazılır ve farklı sayılarla üç kez çağrılır.

Fonksiyon, adını yazarak kodun herhangi bir yerinden çalıştırabileceğin, adlandırılmış bir kod bloğudur. void flash(int pin, int times) herhangi bir pini istediğin sayıda yakıp söndüren bir fonksiyondur; böylece her LED için aynı dört satırı kopyalamak yerine flash(13, 1), flash(12, 2) ve flash(11, 3) yazarsın. setup() ve loop() da fonksiyondur; hep onları yazıyordun.

Yukarıdaki devrede 13, 12 ve 11 pinlerinde üç lamba var ve tam olarak o fonksiyonla çalışıyorlar. Çalıştır'a bas. Seri monitör "three lamps, one flash function" yazdırır, sonra "pin 13 flashes 1 times", "pin 12 flashes 2 times" ve "pin 11 flashes 3 times" yazar ve her lamba kendi satırının söylediğini yapar.

Aşağıda bir fonksiyonun biçimi, cevap döndüren fonksiyonlar, bir parametrenin değiştirilmesinin neden çağıranı etkilemediği, fonksiyonların nereye yazılıp yazılamayacağı ve her hataya karşılık gelen hata mesajları var.

Adım adım sürümünü mü istersin? "Write it once" dersi bunu kontrol noktalarıyla anlatıyor.

Dersi aç

Bir fonksiyonun biçimi

Fonksiyonun bir dönüş tipi, bir adı ve parantez içinde parametreleri, sonra süslü parantez içinde gövdesi olur. void flash(int pin, int times, int onMs) içinde void hiçbir şey döndürmediğini, flash ad olduğunu ve üç int, çağıranın ona vermesi gereken sayılardır. İçeride pin, times ve onMs, çağıranın geçirdiği değerleri tutan sıradan değişkenlerdir.

Onun sonundaki iki küçük fonksiyon ise bir iş yapmak yerine bir soruya cevap verir. lampFor(round) bir tur için pini döndürür ve timesFor(round) kaç kez flaş yapılacağını döndürür; loop() cevaplarını kullanır. return round + 1; ifadesini return round + 2; olarak değiştir ve her lamba bir kez daha flaş yapar.

firmware/uno/examples/cppfunc (yukarıda çalışan fonksiyonlar)
void flash(int pin, int times, int onMs) {
  for (int i = 0; i < times; i++) {
    digitalWrite(pin, HIGH);
    delay(onMs);
    digitalWrite(pin, LOW);
    delay(onMs);
  }
}

int lampFor(int round) {
  if (round == 0) return LAMP_A;
  if (round == 1) return LAMP_B;
  return LAMP_C;
}

int timesFor(int round) {
  return round + 1;
}

Bir değer döndürmek

void dışındaki her tip, fonksiyonun o tipte bir değer döndürdüğü anlamına gelir ve bunu return ile yapar. Çağıran onu yazdırabilir, saklayabilir veya bir toplamda kullanabilir. Aşağıda twice(21) 42 yazdırdı.

twice() fonksiyonunun, onu çağıran setup() fonksiyonundan sonra yazıldığına dikkat et. Düz C++'ta bu bir hata sayılır, çünkü derleyici yukarıdan aşağı okur ve henüz twice fonksiyonunu görmemiştir. Arduino IDE, derlemeden önce bir .ino dosyasındaki her fonksiyon için dosyanın en üstüne sessizce bir bildirim ekler ve Mokxi de aynısını yapar, yani kodunda sıralamanın önemi yoktur.

Cevap veren bir fonksiyon
void setup() {
  Serial.begin(9600);
  Serial.println(twice(21));
}

void loop() {
}

int twice(int x) {
  return x * 2;
}

Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.

Parametreler kopyadır

Parametre, çağıranın geçirdiği şeyin bir kopyasıdır. Aşağıdaki addOne(score) kendi kopyasına bir ekler ve onu atar, bu yüzden score sonrasında hâlâ 5 yazdırdı. Çoğu zaman istediğin tam olarak budur: bir fonksiyon değişkenlerini sessizce değiştiremez.

Değiştirmesini istediğinde, tipin sonuna & koy. void addOneRef(int &n) bir referans alır; bu, çağıranın kendi değişkeninin başka bir adla kullanılmasıdır ve addOneRef(score)'dan sonra 6 yazdırdı. Referans ayrıca tek bir fonksiyondan iki cevap almanın yaygın yoludur: minMax(7, 3, lo, hi) ikisini de doldurdu ve "3 7" yazdırdı.

Bir kopya ve bir referans
void addOne(int n) {
  n = n + 1;
}

void addOneRef(int &n) {
  n = n + 1;
}

void setup() {
  Serial.begin(9600);
  int score = 5;
  addOne(score);
  Serial.println(score);
  addOneRef(score);
  Serial.println(score);
}

void loop() {
}

Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.

Fonksiyonlar nereye yazılır, yazılmadığında çıkan hatalar

Fonksiyon, diğer her fonksiyonun dışına, dosyanın en üst düzeyine yazılır; genellikle loop()'dan sonra ya da setup()'ın üstüne. Her birini kısa tut ve ne yaptığını söyleyen bir ad ver, örneğin readTemperature() veya flashError() gibi; böylece loop() bir adım listesi gibi okunmaya başlar. Bir tanesini setup() içine yazarsan derleme durur. Mokxi clang ile derler ve clang'ın sözleri şöyledir: function definition is not allowed here; Arduino IDE'nin GCC'si ise şöyle der: a function-definition is not allowed here before '{' token. Bu neredeyse her zaman yukarıda bir kapanış parantezinin eksik olduğu anlamına gelir, yani derleyici hâlâ setup() içinde olduğunu düşünür. Parantezlerini say.

Değer vaat eden bir fonksiyon, her yolda bir değer döndürmelidir. int f(int x) { if (x > 0) return 1; } derlenir ama şu uyarıyı verir: non-void function does not return a value in all control paths. f(-5) çağırırsan, o sırada orada kalmış ne varsa onu alırsın; burada 1 yazdırdı. Sona bir return ekle, return 0; olsa bile.

Ayrı bir .cpp sekmesindeki fonksiyonlar, bir .ino dosyasının aldığı otomatik bildirimleri almaz. Bir fonksiyonu more.cpp adlı bir sekmeye taşıdık ve kod, use of undeclared identifier 'helper' hatasıyla durdu. more.h gibi bir başlık dosyasına void helper(); bildirimini ekle ve kodun en üstüne #include "more.h" yaz, böylece derlenir.

Bu devreyi düzenleyicide aç. Arduino Uno: üç lamba, bir flaş fonksiyonu, bu sayfanın en üstünde çalıştığı şekliyle kablolanmış. Bir parçayı veya değeri değiştir ve yeniden çalıştır.

Sorular

Arduino'da void ne demek?

Fonksiyonun geriye hiçbir şey vermediğini. void setup() ve void loop() bir iş yapar ve değer döndürmez. Bir soruya cevap veren fonksiyonun ise void yerine int veya float gibi bir türü olur ve return ile biter.

Arduino'da bir fonksiyonu kullanmadan önce bildirmem gerekir mi?

.ino dosyasında gerekmez: Arduino IDE derlemeden önce bildirimleri senin için ekler, Mokxi de öyle yapar, bu yüzden fonksiyon onu çağıran kodun altına yazılabilir. Bir .cpp dosyasında gerekir, genellikle bir başlık dosyasında.

Bir fonksiyondan iki değer nasıl döndürürüm?

İki değişkeni referans ile geçir, türden sonra & koy, ve fonksiyonun içinde onlara değer ata. Ya da ikisini tutan bir struct döndür. Bu sayfadaki minMax() örneği bir en düşük ve bir en yüksek değeri böyle doldurur.

Bir parametreyi değiştirmek değişkenimi neden değiştirmiyor?

Çünkü parametre bir kopyadır. Onu değiştirmek yalnızca kopyayı değiştirir. Fonksiyonun çağıranın değişkenini değiştirmesi gerekiyorsa parametreyi referans olarak bildir, int n yerine int &n.

"a function-definition is not allowed here" ne demek?

Bir fonksiyonun başka bir fonksiyonun içinde tanımlandığını, bunun da neredeyse her zaman yukarıda eksik bir kapanış süslü parantezinden kaynaklandığını. Hatadan önceki fonksiyonu bul ve her { işaretinin } karşılığı olduğunu kontrol et.

Bir Arduino fonksiyonu dizi döndürebilir mi?

Dizi olarak döndüremez. Bir fonksiyon işaretçi döndürebilir ama yerel bir dizinin adresini döndürmek bir hatadır: derleme, address of stack memory associated with local variable 'a' returned uyarısıyla başarılı olur, çünkü fonksiyon bittiğinde dizi yok olmuştur. Diziyi parametre olarak geçir ve doldur, ya da değerleri tutan bir struct döndür.

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.