ESP-IDF هو إطار التطوير الرسمي لشريحة ESP32.
راجع أدلة الإعداد للحصول على تعليمات مفصلة لإعداد ESP-IDF:
بالإضافة إلى مشروع قالب esp-idf المذكور في دليل الإعداد، يأتي ESP-IDF مع بعض نماذج المشاريع في دليل الأمثلة.
بمجرد العثور على المشروع الذي تريد العمل معه، قم بالتغيير إلى الدليل الخاص به ويمكنك تكوينه وإنشائه.
make menuconfig
? لرؤية شاشة المساعدة. مفتاح الإدخال يخرج من شاشة المساعدة.Y و N لتمكين (نعم) وتعطيل (لا) عناصر التكوين باستخدام مربعات الاختيار " [*] "? بينما يؤدي تمييز عنصر التكوين إلى عرض تعليمات حول هذا العنصر./ للبحث في عناصر التكوين.بمجرد الانتهاء من التهيئة، اضغط على Escape عدة مرات للخروج وقل "Yes" لحفظ التكوين الجديد عندما يُطلب منك ذلك.
make all
... سوف يقوم بتجميع التطبيق ومحمل الإقلاع وإنشاء جدول أقسام بناءً على التكوين.
عند الانتهاء make all ، سيتم طباعة سطر أوامر لاستخدام esptool.py لوميض الشريحة. ومع ذلك، يمكنك أيضًا القيام بذلك من خلال تشغيل:
make flash
سيؤدي هذا إلى تحويل المشروع بأكمله (التطبيق ومحمل الإقلاع وجدول الأقسام) إلى شريحة جديدة. يمكن تكوين إعدادات وميض المنفذ التسلسلي باستخدام make menuconfig .
لا تحتاج إلى تشغيل make all قبل تشغيل make flash ، فسوف يقوم make flash تلقائيًا بإعادة بناء أي شيء يحتاج إليه.
سيستخدم هدف make monitor Miniterm المثبت بالفعل (جزء من pyserial) لعرض الإخراج التسلسلي من ESP32 على وحدة التحكم الطرفية.
اخرج من miniterm بكتابة Ctrl-].
لفلاش ومراقبة الإخراج في مسار واحد، يمكنك تشغيل:
make flash monitor
بعد الوميض الأولي، قد ترغب فقط في إنشاء تطبيقك وتفليشه فقط، وليس أداة تحميل التشغيل وجدول الأقسام:
make app - إنشاء التطبيق فقط.make app-flash - فلاش التطبيق فقط. سيقوم make app-flash بإعادة إنشاء التطبيق تلقائيًا إذا كان في حاجة إليه.
(في التطوير العادي، ليس هناك جانب سلبي لإعادة تحميل ملفات محمل الإقلاع وجدول الأقسام في كل مرة، إذا لم يتغيرا.)
يدعم ESP-IDF تجميع ملفات متعددة بالتوازي، لذلك يمكن تشغيل جميع الأوامر المذكورة أعلاه كـ make -jN حيث N هو عدد عمليات الإنشاء المتوازية المطلوب تشغيلها (عمومًا، يجب أن يكون N مساويًا أو واحدًا أكثر من عدد نوى وحدة المعالجة المركزية في نظامك.)
يمكن دمج وظائف التصنيع المتعددة في وظيفة واحدة. على سبيل المثال: لإنشاء التطبيق ومحمل الإقلاع باستخدام 5 مهام بالتوازي، ثم قم بتفليش كل شيء، ثم قم بعرض الإخراج التسلسلي من تشغيل ESP32:
make -j5 flash monitor
بمجرد الانتهاء من تجميع مشروعك، سيحتوي دليل "build" على ملف ثنائي باسم مثل "my_app.bin". هذه صورة ثنائية لـ ESP32 يمكن تحميلها بواسطة أداة تحميل التشغيل.
يمكن أن يحتوي فلاش ESP32 الواحد على تطبيقات متعددة، بالإضافة إلى العديد من أنواع البيانات المختلفة (بيانات المعايرة، وأنظمة الملفات، وتخزين المعلمات، وما إلى ذلك). لهذا السبب، يتم وميض جدول الأقسام لتعويض 0x4000 في الفلاش.
كل إدخال في جدول الأقسام له اسم (تسمية)، ونوع (تطبيق، بيانات، أو أي شيء آخر)، ونوع فرعي والإزاحة في الفلاش حيث يتم تحميل القسم.
إن أبسط طريقة لاستخدام جدول الأقسام هي make menuconfig واختيار أحد جداول الأقسام البسيطة المحددة مسبقًا:
في كلتا الحالتين، يتم وميض تطبيق المصنع عند الإزاحة 0x10000. إذا قمت make partition_table فسوف يقوم بطباعة ملخص لجدول الأقسام.
لمزيد من التفاصيل حول جداول الأقسام وكيفية إنشاء أشكال مختلفة، قم بعرض الملف docs/partition-tables.rst .
لا يؤدي هدف make flash إلى مسح محتويات الفلاش بالكامل. ومع ذلك، فمن المفيد في بعض الأحيان إعادة ضبط الجهاز إلى حالة المسح تمامًا، خاصة عند إجراء تغييرات على جدول الأقسام أو تحديثات تطبيق عبر الهواء. لمسح الفلاش بالكامل، قم بتشغيل make erase_flash .
يمكن دمج هذا مع أهداف أخرى، على سبيل المثال، سيؤدي make erase_flash flash إلى مسح كل شيء ثم إعادة تحميل التطبيق الجديد ومحمل الإقلاع وجدول الأقسام.
وثائق الإصدار الأحدث: http://esp-idf.readthedocs.io/. تم إنشاء هذه الوثائق من دليل المستندات لهذا المستودع.
يعد منتدى esp32.com مكانًا لطرح الأسئلة والعثور على موارد المجتمع.
تحقق من قسم المشكلات على جيثب إذا وجدت خطأً أو كان لديك طلب ميزة. يرجى التحقق من المشكلات الموجودة قبل فتح مشكلة جديدة.
إذا كنت مهتمًا بالمساهمة في ESP-IDF، فيرجى مراجعة دليل المساهمات.
