تعلّم

تحكّم بمحرك سيرفو بـ ESP32

مبتدئ

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
ESP32-C3: مسح بمحرك سيرفومباشر0.000 s 0.00x
اضغط لفتحه في المحرر
محرك SG90 على GPIO 4، يمسح من 0 إلى 180 درجة ثم يعود عبر قناة LEDC بتردد 50 Hz.

للتحكم بمحرك سيرفو بـ ESP32، غذِّ المحرك من 5 V، واجمع الأرضيين، وصِل إشارته بطرف GPIO، وأرسل نبضة بعرض من 544 إلى 2400 ميكروثانية خمسين مرة في الثانية. على ESP32 تقوم وحدة LEDC الطرفية بتوليد تلك النبضة عتاديًا: ledcAttach(pin, 50, 14) تهيّئ الإطار و ledcWrite(pin, duty) تضبط الزاوية.

الدائرة أعلاه هي محرك سيرفو من طراز SG90 موصّل بالطرف GPIO 4 على لوحة ESP32-C3، يتحرك من 0 إلى 180 درجة ثم يعود. تعمل في متصفحك على ESP32-C3 مُحاكى، والكود هو نفسه الذي ترفعه إلى اللوحة الحقيقية.

ما تحتاجه

  • لوحة ESP32 (هنا ESP32-C3-DevKitM-1؛ لوحة ESP32 DevKit الكلاسيكية توصَّل بالطريقة نفسها)
  • سيرفو هواة SG90 (أو مشابه)
  • أسلاك توصيل، ولوحة تجارب لمسارات التغذية

التوصيل

القطعة والطرفيتصل بـملاحظة
سلك السيرفو البني (GND)GNDعبر مسار الأرضي في لوحة التجارب
سلك السيرفو الأحمر (VCC)5Vليس 3V3: يحتاج SG90 إلى 4 فولت أو أكثر
سلك السيرفو البرتقالي (الإشارة)GPIO 4أي طرف GPIO حر يمكن أن يعمل كمخرج

الخطوة 1: وصّل التغذية أولًا

لمحرك السيرفو ثلاثة أسلاك. البني (أو الأسود) هو الأرضي، والأحمر هو التغذية، والبرتقالي (أو الأصفر أو الأبيض) هو الإشارة. لوحة ESP32 تعمل على 3.3 فولت، لكن SG90 يحتاج إلى أربعة فولت أو أكثر ليتحرك، لذلك يذهب سلكه الأحمر إلى طرف 5V في اللوحة، الذي يحمل تغذية USB، وليس إلى 3V3. في المحاكي، كما على المنضدة، لا يدور محرك السيرفو على 3.3 فولت.

الأرضي هو السلك الذي ينساه الناس. تُقاس الإشارة بالنسبة إلى أرضي محرك السيرفو نفسه، لذلك يجب أن يتشارك محرك السيرفو وESP32 أرضيًا واحدًا. هنا يتصل كلاهما بمسار الأرضي في لوحة التجارب. إذا غذّيت محرك سيرفو حقيقيًا من مصدر مستقل، فوصل أرضي ذلك المصدر بأرضي اللوحة.

الخطوة 2: افهم النبضة

محرك السيرفو العادي يستمع إلى عرض النبضة، لا إلى دورة التشغيل بمعنى التعتيم. بحسب أرقام مكتبة Arduino Servo، ترسل 544 ميكروثانية القرن إلى أحد الطرفين، و2400 ميكروثانية إلى الآخر، و1472 ميكروثانية إلى المنتصف، وتتكرر كل 20 ميلي ثانية. وبين النبضات يحافظ على آخر زاوية أُمر بها.

لا تزال هذه موجة PWM، لكنها بطيئة، لذا يمكن للطرف المحيطي LEDC في ESP32 توليدها. توليدها بالعتاد أفضل من قلب حالة طرف في حلقة: العرض دقيق، ولا شيء يفعله مقاطعة يمكنه تمديده، والنواة تبقى حرة بين الإطارات.

