تعلّم

عصا تحكم Arduino، تُقرأ وتُرسم على ثمانية LED

متوسط

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: رسم أعمدة بعصا التحكممباشر0.000 s 0.00x
اسحب العصا أو اضغطها لتبديل المحورين
مثال رسم الأعمدة على ATmega328P مُحاكى. اسحب العصا لتحريك العمود، واضغط عليها لقراءة المحور الآخر.

وحدة عصا الإبهام الموجودة في كل مجموعة أدوات بداية، KY-023 ونسخها، تبدو كقطعة من ذراع تحكم للألعاب، لكنها في الحقيقة مقاومتان متغيرتان وزر ضغط تحت غطاء واحد. هذا يجعلها من أفضل القطع لتعلم المدخل التماثلي، لأنك تشعر بالرقم يتغير أثناء تحريكها. الدائرة أعلاه هي Arduino Uno يقرأ محورًا واحدًا من العصا ويرسمه كعمود على ثمانية LED، وتعمل الآن في متصفحك بنفس الكود الذي يمكنك قراءته أدناه.

اسحب الغطاء الأسود في مساحة العمل ويتحرك العمود معه. اتركه فيعود نابضًا إلى المنتصف، بأربعة مصابيح مضيئة. اضغط العصا إلى الأسفل مباشرة فينتقل العمود إلى المحور الآخر، وتخبرك الشاشة التسلسلية أيهما تنظر إليه.

ما تحتاجه

  • Arduino Uno
  • وحدة عصا تحكم بمحورين (KY-023 أو ما شابه)
  • ثمانية LED: ثلاثة خضراء وثلاثة صفراء واثنان أحمران
  • ثماني مقاومات بقيمة 220 أوم، واحدة لكل LED
  • لوحة تجارب وأسلاك توصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
VCC في عصا التحكم5 Vيغذّي مساري مقاومة الجهد المتغيرة معًا
GND في عصا التحكمGNDالطرف الآخر لكلا المسارين
VRX في عصا التحكمA0منزلق محور X
VRY في عصا التحكمA1منزلق محور Y
SW في عصا التحكمالطرف 12يتصل بـ GND عند الضغط، والمقاومة الداخلية للسحب للأعلى تُبقيه مرتفعًا
ثمانية LED، كل واحد عبر مقاومة 220 أومالأطراف من 2 إلى 9من اليسار إلى اليمين، الكاثودات إلى GND

ما يوجد داخل وحدة عصا التحكم

كل محور عبارة عن مقاومة جهد متغيرة بقيمة 10 k أحد طرفيها على VCC والآخر على GND ومنزلقها على VRX أو VRY. عند إمالة العصا يتحرك المنزلق، فيرى الطرف جهدًا يقع في مكان ما بين 0 و5 فولت: نحو 2.5 فولت في وضع السكون، وقرب 0 عند أحد طرفي المدى وقرب 5 عند الطرف الآخر. إنها تمامًا دائرة تقسيم الجهد التي تبنيها بمقبض دوّار، لكن مع نابض يعيدها إلى المنتصف.

أما الزر فهو أبسط. الضغط على الغطاء يغلق مفتاحًا من SW إلى الأرضي، ولا شيء غير ذلك. لا توجد مقاومة في معظم الوحدات، لذا يحتاج الطرف إلى مقاومة سحب للأعلى ليقرأ HIGH عندما لا يكون الزر مضغوطًا، واللوحة Uno فيها واحدة مدمجة يشغّلها الكود عبر INPUT_PULLUP. عند الضغط يقرأ LOW.

بما أن المحورين مجرد جهدَين، تعمل الوحدة على لوحة بجهد 3.3 فولت أيضًا. غذِّها من 3.3 V وستقرأ العصا نفسها من 0 إلى 3.3 فولت. على ESP32 يكون المحول باثني عشر بتًا، فيصبح المدى الكامل من 0 إلى 4095 بدلًا من 0 إلى 1023.

قراءتها: analogRead وmap

analogRead(A0) turns the voltage on the pin into a number from 0 to 1023, where 0 is 0 volts and 1023 is the 5 volt reference. A centered stick reads somewhere near 512. The sketch then uses map() to turn that 0 to 1023 range into a number of lamps from 0 to 8, and lights that many LEDs from the left. That really is the whole bar graph: the meter is one line of arithmetic, and the LEDs are only where the answer is written down.

قد تُرجع map() القيمة 8 عند قراءة تساوي بالضبط 1023، وهي رقم يتجاوز آخر فهرس في المصفوفة بواحد، لذا يقيّدها الكود إلى 8 مصابيح. كما أنها لا تطبع على الشاشة التسلسلية إلا عندما يتغير عدد المصابيح، وهذا يحافظ على قابلية قراءة الشاشة بدلًا من تمرير مئات الأسطر المتطابقة في الثانية.

