ESP32 PWM مع ledcAttach و ledcWrite
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
لا تملك ESP32 أطراف PWM ثابتة. يأتي PWM الخاص بها من كتلة اسمها LEDC، وأي طرف لديه مشغّل مخرجات يمكن أن يكون أحد مخرجاتها. منذ الإصدار 3.0 من نواة Arduino ESP32، يقوم استدعاءان بكل شيء: ledcAttach(pin, frequency, bits) يهيّئ الطرف، وledcWrite(pin, duty) يحدد نسبة الفترة التي يكون فيها مرتفعًا. ويعمل analogWrite() أيضًا، فوق العتاد نفسه.
الدائرة أعلاه هي ESP32 DevKit مع مقاومة متغيرة على GPIO 32 و LED على GPIO 4. يقرأ الكود المقبض ويستدعي analogWrite(4, duty)، فيخفّض تدوير المقبض إضاءة الـ LED، وتعرض الشاشة التسلسلية القراءة ودورة التشغيل التي اختارها. في الأسفل ما تفعله استدعاءات LEDC، مقيسة على اللوحة نفسها، وما تغيّر عن نواة 2.x التي ما زالت معظم الدروس تستخدمها.
ledcAttach و ledcWrite
يوصّل الكود أدناه GPIO 4 عند 5000 Hz بدقة 8 بتات، فتتراوح دورة التشغيل من 0 إلى 255، ويكتب 64، أي ربعًا. سلك توصيل من GPIO 4 إلى GPIO 15 يتيح للوحة نفسها قياس مخرجها عبر pulseIn(). طبع «high 50 us, low 150 us»: فترة 200 ميكروثانية، أي 5000 Hz، مرتفعة لربعها.
يعيد ledcAttach() القيمة true عندما يجد قناة ومؤقتًا للطرف، و false عندما لا يجدهما، فتحقق من ذلك. فشل هنا على GPIO 34، أحد أطراف الإدخال فقط، التي لا تملك مشغّل مخرجات أصلًا. الطرف هو الاسم لكل ما يأتي بعده: ledcWrite(4, 128) للنصف، وledcRead(4) لدورة التشغيل، وledcReadFreq(4) للتردد، وledcDetach(4) لإعادة القناة.
const int kLed = 4;
const int kProbe = 15; // a jumper from GPIO 4
void setup() {
Serial.begin(115200);
pinMode(kProbe, INPUT);
if (!ledcAttach(kLed, 5000, 8)) {
Serial.println("ledcAttach failed");
}
ledcWrite(kLed, 64); // 64 of 256: a quarter
delay(5);
Serial.print("high ");
Serial.print(pulseIn(kProbe, HIGH));
Serial.print(" us, low ");
Serial.print(pulseIn(kProbe, LOW));
Serial.println(" us");
}
void loop() {
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
analogWrite مقابل ledcWrite
على ESP32، يوصّل analogWrite(pin, value) الطرف بقناة عند أول استدعاء، بـ 8 بتات و 1000 Hz، ثم يكتب القيمة. مع analogWrite(4, 64) طبع القياس نفسه «high 250 us, low 750 us»: فترة 1 kHz، مرتفعة لربعها. وهو الاستدعاء المناسب لـ LED ولكود يجب أن يُبنى أيضًا لـ Uno.
عندما يهم التردد، اضبطه لكل طرف قبل الكتابة. analogWriteFrequency(4, 5000) وanalogWriteResolution(4, 10)، ثم analogWrite(4, 256)، طبع «high 50 us, low 150 us» من جديد، لأن 256 من 1024 هي الربع. مشغّل محرك أو مروحة أو صافرة تريد عادة ترددها الخاص، ومحرك السيرفو يريد 50 Hz، ولهذا تستخدم معظم دروس ESP32 استدعاءات LEDC مباشرة.
التردد مقابل الدقة
يَعُدّ مؤقّت LEDC نبضات ساعة، والدورة الواحدة تساوي 2 مرفوعة لقوة الدقة من النبضات. على ESP32 الكلاسيكي أسرع ساعة هي ساعة APB بسعة 80 MHz، لذا يجب أن يبقى حاصل ضرب التردد في 2 مرفوعة لقوة عدد البتات أقل من 80 مليونًا (دليل Espressif لميزة LEDC). هذا يسمح بـ 13 بتة عند 5 kHz، و11 بتة عند 20 kHz، و10 بتات عند 40 kHz. اطلب أكثر من ذلك وترفض لوحة ESP32 الحقيقية عملية الربط.
لا يتحقق Mokxi من هذا الحد بعد: فهو يقبل أي تردد وحتى 14 بتة، لذا قد يعمل زوج القيم هنا ويفشل على اللوحة. اختر الزوج من الحساب أعلاه. لِـ LED، تكفي 5 kHz عند 8 بتات. لمحرك لا يصدر صوتًا مزعجًا، استخدم 20 kHz عند 10 بتات أو أقل.
الدالة ledcChangeFrequency(pin, frequency, bits) تعيد ضبط طرف تم ربطه بالفعل، وledcWriteTone(pin, 440) تشغّل موجة مربعة بنسبة تعبئة نصفية، وهكذا يعزف الطنين (buzzer) السلبي نغمة. هنا أعادت القيمة 440، وقُيست النصف العلوي من كل دورة بـ 1130 ميكروثانية، أي نصف دورة بتردد 440 Hz.
كم قناة PWM يحتوي عليها ESP32؟
تقود كل قناة طرفًا واحدًا، والقنوات ذات التردد والدقة نفسيهما تتشارك مؤقّتًا واحدًا. يمنح جدول Espressif لوحة ESP32 الكلاسيكية 16 قناة في مجموعتين، وثماني قنوات لـ S3، وست قنوات لـ C3، ولكل مجموعة أربعة مؤقّتات. الإصدار Core 3.x يوزّعها تلقائيًا؛ والدالة ledcAttachChannel(pin, frequency, bits, channel) تختار قناة عندما تحتاج إلى ذلك.
ينمذج ESP32 الكلاسيكي في Mokxi المجموعة عالية السرعة: ثماني قنوات وأربعة مؤقّتات. عند ربط طرف بعد طرف بتردد 5000 Hz، أعاد الاستدعاء التاسع لـ ledcAttach() القيمة 0 هنا. وعند ربط كل طرف بتردد مختلف، أعاد الخامس القيمة 0، لأن كل تردد يحتاج إلى مؤقّت خاص به. تحتوي لوحة ESP32 الحقيقية على المجموعة الثانية أيضًا، لذلك يصل الكود نفسه إلى ضعف المسافة، والدرس واحد: الأضواء التي تخفت معًا ينبغي أن تتشارك ترددًا واحدًا.
"ledcSetup was not declared in this scope"
هذا هو الخطأ الذي يصادفه الجميع تقريبًا بعد تحديث حزمة لوحات ESP32. أزال الإصدار Core 3.0 الدالتين ledcSetup() وledcAttachPin() ودمجهما في ledcAttach()، وأصبح كل استدعاء LEDC يأخذ الطرف بدلًا من رقم القناة (دليل الانتقال من Espressif من 2.x إلى 3.0). يتوقف الكود المكتوب لـ 2.x في Arduino IDE مع رسالة 'ledcSetup' was not declared in this scope. أما ledcDetachPin() فقد أصبحت ledcDetach().
يقبل Mokxi الصيغتين، لذا يعمل الدرس القديم هنا دون تغيير: أعادت ledcSetup(0, 5000, 8) القيمة 5000، وبعد ledcAttachPin(4, 0) وledcWrite(0, 64) قاس الطرف "high 50 us" كما كان من قبل. هذا تيسير لا تفعله Arduino IDE، لذا انقل الكود إلى الصيغة الجديدة قبل أخذه إلى لوحة. النقل هو ثلاثة أسطر تصبح سطرين: احذف رقم القناة، واربط بالطرف، واكتب بالطرف.
// Core 2.x: by channel
ledcSetup(0, 5000, 8);
ledcAttachPin(4, 0);
ledcWrite(0, 64);
// Core 3.x: by pin
ledcAttach(4, 5000, 8);
ledcWrite(4, 64);افتح هذه الدائرة في المحرر. ESP32 DevKit: مفتاح دوّار يخفّف إضاءة LED على الطرف GPIO 4، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» من جديد.
افتح الدائرةالأسئلة
أي أطراف ESP32 تدعم PWM؟
أي طرف يحتوي على مشغّل مخرج: تصل إشارة LEDC إلى الأرجل عبر مصفوفة GPIO. ليست الأطراف من GPIO 34 إلى 39، فهي للمدخل فقط، والأفضل تجنّب الأطراف من GPIO 6 إلى 11، فهي مخصصة للذاكرة الفلاشية.
كيف أصلح خطأ "ledcSetup was not declared in this scope"؟
لديك Core 3.x وكود مكتوب لـ 2.x. استبدل ledcSetup(channel, freq, bits) وledcAttachPin(pin, channel) بـ ledcAttach(pin, freq, bits)، ومرّر الطرف إلى ledcWrite بدلًا من القناة.
هل أستخدم analogWrite أم ledcWrite على ESP32؟
استخدم analogWrite لِـ LED عند الإعدادات الافتراضية 1 kHz و8 بتات، أو لكود مشترك مع Uno. واستخدم ledcAttach وledcWrite عندما تكون التردد أو الدقة مهمين، كما مع محرك سيرفو أو مشغّل محرك أو جهاز طنين.
لماذا لا تعمل ledcWrite على ESP32 لدي؟
غالبًا لأن كود 2.x يعمل على Core 3.x: الدالة ledcWrite(0, duty) تعني الآن الطرف 0 وليس القناة 0. وإلا فربما فشلت ledcAttach (تحقق من قيمتها المرجعة)، أو أن الطرف للمدخل فقط، أو أن التردد والدقة لا يناسبان ساعة 80 MHz.
أي تردد PWM ينبغي أن أستخدم على ESP32؟
5 kHz عند 8 إلى 13 بتة لِـ LED، و20 kHz عند 11 بتة كحد أقصى للمحركات التي لا تريد سماعها، و50 Hz لمحرك سيرفو، والنغمة نفسها لِلجرس، باستخدام ledcWriteTone.
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.