الإشارة بجهد 3.3 فولت الصادرة من ESP32 تقبلها معظم محركات السيرفو من طراز SG90، لذا لا يحتاج سلك الإشارة عادة إلى محول مستوى، رغم أن محرك السيرفو نفسه يعمل على 5 فولت.

الخطوة 3: الكود، بالشرح

الدالة ledcAttach(SERVO_PIN, 50, 14) تعطي الطرف GPIO 4 إطارًا بتردد 50 هرتز مقسومًا إلى 16384 قسمًا، لذا القسم الواحد يساوي 20000 / 16384، أي حوالي 1.22 ميكروثانية. الدالة writeAngle() تحوّل المدى من 0 إلى 180 درجة إلى المدى من 544 إلى 2400 ميكروثانية، وهو نافذة مكتبة Servo والقيمة الافتراضية لقطعة محرك السيرفو، ثم إلى أقسام: 544 ميكروثانية تساوي 445 قسمًا و2400 تساوي 1966. يأتي الضرب قبل القسمة حتى لا يضيع شيء بالتقريب.

الدالة setup() تضع القرن عند 90 درجة وتنتظر نصف ثانية. ثم الدالة loop() تحركه من 0 إلى 180 بخطوات من خمس درجات، تفصل بينها 40 ميلي ثانية، وتطبع "at 180"، ثم تعيده وتطبع "back at 0". افتح الشاشة التسلسلية لترى السطرين يصلان مع نهاية كل مسحة.

مثال محرك السيرفو لـ ESP32-C3، مع اختصار بسيط
const uint8_t SERVO_PIN = 4;
const uint32_t FRAME_HZ = 50;
const uint8_t FRAME_BITS = 14;
const uint32_t FRAME_US = 1000000UL / FRAME_HZ;   // 20000
const uint32_t FRAME_COUNTS = 1UL << FRAME_BITS;  // 16384
const uint32_t MIN_US = 544;
const uint32_t MAX_US = 2400;

uint32_t countsForMicros(uint32_t us) {
  return (us * FRAME_COUNTS) / FRAME_US;
}

void writeAngle(int degrees) {
  degrees = constrain(degrees, 0, 180);
  uint32_t us = MIN_US + ((MAX_US - MIN_US) * (uint32_t)degrees) / 180;
  ledcWrite(SERVO_PIN, countsForMicros(us));
}

void setup() {
  Serial.begin(115200);
  ledcAttach(SERVO_PIN, FRAME_HZ, FRAME_BITS);
  writeAngle(90);
  delay(500);
}

void loop() {
  for (int angle = 0; angle <= 180; angle += 5) {
    writeAngle(angle);
    delay(40);
  }
  Serial.println("at 180");
  for (int angle = 180; angle >= 0; angle -= 5) {
    writeAngle(angle);
    delay(40);
  }
  Serial.println("back at 0");
}

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

الخطوة 4: أو استخدم مكتبة ESP32Servo

معظم دروس محركات السيرفو لـ ESP32 تستخدم مكتبة ESP32Servo، التي لها الاستدعاءات نفسها كمكتبة Arduino Servo: attach(pin) ثم write(angle). في Mokxi، الملف ESP32Servo.h هو نفس الصنف في Servo.h بالاسم الذي تستخدمه تلك الدروس، لذلك تُترجم أكوادها كما هي. الدالة attach(pin) بلا عروض تستخدم القيم الافتراضية لـ ESP32Servo نفسها، من 544 إلى 2400 ميكروثانية، لذا فإن write(90) تعني 1472 ميكروثانية و90 درجة على محرك السيرفو.

نسخة LEDC أعلاه تستحق المعرفة على أي حال. فهي تُظهر ما تفعله المكتبة من أجلك، ولا تحتاج إلى أي مكتبة، وهي الاستدعاء الذي تلجأ إليه عندما تريد معدل إطارات أو نافذة نبضات لا توفرها المكتبة.

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

