إصلاح undefined reference to في Arduino
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
خطأ undefined reference to 'loop' هو خطأ من الرابط. تمت ترجمة الكود، ثم لم يجد الرابط، الذي يجمع القطع المترجمة في برنامج واحد، الكود الخاص باسم يستخدمه البرنامج. في حالة setup أو loop يعني ذلك أن الكود لا يحتوي على دالة بهذا الاسم بالضبط، غالبًا لأنها مكتوبة Loop() أو Setup(). وفي حالة دالة من عندك يعني ذلك أن الدالة أُعلن عنها لكن لم تُكتب قط، أو كُتبت بأنواع معاملات مختلفة عن الإعلان. وفي حالة دالة من مكتبة، فإن ملف .cpp الخاص بالمكتبة ليس ضمن البناء.
يستخدم Mokxi رابط LLVM، الذي يصوغ الخطأ undefined symbol: loop(). الدائرة أعلاه هي LED يومض على الطرف 13. افتحها، وأعد تسمية loop إلى Loop واضغط «تشغيل»: يتوقف البناء مع undefined symbol: loop()، وتذكر لوحة البناء السطر الذي يحتوي على Loop() وتقول «Arduino يستدعي loop()، مكتوبة بهذه الطريقة تمامًا بأحرف صغيرة.»
لا يوجد setup() أو لا يوجد loop()
The Arduino core has the program’s real starting point, main(), and it calls setup() once and then loop() forever. So every sketch needs both, even when one of them has nothing to do. Leave one out and nothing is wrong in the sketch itself, which is why the compiler is happy and the linker is not. A sketch with only setup() stopped with undefined symbol: loop(), and the build tab said "The sketch has no loop() function. Every Arduino sketch needs both setup() and loop()." An empty void loop() { } is enough.
كود فارغ يفشل بالاثنين معًا: undefined symbol: setup() وundefined symbol: loop(). تقول لوحة البناء في Mokxi «sketch.ino فارغ، فلا يوجد ما يُبنى» بدلًا من تسمية الدالتين، والأمر نفسه لملف لا يُبنى أصلًا، مثل sketch.py، الذي تسميه Python.
void setup() {
pinMode(13, OUTPUT);
digitalWrite(13, HIGH);
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
Loop() وSetup() وأخطاء مشابهة
The names have to match exactly, lower case included. void Loop() is a perfectly good function that nothing calls, so the sketch compiles and the link fails. In a sketch with void Loop() on line 5, Mokxi’s build tab said "sketch.ino line 5 has Loop(), but Arduino calls loop(), spelled exactly that way in lower case. Rename Loop to loop." The same goes for setUp(), Setup() and void loop1().
void setup() {
pinMode(13, OUTPUT);
}
void Loop() {
digitalWrite(13, HIGH);
}دالتك الخاصة: معلن عنها، لكنها غير مكتوبة
إعلان مثل void blinkTimes(int count); يعد بوجود الدالة في مكان ما. استدعِها ولا تكتب جسمها أبدًا، ويفشل الربط: undefined symbol: blinkTimes(int) في Mokxi، وundefined reference to 'blinkTimes(int)' من GCC. تقول لوحة البناء في Mokxi «blinkTimes مستخدمة، لكن كودها ليس في أي ملف من ملفات البناء.»
يأتي الخطأ نفسه عندما يكون الجسم موجودًا لكن بأنواع معاملات مختلفة. مع إعلان يأخذ int ودالة مكتوبة void blinkTimes(byte count)، كان لدى C++ دالتان مختلفتان: التي استدعاها، وتأخذ int ولا جسم لها، وأخرى لم يستدعها أحد. فشل الربط بالخطأ نفسه undefined symbol: blinkTimes(int). اجعل الإعلان والتعريف متطابقين، كلمة بكلمة.
void blinkTimes(int count);
void setup() {
pinMode(13, OUTPUT);
blinkTimes(3);
}
void loop() {
}
void blinkTimes(int count) {
for (int i = 0; i < count; i++) {
digitalWrite(13, HIGH);
delay(200);
digitalWrite(13, LOW);
delay(200);
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
ملف .h بدون .cpp، وextern، وعضو static
تبويب ترويسة sensor.h يعلن عن int readSensor();، دون تبويب .cpp يكتبه، أعطى undefined symbol: readSensor(). الترويسة هي الوعد و.cpp هو الكود: أضف تبويب .cpp، بدايةً بـ #include <Arduino.h> و#include "sensor.h".
السطر extern int threshold; يعني أن المتغيّر مُعرَّف في ملف آخر، وإذا لم يعرّفه أي ملف فسيفشل الربط بالخطأ undefined symbol: threshold. اكتب int threshold = 500; في ملف واحد فقط. وأما static int total; داخل الصنف فهي مجرد تصريح: فشل الربط بالخطأ undefined symbol: Counter::total حتى أضاف سطر واحد خارج الصنف، int Counter::total = 0;، فعرّفها.
تبويب .c و extern "C"
الكود هو C++، وC++ تضيف أنواع معاملات الدالة إلى الاسم الذي تمرّره إلى الرابط. أما تبويب .c فيُترجم كـ C، وهي لا تفعل ذلك. لذا فإن ملف mathutil.c الذي يكتب int addTwo(int a, int b)، مع ملف mathutil.h يصرّح به فقط، تتم ترجمته بنجاح ثم يفشل بالخطأ undefined symbol: addTwo(int, int). الكود موجود تحت اسمه C العادي، والكود يطلب اسم C++. السطر التالي من الرابط، >>> referenced by sketch.ino:5، يحدّد السطر الذي يستدعيها، وتقول لوحة البناء في Mokxi: "addTwo مستخدمة، لكن كودها ليس في أي ملف من ملفات البناء."
هناك حلّان، وقد نجح كلاهما. أعِد تسمية التبويب إلى mathutil.cpp ليصبح الطرفان C++، أو غلّف تصريحات الترويسة بـ extern "C"، كما أدناه، ليطلب الكود الاسم بنمط C. أبقِ سطري #ifdef __cplusplus: فـ C لا تعرف extern "C"، وتبويب .c يتضمّن الترويسة نفسها.
#pragma once
#ifdef __cplusplus
extern "C" {
#endif
int addTwo(int a, int b);
#ifdef __cplusplus
}
#endifمكتبة ملف .cpp الخاص بها ليس في البناء
المكتبة عادةً هي ملف .h وملف .cpp. إذا نسخت ملف .h فقط إلى الكود، أو ثبّتّ مكتبة يدويًا في مجلد خاطئ، فإن كل استدعاء لها يصبح undefined reference، رغم أن الكود يُترجم بنجاح. في Arduino IDE، ثبّتها من Library Manager أو عبر Sketch ثم Include Library ثم Add .ZIP Library. أما في Mokxi، فخيار Add library يقبل ملف .zip للمكتبة، أو ملفّي .h و.cpp معًا.
افتح هذه الدائرة في المحرر. Arduino Uno: وميض، جاهزة للتعطيل، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة ثم شغّلها مرة أخرى.
افتح الدائرةالأسئلة
ماذا يعني "undefined reference to setup" في Arduino؟
الكود لا يحتوي على دالة setup()، أو يكتبها بشكل مختلف مثل Setup(). كل كود يحتاج إلى setup() وloop() بحروف صغيرة، حتى لو كانت إحداهما فارغة.
هل "undefined reference" خطأ من المترجم؟
لا، بل خطأ من الرابط. تمّت الترجمة بنجاح؛ لكن الرابط لم يجد الكود المقابل لاسم ما لضمّه إلى البرنامج. لذا فإن السطر الذي يذكره غالبًا ليس في كودك أصلًا.
هل "undefined symbol" هو الخطأ نفسه؟
نعم. "undefined reference to" هي صياغة رابط GCC الذي يستخدمه Arduino IDE؛ أما Mokxi فيربط برابط LLVM، الذي يقول "undefined symbol".
دالتي موجودة أمامي، فلماذا يظهر undefined reference؟
الأرجح أن معاملاتها تختلف عن التصريح في الأعلى، مثل byte في أحدهما وint في الآخر. تعتبر C++ هاتين دالتين مختلفتين. اجعل السطرين متطابقين.
واصل
من أين جاءت الحقائق في هذه الصفحة
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.