ما تراه
The Checkup is the Circuit Doctor inside Mokxi AI. It reads your wiring and your code together, in your browser, and stays quiet when it is not sure. Open it from Checkup in the serial monitor's bar or on the toolbar (see الفحص الشامل). كل نتيجة هي بطاقة موسومة بعبارة Problem, Check or Tip, with one sentence on what is wrong and a line on what to do. Where a fix is safe there is a button for it, and Ctrl+Z undoes it like any edit.
لكل نتيجة أدناه رمزها القصير بين قوسين. لن تحتاجه أبدًا؛ إنه موجود فقط لتطابق النتيجة مع هذه الصفحة، أو لتقتبسه عندما اكتب إلينا.
الغذاء والتوصيل بالأرضي
- مصدر تغذية موصّل مباشرة بالأرضي (
short_circuit). سلك أو شريط في لوحة التجارب يصل 5V أو 3V3 بـ GND. على لوحة حقيقية يسخّن هذا الأسلاك وقد يتلف منفذ USB. أخرج السلك (زر إزالة هذا السلك يفعل ذلك)، أو انقل القطعة بحيث يقع الطرفان في شريطين مختلفين. صيغة أخرى تقول إن مصدرين مختلفين يتشاركان سلكًا واحدًا: استخدم مصدرًا واحدًا لكل قضيب. - أرضيان غير متصلتين (
ground_not_shared). قطعة تأخذ غذاءها من بطارية أو مصدر تغذية، لكن أرضيها لا يصل إلى GND اللوحة، فلا يعود للإشارة طريق. أبقِ المصدر وأضف سلكًا واحدًا من أرضيه إلى GND اللوحة. زر الإصلاح يرسمه. - وحدة بلا أرضي أو بلا غذاء (
module_no_gnd،module_no_vcc). طرف GND أو VCC فيها غير موصل، أو يذهب إلى مكان ليس أرضيًا أو مصدر تغذية. وصّل GND بـ GND اللوحة، ووصّل VCC بـ 5V أو 3V3، أيهما تطلبه القطعة. - غذاء وحدة على VIN ولا شيء يغذي VIN (
module_on_vin). طرف VIN (ويسمى RAW في بعض اللوحات) هو مدخل منظّم الجهد في اللوحة. لا يحمل جهدًا إلا عند توصيل بطارية أو محوّل به، لا عبر USB. انقل طرف VCC في الوحدة إلى 5V. - قطعة يستخدمها الكود غير موصلة بشيء (
part_not_wired). الكود يخاطبها، لكن لا أحد من أطرافها موصل. وصّل أطراف الغذاء والأرضي والإشارة إلى اللوحة. - وحدة تُغذى من جهد منخفض جدًا (
module_low_supply). غذّ طرف VCC من 5V (أو VIN في ESP32 DevKit). إذا أصبح مخرجها يتأرجح إلى 5 V ويذهب إلى لوحة 3.3 V، أضف مقسم جهد (1 kΩ و 2 kΩ). - 5 V on a 3.3 V pin (
voltage_5v_on_3v3). A 5 V part's output, or a 5 V rail, reaches a pin that takes 3.6 V at most. The simulator carries on, a real board may not. Power the part from 3V3 if it works there (the Move it to 3V3 button does it where it can), or put a divider or a level shifter on that wire. A 3.3 V part on 5 V gets the same finding: power it from 3V3. - مخرج موصّل مباشرة بقضيب تغذية (
output_to_rail). طرف لوحة مضبوط كمخرج يذهب مباشرة إلى GND أو 5V، فيقصر عندما يقوده الكود في الاتجاه الآخر. ضع القطعة، مع مقاومتها، بين الطرف والقضيب. - مخرجان على سلك واحد (
two_outputs). مخرجان يتضاربان عندما يقول أحدهما HIGH والآخر LOW. صِل المخرجات بالمدخلات فقط. - مقاومة متغيرة قد تقصر مصدر التغذية (
pot_short). طرفها الأوسط على 5V أو GND، فعند تدويرها إلى النهاية تصل بينهما. وصّل الطرفين الخارجيين بمصدر التغذية والأرضي، واقرأ الطرف الأوسط.
LED وقطع أخرى
- LED بلا مقاومة (
led_resistor). LED الحقيقية تحترق بدونها. زر الإصلاح يضع مقاومة 220 Ω على التوالي. سلسلة LED موصولة ساقًا بساق تُحسب سلسلة واحدة: مقاومة واحدة في أي مكان فيها تكفي، وانعدامها هو هذه النتيجة، على LED الأقرب إلى الطرف. - المقاومة أكبر من اللازم (
led_dim_resistor). يمر تيار قليل جدًا حتى تكاد LED مطفأة. قد يحمل مشروع من Wokwi هذه القيمة ويبدو سليمًا هناك، لأن Wokwi تضيء LED أيًا كانت مقاومتها. زر الإصلاح يضع قيمة تضيئها. - المقاومة أصغر من اللازم (
led_small_resistor). تيار كثير جدًا يمر عبر LED والطرف. تحقق من الشريط الملون الثالث: 22 Ω و 220 Ω يختلفان هناك فقط. زر الإصلاح يضع 220 Ω. - LED مركّبة بالمقلوب (
led_reversed). أنودها (A، الساق الأطول) على GND، وكاثودها نحو الطرف، مباشرة أو عبر مقاومة أو عبر LED أخرى. اقلبها. زر الإصلاح يبدّل سلكيها. - ساقا LED على شبكة واحدة (
led_shorted). الساقان معًا على GND، أو على طرف واحد، أو مغروزتان في شريط لوحة التجارب نفسه، فلن تضيء LED أبدًا. انقل ساقًا واحدة: A إلى طرفها عبر مقاومة، وC إلى GND. مقاومة بين ساق وGND تُحسب أيضًا: زر الإصلاح ينقل الطرف الآخر للمقاومة إلى طرف حر. - كاثود LED على مصدر التغذية (
led_cathode_to_supply). ساقها القصيرة (C) على 3V3 أو 5V (غالبًا قضيب +) وساقها الطويلة على طرف. لا يرتفع الطرف فوق جهد المصدر، فلن تضيء أبدًا. انقل C إلى GND (قضيب -). زر الإصلاح ينقل ذلك السلك إلى GND اللوحة. LED بـ A على المصدر وC على الطرف، تُضاء بـ LOW، صحيحة وليست هذه الحالة. - مقاومة لا تفعل شيئًا (
resistor_dangling). طرفها موصل بلا شيء، أو الطرفان على الشبكة نفسها، فلا يمر بها تيار. مقاومة LED توضع على التوالي: طرف، مقاومة، أنود LED. حيثما وُصل طرف مباشرة بـ LED بجانبه، ينقل زر الإصلاح ذلك السلك إلى الطرف الحر للمقاومة. مقاومة غير موصلة بشيء إطلاقًا تعطي تلميحًا: وصّلها أو احذفها. - طرف يقود مقاومة فقط إلى GND (
pin_to_ground_resistor). الكود يقود الطرف كمخرج، وقطعتها الوحيدة مقاومة مباشرة إلى GND، فلا شيء يضيء. ضع LED بعد المقاومة: طرف، مقاومة، A، ثم C إلى GND. مقاومة سحب لأسفل على طرف مدخل صحيحة وليست هذه الحالة. - مكثف كهربائي مركّب بالمقلوب (
capacitor_reversed). ساقه المخططة على الجهد الأعلى. المحاكي لا يظهر شيئًا، لكن المكثف الحقيقي يتسرب ويسخن وقد ينفجر. زر الإصلاح يقلبه. - زر لا يغيّر شيئًا (
button_same_side). السلكان على ساقين ملتصقتين دائمًا داخل الزر. انقل سلكًا واحدًا إلى ساق في الجهة الأخرى، أو أدر الزر ربع دورة. زر الإصلاح ينقل سلكًا واحدًا عنك. - محرك أو محرك سيرفو على طرف GPIO (
motor_on_gpio). الطرف يعطي بضعة ميلي أمبير بينما المحرك يريد مئات. غذّ طرف VCC في السيرفو من 5V وأبقِ إشارته فقط على طرف (زر الإصلاح ينقله إلى 5V). قُد محركًا عبر ترانزستور أو مشغّل محركات مثل L298N. - محرك واحد موصول بالاتجاه المعاكس (
motor_reversed). محركان على مشغّل واحد، مع تقاطع سلكي أحد المحركين، فيدير نفس الكود المحركين في اتجاهين متعاكسين فتدور السيارة بدل أن تتقدم بخط مستقيم. بدّل سلكي ذلك المحرك، أو طرفي IN في الكود؛ وزر الإصلاح يبدّل السلكين. المحركات المرسومة متقابلة، مثل جانبي السيارة، يُفترض أن تتقاطع، ويعرف الفحص الشامل ذلك: هناك، محركان موصولان بنفس الطريقة يظهران هذه النتيجة، لأن السيارة تدور في مكانها. - I2C على الأطراف الخاطئة (
i2c_pins). الطرفان SDA و SCL معكوسان، أو ليسا على الأطراف التي تستخدمها اللوحة لـ I2C. تُسمّي النتيجة الأطراف الصحيحة، وزر الإصلاح ينقل الأسلاك أو يبدّلها. - قطعة احترقت أو تجاوزت حدودها (
part_damaged). تُرسم القطعة داكنة، أو محاطة بلون كهرماني إذا نجت مرة واحدة. تذكر النتيجة ما قيس مقارنة بالحد. أصلح السبب، ثم اضغط «إيقاف» ثم «تشغيل»: كل قطعة تبدأ سليمة من جديد.
الأطراف والكود
- الكود والسلك يستخدمان طرفين مختلفين (
pin_mismatch). أزرار الإصلاح تغيّر الرقم في الكود، أو تنقل السلك. - مكتبة تستخدم طرفًا مختلفًا عن السلك (
library_pin). مثل محرك سيرفو موصول بطرف في الكود وموصّل بطرف آخر. اجعل الاثنين متطابقين. - طرف يستخدمه الكود لا شيء عليه (
pin_unwired)، أو قطعة موصولة لا يستخدمها الكود أبدًا (pin_unused). وصّل القطعة بالطرف الذي يستخدمه الكود، أو غيّر الكود. - ينقص
pinMode(pinmode_missing). الطرف المكتوب بـdigitalWriteيبقى مدخلًا، فيضيء LED عليه بضعف أو لا يضيء أبدًا. أضفpinMode(pin, OUTPUT);فيsetup(). pinModeمضبوط بالاتجاه الخاطئ (pinmode_wrong). الكود يكتب على طرف مضبوط كمدخل، أو يقرأ زرًا على طرف مضبوط كمخرج.analogReadعلى طرف بلا مدخل تناظري (analog_pin)، أوanalogWriteعلى طرف بلا PWM (pwm_pin). تُدرج النتيجة الأطراف التي تستطيع ذلك.- زر يترك طرفه عائمًا (
button_floating). لا شيء يثبّت الطرف، فيقرأ قيمًا عشوائية. استخدمINPUT_PULLUPوصّل الزر بـ GND؛ فيقرأ الطرف LOW عند الضغط. صيغة ثانية تقول إن الزر موصول بالتغذية بينماINPUT_PULLUPيثبّت الطرف على HIGH أصلًا: وصّله بـ GND بدلًا من ذلك. - طرف بلا مقاومة سحب داخلية (
pin_no_pull). على ESP32، الأطراف GPIO 34 إلى 39 ليست لها مقاومة سحب، فلا يفعلINPUT_PULLUPشيئًا هناك. أضف مقاومة 10 kΩ، أو انقل الزر إلى طرف لديه مقاومة. - طرف يعمل هنا ولا يعمل على ESP32-S3 حقيقية (
s3_reserved_pin). على لوحات ESP32-S3 ذات PSRAM ثماني (octal، مثل N8R8 و N16R8 التي يشتريها معظم الناس)، تنتمي الأطراف GPIO 35 و 36 و 37 إلى PSRAM، والطرفان GPIO 19 و 20 هما D- و D+ لمنفذ USB. لا توجد PSRAM في Mokxi، فالقطعة أو الكود على تلك الأطراف يعمل هنا، ولا يعمل على لوحة حقيقية. انقله إلى طرف حر مثل 39 وغيّر الطرف في الكود. انظر الـ ESP32-S3-DevKitC-1. - قطعة على الطرف 0 أو 1 (
serial_pin_used). على Uno أو Nano أو Mega أو Pro Mini هذان الطرفان هما RX و TX، موصولان بالشريحة التي ترفع الكود. يعمل في Mokxi، لكن على لوحة حقيقية قد توقف القطعة الرفع وتشوّه الشاشة التسلسلية. انقلها إلى طرف حر وغيّر رقم الطرف في الكود. - وحدة تسلسلية على الطرفين 0 و 1 (
serial_module_upload). نصيحة لا خطأ. على Uno أو Nano أو Pro Mini، تكون TX و RX للوحدة على الطرفين 0 و 1 مشتركين مع USB في Serial. يعمل هذا هنا وعلى اللوحة، لكن على لوحة حقيقية افصل الطرف 0 أثناء الرفع، أو انقل الوحدة إلى طرفين آخرين باستخدام SoftwareSerial. - TX أو RX لوحدة على طرف لا يحمل بيانات (
serial_power_pin). طرف TX أو RX لوحدة (وحدة Bluetooth أو GPS أو GSM مثلًا) موصول بـ IOREF أو RESET أو AREF أو 5V أو 3V3 أو VIN أو GND، فلا يستطيع التخاطب مع اللوحة أبدًا. وصّل طرف TX بطرف RX في اللوحة وطرف RX بطرف TX فيها (الطرفان 0 و 1 على Uno)، أو بطرفين آخرين باستخدام SoftwareSerial.
التسلسلي والتوقيت
- ينقص
Serial.begin(serial_begin). لا يصل شيء إلى الشاشة التسلسلية حتى يبدأ المنفذ. زر الإصلاح يضيفSerial.begin(9600);. - سرعات الباود غير متطابقة أو إحداها غير معتادة (
serial_baud). يتحدث الكود بسرعة والشاشة التسلسلية تستمع بأخرى، فيكون المخرج غير مفهوم: زر الإصلاح يضع سرعة الشاشة في الكود. أو يستخدمSerial.beginسرعة غير قياسية، فستعرض شاشة تسلسلية حقيقية رموزًا غير مفهومة: تقترح النتيجة أقرب سرعة قياسية. - وقت
millis()مخزّن فيint(millis_overflow)، أو فحص وقت يتعطل عند التفافmillis(). خزّن الأوقات فيunsigned long، وقارنmillis() - startبالمدة بدل الجمع. زر الإصلاح يغيّر النوع. - مدة
delay()طويلة قد تفوّت ضغطة زر (delay_button). نصيحة لا خطأ. قِس الوقت بـmillis()وعالج ارتداد الزر.
الدائرة ككل
- تعذّر قراءة الدائرة كما هي مرسومة (
circuit_unreadable). يذكر التفصيل السبب. تراجع عن آخر تغيير، أو احذف السلك أو القطعة التي يسمّيها. - سلك لا يوصل إلى أي مكان (
wire_nowhere). أحد طرفيه يشير إلى طرف غير موجود. يترك التشغيل السلك جانبًا. احذفه، أو ارسمه من جديد. - قطعة لا يعرفها المحاكي (
part_unknown). إذا كانت الصفحة أقدم من القطعة، يجلبها إعادة التحميل ويحفظ عملك. وإلا يتركها التشغيل جانبًا، فأزلها إن كان لا يفترض وجودها. - جزء من الدائرة لم يستقر أبدًا (
circuit_unsettled). ظلت بعض الأسلاك تتقلب دون ما يبطئها، فأمسك بها المحاكي وأكمل التشغيل. قد لا يطابق ما تُظهره تلك القطع دائرة حقيقية. تحقق من قطعتين موصولتين في حلقة، أو رجلي قطعة في صف واحد من لوحة التجارب.
ما زلت عالقًا
اضغط اشرح على نتيجة لتسأل Mokxi AI عنها (يستهلك سؤالًا)، أو انظر لا يضيء شيء لمعرفة الفحوص التي لا يستطيع الفحص الشامل القيام بها. إذا بدت نتيجة خاطئة لدائرتك، راسلنا من /support مع رمزها ورابط للمشروع.