تعلّم

إصلاح الخطأ "redefinition of 'void setup()'" وإعادة التعريفات الأخرى

مبتدئ

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: زر و LED، جاهزان لكود ثانٍمباشر0.000 s 0.00x
اضغط على الزر مع الاستمرار
استمر بالضغط على الزر فيضيء LED الموجود على الطرف 13. افتحه، وألصق setup() ثانية و loop() ثانية تحت الكود، ثم اضغط «تشغيل».

الخطأ redefinition of 'void setup()' يعني أن الكود يعرّف setup() مرتين. يحدث هذا في الغالب من لصق مثال ثانٍ تحت الأول، أو من تبويبة ثانية تجلب setup() خاصة بها. لكل كود setup() واحد و loop() واحد بالضبط: انقل أسطر setup() الثانية إلى الأولى، وأسطر loop() الثانية إلى الأولى، واحذف النسخ الفارغة. الرسالة نفسها مع أي اسم آخر، مثل redefinition of 'int ledPin'، تعني أن ذلك الاسم معرّف مرتين.

يترجم Mokxi باستخدام clang، الذي يصوغه redefinition of 'setup' ويضيف ملاحظة، previous definition is here، على التعريف الأول. الدائرة أعلاه زر و LED على Uno: استمر بالضغط على الزر فيضيء LED. في الأسفل، يُلصق كود ثانٍ يطبع الوقت تحت الأول، فيتوقف البناء، ثم يُدمجان في كود واحد يقوم بالمهمتين.

كودان ملصوقان في واحد

ينتهي كود الزر عند السطر 18. ألصق كودًا ثانيًا تحته، بـ setup() خاصة به تفتح المنفذ التسلسلي و loop() خاصة به تطبع الثواني، فتوقف البناء بخطأين: redefinition of 'setup' على السطر 20 و redefinition of 'loop' على السطر 24، مع ملاحظة عند التعريف الأول، على السطرين 9 و 14. تقول تبويبة البناء في Mokxi "يحتوي الكود على دالتي setup()، وغالبًا بسبب لصق مثال ثانٍ تحت الأول. أبقِ setup() واحدة وانقل أسطر الأخرى إليها."

الدمج في معظمه نسخ أسطر من مكان إلى آخر. أسطر الدالتين setup تذهب إلى setup() واحدة. أما الدالتان loop فتحتاجان إلى تفكير إضافي، لأن delay(1000) منسوخةً إلى حلقة الزر تجعل الزر ينتظر حتى ثانية. احسب وقت الطباعة بـ millis() بدلًا من ذلك، فيعمل الاثنان معًا. الكود المدموج في الأسفل أشعل LED أثناء الضغط على الزر وطبع "seconds: 1" و "seconds: 2" و "seconds: 3" في أول ثلاث ثوانٍ ونصف له.

الكودان مدموجان في setup() واحدة و loop() واحدة
const int BUTTON_PIN = 2;
unsigned long lastPrint = 0;

void setup() {
  pinMode(BUTTON_PIN, INPUT_PULLUP);  // from the button sketch
  pinMode(LED_BUILTIN, OUTPUT);
  Serial.begin(9600);                 // from the second sketch
}

