esp idf
v5.3.1
中文版
ESP-IDF هو إطار عمل التطوير لـ Espressif SoCs المدعومة على أنظمة التشغيل Windows وLinux وmacOS.
يرجى قراءة سياسة الدعم والوثائق لمزيد من المعلومات حول إصدارات ESP-IDF.
برجاء مراجعة تحذيرات نهاية العمر للحصول على معلومات حول إصدارات ESP-IDF مع توقف الدعم.
يوضح الجدول التالي دعم ESP-IDF لـ Espressif SoCs حيث يشير إلى حالة المعاينة والدعم، على التوالي. عادةً ما يكون دعم المعاينة محدودًا بالوقت ومخصصًا للإصدارات التجريبية من الرقائق. يرجى استخدام إصدار ESP-IDF حيث يتم دعم SoC المطلوب بالفعل.
| رقاقة | v5.0 | v5.1 | v5.2 | v5.3 | v5.4 | |
|---|---|---|---|---|---|---|
| ESP32 | ||||||
| ESP32-S2 | ||||||
| ESP32-C3 | ||||||
| ESP32-S3 | إعلان | |||||
| ESP32-C2 | إعلان | |||||
| ESP32-C6 | إعلان | |||||
| ESP32-H2 | إعلان | |||||
| ESP32-P4 | إعلان | |||||
| ESP32-C5 | إعلان | |||||
| ESP32-C61 | إعلان |
هناك أنواع مختلفة من المراجعات لسلسلة من الرقائق. راجع التوافق بين إصدارات ESP-IDF ومراجعات Espressif SoCs للحصول على تفاصيل التوافق بين ESP-IDF ومراجعات الشرائح.
يتم دعم Espressif SoCs التي تم إصدارها قبل عام 2016 (ESP8266 وESP8285) بواسطة RTOS SDK بدلاً من ذلك.
راجع https://idf.espressif.com/ للحصول على روابط للتعليمات التفصيلية حول كيفية إعداد ESP-IDF اعتمادًا على الشريحة التي تستخدمها.
ملحوظة: كل سلسلة SoC وكل إصدار ESP-IDF له وثائقه الخاصة. يرجى مراجعة إصدارات القسم حول كيفية العثور على الوثائق وكيفية التحقق من إصدار محدد من ESP-IDF.
يستخدم ESP-IDF المواقع النسبية كعناوين URL للوحدات الفرعية (.gitmodules). لذا فهم يرتبطون بـ GitHub. إذا تم تشعب ESP-IDF إلى مستودع Git غير الموجود على GitHub، فستحتاج إلى تشغيل أدوات البرنامج النصي/set-submodules-to-github.sh بعد استنساخ git.
يقوم البرنامج النصي بتعيين عناوين URL مطلقة لجميع الوحدات الفرعية، مما يسمح بإكمال git submodule update --init --recursive . في حالة استنساخ ESP-IDF من GitHub، ليست هناك حاجة لهذه الخطوة.
بالإضافة إلى مشروع قالب esp-idf المذكور في "بدء الاستخدام"، يأتي ESP-IDF مع بعض نماذج المشاريع في دليل الأمثلة.
بمجرد العثور على المشروع الذي تريد العمل معه، قم بالتغيير إلى الدليل الخاص به ويمكنك تكوينه وإنشائه.
لبدء مشروعك الخاص بناءً على مثال، انسخ دليل المشروع النموذجي خارج دليل ESP-IDF.
راجع روابط دليل البدء أعلاه للحصول على دليل الإعداد التفصيلي. هذا مرجع سريع للأوامر الشائعة عند العمل مع مشاريع ESP-IDF:
(راجع دليل البدء المذكور أعلاه للحصول على قائمة كاملة بالخطوات المطلوبة مع مزيد من التفاصيل.)
قم بتثبيت تبعيات بناء المضيف المذكورة في دليل البدء.
قم بتشغيل البرنامج النصي للتثبيت لإعداد بيئة البناء. تتضمن الخيارات install.bat أو install.ps1 لنظام التشغيل Windows، و install.sh أو install.fish لقذائف Unix.
قم بتشغيل البرنامج النصي للتصدير على نظام التشغيل Windows ( export.bat ) أو مصدره على نظام Unix ( source export.sh ) في كل بيئة Shell قبل استخدام ESP-IDF.
يقوم idf.py set-target <chip_name> بتعيين هدف المشروع على <chip_name> . قم بتشغيل idf.py set-target بدون أي وسيطات لرؤية قائمة بالأهداف المدعومة.
يفتح idf.py menuconfig قائمة تكوين نصية حيث يمكنك تكوين المشروع.
idf.py build
... سوف يقوم بتجميع التطبيق ومحمل الإقلاع وإنشاء جدول أقسام بناءً على التكوين.
عند انتهاء الإنشاء، سيتم طباعة سطر أوامر لاستخدام esptool.py لوميض الشريحة. ومع ذلك، يمكنك أيضًا القيام بذلك تلقائيًا عن طريق تشغيل:
idf.py -p PORT flash
استبدل PORT باسم المنفذ التسلسلي لديك (مثل COM3 على نظام Windows، /dev/ttyUSB0 على نظام Linux، أو /dev/cu.usbserial-X على نظام MacOS. إذا تم ترك الخيار -p ، فسيحاول idf.py flash فلاش أول منفذ تسلسلي متاح.
سيؤدي هذا إلى تحويل المشروع بأكمله (التطبيق ومحمل الإقلاع وجدول الأقسام) إلى شريحة جديدة. يمكن تكوين إعدادات وميض المنفذ التسلسلي باستخدام idf.py menuconfig .
لا تحتاج إلى تشغيل idf.py build قبل تشغيل idf.py flash ، وسيقوم idf.py flash تلقائيًا بإعادة بناء أي شيء يحتاج إليه.
يستخدم هدف idf.py monitor أداة esp-idf-monitor لعرض الإخراج التسلسلي من Espressif SoCs. تحتوي شاشة esp-idf أيضًا على مجموعة من الميزات لفك تشفير مخرجات الأعطال والتفاعل مع الجهاز. تحقق من صفحة الوثائق للحصول على التفاصيل.
اخرج من الشاشة عن طريق كتابة Ctrl-].
لإنشاء وفلاش ومراقبة الإخراج في مسار واحد، يمكنك تشغيل:
idf.py flash monitor
بعد الوميض الأولي، قد ترغب فقط في إنشاء تطبيقك وتفليشه فقط، وليس أداة تحميل التشغيل وجدول الأقسام:
idf.py app - أنشئ التطبيق فقط.
idf.py app-flash - فلاش التطبيق فقط.
سيقوم idf.py app-flash بإعادة إنشاء التطبيق تلقائيًا في حالة تغيير أي ملفات مصدر.
(في التطوير العادي، ليس هناك جانب سلبي لإعادة تحميل ملفات محمل الإقلاع وجدول الأقسام في كل مرة، إذا لم يتغيرا.)
لا يمسح هدف idf.py flash محتويات الفلاش بالكامل. ومع ذلك، فمن المفيد في بعض الأحيان إعادة ضبط الجهاز إلى حالة المسح تمامًا، خاصة عند إجراء تغييرات على جدول الأقسام أو تحديثات تطبيق عبر الهواء. لمسح الفلاش بالكامل، قم بتشغيل idf.py erase-flash .
يمكن دمج هذا مع أهداف أخرى، على سبيل المثال، سوف يقوم idf.py -p PORT erase-flash flash بمسح كل شيء ثم إعادة تحميل التطبيق الجديد ومحمل الإقلاع وجدول الأقسام.
وثائق الإصدار الأخير: https://docs.espressif.com/projects/esp-idf/. تم إنشاء هذه الوثائق من دليل المستندات لهذا المستودع.
دليل المبتدئين للمفاهيم والموارد الأساسية لـ ESP-IDF
يعد منتدى esp32.com مكانًا لطرح الأسئلة والعثور على موارد المجتمع.
تحقق من قسم المشكلات على جيثب إذا وجدت خطأً أو كان لديك طلب ميزة. يرجى التحقق من المشكلات الموجودة قبل فتح مشكلة جديدة.
إذا كنت مهتمًا بالمساهمة في ESP-IDF، فيرجى مراجعة دليل المساهمات.