افتح الدائرة في المحرر وغيّر الخطوة من 5 إلى 1 درجة والتأخير من 40 إلى 10 ميلي ثانية: تصبح المسحة أنعم وبسرعة قريبة. ثم غيّر MIN_US وMAX_US إلى 1200 و1800. يغطي القرن الآن قوسًا أضيق، وهذه هي الطريقة لتبعد محرك السيرفو عن النهاية الميكانيكية.

انقل سلك الإشارة إلى طرف GPIO آخر وغيّر SERVO_PIN ليطابقه. يمكن لـ LEDC التوجيه إلى أي طرف مخرج، فيتبعه محرك السيرفو. حدد محرك السيرفو لترى خصائصه، بما فيها نافذة النبضات وسرعة دورانه.

أخطاء شائعة

تغذية محرك السيرفو من 3V3. لا يتحرك محرك السيرفو، أو على منضدة حقيقية يرتجف ويتوقف. استخدم 5V، أو مصدر 5 فولت مستقل مع وصل الأرضيين.

استخدام كود لنواة ESP32 القديمة. الدروس المكتوبة للإصدار 2 من نواة Arduino-ESP32 تستدعي ledcSetup() وledcAttachPin() مع رقم قناة. الإصدار 3 استبدلهما بـ ledcAttach(pin, frequency, resolution) وledcWrite(pin, duty)، وهو ما يستخدمه هذا الكود.

توقع أن تغذي اللوحة محرك سيرفو متوقفًا. قد يسحب SG90 الحقيقي بضع مئات من الميلي أمبير عند توقفه، وهذا كافٍ لإعادة تشغيل ESP32 يعمل من USB. المحاكي لا يحاكي تيار التغذية، لذا إذا بنيت هذا فعليًا، أعطِ محرك السيرفو مصدر تغذية خاصًا به.

اختيار دقة خاطئة. عند 8 بت، يحتوي إطار 50 هرتز على 256 عدّة فقط من 78 ميكروثانية لكل منها، فيحصل محرك السيرفو على نحو 13 خطوة عبر مداه كاملًا. أربعة عشر بتًا تعطي نحو 819.

افتح هذه الدائرة في المحرر. ESP32-C3: مسح محرك سيرفو، موصول كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

افتح الدائرة

الأسئلة

أي أطراف ESP32 يمكنها التحكم في محرك سيرفو؟

أي طرف GPIO يمكن أن يكون مخرجًا. يمكن توجيه LEDC إلى أي منها. تجنب الأطراف التي تستخدمها لوحتك للفلاش أو للإقلاع، والتي يشير إليها مخطط الأطراف.

هل يمكنني تغذية SG90 من طرف 3.3 فولت في ESP32؟

لا. يحتاج SG90 إلى نحو 4 إلى 6 فولت ليتحرك. غذّه من 5V أو من مصدر 5 فولت خاص به، وشارك الأرضي مع ESP32. إشارة 3.3 فولت نفسها لا بأس بها.

هل تعمل مكتبة Arduino Servo على ESP32؟

ليست الأصلية، فهي مكتوبة لمؤقتات AVR. مكتبة ESP32Servo لها الاستدعاءات نفسها وهي ما تستخدمه دروس ESP32. في Mokxi يُترجم كل من Servo.h وESP32Servo.h للوحات ESP32.

كم محرك سيرفو يمكن أن يشغّل ESP32 واحد؟

بقدر ما لديه من قنوات LEDC حرة وأطراف مخرج: يحتوي ESP32-C3 على ست قنوات LEDC، ويحتوي ESP32 الكلاسيكي على ست عشرة. للمزيد، أو لتوفير الأطراف، تقود لوحة PCA9685 ستة عشر محرك سيرفو عبر I2C.

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

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