void loop() {
  bool pressed = digitalRead(BUTTON_PIN) == LOW;
  digitalWrite(LED_BUILTIN, pressed ? HIGH : LOW);

  if (millis() - lastPrint >= 1000) {  // the second sketch's loop, without delay()
    lastPrint += 1000;
    Serial.print("seconds: ");
    Serial.println(millis() / 1000);
  }
  delay(5);
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

تبويبة ثانية بـ setup() خاصة بها

الكود المقسّم إلى عدة تبويبات .ino يُضم إلى ملف واحد قبل ترجمته: التبويبة الرئيسية أولًا، ثم البقية بالترتيب الأبجدي، في Arduino IDE وفي Mokxi. تبويبة ثانية بـ setup() خاصة بها هي دالتا setup في ملف واحد. مع تبويبة باسم extra.ino تفتح المنفذ التسلسلي، أشار الخطأ إلى السطر 1 من extra.ino، وإلى الملاحظة عند السطر 1 من sketch.ino.

أعطِ الثانية اسمًا خاصًا بها، مثل void setupSerial()، واستدعها من setup() الحقيقية.

التبويبة .cpp مختلفة: تُترجم وحدها، فلا يرى المترجم كلتيهما. لكن الرابط يفعل. رابط GCC يقول multiple definition of 'setup'، ورابط Mokxi يقول duplicate symbol: setup(). والإصلاح هو نفسه.

المتغير نفسه معرّفًا مرتين

السطر int ledPin = 13; ثم int ledPin = 12; في الأسفل هو متغيران باسم واحد، والسطر الثاني يوقف البناء: يقول GCC‏ redefinition of 'int ledPin'، ويقول clang‏ redefinition of 'ledPin'. احذف أحدهما. داخل دالة، يكون السطر الثاني عادة سطرًا أراد تغيير القيمة: int total = 0; ثم int total = analogRead(A0); أعطى redefinition of 'total'. احذف النوع من السطر الثاني، total = analogRead(A0);، فيغيّر المتغير الأول بدل إنشاء آخر.

اسم تستخدمه نواة Arduino بالفعل

تحتوي النواة بالفعل على دوال اسمها delay وrandom وmillis وmap، ولا يمكن أن يحمل متغير عام نفس الاسم. تسبّب السطر int delay = 500; في إيقاف البناء: يقول clang‏ redefinition of 'delay' as different kind of symbol، مع ملاحظة تشير إلى void delay(uint32_t ms); في النواة، ويقول GCC‏ 'int delay' redeclared as different kind of entity (الإصدارات الأقدم تقول symbol). تعرض تبويبة البناء في Mokxi خيار إعادة تسمية المتغير الخاص بك إلى myDelay في كل موضع يستخدمه فيه الكود. أعطى السطر int random = 4; الخطأ نفسه.

هناك اسم يعتمد على اللوحة. المتغير العام unsigned long time = 0; يُبنى بنجاح على لوحة Uno، في Arduino IDE وفي Mokxi، لأن نواة Uno لا تعلن أبدًا دالة مكتبة C‏ time(). أما نواتا ESP32 وESP8266 فتعلمانها في كل كود، لذا على تلك اللوحات يوقف السطر نفسه البناء بالخطأ redefinition of 'time' as different kind of symbol كما يفعل delay. سمِّه lastTime أو startTime، فهذا أوضح على أي حال، وسيُبنى على كل لوحة.

ترويسة مُدرَجة مرتين

التبويبة blinker.h التي تعلن class Blinker { ... }; وتُدرَج مرتين، مباشرة أو عبر ترويسة أخرى، تعلن الصنف مرتين. يقول clang‏ redefinition of 'Blinker' مع ملاحظات بأن الملف أُدرج عدة مرات وبأنه unguarded header; consider using #ifdef guards or #pragma once.

ضع #pragma once في السطر الأول من كل ترويسة تكتبها. مع وجوده، اكتمل بناء المشروع نفسه، بكلا سطري #include وكل شيء.

blinker.h، محمية بحيث لا يفعل تضمين #include الثاني شيئًا
#pragma once

class Blinker {
 public:
  Blinker(int pin) : pin_(pin) {}
  void tick() { digitalWrite(pin_, !digitalRead(pin_)); }
 private:
  int pin_;
};

افتح هذه الدائرة في المحرر. لوحة Arduino Uno: زر وLED، جاهزة لكود ثانٍ، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.

افتح الدائرة

الأسئلة

ماذا يعني "redefinition of void setup()"؟

يحتوي الكود على دالّتي setup()، عادةً لأن مثالًا ثانيًا لُصق تحت الأول أو لأن تبويبة ثانية لديها دالّتها الخاصة. أبقِ setup() واحدة وانقل أسطر الأخرى إليها، وافعل الشيء نفسه مع loop().

كيف أدمج كودي Arduino في كود واحد؟

ضع المتغيرات العامة وأسطر #include لكليهما في الأعلى، وأسطر كلتا دالّتي setup في setup() واحدة، وأسطر كلتا دالّتي loop في loop() واحدة. استبدل أي delay() داخل الحلقات بتوقيت millis()، حتى لا ينتظر أي جزء الآخر.

هل الخطأ "redefinition of 'setup'" هو نفسه؟

نعم. هذه صياغة clang؛ أما GCC الذي يستخدمه Arduino IDE فيقول "redefinition of 'void setup()'". يجري Mokxi الترجمة بـ clang، لذا تعرض تبويبة البناء كلمات clang.

لماذا لا أستطيع تسمية متغير delay أو random؟

لدى نواة Arduino بالفعل دوال بهذين الاسمين، ولا يمكن أن يكون الاسم واحد دالةً ومتغيرًا في آنٍ معًا. اختر اسمًا آخر مثل myDelay أو waitMs.

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.