الحلقة، من مثال مقياس الأعمدة
void loop() {
  if (stick.clicked()) {
    useY = !useY;
    Serial.println(useY ? "reading the Y axis" : "reading the X axis");
  }

  int raw = useY ? stick.y() : stick.x();
  int lit = (int)map(raw, 0, 1023, 0, LEDS);
  if (lit > LEDS) {
    lit = LEDS;
  }
  bar(lit);
  delay(40);
}

الدالة المساعدة، ونسخة Arduino البسيطة

يستخدم المثال ملف رأس صغيرًا يأتي مع Mokxi، هو mokxi_joystick.h. لا سحر فيه: الدالتان x() وy() هما analogRead على طرفَي المحورين، وpressed() هي digitalRead على SW مقارنةً بـ LOW، وclicked() تصبح true مرة واحدة عند كل ضغطة، عند الحافة، حتى لا ينعكس المحور مرارًا عند الاستمرار في الضغط على العصا.

على لوحة Uno حقيقية دون ذلك الملف، اكتب الأشياء الثلاثة نفسها بنفسك: الدالة pinMode(12, INPUT_PULLUP) في setup()، وanalogRead(A0) وanalogRead(A1) للمحورين، واحفظ حالة الزر الأخيرة حتى لا تتصرّف إلا عند انتقالها من HIGH إلى LOW. بقية الكود كود Arduino قياسي ويعمل دون تغيير.

يحتوي الملف أيضًا على الدالتين dx() وdy()، اللتين تقيسان من المكان الذي كانت العصا تستقر فيه عند تشغيل begin() وتتجاهلان منطقة سكون صغيرة حوله. استخدمهما لتوجيه لعبة أو روبوت، حيث يجب أن تُعتبر العصا التي تستقر عند 519 بدلًا من 512 ساكنةً. يستخدم مقياس الأعمدة القراءة الخام عمدًا، لأن نصف المصابيح يجب أن يضيء عندما تكون العصا في المنتصف.

جرّبه في المحرر

افتح الدائرة وغيّر LEDS وقائمة الأطراف لاستخدام أربع مصابيح فقط. سيتحرك المقياس الآن بخطوات أكبر، لأن map() تقسم المدى نفسه إلى قطع أقل.

ثم اصنع مؤشر اتجاه بدلًا من عمود: أضئ المصباح في الموضع lit فقط بدلًا من كل مصباح قبله. إنه تغيير حرف واحد في الدالة bar()، من i < lit إلى i == lit.

أخيرًا، أضف محرك سيرفو على الطرف 10 وأرسل إليه map(raw, 0, 1023, 0, 180). أصبحت العصا الآن تقود محرك سيرفو، وهذه بداية رأس تحريك أفقي ورأسي أو ذراع روبوت.

أخطاء شائعة

نسيان مقاومة السحب على SW. بدون INPUT_PULLUP يبقى طرف الزر عائمًا ويقرأ ضغطات عشوائية، غالبًا من مجرد لمس الأسلاك.

توقّع القيمة 512 بالضبط في وضع السكون. العصي الحقيقية تستقر على بعد بضعة أرقام من المنتصف في الاتجاهين، وكل محور يستقر بشكل مختلف. قِس وضع السكون عند بدء التشغيل، أو استخدم منطقة سكون.

تبديل VRX وVRY، أو اكتشاف أن أحد المحورين يعمل بالاتجاه المعاكس. كلاهما طبيعي: الوحدات تُركّب باتجاهات مختلفة. بدّل الطرفين في الكود أو اعكس القراءة بـ 1023 - raw.

عدم وضع مقاومات على LED. كل LED يحتاج إلى مقاومة 220 أوم خاصة به لإبقاء التيار عند مستوى آمن للطرف.

افتح هذه الدائرة في المحرر. لوحة Arduino Uno: مقياس أعمدة بعصا تحكم، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها من جديد.

افتح الدائرة

الأسئلة

كيف أوصّل عصا تحكم بـ Arduino؟

VCC إلى 5 V، وGND إلى GND، وVRX وVRY إلى طرفين تناظريين مثل A0 وA1، وSW إلى أي طرف رقمي مع تشغيل مقاومة السحب الداخلية. اقرأ المحورين بـ analogRead والزر بـ digitalRead.

ما القيم التي تعطيها عصا تحكم Arduino؟

على لوحة Uno يقرأ كل محور من 0 إلى 1023، والوسط قرب 512. على لوحة 12 بت مثل ESP32 يقرأ من 0 إلى 4095. يقرأ الزر LOW عند الضغط وHIGH عند الإفلات.

هل يمكنني استخدام عصا تحكم مع Raspberry Pi Pico؟

نعم، على أطراف ADC: الطرفان GP26 وGP27 للمحورين، وأي طرف آخر للزر. محوّل Pico مُحاكى، لذا تقرأ analogRead العصا ويُبنى ملف عصا التحكم لها.

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

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