د ESP32 Dev Kitc پراختیا بورډ

د محصول معلومات

مشخصات

  • محصول: ESP32
  • د پروګرام کولو لارښود: ESP-IDF
  • د خپریدو نسخه: v5.0.9
  • جوړونکی: Espressif Systems
  • د خپریدو نیټه: د می 16، 2025

د محصول کارولو لارښوونې

1. پیل کړئ

د ESP32 سره پیل کولو دمخه، ځان د دې سره آشنا کړئ
لاندې

1.1 پیژندنه

د اساسي فعالیتونو او وړتیاوو په اړه زده کړه وکړئ
د ESP32.

1.2 هغه څه چې تاسو ورته اړتیا لرئ

ډاډ ترلاسه کړئ چې تاسو اړین هارډویر او سافټویر لرئ:

  • هارډویر: د اړتیا وړ هارډویر لیست وګورئ
    اجزا.
  • سافټویر: اړین سافټویر نصب کړئ
    اجزا.

1.3 نصب کول

د IDE نصبولو او تنظیم کولو لپاره دا ګامونه تعقیب کړئ
چاپیریال:

  • IDE: د دې لپاره وړاندیز شوی IDE نصب کړئ
    د ESP32 پروګرام کول.
  • لاسي نصب کول: په لاسي ډول تنظیم کړئ
    که اړتیا وي، چاپیریال.

۱.۴ خپله لومړۍ پروژه جوړه کړئ

د ESP32 په کارولو سره خپله لومړنۍ پروژه جوړه او جوړه کړئ.

۱.۵ د ESP-IDF غیر نصب کړئ

که اړتیا وي، زده کړئ چې څنګه له خپل څخه ESP-IDF غیر نصب کړئ
سیسټم

۲. د API حواله

د تفصيلي معلوماتو لپاره د API اسنادو ته مراجعه وکړئ
د غوښتنلیک پروتوکولونه، د تېروتنې اداره کول، او ترتیب
جوړښتونه

ډیری پوښتل شوي پوښتنې (FAQ)

پوښتنه: زه څنګه کولی شم د ESP32 سره عامې ستونزې حل کړم؟

الف: د پروګرام کولو لارښود کې د ستونزو حل کولو برخې ته مراجعه وکړئ
یا د جوړونکي څخه لیدنه وکړئ webد ملاتړ سرچینو لپاره سایټ.

پوښتنه: ایا زه کولی شم د نورو مایکرو کنټرولرونو سره ESP-IDF وکاروم؟

الف: ESP-IDF په ځانګړې توګه د ESP32 لپاره ډیزاین شوی، مګر تاسو ممکن ومومئ
د نورو ایسپریسیف مایکرو کنټرولرونو سره مطابقت.

ایسپیکس اینمکس
د ESP-IDF پروګرام کولو لارښود
د ایسپریسیف سیسټمونو ۵.۰.۹ نسخه د می ۱۶، ۲۰۲۵ خپره شوه

فهرست

فهرست

i

1 پیل کړئ

3

۲.۳.۱ سریزه .

۱.۲ هغه څه چې تاسو ورته اړتیا لرئ .

۱.۲.۱ هارډویر .

۱.۲.۲ سافټویر .

۱.۳ نصب کول .

1.3.1 IDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

۱.۳.۲ لاسي نصبول . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۴

۱.۴ خپله لومړۍ پروژه جوړه کړئ .

۱.۵ د ESP-IDF غیر نصب کړئ .

۲ د API حواله

45

۲.۱ د API کنوانسیونونه .

۲.۱.۱ د مدیریت تېروتنه .

۲.۱.۲ د تشکیلاتو جوړښتونه .

۲.۱.۳ شخصي APIs .

۲.۱.۴ په پخواني کې اجزاampپروژې .

۲.۱.۵ د API ثبات .

۲.۲ د غوښتنلیک پروتوکولونه .

2.2.1 ASIO پورټ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۴۸

۲.۲.۲ د ESP-موډبس .

۲.۲.۳ ESP-MQTT .

۲.۲.۴ ESP-TLS .

۲.۲.۵ د ESP HTTP مراجع .

۲.۲.۶ د ESP سیمه ایز کنټرول .

۲.۲.۷ د ESP سریال غلام لینک .

۲.۲.۸ د ESP x۵۰۹ سند بنډل . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۱

۲.۲.۹ HTTP سرور . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۳

۲.۲.۱۰ HTTPS سرور .

۲.۲.۱۱ د ICMP اکو .

۲.۲.۱۲ د mDNS خدمت . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۵۹

۲.۲.۱۳ ایم بیډ ټي ایل ایس .

۲.۲.۱۴ د IP شبکې طبقه .

۲.۳ بلوتوث API .

۲.۳.۱ بلوتوث® عام .

۲.۳.۲ بلوتوث® ټیټه انرژي .

۲.۳.۳ بلوتوث® کلاسیک .

۲.۳.۴ کنټرولر او HCI .

۲.۳.۵ ESP-BLE-MESH .

۲.۳.۶ د NimBLE پر بنسټ کوربه APIs .

۲.۴ د تېروتنې کوډونو حواله .

۲.۵ د شبکې APIs .

2.5.1 وای فای . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۷۷۶

۲.۵.۲ ایترنیټ .

۲.۵.۳ موضوع .

i

۲.۵.۴ ESP-NETIF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۹۴۲ ۲.۵.۵ د IP شبکې طبقه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۹۷۴ ۲.۵.۶ د غوښتنلیک طبقه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۹۷۶ ۲.۶ پرفیریلز API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۹۷۷ ۲.۶.۱ انلاګ څخه ډیجیټل کنورټر (ADC) د ون شاټ موډ ډرایور. . . . . . . . . . . . . . . . . ۹۷۷ ۲.۶.۲ انلاګ څخه ډیجیټل کنورټر (ADC) دوامداره حالت ډرایور. . . . . . . . . . . . . . . ۹۸۶ ۲.۶.۳ انلاګ څخه ډیجیټل کنورټر (ADC) کیلیبریشن ډرایور. . . . . . . . . . . . . . . . . . . ۹۹۳ ۲.۶.۴ د ساعت ونې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۹۹۷ ۲.۶.۵ ډیجیټل ته انالوګ کنورټر (DAC). . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۰۰۴ ۲.۶.۶ GPIO او RTC GPIO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۰۰۸ ۲.۶.۷ عمومي هدف ټایمر (GPTimer). . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۰۲۷ ۲.۶.۸ انټر انټیګریټډ سرکټ (I2C). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۰۳۹ ۲.۶.۹ انټر-آی سي غږ (I2S). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۰۵۶ ۲.۶.۱۰ LCD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۰۹۰ ۲.۶.۱۱ د LED کنټرول (LEDC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۱۰۷ ۲.۶.۱۲ د موټرو کنټرول د نبض د عرض ماډلیټر (MCPWM). . . . . . . . . . . . . . . . . . . . . ۱۱۲۶ ۲.۶.۱۳ د نبض شمېرونکی (PCNT). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۱۷۸ ۲.۶.۱۴ د ریموټ کنټرول ټرانسیور (RMT). . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۱۹۳ ۲.۶.۱۵ د SD د پورته کولو اړتیاوې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۲۰ ۲.۶.۱۶ د SDMMC کوربه ډرایور. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۲۳ ۲.۶.۱۷ د SD SPI کوربه ډرایور. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۲۹ ۲.۶.۱۸ د SDIO کارت غلام چلوونکی. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۳۴ ۲.۶.۱۹ د سیګما-ډیلټا ماډولیشن (SDM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۴۴ ۲.۶.۲۰ د SPI ماسټر ډرایور. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۴۹ ۲.۶.۲۱ د SPI غلام چلوونکی. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۷۴ ۲.۶.۲۲ ESP32-WROOM-32SE (خوندي عنصر). . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۸۱ ۲.۶.۲۳ د لمس سینسر. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۸۲ ۲.۶.۲۴ دوه تاره اتومات انٹرفیس (TWAI). . . . . . . . . . . . . . . . . . . . . . . . . . ۱۲۹۹ ۲.۶.۲۵ یونیورسل غیر متمرکز رسیدونکی/لیږدونکی (UART). . . . . . . . . . . . . . . . . . ۱۳۱۷ ۲.۷ د پروژې ترتیب. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۳۴۲ ۲.۷.۱ سریزه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۳۴۲ ۲.۷.۲ د پروژې ترتیب مینو. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۳۴۲ ۲.۷.۳ د sdkconfig.defaults کارول. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۳۴۲ ۲.۷.۴ د Kconfig فارمیټ کولو قواعد. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۳۴۳ ۲.۷.۵ د Kconfig انتخابونو شاته مطابقت. . . . . . . . . . . . . . . . . . . . . . . . ۱۳۴۳ ۲.۷.۶ د ترتیب کولو اختیارونو حواله. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۳۴۳ ۲.۸ د چمتو کولو API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۶۴۷ ۲.۸.۱ پروتوکول اړیکه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۶۴۷ ۲.۸.۲ متحد چمتووالی. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۶۶۵ ۲.۸.۳ د وای فای چمتو کول. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۶۶۹ ۲.۹ د ذخیره کولو API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fileد سیسټم ملاتړ . . ۱۷۰۳ ۲.۹.۴ د NVS د برخې جنراتور یوټیلټي . . . . . . . . . . . . . . . . ۱۷۴۴ ۲.۹.۷ سپیفس Fileسیسټم . fileد سیسټم برخه . . . . . . . . . . . . 1803 2.10.1 د اپلیکیشن انځور بڼه . . ۱۸۱۷ ۲.۱۰.۶ د ای فیوز مدیر .
ii

۲.۱۰.۸ ESP HTTPS OTA .view) . . . . . 1988 2.10.13 د حافظې د اندازې تخصیص . . . . . . . . . . . . . 2032 2.10.16 داخلي او بې ثباته APIs . . ۲۰۵۸ ۲.۱۰.۲۱ د هوا له لارې تازه معلومات (OTA) . . . . . . . . . . . . . 2087 2.10.24 د پوزیکس تارونو ملاتړ . . ۲۱۲۱ ۲.۱۰.۲۹ د هیم تخصیص API . . . . . . . . . . . . . . . . . . ۲۱۶۱

3 د هارډویر حواله

2167

۳.۱ د چپ لړۍ پرتله کول .

۳.۱.۱ اړوند اسناد .

۴ د API لارښوونې

2171

۴.۱ د غوښتنلیک کچې تعقیب کتابتون .

4.1.1 اوورview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۷۴

۴.۱.۲ د عملیاتو طریقې .

۴.۱.۳ د ترتیب انتخابونه او انحصارونه . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۱۷۲

۴.۱.۴ د دې کتابتون کارولو څرنګوالی . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2173

۴.۲ د غوښتنلیک د پیل جریان .

4.2.1 لومړی stagای بوټلوډر .

4.2.2 دوهم stagای بوټلوډر .

۴.۲.۳ د اپلیکېشن پیل .

۴.۳ بلوتوث® کلاسیک .

4.3.1 اوورview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۷۴

۴.۴ بلوتوث® ټیټه انرژي .

4.4.1 اوورview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۷۴

۴.۴.۲ پیل وکړئ .

4.4.3 پروfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۱۴

۴.۵ بوټلوډر .

۴.۵.۱ د بوټلوډر مطابقت .

۴.۵.۲ د ننوتلو کچه .

۴.۵.۳ د فابریکې بیا تنظیمول .

۴.۵.۴ د ټیسټ فرم ویئر څخه بوټ کړئ .

۴.۵.۵ بیرته راګرځول .

۴.۵.۶ څارونکی .

۴.۵.۷ د بوټلوډر اندازه .

۴.۵.۸ د ژور خوب څخه چټک بوټ .

۴.۵.۹ دودیز بوټلوډر .

۴.۶ د جوړولو سیسټم .

4.6.1 اوورview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۷۴

۴.۶.۲ د جوړونې سیسټم کارول .

iii

4.6.3 پخوانیampپروژه . File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.5 د CMakeLists اجزا Files . ۲۲۹۵ ۴.۶.۸ د اجزاو اړتیاوې . ۲۳۰۰ ۴.۶.۱۱ د CMake ډیبګ کول . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۰۰ ۴.۶.۱۲ مثالampد اجزاو CMakeLists . . . . . . 2305 4.6.15 د بوټلوډر جوړول . ۲۳۰۶ ۴.۶.۱۸ د اجزاو سره د مخکې جوړو شویو کتابتونونو کارول . File ګلوبینګ او زیاتیدونکي جوړښتونه . . . 2313 4.6.24 د ESP-IDF GNU میک سیسټم څخه مهاجرت .view . . . . . . . . . . . . . . . . . . 2317 4.7.4 کور ډمپ په UART کې چاپ کړئ . . . . . . . . . . . . . . . . . . . . . 2318 4.7.7 د espcoredump.py چلول . . ۲۳۲۲ ۴.۸.۴ د RTC حافظې ته د معلوماتو بارول .ample .view . . . . . . . 2324 4.9.4 ESP_ERROR_CHECK میکرو . . . . . 2325 4.9.7 ESP_GOTO_ON_ERROR میکرو . . . . . . . . 2325 4.9.10 د میکروس مثال وګورئampلږ . . . . . 2327 4.10 ESP-WIFI-MESH .view . . . . . . . . . . . . . . . . . . . 2329 4.10.4 د شبکې جوړول . .
iv

۴.۱۰.۸ فعالیت . . ۲۳۴۹ ۴.۱۱.۳ بلوتوث پیښې .view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۰ ۴.۱۲.۲ د وېرې سمبالونکی. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۰ ۴.۱۲.۳ د ډمپ او بیکټریس راجستر کول. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۱ ۴.۱۲.۴ د GDB سټب. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۳ ۴.۱۲.۵ د RTC واچ ډاګ وخت پای. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۴ ۴.۱۲.۶ د ګورو مراقبې تېروتنې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۴ ۴.۱۲.۷ نورې وژونکې تېروتنې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۶ ۴.۱۳ فلش کوډ کول. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۱۳۴۲ ۲.۷.۱ سریزه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۹ ۴.۱۳.۲ اړونده ای فیوزونه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۵۹ ۴.۱۳.۳ د فلش کوډ کولو پروسه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۶۰ ۴.۱۳.۴ د فلش کوډ کولو ترتیب. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۶۰ ۴.۱۳.۵ ممکنه ناکامۍ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۶۶ ۴.۱۳.۶ د ESP۳۲ فلش کوډ کولو حالت. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۶۸ ۴.۱۳.۷ په کوډ شوي فلش کې د معلوماتو لوستل او لیکل. . . . . . . . . . . . . . . . . . . . . . . ۲۳۶۸ ۴.۱۳.۸ د کوډ شوي فلش تازه کول. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۶۹ ۴.۱۳.۹ د فلش کوډ کول غیر فعالول. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۶۹ ۴.۱۳.۱۰ د فلش کوډ کولو په اړه مهم ټکي. . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۰ ۴.۱۳.۱۱ د فلش کوډ کولو محدودیتونه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۰ ۴.۱۳.۱۲ د فلش کوډ کول او خوندي بوټ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۱ ۴.۱۳.۱۳ پرمختللې ځانګړتیاوې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۱ ۴.۱۳.۱۴ تخنیکي توضیحات. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۳ ۴.۱۴ د هارډویر خلاصون. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۳ ۴.۱۴.۱ معمارۍ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۴ ۴.۱۴.۲ LL (ټيټه کچه) طبقه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۵ ۴.۱۴.۳ HAL (د هارډویر خلاصون طبقه). . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۶ ۴.۱۵ د لوړې کچې مداخلې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۷ ۴.۱۵.۱ د مداخلې کچې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۳۷۷ ۴.۱۵.۲ یادښتونه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TAG ډیبګ کول . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2379 4.16.3 د J غوره کولTAG اډاپټر . . . . . . . . 2380 4.16.6 د ډیبګر پیل کول .ampلږ . . . . . . 2391 4.16.10 اړوند اسناد .view . . . . . . . . . . . . . 2424 4.18 lwIP . ۲۴۳۰ ۴.۱۸.۲ د BSD ساکټونو API . .
v

۴.۱۸.۷ د فعالیت اصلاح کول .
۴.۱۹.۱ DRAM (د معلوماتو RAM) . . . . . . . . . 2441 4.19.4 DROM (په فلش کې زیرمه شوی معلومات) . . . ۲۴۴۳ ۴.۲۰.۳ د اوپن تریډ بارډر روټر .view . . . . . . . . . . . . . . 2445 4.21.4 د بائنري برخې جدول جوړول . . . . . . . . . . . . . . . . . . . . 2449 4.21.7 د برخې کولو وسیله (parttool.py) . . . . . . . . . . 2468 4.23.1 جزوي کیلیبریشن . . ۲۴۶۹ ۴.۲۴ خوندي بوټ .view . . . . . . . . . . . . . . . 2474 4.24.5 د خوندي بوټ فعالولو څرنګوالی . . . . . . . . . . . 2475 4.24.8 د انځورونو لرې لاسلیک کول . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.11 خوندي بوټ او فلش کوډ کول . . . . . . . . . . . 2478 4.25 خوندي بوټ V2 .tages . . . . . . . . . . . . 2480 4.25.5 خوندي پیډینګ . . ۲۴۸۱ ۴.۲۵.۱۰ د خوندي بوټ V2 فعالولو څرنګوالی .
vi

۴.۲۵.۱۳ د انځورونو لرې لاسلیک کول . . . . . . . . . . 2484 4.25.16 خوندي بوټ او فلش کوډ کول . . ۲۴۸۵ ۴.۲۶ د بهرني RAM لپاره ملاتړ . . ۲۴۸۷ ۴.۲۶.۵ د پیل کولو ناکامي. .view . . ۲۴۸۹ ۴.۲۸.۱ IDF فرنټ اینډ – idf.py . . . . . . . . . . . . . . . . . . . . . 2495 4.28.4 د IDF اجزاو مدیر . . . . 2512 4.29.2 د څو وسیلو ازموینې قضیې .tagد ازموینې قضیې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۱۴ ۴.۲۹.۴ د مختلفو هدفونو لپاره ازموینې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۱۴ ۴.۲۹.۵ د ودانۍ واحد ازموینې اپلیکیشن. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۱۵ ۴.۲۹.۶ د چلولو واحد ازموینې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۱۵ ۴.۲۹.۷ د وخت کوډ د کیش معاوضه شوي ټایمر سره. . . . . . . . . . . . . . . . . . . . . . . ۲۵۱۶ ۴.۲۹.۸ ټوکې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۱۷ ۴.۳۰ په لینکس کې د واحد ازموینه. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۱۹ ۴.۳۰.۱ د سافټویر ایمبیډ شوي ازموینې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۱۹ ۴.۳۰.۲ د لینکس کوربه کې د IDF واحد ازموینې. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۰ ۴.۳۱ وای فای ډرایور. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۱ ۴.۳۱.۱ د ESP۳۲ وای فای ځانګړتیاو لیست. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۱ ۴.۳۱.۲ د وای فای اپلیکیشن څنګه ولیکئ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۱ ۴.۳۱.۳ د ESP32 وای فای API د تېروتنې کوډ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۲ ۴.۳۱.۴ د ESP32 وای فای API پیرامیټر پیل کول. . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۲ ۴.۳۱.۵ د ESP۳۲ وای فای پروګرام کولو ماډل. . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۲ ۴.۳۱.۶ د ESP۳۲ وای فای پیښې توضیحات. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۳ ۴.۳۱.۷ د ESP۳۲ وای فای سټیشن عمومي سناریو. . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۶ ۴.۳۱.۸ ESP32 وای فای AP عمومي سناریو. . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۹ ۴.۳۱.۹ د ESP۳۲ وای فای سکین. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۲۹ ۴.۳۱.۱۰ د ESP۳۲ وای فای سټیشن د نښلولو سناریو. . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۳۶ ۴.۳۱.۱۱ د ESP۳۲ وای فای سټیشن سره نښلول کله چې ډیری AP وموندل شي. . . . . . . . . . . . . ۲۵۴۳ ۴.۳۱.۱۲ وای فای بیا وصل کړئ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۴۳ ۴.۳۱.۱۳ د وای فای بیکن وخت پای ته ورسید. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۴۳ ۴.۳۱.۱۴ د ESP۳۲ وای فای ترتیب. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۴۳ ۴.۳۱.۱۵ وای فای ایزی کنیکټ ™ (DPP). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۴۹ ۴.۳۱.۱۶ د بېسیم شبکې مدیریت. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۴۹ ۴.۳۱.۱۷ د راډیو سرچینو اندازه کول. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۴۹ ۴.۳۱.۱۸ د BSS چټک لیږد. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۵۰ ۴.۳۱.۱۹ د ESP32 وای فای د بریښنا سپمولو حالت. . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۵۰ ۴.۳۱.۲۰ د ESP۳۲ وای فای تروپټ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vii

۴.۳۱.۲۱ د وای فای ۸۰۲۱۱ پیکټ لیږل . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.24 د وای فای چینل حالت معلومات . . . . . . . . . . . . . . . . . . . . . . 2557 4.31.27 Wi-Fi QoS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2557 4.31.28 وای فای AMSDU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۵۸ ۴.۳۱.۲۹ د وای فای ټوټه . . . . . . . . . . . . . 2568 4.32.2 خوندي شوي مدیریت چوکاټونه (PMF) . .view . ۲۵۷۴ ۴.۳۳.۴ د همسایه توب ځانګړتیا څنګه وکاروئ . . . . . . . . . . . . . . . . . . 2577 4.34.2 د نه تکثیر وړ جوړښتونو دلیلونه . . . . . . . . . . 2578 4.34.5 د تکثیر وړ جوړښتونه او ډیبګ کول . . . . . . . ۲۵۷۸

۵ د مهاجرت لارښوونې

2579

۵.۱ ESP-IDF ۵.x د مهاجرت لارښود . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۷۹

۵.۱.۱ له ۴.۴ څخه ۵.۰ ته مهاجرت . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۵۷۹

۶ کتابتونونه او چوکاټونه

2611

۶.۱ د کلاوډ چوکاټونه .

۶.۱.۱ د ESP باران جوړونکی .

۶.۱.۲ AWS IoT .

۶.۱.۳ ازور IoT .

۶.۱.۴ د ګوګل IoT کور .

6.1.5 Aliyun IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

۶.۱.۶ جوی لینک IoT .

۶.۱.۷ ټینسنټ آی او ټي .

۶.۱.۸ ټینسینټیون آی او ټي .

۶.۱.۹ بایډو آی او ټي .

۶.۲ د ایسپریس اف چوکاټونه .

۶.۲.۱ د ایسپریسیف آډیو پراختیا چوکاټ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۶۱۲

۶.۲.۲ ESP-CSI .

۶.۲.۳ د ایسپریسیف ډي ایس پي کتابتون .

۶.۲.۴ د ESP-WIFI-MESH پراختیا چوکاټ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۶۱۳

۶.۲.۵ ESP-WHO .

۶.۱.۱ د ESP باران جوړونکی .

۶.۲.۷ د ESP-IoT-حل .

۶.۲.۸ د ESP پروتوکولونه .

viii

۶.۲.۹ ESP-BSP .

د ونډو ۷ لارښود

2615

۷.۱ څنګه ونډه واخلو.

۷.۲ د ونډې اخیستلو دمخه .

۷.۳ د غوښتنې د را ایستلو پروسه .

۷.۴ قانوني برخه .

۷.۵ اړوند اسناد .

۷.۵.۱ د ایسپریسیف IoT پراختیا چوکاټ سټایل لارښود . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۶۱۶

۷.۵.۲ د ESP-IDF پروژې لپاره د پری کمیټ هوک نصب کړئ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۶۲۳

۷.۵.۳ د اسنادو کوډ .

۷.۵.۴ د پخواني جوړولampد . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۲۶۲۹

۷.۵.۵ د API اسنادو نمونه .

۷.۵.۶ د مرسته کوونکي تړون .

۷.۵.۷ د کاپي حق سرلیک لارښود .

۷.۵.۸ د پایټیسټ لارښود سره د ESP-IDF ازموینې .

8 د ESP-IDF نسخې

2645

۸.۱ خپرونې .

۸.۲ زه باید له کومې نسخې سره پیل وکړم؟ .

۸.۳ د نسخې کولو سکیم .

۸.۴ د ملاتړ دورې .

۸.۵ د اوسني نسخې چک کول .

۸.۶ د ګیټ کاري جریان .

۸.۷ د ESP-IDF تازه کول .

۸.۷.۱ د ثبات وړ خپرونې ته تازه کول .

۸.۷.۲ د خپریدو دمخه نسخې ته تازه کول .

۸.۷.۳ ماسټر برانچ ته تازه کول.

۸.۷.۴ د خوشې کولو څانګې ته تازه کول .

9 سرچینې

2651

۹.۱ پلیټ فارم آی او .

۹.۱.۱ پلیټ فارم آی او څه شی دی؟ .

۹.۱.۲ نصب کول .

۹.۱.۳ ترتیب .

۹.۱.۴ درسونه .

۹.۱.۵ د پروژې پخوانیampد . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ۹

۹.۱.۶ راتلونکي ګامونه .

۹.۲ ګټورې اړیکې .

۱۰ د چاپ حقونه او جوازونه

2653

۱۰.۱ د سافټویر د چاپ حقونه .

۱۰.۱.۱ د فرم ویئر اجزا .

۱۰.۱.۲ اسناد .

۱۰.۲ د ROM سرچینې کوډ کاپي حقونه .

10.3 Xtensa libhal MIT جواز . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

10.4 TinyBasic Plus MIT جواز. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

۱۰.۵ د TJpgDec جواز .

11 په اړه

2657

۱۲ د ژبو ترمنځ بدل کړئ

2659

شاخص

2661

شاخص

2661

ix

x

فهرست
دا د ایسپریسیف IoT پراختیا چوکاټ (esp-idf) لپاره اسناد دي. ESP-IDF د ESP32، ESP32-S او ESP32-C لړۍ SoCs لپاره رسمي پراختیا چوکاټ دی. دا سند د ESP32 SoC سره د ESP-IDF کارولو تشریح کوي.

پیل کړئ

د API حواله

د API لارښوونې

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

فهرست

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

څپرکی 1
پیل کړئ
دا سند د دې لپاره دی چې تاسو سره د ایسپریسیف لخوا د ESP32 چپ پر بنسټ د هارډویر لپاره د سافټویر پراختیا چاپیریال تنظیم کولو کې مرسته وکړي. له هغې وروسته، یو ساده مثالampزه به تاسو ته وښیم چې څنګه د مینو تنظیم کولو لپاره ESP-IDF (Espressif IoT پراختیا چوکاټ) وکاروئ، بیا د ESP32 بورډ کې د فرم ویئر جوړولو او فلش کولو لپاره.
یادونه: دا د ESP-IDF د مستحکم نسخې v5.0.9 لپاره اسناد دي. د ESP-IDF نورې نسخې هم شتون لري.
1.1 پیژندنه
ESP32 یو سیسټم دی چې په یوه چپ باندې جوړ شوی دی چې لاندې ځانګړتیاوې سره یوځای کوي: · وای فای (2.4 GHz بینډ) · بلوتوث · دوه ګونی لوړ فعالیت Xtensa® 32-bit LX6 CPU کورونه · د الټرا ټیټ پاور شریک پروسسر · څو پردیي وسایل
د 40 نانو میتر ټیکنالوژۍ لخوا ځواکمن شوی، ESP32 یو پیاوړی، خورا مدغم پلیټ فارم چمتو کوي، کوم چې د اغیزمن بریښنا کارولو، کمپیکټ ډیزاین، امنیت، لوړ فعالیت، او اعتبار لپاره دوامداره غوښتنو پوره کولو کې مرسته کوي. ایسپریسیف د هارډویر او سافټویر لومړني سرچینې چمتو کوي ترڅو د غوښتنلیک پراختیا کونکو سره د ESP32 لړۍ هارډویر په کارولو سره د دوی نظرونو درک کولو کې مرسته وکړي. د ایسپریسیف لخوا د سافټویر پراختیا چوکاټ د وای فای، بلوتوټ، بریښنا مدیریت او ډیری نورو سیسټم ځانګړتیاو سره د انټرنیټ آف-تینګز (IoT) غوښتنلیکونو پراختیا لپاره دی.
1.2 هغه څه چې تاسو ورته اړتیا لرئ
1.2.1 هارډویر
· د ESP32 بورډ. · USB کیبل - USB A / مایکرو USB B. · کمپیوټر چې وینډوز، لینکس، یا macOS چلوي.
یادونه: اوس مهال، ځینې پراختیایي بورډونه د USB ډول C نښلونکو څخه کار اخلي. ډاډ ترلاسه کړئ چې تاسو د خپل بورډ سره د نښلولو لپاره سم کیبل لرئ!
که تاسو د ESP32 رسمي پراختیایي بورډونو څخه یو لرئ چې لاندې لیست شوي دي، تاسو کولی شئ د هارډویر په اړه د نورو معلوماتو لپاره په لینک کلیک وکړئ.
3

لومړی فصل. پیل وکړئ
د ESP32-DevKitS(-R) معرفي کول
دا کارن لارښود د ESP32-DevKitS(-R) په اړه معلومات وړاندې کوي، چې د ESP32 پر بنسټ فلش کولو بورډ دی چې د Espressif لخوا تولید شوی. ESP32-DevKitS(-R) د دوو بورډ نومونو ترکیب دی: ESP32-DevKitS او ESP32-DevKitS-R. S د سپرینګونو لپاره ولاړ دی، او R د WROVER لپاره ولاړ دی.

د ESP32-DevKitS معرفي کول

د ESP32-DevKitS-R معرفي کول

دا سند لاندې مهمې برخې لري: · پیل کول: یو بشپړ معلومات وړاندې کويview د ESP32-DevKitS(-R) او د هارډویر/سافټویر تنظیم کولو لارښوونې د پیل کولو لپاره. · د هارډویر حواله: د ESP32-DevKitS(-R)ns هارډویر په اړه نور تفصيلي معلومات چمتو کوي. · اړوند اسناد: د اړوندو اسنادو لینکونه ورکوي.

پیل کول دا برخه د ESP32-DevKitS(-R) سره د پیل کولو څرنګوالی تشریح کوي. دا د ESP32-DevKitS(-R) په اړه د څو تعارفي برخو سره پیل کیږي، بیا د بورډ فلش کولو برخه د ESP32-DevKitS(-R) ته د ماډل نصبولو، چمتو کولو او په هغې باندې د فرم ویئر فلش کولو لارښوونې چمتو کوي.

اوورview ESP32-DevKitS(-R) د Espressifns فلش کولو بورډ دی چې په ځانګړي ډول د ESP32 لپاره ډیزاین شوی. دا د ESP32 ماډل فلش کولو لپاره کارول کیدی شي پرته لدې چې ماډل د بریښنا رسولو او سیګنال لینونو ته سولډر کړي. د نصب شوي ماډل سره، ESP32-DevKitS(-R) د ESP32-DevKitC په څیر د کوچني پراختیا بورډ په توګه هم کارول کیدی شي.
د ESP32-DevKitS او ESP32-DevKitS-R بورډونه یوازې د پسرلي پنونو په ترتیب کې توپیر لري ترڅو لاندې ESP32 ماډلونه فټ شي.
· ESP32-DevKitS: ESP32-WROOM-32 ESP32-WROOM-32D ESP32-WROOM-32U ESP32-SOLO-1 ESP32-WROOM-32E ESP32-WROOM-32UE
· ESP32-DevKitS-R: ESP32-WROVER (PCB او IPEX) ESP32-WROVER-B (PCB او IPEX) ESP32-WROVER-E ESP32-WROVER-IE
د پورته ماډلونو په اړه د معلوماتو لپاره، مهرباني وکړئ د ESP32 لړۍ ماډلونو ته مراجعه وکړئ.

د اجزاو تفصیل

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

شکل ۱: ESP32-DevKitS – مخکینۍ برخه

د Espressif سیسټمونه

شکل ۲: ESP32-DevKitS-R – مخکینۍ پنځمه برخه
د سند فیډبیک وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

د کلیدي برخې پسرلي پنونه 2.54 ملي متره ښځینه سرلیکونه
د USB-to-UART برج LDO مایکرو-USB نښلونکی/مایکرو USB پورټ EN تڼۍ د بوټ تڼۍ
په ایل ای ډي کې بریښنا

توضیحات په ماډل کې کلیک وکړئ. پنونه به د ماډلونو په کاسټیلیټ شوي سوریو کې فټ شي. دا ښځینه سرلیکونه د دې بورډ کې نصب شوي ماډل پنونو سره وصل دي. د ښځینه سرلیکونو توضیحاتو لپاره، مهرباني وکړئ د سرلیک بلاکونو ته مراجعه وکړئ. یو چپ USB ته UART پل تر 3 Mbps پورې د لیږد نرخونه چمتو کوي.
د 5V څخه تر 3.3V پورې ټیټ غورځیدونکی حجمtagد ای تنظیم کوونکی (LDO).
د USB انٹرفیس. د بورډ لپاره د بریښنا رسولو او همدارنګه د کمپیوټر او بورډ ترمنځ د اړیکو انٹرفیس.
د ری سیٹ تڼۍ.
د ډاونلوډ تڼۍ. د بوټ کیښودل او بیا د EN کیښودل د سیریل پورټ له لارې د فرم ویئر ډاونلوډ کولو لپاره د فرم ویئر ډاونلوډ حالت پیل کوي.
کله چې USB یا د بریښنا رسولو بورډ سره وصل وي نو چالان کیږي.

د بورډ فلش کولو څرنګوالی د خپل ESP32-DevKitS(-R) بریښنا ورکولو دمخه، مهرباني وکړئ ډاډ ترلاسه کړئ چې دا په ښه حالت کې دی او د زیان هیڅ څرګند نښې نلري.
اړین هارډویر · ستاسو د خوښې ESP32 ماډل · USB 2.0 کیبل (معیاري-A څخه مایکرو-B پورې) · کمپیوټر چې وینډوز، لینکس، یا macOS چلوي
د هارډویر تنظیم مهرباني وکړئ د لاندې مرحلو سره سم ستاسو د خوښې ماډل په خپل ESP32-DevKitS(-R) کې نصب کړئ:
· په نرمۍ سره خپل ماډل د ESP32-DevKitS(-R) تختې ته واچوئ. ډاډ ترلاسه کړئ چې ستاسو په ماډل کې کاسټیلیټ شوي سوري د تختې د پسرلي پنونو سره سمون لري.
· خپل ماډل په تخته کې ښکته فشار ورکړئ تر هغه چې کلیک وکړي. · وګورئ چې ایا ټول پسرلي پنونه په کاسټیلیټ شوي سوریو کې داخل شوي دي. که چیرې ځینې غلط ترتیب شوي پسرلي پنونه وي،
د ټویزر په مرسته یې په سوریو کې ځای په ځای کړئ.
د ساوتري جوړښت
غوره طریقه د ESP-IDF پراختیا چوکاټ په ESP32-DevKitS(-R) کې د بائنریونو فلش کولو لپاره غوره لاره چمتو کوي. مهرباني وکړئ پیل ته لاړشئ، چیرې چې د برخې نصب کول به تاسو سره د پراختیا چاپیریال تنظیم کولو کې مرسته وکړي او بیا به د غوښتنلیک فلش کول مخکې له مخکې ترسره کړئ.ample ستاسو په ESP32-DevKitS(-R) کې.
بدیل طریقه د بدیل په توګه، د وینډوز کاروونکي کولی شي د فلش ډاونلوډ وسیلې په کارولو سره بائنری فایلونه فلش کړي. یوازې یې ډاونلوډ کړئ، خلاص یې کړئ، او د ډاک فولډر دننه لارښوونې تعقیب کړئ.
یادونه: ۱. د بائنری فلش کولو لپاره files، ESP32 باید د فرم ویئر ډاونلوډ حالت ته تنظیم شي. دا یا د فلش وسیلې لخوا په اتوماتيک ډول ترسره کیدی شي، یا د بوټ تڼۍ په نیولو او د EN تڼۍ په ټایپ کولو سره. 2. د بائنری فلش کولو وروسته files، د فلش ډاونلوډ وسیله ستاسو د ESP32 ماډل بیا پیلوي او فلش شوی اپلیکیشن په ډیفالټ بوټ کوي.

د بورډ ابعاد او بسته بندي

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل کړئ شکل ۳: د ESP32-DevKitS بورډ ابعاد - شاته

د Espressif سیسټمونه

شکل ۴: د ESP32-DevKitS-R بورډ ابعاد – شاته ۷
د سند فیډبیک وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
پرچون امرونه که تاسو څو امرونه وکړئampسربیره پردې، هر ESP32-DevKitS(-R) په انفرادي کڅوړه کې یا په انټي سټیټیک کڅوړه کې یا په پرچون پلورونکي پورې اړوند هر بسته بندۍ کې راځي. د پرچون پلورونکو امرونو لپاره، مهرباني وکړئ https://www.espressif.com/en/contact-us/get-s ته لاړ شئ.amples.
عمده پلور امرونه که تاسو په لویه کچه امر کوئ، تختې په لویو کارت بورډ بکسونو کې راځي. د عمده پلور امرونو لپاره، مهرباني وکړئ https://www.espressif.com/en/contact-us/sales-questions ته لاړ شئ.
د هارډویر حواله
د بلاک ډیاګرام لاندې د بلاک ډیاګرام د ESP32-DevKitS(-R) اجزا او د دوی اړیکې ښیې.

شکل ۵: ESP32-DevKitS(-R) (د لویولو لپاره کلیک وکړئ)
د بریښنا رسولو اختیارونه بورډ ته د بریښنا چمتو کولو لپاره درې متقابلې ځانګړې لارې شتون لري: · مایکرو USB پورټ، ډیفالټ بریښنا رسولو · 5V او GND سرلیک پنونه · 3V3 او GND سرلیک پنونه
سپارښتنه کیږي چې لومړی انتخاب وکاروئ: مایکرو USB پورټ.

د Espressif سیسټمونه

.

د لیبل سیګنال

L1 3V3 VDD 3V3

L2 EN CHIP_PU د محصول ځانګړتیاوې

د L3 VP SENSOR_VP

د L4 VN سینسر_VN

L5 34

GPIO34

L6 35

GPIO35

L7 32

GPIO32

L8 33

GPIO33

په راتلونکې پاڼه کې دوام لري

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

جدول ۸.۳ د تیرې پاڼې څخه دوام لري

.

د لیبل سیګنال

L9 25

GPIO25

L10 26

GPIO26

L11 27

GPIO27

L12 14

GPIO14

L13 12

GPIO12

L14 GND GND

L15 13

GPIO13

د L16 D2 SD_DATA2 معرفي کول

د L17 D3 SD_DATA3 معرفي کول

د L18 CMD SD_CMD

L19 5V

بهرنی 5V

R1 GND GND

R2 23

GPIO23

R3 22

GPIO22

R4 TX U0TXD

R5 RX U0RXD

R6 21

GPIO21

R7 GND GND

R8 19

GPIO19

R9 18

GPIO18

R10 5

GPIO5

R11 17

GPIO17

R12 16

GPIO16

R13 4

GPIO4

R14 0

GPIO0

R15 2

GPIO2

R16 15

GPIO15

د R17 D1 SD_DATA1 معرفي کول

د R18 D0 SD_DATA0 معرفي کول

د R19 CLK SD_CLK معرفي کول

د سرلیک بلاکونه د سرلیک بلاکونو د انځور لپاره، مهرباني وکړئ د اجزاو توضیحاتو ته مراجعه وکړئ.

اړوند اسناد
· ESP32-DevKitS(-R) سکیماتیک (PDF) · ESP32 ډیټاشیټ (PDF) · ESP32-WROOM-32 ډیټاشیټ (PDF) · ESP32-WROOM-32D او ESP32-WROOM-32U ډیټاشیټ (PDF) · ESP32-SOLO-1 ډیټاشیټ (PDF) · ESP32-WROVER ډیټاشیټ (PDF) · ESP32-WROVER-B ډیټاشیټ (PDF) · د ESP محصول انتخاب کونکی

ESP32-DevKitM-1

دا د کارونکي لارښود به تاسو سره د ESP32-DevKitM-1 سره پیل کولو کې مرسته وکړي او همدارنګه به نور ژور معلومات چمتو کړي.
ESP32-DevKitM-1 د ESP32-MINI-1(1U)-پر بنسټ د پراختیا بورډ دی چې د Espressif لخوا تولید شوی. ډیری I/O پنونه د اسانه مداخلې لپاره په دواړو خواوو کې د پن سرلیکونو ته مات شوي دي. کاروونکي کولی شي یا د جمپر تارونو سره پریفیرالونه وصل کړي یا ESP32-DevKitM-1 په برډ بورډ کې نصب کړي.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

ESP32-DevKitM-1 – مخکی

ESP32-DevKitM-1 – ایزومیټریک

دا سند لاندې مهمې برخې لري: · پیل کول: یو بشپړ معلومات وړاندې کويview د پیل کولو لپاره د ESP32-DevKitM-1 او هارډویر/سافټویر تنظیم کولو لارښوونې. · د هارډویر حواله: د ESP32-DevKitM-1ns هارډویر په اړه نور تفصيلي معلومات چمتو کوي. · اړوند اسناد: اړونده اسنادو ته لینکونه ورکوي.

پیل کول دا برخه د ESP32-DevKitM-1 سره د پیل کولو څرنګوالی تشریح کوي. دا د ESP32-DevKitM-1 په اړه د څو تعارفي برخو سره پیل کیږي، بیا د غوښتنلیک پراختیا پیل برخه د لومړني هارډویر تنظیم کولو او بیا د ESP32-DevKitM-1 ته د فرم ویئر فلش کولو څرنګوالي په اړه لارښوونې چمتو کوي.

اوورview دا یو کوچنی او اسانه پرمختیایی بورډ دی چې ځانګړتیاوې لري:
· ESP32-MINI-1، یا ESP32-MINI-1U ماډل · د USB-to-serial پروګرام کولو انٹرفیس چې د بورډ لپاره بریښنا رسولو هم چمتو کوي · د پن سرلیکونه · د فرم ویئر ډاونلوډ حالت د بیا تنظیم او فعالولو لپاره تڼۍ · یو څو نورې برخې

محتوا او بسته بندي

پرچون امرونه که تاسو څو امرونه وکړئampهمدارنګه، هر ESP32-DevKitM-1 په انفرادي کڅوړه کې یا په انټي سټیټیک کڅوړه کې یا ستاسو د پرچون پلورونکي پورې اړه لري په هر بسته بندۍ کې راځي.
د پرچون پلورنې فرمایشونو لپاره، مهرباني وکړئ https://www.espressif.com/en/contact-us/get-s ته لاړ شئ.amples.

عمده پلور امرونه که تاسو په لویه کچه امر کوئ، تختې په لویو کارت بورډ بکسونو کې راځي. د عمده پلور امرونو لپاره، مهرباني وکړئ https://www.espressif.com/en/contact-us/sales-questions ته لاړ شئ.

د اجزاو توضیحات لاندې انځور او لاندې جدول د ESP32-DevKitM-1 بورډ کلیدي برخې، انٹرفیسونه او کنټرولونه تشریح کوي. موږ د ESP32-MINI-1 ماډل سره بورډ د مثال په توګه اخلوampپه لاندې برخو کې.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

شکل ۶: ESP32-DevKitM-1 – مخکینۍ برخه

کلیدي برخه په بورډ کې ماډل
د 5 V څخه تر 3.3 V پورې د LDO بوټ تڼۍ
د تڼۍ مایکرو-USB پورټ بیا تنظیم کړئ
د USB-to-UART برج 3.3 V بریښنا په LED کې
I/O نښلونکی

تفصیل
د ESP32-MINI-1 ماډل یا ESP32-MINI-1U ماډل. ESP32-MINI-1 د PCB انټینا سره راځي. ESP32-MINI-1U د بهرني انټینا نښلونکي سره راځي. دواړه ماډلونه د 4 MB فلش ان چپ پیکج لري. د جزیاتو لپاره، مهرباني وکړئ د ESP32-MINI-1 او ESP32-MINI-1U ډیټاشیټ وګورئ.
د بریښنا تنظیم کوونکی 5 V ته 3.3 V بدلوي.
د ډاونلوډ تڼۍ. د بوټ کیښودل او بیا د ری سیٹ فشارول د سیریل پورټ له لارې د فرم ویئر ډاونلوډ کولو لپاره د فرم ویئر ډاونلوډ حالت پیل کوي.
د بیا تنظیم تڼۍ
د USB انٹرفیس. د بورډ لپاره د بریښنا رسولو او همدارنګه د کمپیوټر او ESP32 چپ تر مینځ د ارتباط انٹرفیس.
واحد USB-UART برج چپ تر 3 Mbps پورې د لیږد نرخ چمتو کوي.
کله چې USB له بورډ سره وصل شي نو چالان کیږي. د جزیاتو لپاره، مهرباني وکړئ په اړوندو اسنادو کې سکیماتیک وګورئ. ټول موجود GPIO پنونه (د فلش لپاره د SPI بس پرته) په بورډ کې د پن سرلیکونو ته ویشل شوي دي. کاروونکي کولی شي د ESP32 چپ پروګرام کړي ترڅو ډیری دندې فعالې کړي.

د اپلیکیشن پراختیا پیل کړئ مخکې له دې چې خپل ESP32-DevKitM-1 فعال کړئ، مهرباني وکړئ ډاډ ترلاسه کړئ چې دا په ښه حالت کې دی او د زیان هیڅ څرګند نښې نشته.
اړین هارډویر · ESP32-DevKitM-1 · USB 2.0 کیبل (معیاري-A څخه مایکرو-B پورې) · کمپیوټر چې وینډوز، لینکس، یا macOS چلوي
د سافټویر تنظیم کول مهرباني وکړئ پیل ته لاړ شئ، چیرې چې د نصب کولو برخه به تاسو سره د پراختیا چاپیریال تنظیم کولو کې مرسته وکړي او بیا به یو اپلیکیشن فلش کړي.ampخپل ESP32-DevKitM-1 ته لاړ شئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
پاملرنه: د ESP32-DevKitM-1 بورډونه چې د دسمبر 2، 2021 څخه مخکې جوړ شوي دي یو واحد کور ماډل نصب شوی دی. د دې تصدیق کولو لپاره چې تاسو کوم ماډل لرئ، مهرباني وکړئ په PCN-2021-021 کې د ماډل نښه کولو معلومات وګورئ. که ستاسو بورډ یو واحد کور ماډل نصب کړی وي، مهرباني وکړئ د خپلو غوښتنلیکونو فلش کولو دمخه په مینو کنفیګ کې د واحد کور حالت (CONFIG_FREERTOS_UNICORE) فعال کړئ.
د هارډویر حوالې بلاک ډیاګرام لاندې د بلاک ډیاګرام د ESP32-DevKitM-1 اجزا او د دوی متقابل اړیکې ښیې.

شکل ۷: ESP32-DevKitM-1
د بریښنا سرچینه غوره کړئ بورډ ته د بریښنا چمتو کولو لپاره درې متقابلې ځانګړې لارې شتون لري: · مایکرو USB پورټ، ډیفالټ بریښنا رسولو · 5V او GND سرلیک پنونه · 3V3 او GND سرلیک پنونه
خبرداری: · د بریښنا رسولو باید د پورته ذکر شویو انتخابونو څخه یوازې یو په کارولو سره چمتو شي، که نه نو بورډ او/یا د بریښنا رسولو سرچینه زیانمن کیدی شي. · د مایکرو USB پورټ له لارې د بریښنا رسولو سپارښتنه کیږي.

د پن توضیحات لاندې جدول د بورډ په دواړو خواوو کې د پنونو نوم او دنده وړاندې کوي. د پردیي پن ترتیبونو لپاره، مهرباني وکړئ د ESP32 ډیټاشیټ ته مراجعه وکړئ.

نه.

نوم

ډول

1

GND

P

2

3V3

P

فعالیت ځمکه 3.3 V بریښنا رسولو

په راتلونکې پاڼه کې دوام لري

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

جدول ۸.۳ د تیرې پاڼې څخه دوام لري

نه.

نوم

ډول

فعالیت

3

I36

I

GPIO36، ADC1_CH0، RTC_GPIO0

4

I37

I

GPIO37، ADC1_CH1، RTC_GPIO1

5

I38

I

GPIO38، ADC1_CH2، RTC_GPIO2

6

I39

I

GPIO39، ADC1_CH3، RTC_GPIO3

7

RST

I

راګرځول لوړ: فعالول ټیټ: بریښنا بنده ده

8

I34

I

GPIO34، ADC1_CH6، RTC_GPIO4

9

I35

I

GPIO35، ADC1_CH7، RTC_GPIO5

10

IO32

I/O

GPIO32، XTAL_32K_P (32.768 kHz کرسټال اوسیلیټر ان پټ)،

ADC1_CH4، TOUCH9، RTC_GPIO9

11

IO33

I/O

GPIO33, XTAL_32K_N (32.768 kHz کرسټال اوسیلیټر محصول)،

ADC1_CH5، TOUCH8، RTC_GPIO8

12

IO25

I/O

GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0

13

IO26

I/O

GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1

14

IO27

I/O

GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV

15

IO14

I/O

GPIO14، ADC2_CH6، TOUCH6، RTC_GPIO16، MTMS، HSPICLK،

HS2_CLK، SD_CLK، EMAC_TXD2

16

5V

P

د 5V بریښنا رسول

17

IO12

I/O

GPIO12، ADC2_CH5، TOUCH5، RTC_GPIO15، MTDI، HSPIQ،

HS2_DATA2، SD_DATA2، EMAC_TXD3

18

IO13

I/O

GPIO13، ADC2_CH4، TOUCH4، RTC_GPIO14، MTCK، HSPID،

HS2_DATA3، SD_DATA3، EMAC_RX_ER

19

IO15

I/O

GPIO15، ADC2_CH3، TOUCH3، RTC_GPIO13، MTDO، HSPICS0،

HS2_CMD، SD_CMD، EMAC_RXD3

20

IO2

I/O

GPIO2، ADC2_CH2، TOUCH2، RTC_GPIO12، HSPIWP،

HS2_DATA0، SD_DATA0

21

IO0

I/O

GPIO0، ADC2_CH1، TOUCH1، RTC_GPIO11، CLK_OUT1،

EMAC_TX_CLK

22

IO4

I/O

GPIO4، ADC2_CH0، TOUCH0، RTC_GPIO10، HSPIHD،

HS2_DATA1، SD_DATA1، EMAC_TX_ER

23

IO9

I/O

GPIO9، HS1_DATA2، U1RXD، SD_DATA2

24

IO10

I/O

GPIO10، HS1_DATA3، U1TXD، SD_DATA3

25

IO5

I/O

GPIO5، HS1_DATA6، VSPICS0، EMAC_RX_CLK

26

IO18

I/O

GPIO18، HS1_DATA7، VSPICLK

27

IO23

I/O

GPIO23، HS1_STROBE، VSPID

28

IO19

I/O

GPIO19، VSPIQ، U0CTS، EMAC_TXD0

29

IO22

I/O

GPIO22، VSPIWP، U0RTS، EMAC_TXD1

30

IO21

I/O

GPIO21، VSPIHD، EMAC_TX_EN

31

TXD0

I/O

GPIO1، U0TXD، CLK_OUT3، EMAC_RXD2

32

RXD0

I/O

GPIO3، U0RXD، CLK_OUT2

د هارډویر بیاکتنې توضیحات هیڅ پخوانۍ نسخې شتون نلري.
اړوند اسناد
· ESP32-MINI-1 او ESP32-MINI-1U ډیټاشیټ (PDF) · ESP32-DevKitM-1 سکیماتیک (PDF) · ESP32-DevKitM-1 PCB ترتیب (PDF) · ESP32-DevKitM-1 ترتیب (DXF) - تاسو کولی شئ view دا د آټوډیسک سره Viewآنلاین · د ESP32 ډیټاشیټ (PDF) · د ESP محصول انتخاب کونکی
د بورډ لپاره د نورو ډیزاین اسنادو لپاره، مهرباني وکړئ موږ سره په sales@espressif.com اړیکه ونیسئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
د ایکس این ایم ایکس سافټویر
د ESP32 په اړه د ESP-IDF کارولو پیل کولو لپاره، لاندې سافټویر نصب کړئ: · د ESP32 لپاره د کوډ راټولولو لپاره د وسیلې زنځیر · د وسیلو جوړول - د ESP32 لپاره د بشپړ غوښتنلیک جوړولو لپاره CMake او Ninja · ESP-IDF چې په اصل کې د ESP32 لپاره API (د سافټویر کتابتونونه او سرچینې کوډ) او د وسیلې زنځیر چلولو لپاره سکریپټونه لري.

1.3 نصب کول
د ټولو اړینو سافټویرونو د نصبولو لپاره، موږ د دې کار د اسانتیا لپاره ځینې مختلفې لارې وړاندې کوو. د شته انتخابونو څخه یو غوره کړئ.
۱.۳.۱ IDE

یادونه: موږ په کلکه سپارښتنه کوو چې ستاسو د خوښې IDE له لارې ESP-IDF نصب کړئ.
· د ایکلیپس پلگ ان · د VSCode توسیع

1.3.2 لاسي نصب کول
د لاسي طرزالعمل لپاره، مهرباني وکړئ د خپل عملیاتي سیسټم سره سم غوره کړئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
د وینډوز لپاره د اوزار چین معیاري تنظیم
پیژندنه ESP-IDF د ځینې اړینو وسیلو نصبولو ته اړتیا لري ترڅو تاسو د ملاتړ شوي چپس لپاره فرم ویئر جوړ کړئ. د اړتیا وړ وسیلو کې پایتون، ګیټ، کراس کمپیلرونه، CMake او Ninja جوړونې وسایل شامل دي. د دې لپاره پیل کول موږ د کمانډ پرامپټ کارولو ته ځو، مګر د ESP-IDF نصبولو وروسته تاسو کولی شئ د Eclipse Plugin یا بل ګرافیکي IDE د CMake ملاتړ سره وکاروئ. یادونه: محدودیتونه: - د ESP-IDF او ESP-IDF وسیلو د نصبولو لاره باید د 90 حروفو څخه اوږده نه وي. د نصبولو ډیرې اوږدې لارې ممکن د ناکامې جوړونې پایله ولري. - د پایتون یا ESP-IDF د نصبولو لاره باید سپینې ځایونه یا قوسونه ونه لري. - د پایتون یا ESP-IDF د نصبولو لاره باید ځانګړي حروف (غیر ASCII) ونه لري پرته لدې چې عملیاتي سیسټم د oUnicode UTF-8psupport سره تنظیم شوی وي. د سیسټم مدیر کولی شي د کنټرول پینل له لارې ملاتړ فعال کړي - نیټه، وخت، یا د شمیرې بڼې بدل کړئ - اداري ټب - د سیسټم ځای بدل کړئ - د oBeta اختیار وګورئ: د نړۍ په کچه د ژبې ملاتړ لپاره یونیکوډ UTF-8 وکاروئ - سمه ده او کمپیوټر بیا پیل کړئ.
د ESP-IDF وسیلو انسټالر د ESP-IDFns د اړتیاوو د نصبولو لپاره ترټولو اسانه لاره د ESP-IDF وسیلو انسټالرونو څخه یو ډاونلوډ کول دي.

د وینډوز انسټالر ډاونلوډ کړئ
د آنلاین او آفلاین انسټالر لپاره د کارونې قضیه څه ده آنلاین انسټالر خورا کوچنی دی او د ESP-IDF ټولو شته نسخو نصبولو ته اجازه ورکوي. انسټالر به د نصب کولو پروسې په جریان کې یوازې اړین انحصارونه ډاونلوډ کړي په شمول د Git For Windows. انسټالر ډاونلوډ شوي ذخیره کوي files د کیش ډایرکټرۍ کې %userprofile٪. ایسپریسیف
آفلاین انسټالر د شبکې اتصال ته اړتیا نلري. انسټالر ټول اړین انحصارونه لري په شمول د ګیټ فار وینډوز.
د نصبولو اجزا انسټالر لاندې برخې ځای پر ځای کوي:
· ایمبیډډ پایتون · کراس کمپیلرونه · اوپن او سي ډي · سي میک او ننجا جوړونې وسایل · ESP-IDF
انسټالر د ESP-IDF سره د موجوده ډایرکټرۍ بیا کارولو ته هم اجازه ورکوي. وړاندیز شوی ډایرکټرۍ %userpro ده.file%Desktopesp-idf چیرته چې %userprofile% ستاسو د کور لارښود دی.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
د ESP-IDF چاپیریال پیل کول د نصبولو پروسې په پای کې تاسو کولی شئ د Run ESP-IDF PowerShell Environment یا Run ESP-IDF Command Prompt (cmd.exe) اختیار وګورئ. انسټالر به په ټاکل شوي پرامپټ کې ESP-IDF چاپیریال پیل کړي. د ESP-IDF PowerShell چاپیریال چلول:

شکل ۸: د ESP-IDF پاورشیل چاپیریال چلولو سره د ESP-IDF وسیلو سیټ اپ وزرډ بشپړول
د ESP-IDF کمانډ پرامپټ (cmd.exe) چلول:
د کمانډ پرامپټ کارول د پیل کولو پاتې مرحلو لپاره، موږ به د وینډوز کمانډ پرامپټ وکاروو. د ESP-IDF وسیلو انسټالر د ESP-IDF کمانډ پرامپټ لانچ کولو لپاره په سټارټ مینو کې یو شارټ کټ هم رامینځته کوي. دا شارټ کټ د کمانډ پرامپټ (cmd.exe) لانچ کوي او د چاپیریال متغیراتو (PATH، IDF_PATH او نورو) تنظیم کولو لپاره export.bat سکریپټ چلوي. د دې کمانډ پرامپټ دننه، ټول نصب شوي وسایل شتون لري. په یاد ولرئ چې دا شارټ کټ د ESP-IDF وسیلو انسټالر کې غوره شوي ESP-IDF لارښود لپاره ځانګړی دی. که تاسو په کمپیوټر کې ډیری ESP-IDF لارښودونه لرئ (د مثال په توګهampکه نه، د ESP-IDF مختلفو نسخو سره کار کولو لپاره)، تاسو د دوی کارولو لپاره دوه اختیارونه لرئ:
۱. د ESP-IDF Tools Installer لخوا جوړ شوي شارټ کټ یوه کاپي جوړه کړئ، او د نوي شارټ کټ کاري ډایرکټرۍ هغه ESP-IDF ډایرکټرۍ ته بدل کړئ چې تاسو یې کارول غواړئ.
۲. په بدیل سره، cmd.exe چل کړئ، بیا هغه ESP-IDF ډایرکټرۍ ته لاړ شئ چې تاسو یې کارول غواړئ، او export.bat چل کړئ. په یاد ولرئ چې د مخکینۍ اختیار برعکس، دا لاره د Python او Git ته اړتیا لري چې په PATH کې شتون ولري. که تاسو د Python پورې اړوند غلطۍ ترلاسه کړئ یا Git ونه موندل شي، نو لومړی اختیار وکاروئ.
د ESP-IDF په اړه لومړني ګامونه اوس چې ټولې اړتیاوې پوره شوې، راتلونکې موضوع به تاسو ته لارښوونه وکړي چې څنګه خپل لومړی پروژه پیل کړئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ شکل ۹: ESP-IDF پاورشیل

شکل ۱۰: د ESP-IDF د کمانډ پرامپټ (cmd.exe) په چلولو سره د ESP-IDF وسیلو د تنظیم وزرډ بشپړول

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

شکل ۱۱: د ESP-IDF کمانډ پرامپټ

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
دا لارښود به تاسو سره د ESP-IDF کارولو په لومړیو مرحلو کې مرسته وکړي. دا لارښود تعقیب کړئ ترڅو په ESP32 کې یو نوی پروژه پیل کړئ او د وسیلې محصول جوړ کړئ، فلش کړئ، او څارنه وکړئ. یادونه: که تاسو لا تر اوسه ESP-IDF نه دی نصب کړی، مهرباني وکړئ نصب ته لاړ شئ او لارښوونې تعقیب کړئ ترڅو د دې لارښود کارولو لپاره اړین ټول سافټویر ترلاسه کړئ.

پروژه پیل کړئ اوس تاسو د ESP32 لپاره خپل غوښتنلیک چمتو کولو ته چمتو یاست. تاسو کولی شئ د getstarted/hello_world پروژې سره د پخواني څخه پیل وکړئ.amples لارښود په ESP-IDF کې.
مهم: د ESP-IDF جوړونې سیسټم د ESP-IDF یا پروژو ته په لارو کې د ځایونو ملاتړ نه کوي.
پروژه get-started/hello_world د ~/esp ډایرکټرۍ ته کاپي کړئ: cd %userprofile%esp xcopy /e /i %IDF_PATH%examplesget-startedhello_world سلام_نړۍ
یادونه: د پخوانیو لړۍ شتون لريample پروژې په examples لارښود په ESP-IDF کې. تاسو کولی شئ هره پروژه په ورته ډول کاپي کړئ لکه څنګه چې پورته وړاندې شوي او پرمخ وړئ. دا هم ممکنه ده چې پخواني جوړ کړيampپرته له دې چې لومړی یې کاپي کړئ، په خپل ځای کې یې واچوئ.

خپل وسیله وصل کړئ اوس خپل ESP32 بورډ کمپیوټر سره وصل کړئ او وګورئ چې بورډ د کوم سریال پورټ لاندې لیدل کیږي. د سریال پورټ نومونه په وینډوز کې د COM سره پیل کیږي. که تاسو ډاډه نه یاست چې څنګه د سریال پورټ نوم وګورئ، مهرباني وکړئ د بشپړ توضیحاتو لپاره د ESP32 سره د سریال اتصال رامینځته کولو ته مراجعه وکړئ.
یادونه: د پورټ نوم په لاس کې وساتئ ځکه چې تاسو به ورته په راتلونکو ګامونو کې اړتیا ولرئ.

خپله پروژه تنظیم کړئ خپل hello_world ډایرکټرۍ ته لاړ شئ، ESP32 د هدف په توګه وټاکئ، او د پروژې ترتیب کولو یوټیلټي مینو کنفیګ چل کړئ.
د وینډوز سي ډي٪ یوزر پروfile%esphello_world idf.py د هدف ټاکل شوی esp32 idf.py مینو کنفیګ
د یوې نوې پروژې له پرانیستلو وروسته، تاسو باید لومړی د idf.py set-target esp32 سره هدف وټاکئ. په یاد ولرئ چې په پروژه کې موجوده جوړونه او تشکیلات، که کوم وي، به په دې پروسه کې پاک او پیل شي. هدف ممکن د چاپیریال متغیر کې خوندي شي ترڅو دا ګام په بشپړ ډول پریږدئ. د اضافي معلوماتو لپاره د هدف چپ غوره کړئ: set-target وګورئ. که مخکیني ګامونه په سمه توګه ترسره شوي وي، لاندې مینو ښکاري: تاسو دا مینو د پروژې ځانګړي متغیرونو تنظیم کولو لپاره کاروئ، د بیلګې په توګه، د Wi-Fi شبکې نوم او پټنوم، د پروسیسر سرعت، او نور. د مینو کنفیګ سره د پروژې تنظیم کول ممکن د ohello_wordp لپاره پریښودل شي، ځکه چې دا پخوانیample د ډیفالټ ترتیب سره چلیږي.
پاملرنه: که تاسو د ESP32-SOLO-1 ماډل سره ESP32-DevKitC بورډ کاروئ، یا د ESP32-DevKitM-1 بورډ د ESP32-MIN1-1(1U) ماډل سره کاروئ، مهرباني وکړئ د فلش کولو دمخه په مینو کنفیګ کې د واحد کور حالت (CONFIG_FREERTOS_UNICORE) فعال کړئ.amples.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

شکل ۱۲: د پروژې ترتیب – د کور کړکۍ
یادونه: د مینو رنګونه ستاسو په ټرمینل کې مختلف کیدی شي. تاسو کولی شئ د –style اختیار سره بڼه بدله کړئ. مهرباني وکړئ د نورو معلوماتو لپاره idf.py menuconfig –help چل کړئ.
که تاسو د ملاتړ شوي پراختیایي بورډونو څخه یو کاروئ، تاسو کولی شئ د بورډ ملاتړ کڅوړې په کارولو سره خپل پراختیا ګړندۍ کړئ. د نورو معلوماتو لپاره اضافي لارښوونې وګورئ.
پروژه جوړه کړئ پروژه د لاندې چلولو له لارې جوړه کړئ:
idf.py جوړول
دا کمانډ به غوښتنلیک او د ESP-IDF ټولې برخې تالیف کړي ، بیا به دا بوټلوډر ، د برخې جدول ، او غوښتنلیک بائنری رامینځته کړي.
$ idf.py build په /path/to/hello_world/build ډایرکټرۍ کې cmake چلول د "cmake -G Ninja –warn-uninitialized /path/to/hello_world" اجرا کول… د نه پیل شوي ارزښتونو په اړه خبرداری ورکول. — Git وموندل شو: /usr/bin/git (نسخه "2.17.0" وموندل شوه) — د ترتیب له امله د خالي aws_iot برخې جوړول — د اجزاو نومونه: … — د اجزاو لارې: …
… (د سیسټم تولید د جوړولو نورې کرښې)
[527/527] د hello_world.bin esptool.py v2.3.1 تولید کول
د پروژې جوړول بشپړ شول. د فلش کولو لپاره، دا قومانده پرمخ بوځئ: ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash -flash_mode dio –flash_size detect –flash_freq 40m 0x10000 build/hello_world. bin build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/ partition-table.bin یا 'idf.py -p PORT flash' چل کړئ
که کومه تېروتنه نه وي، جوړونه به د فرم ویئر بائنری .bin په جوړولو سره پای ته ورسیږي files.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
په آلې باندې فلش کړئ هغه بائنریونه چې تاسو یې جوړ کړي دي (bootloader.bin، partition-table.bin او hello_world.bin) په خپل ESP32 بورډ کې د idf.py -p PORT [-b BAUD] فلش په چلولو سره فلش کړئ.
PORT د خپل ESP32 بورډونو سیریل پورټ نوم سره بدل کړئ. تاسو کولی شئ د فلشیر باډ نرخ د BAUD په ځای د هغه باډ نرخ سره بدل کړئ چې تاسو ورته اړتیا لرئ. د ډیفالټ باډ نرخ 460800 دی. د idf.py دلیلونو په اړه د نورو معلوماتو لپاره، idf.py وګورئ.
یادونه: د فلش اختیار په اتوماتيک ډول پروژه جوړوي او فلش کوي، نو د idf.py build چلول اړین ندي.

د فلش کولو پرمهال له ستونزو سره مخ شوي یاست؟ که تاسو ورکړل شوی قومانده پرمخ وړئ او د oFailed to connectp په څیر غلطۍ وګورئ، نو د دې لپاره ډیری دلیلونه کیدی شي. یو دلیل ممکن د esptool.py لخوا ورسره مخ شوي ستونزې وي، هغه یوټیلټي چې د جوړونکي سیسټم لخوا د چپ بیا تنظیمولو، د ROM بوټلوډر سره تعامل کولو، او فلش فرم ویئر لپاره ویل کیږي. د هڅه کولو لپاره یوه ساده حل د لاسي بیا تنظیم کول دي چې لاندې تشریح شوي، او که دا مرسته ونکړي تاسو کولی شئ د ستونزو حل کولو کې د ممکنه ستونزو په اړه نور توضیحات ومومئ.
esptool.py د USB د DTR او RTS کنټرول لاینونو ته د سیریل کنورټر چپ، یعنې FTDI یا CP210x په تاییدولو سره ESP32 په اتوماتيک ډول بیا تنظیموي (د نورو معلوماتو لپاره، د ESP32 سره د سریال اتصال رامینځته کول وګورئ). د DTR او RTS کنټرول لاینونه په بدل کې د ESP32 د GPIO0 او CHIP_PU (EN) پنونو سره وصل دي، پدې توګه په حجم کې بدلون راځي.tagد DTR او RTS e کچه به ESP32 د فرم ویئر ډاونلوډ حالت کې بوټ کړي. د مثال په توګهample، د ESP32 DevKitC پراختیایي بورډ لپاره سکیماتیک وګورئ.
په عمومي توګه، تاسو باید د رسمي esp-idf پراختیایي بورډونو سره کومه ستونزه ونلرئ. په هرصورت، esptool.py نشي کولی ستاسو هارډویر په لاندې قضیو کې په اتوماتيک ډول بیا تنظیم کړي:
· ستاسو هارډویر د GPIO0 او CHIP_PU سره د DTR او RTS لاینونه نه لري · د DTR او RTS لاینونه په مختلف ډول تنظیم شوي · داسې هیڅ سریال کنټرول لاینونه شتون نلري.
د هغه هارډویر ډول پورې اړه لري چې تاسو یې لرئ، دا هم ممکن وي چې خپل ESP32 بورډ په لاسي ډول د فرم ویئر ډاونلوډ حالت (ری سیٹ) ته واچوئ.
· د ایسپریسیف لخوا تولید شوي پراختیایي بورډونو لپاره، دا معلومات د پیل کولو اړوند لارښودونو یا د کارونکي لارښودونو کې موندل کیدی شي. د مثال په توګهampد ESP-IDF پراختیایي بورډ په لاسي ډول بیا تنظیمولو لپاره، د بوټ تڼۍ (GPIO0) ونیسئ او د EN تڼۍ (CHIP_PU) فشار ورکړئ.
· د نورو ډولونو هارډویر لپاره، هڅه وکړئ چې GPIO0 ښکته کش کړئ.

نورمال عملیات کله چې چمکۍ، تاسو به د محصول لاګ د لاندې سره ورته وګورئ:
… esptool.py –chip esp32 -p /dev/ttyUSB0 -b 460800 –before=default_reset -after=hard_reset write_flash –flash_mode dio –flash_freq 40m –flash_size 2MB 0x8000 partition_table/partition-table.bin 0x1000 bootloader/bootloader.bin 0x10000 hello_world.bin esptool.py v3.0-dev سیریل پورټ /dev/ttyUSB0 نښلول…….._ چپ ESP32D0WDQ6 دی (بیاکتنه 0) ځانګړتیاوې: وای فای، BT، دوه ګونی کور، د کوډ کولو سکیم هیڅ نه کرسټال 40MHz دی MAC: 24:0a:c4:05:b9:14 سټب اپلوډ کول… سټب چلول… سټب چلول… د باډ نرخ 460800 ته بدلول بدل شوي.
(په راتلونکې پاڼه کې دوام لري)

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
(له مخکینۍ پاڼې څخه دوام لري) د فلش اندازه تنظیمول… ۳۰۷۲ بایټس تر ۱۰۳ پورې کمپریس شوی… په ۰x۰۰۰۰۸۰۰۰ لیکل… (۱۰۰٪) په ۰.۰ ثانیو کې په ۰x۰۰۰۰۸۰۰۰ کې ۳۰۷۲ بایټس (۱۰۳ کمپریس شوی) لیکل (مؤثر ۵۹۶۲.۸ کیلوبایټ/سیکنډ)… د معلوماتو هش تایید شوی. ۲۶۰۹۶ بایټس تر ۱۵۴۰۸ پورې کمپریس شوی… په ۰x۰۰۰۰۱۰۰۰ کې لیکل… (۱۰۰٪) په ۰.۴ ثانیو کې په ۰x۰۰۰۰۱۰۰۰ کې ۲۶۰۹۶ بایټس (۱۵۴۰۸ کمپریس شوی) لیکل (مؤثر ۵۴۶.۷ کیلوبایټ/سیکنډ)… د معلوماتو هش تایید شوی. ۱۴۷۱۰۴ بایټونه تر ۷۷۳۶۴ پورې کمپریس شوي… په ۰x۰۰۱۰۰۰۱۰۰۰ لیکل… (۲۰٪) په ۰x۰۰۱۴۰۰۰ لیکل… (۴۰٪) په ۰x۰۰۱۸۰۰۰ لیکل… (۶۰٪) په ۰x۰۰۱c۰۰۰ لیکل… (۸۰٪) په ۰x۰۰۲۰۰۰ لیکل… (۱۰۰٪) په ۱.۹ ثانیو کې ۱۴۷۱۰۴ بایټونه (۷۷۳۶۴ کمپریس شوي) په ۰x۰۰۱۰۰۰۱۰۰۰ لیکلي (مؤثر ۶۱۵.۵ کیلو بایټ/سیکنډ)… د معلوماتو هش تایید شوی.
پریښودل… د RTS پن له لارې سخت بیا تنظیم کول… بشپړ شو
که چیرې د فلش پروسې تر پایه پورې کومه ستونزه نه وي، نو بورډ به ریبوټ شي او theohello_worldp اپلیکیشن به پیل کړي. که تاسو غواړئ د idf.py چلولو پرځای د Eclipse یا VS Code IDE وکاروئ، نو د Eclipse Plugin، VSCode Extension وګورئ.
د محصول څارنه د دې لپاره چې وګورئ چې ohello_worldpis په ریښتیا سره روان دی، idf.py -p PORT monitor ولیکئ (مه هیروئ چې PORT د خپل سریال پورټ نوم سره بدل کړئ).
دا قومانده د IDF مانیټر غوښتنلیک پیلوي:
$ idf.py -p څارنه په ډایرکټرۍ کې د idf_monitor چلول […]/esp/hello_world/build د "python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_ world/build/hello_world.elf" اجرا کول… — idf_monitor فعال دی ۱۱۵۲۰۰ —– پریږدئ: Ctrl+] | مینو: Ctrl+T | مرسته: Ctrl+T ورپسې Ctrl+H –ets جون ۸ ۲۰۱۶ ۰۰:۲۲:۵۷
لومړی: 0x1 (POWERON_RESET)، بوټ: 0x13 (SPI_FAST_FLASH_BOOT) ets د جون ۸، ۲۰۱۶ ۰۰:۲۲:۵۷ …
د پیل او تشخیصي لاګونو پورته سکرول کولو وروسته، تاسو باید د oHello world! اپلیکیشن لخوا چاپ شوی وګورئ.
... سلام نړۍ! په ۱۰ ثانیو کې بیا پیل کیږي ... دا د esp32 چپ دی چې د ۲ CPU کور (کورونه)، وای فای/BT/BLE، سیلیکون بیاکتنه ۱، ۲MB بهرنۍ فلش لري لږترلږه وړیا هپ اندازه: ۲۹۸۹۶۸ بایټس په ۹ ثانیو کې بیا پیل کیږي ... په ۸ ثانیو کې بیا پیل کیږي ... په ۷ ثانیو کې بیا پیل کیږي ...
د IDF مانیټر څخه د وتلو لپاره شارټ کټ Ctrl+] وکاروئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
که چیرې د IDF مانیټر د اپلوډ څخه لږ وروسته ناکام شي، یا، که د پورته پیغامونو پرځای، تاسو د لاندې ورکړل شوي سره ورته تصادفي کثافات وګورئ، ستاسو بورډ احتمال لري چې د 26 MHz کرسټال کاروي. ډیری پراختیایی بورډ ډیزاینونه 40 MHz کاروي، نو ESP-IDF دا فریکونسي د ډیفالټ ارزښت په توګه کاروي.

که تاسو داسې ستونزه لرئ، لاندې کارونه وکړئ: ۱. له مانیټر څخه ووځئ. ۲. بیرته مینو کنفیګ ته لاړ شئ. ۳. د اجزاو ترتیب> هارډویر ترتیبات> اصلي XTAL ترتیب> اصلي XTAL فریکونسی ته لاړ شئ، بیا CONFIG_XTAL_FREQ_SEL ۲۶ MHz ته بدل کړئ. ۴. له هغې وروسته، اپلیکیشن بیا جوړ او فلش کړئ.
د ESP-IDF په اوسني نسخه کې، د ESP32 لخوا ملاتړ شوي اصلي XTAL فریکونسۍ په لاندې ډول دي:
· ۲۶ میګاهرتز · ۴۰ میګاهرتز
یادونه: تاسو کولی شئ د idf.py -p PORT فلش مانیټر په چلولو سره په یوه مرحله کې جوړول، فلش کول او څارنه یوځای کړئ.
دا هم وګورئ: · د IDF مانیټر کارولو په اړه د اسانه شارټ کټونو او نورو جزیاتو لپاره IDF مانیټر. · د idf.py امرونو او اختیارونو بشپړ حوالې لپاره idf.py.
دا ټول هغه څه دي چې تاسو ورته اړتیا لرئ د ESP32 سره پیل وکړئ! اوس تاسو چمتو یاست چې یو بل پخوانی هڅه وکړئampکم، یا مستقیم د خپلو غوښتنلیکونو پراختیا ته لاړ شئ.
مهم: ځینې پخوانيampدا د ESP32 ملاتړ نه کوي ځکه چې اړین هارډویر په ESP32 کې شامل نه دی نو دا نشي ملاتړ کیدی. که چیرې یو پخوانی جوړ کړئample، مهرباني وکړئ README وګورئ file د ملاتړ شوي هدفونو جدول لپاره. که چیرې دا د ESP32 هدف په شمول شتون ولري، یا جدول په بشپړ ډول شتون ونلري، نو پخوانیampدا به په ESP32 کې کار وکړي.
اضافي لارښوونې
د اجازې مسلې /dev/ttyUSB0 د ځینو لینکس توزیعونو سره، تاسو ممکن د ESP32 فلش کولو پر مهال د /dev/ttyUSB0 پورټ خلاصولو کې ناکامۍ خطا پیغام ترلاسه کړئ. دا د اوسني کارونکي د ډایل آوټ ګروپ ته اضافه کولو سره حل کیدی شي.
د پایتون مطابقت ESP-IDF د پایتون 3.7 یا نوي ملاتړ کوي. سپارښتنه کیږي چې خپل عملیاتي سیسټم وروستي نسخې ته لوړ کړئ چې دا اړتیا پوره کوي. په نورو انتخابونو کې د سرچینو څخه د پایتون نصب کول یا د پایتون نسخې مدیریت سیسټم لکه pyenv کارول شامل دي.
د بورډ سپورټ پیکج سره پیل وکړئ د ځینو پرمختیایي بورډونو پروټوټایپینګ ګړندی کولو لپاره، تاسو کولی شئ د بورډ سپورټ پیکجونه (BSPs) وکاروئ، کوم چې د یو ځانګړي بورډ پیل کول د څو فنکشن زنګونو په څیر اسانه کوي.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

BSP معمولا د پراختیا بورډ کې چمتو شوي ټولو هارډویر اجزاو ملاتړ کوي. د پن آوټ تعریف او ابتدايي دندو سربیره، BSP د بهرنیو برخو لکه سینسرونو، ښودنې، آډیو کوډیکونو او نورو لپاره ډرایورونه لیږدوي. BSPs د IDF اجزاو مدیر له لارې ویشل شوي، نو دوی د IDF اجزاو راجسټری کې موندل کیدی شي. دلته یو مثال دیampستاسو په پروژه کې د ESP-WROVER-KIT BSP اضافه کولو څرنګوالی: idf.py add-dependency esp_wrover_kit
نور پخوانيampد BSP کارولو لنډیزونه په BSP ex کې موندل کیدی شيamples فولډر.
اړونده اسناد د هغو پرمختللو کاروونکو لپاره چې غواړي د نصبولو پروسه تنظیم کړي: · په وینډوز کې د ESP-IDF وسیلو تازه کول · د ESP32 سره سریال اړیکه رامینځته کول · د ایکلیپس پلگ ان · د VSCode توسیع · IDF مانیټر
په وینډوز کې د ESP-IDF وسایلو تازه کول
د سکرېپټ په کارولو سره د ESP-IDF وسایل نصب کړئ د وینډوز کمانډ پرامپټ څخه، هغه ډایرکټرۍ ته لاړ شئ چیرې چې ESPIDF نصب شوی دی. بیا لاندې چل کړئ:
install.bat
د پاورشیل لپاره، هغه ډایرکټرۍ ته لاړ شئ چیرې چې ESP-IDF نصب شوی دی. بیا لاندې کار وکړئ:
نصب کړئ.ps1
دا به د ESP-IDF کارولو لپاره اړین وسایل ډاونلوډ او نصب کړي. که چیرې د وسیلې ځانګړی نسخه دمخه نصب شوې وي، نو هیڅ اقدام به ونشي. وسایل د ESP-IDF وسیلو د نصبولو پروسې په جریان کې مشخص شوي لارښود کې ډاونلوډ او نصب شوي. په ډیفالټ ډول، دا C:Usersusername.espressif دی.
د صادراتي سکریپټ په کارولو سره د ESP-IDF وسایل PATH ته اضافه کړئ د ESP-IDF وسایلو انسټالر د oESP-IDF کمانډ پرامپټ لپاره د سټارټ مینو شارټ کټ رامینځته کوي. دا شارټ کټ د کمانډ پرامپټ کړکۍ پرانیزي چیرې چې ټول وسایل دمخه شتون لري
شتون لري. په ځینو مواردو کې، تاسو ممکن وغواړئ چې د ESP-IDF سره په کمانډ پرامپټ کړکۍ کې کار وکړئ کوم چې د دې شارټ کټ په کارولو سره نه و پیل شوی. که دا قضیه وي، نو لاندې لارښوونې تعقیب کړئ ترڅو د ESP-IDF وسایل په PATH کې اضافه کړئ. په کمانډ پرامپټ کې چیرې چې تاسو د ESP-IDF کارولو ته اړتیا لرئ، هغه ډایرکټرۍ ته بدل کړئ چیرې چې ESP-IDF نصب شوی، بیا export.bat اجرا کړئ:
cd % userprofile%espesp-idf صادرات.bat
په بدیل سره په پاورشیل کې چیرې چې تاسو د ESP-IDF کارولو ته اړتیا لرئ، هغه ډایرکټرۍ ته لاړ شئ چیرې چې ESP-IDF نصب شوی، بیا export.ps1 اجرا کړئ:
سي ډي ~/esp/esp-idf صادرات.ps1
کله چې دا ترسره شي، نو وسایل به په دې کمانډ پرامپټ کې شتون ولري.
د ESP32 سره سریال اړیکه جوړه کړئ دا برخه د ESP32 او PC ترمنځ سریال اړیکه جوړولو لارښوونې چمتو کوي.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
ESP32 له کمپیوټر سره وصل کړئ د ESP32 بورډ د USB کیبل په کارولو سره کمپیوټر سره وصل کړئ. که چیرې د وسیلې ډرایور په اتوماتيک ډول نصب نشي، نو په خپل ESP32 بورډ (یا بهرني کنورټر ډونګل) کې د USB څخه سیریل کنورټر چپ وپیژنئ، په انټرنیټ کې ډرایورونه وپلټئ او نصب یې کړئ. لاندې د Espressif لخوا تولید شوي ډیری ESP32 بورډونو کې نصب شوي USB څخه سیریل کنورټر چپس لیست دی او د ډرایورونو لینکونه هم لري:
· CP210x: CP210x USB to UART Bridge VCP ډرایوران · FTDI: FTDI مجازی COM پورټ ډرایوران مهرباني وکړئ د ځانګړي USB to سیریل کنورټر چپ لپاره د بورډ کارونکي لارښود وګورئ. پورته ډرایوران په عمده توګه د حوالې لپاره دي. په نورمال شرایطو کې، ډرایوران باید د عملیاتي سیسټم سره بنډل شي او په اتوماتيک ډول نصب شي کله چې بورډ له کمپیوټر سره وصل شي.
په وینډوز کې پورټ وګورئ د وینډوز ډیوائس مینیجر کې د پیژندل شوي COM پورټونو لیست وګورئ. ESP32 منقطع کړئ او بیرته یې وصل کړئ، ترڅو تایید کړئ چې کوم پورټ له لیست څخه ورک کیږي او بیا بیرته ښکاره کیږي. لاندې انځورونه د ESP32 DevKitC او ESP32 WROVER KIT لپاره سریال پورټ ښیې.

شکل ۱۳: د وینډوز وسیلې مدیر کې د ESP32-DevKitC USB څخه UART پل

په لینکس او macOS کې پورټ وګورئ د خپل ESP32 بورډ (یا بهرني کنورټر ډونګل) د سیریل پورټ لپاره د وسیلې نوم چیک کولو لپاره، دا کمانډ دوه ځله چل کړئ، لومړی د بورډ / ډونګل غیر پلګ سره، بیا د پلګ ان سره. هغه پورټ چې دوهم ځل څرګندیږي هغه دی چې تاسو ورته اړتیا لرئ: لینکس
ls/dev/tty*
macOS

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

شکل ۱۴: د وینډوز وسیلې مدیر کې د ESP-WROVER-KIT دوه USB سریال پورټونه

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

ls /dev/cu.* یادونه: د macOS کاروونکي: که تاسو د سریال پورټ ونه ګورئ نو وګورئ چې تاسو د USB/سیریل ډرایورونه نصب کړي دي. د ډرایورونو لینکونو لپاره د ESP32 سره د PC سره وصل کولو برخه وګورئ. د macOS High Sierra (10.13) لپاره، تاسو ممکن په واضح ډول د ډرایورونو د بارولو اجازه هم ورکړئ. د سیسټم غوره توبونه -> امنیت او محرمیت -> عمومي پرانیزئ او وګورئ چې ایا دلته د oSystem سافټویر په اړه د پراختیا کونکي lp څخه ښودل شوی پیغام شتون لري چیرې چې د پراختیا کونکي نوم سیلیکون لیبز یا FTDI دی.

په لینکس کې ډایل آوټ ته د کارونکي اضافه کول اوس مهال لاګ ان شوی کارونکی باید د USB له لارې سریال پورټ ته د لوستلو او لیکلو لاسرسی ولري. په ډیری لینکس توزیعونو کې، دا د لاندې قوماندې سره د ډایل آوټ ګروپ ته د کارونکي اضافه کولو سره ترسره کیږي:
sudo usermod -a -G ډایل آوټ $USER
په آرچ لینکس کې دا د لاندې کمانډ سره uucp ګروپ ته د کارونکي اضافه کولو سره ترسره کیږي:
sudo usermod -a -G uucp $USER
ډاډ ترلاسه کړئ چې تاسو د سیریل پورټ لپاره د لوستلو او لیکلو اجازه فعالولو لپاره بیا ننوتل.
د سریال اتصال تایید کړئ اوس تایید کړئ چې سریال اتصال فعال دی. تاسو کولی شئ دا د سریال ټرمینل پروګرام په کارولو سره ترسره کړئ د دې په چک کولو سره چې ایا تاسو د ESP32 بیا تنظیم کولو وروسته په ټرمینل کې کوم محصول ترلاسه کوئ. په ESP32 کې د ډیفالټ کنسول باډ نرخ 115200 دی.
په دې مثال کې وینډوز او لینکسampموږ به د PuTTY SSH Client وکاروو چې د وینډوز او لینکس دواړو لپاره شتون لري. تاسو کولی شئ د نورو سریال پروګرامونو څخه کار واخلئ او د اړیکو پیرامیټرونه تنظیم کړئ لکه څنګه چې لاندې دي. ټرمینل چل کړئ او پیژندل شوی سریال پورټ تنظیم کړئ. د باډ کچه = 115200 (که اړتیا وي، دا د کارول شوي چپ ډیفالټ باډ کچه ته بدل کړئ)، د معلوماتو بټونه = 8، د بند بټونه = 1، او برابري = N. لاندې مثالونه ديampد پورټ او داسې لیږد پیرامیټرو تنظیم کولو سکرین شاټونه (په لنډ ډول د 115200-8-1-N په نوم تشریح شوي) په وینډوز او لینکس کې. په یاد ولرئ چې په سمه توګه ورته سریال پورټ غوره کړئ چې تاسو په پورته مرحلو کې پیژندلی دی. بیا په ټرمینل کې سریال پورټ خلاص کړئ او وګورئ، که تاسو د ESP32 لخوا چاپ شوی کوم لاګ وګورئ. د لاګ مینځپانګه به د ESP32 ته پورته شوي غوښتنلیک پورې اړه ولري، Ex وګورئample وتل.
یادونه: د اړیکو د کار کولو تصدیق وروسته د سریال ټرمینل وتړئ. که تاسو د ټرمینل سیشن خلاص وساتئ، نو سریال پورټ به وروسته د فرم ویئر اپلوډ کولو لپاره د لاسرسي وړ نه وي.

macOS د سیریل ټرمینل پروګرام د نصبولو له ستونزو څخه د خلاصون لپاره، macOS د سکرین قومانده وړاندې کوي. · لکه څنګه چې په لینکس او macOS کې د چیک پورټ په برخه کې بحث شوی، لاندې چل کړئ:

ls /dev/cu.* · تاسو باید ورته محصول وګورئ:

/dev/cu.بلوتوث-راتلونکی-پورټ /dev/cu.SLAB_USBtoUART USBtoUART7

/dev/cu.SLAB_

· محصول به ستاسو د کمپیوټر سره د وصل شوي بورډونو ډول او شمیر پورې اړه ولري. بیا د خپل بورډ د وسیلې نوم غوره کړئ او چل کړئ (که اړتیا وي، د کارول شوي چپ ډیفالټ باډ نرخ ته o115200p بدل کړئ):

سکرین /dev/cu.device_name 115200 د device_name ځای د هغه نوم سره بدل کړئ چې موندل شوی دی ls /dev/cu.* چلوي.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

شکل ۱۵: په وینډوز کې په PuTTY کې د سریال اړیکو تنظیم کول

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

شکل ۱۶: په لینکس کې په PuTTY کې د سریال اړیکو تنظیم کول

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
· هغه څه چې تاسو یې په لټه کې یاست هغه د سکرین لخوا ښودل شوي یو څه لاګ دی. د لاګ مینځپانګه به د ESP32 ته پورته شوي غوښتنلیک پورې اړه ولري، وګورئ Exampد سکرین سیشن څخه د وتلو لپاره Ctrl-A + ټایپ کړئ.
یادونه: د دې تصدیق کولو وروسته چې اړیکه کار کوي، د سکرین سیشن څخه وتل مه هیروئ. که تاسو دا کار ونکړئ او یوازې د ټرمینل کړکۍ وتړئ، نو سریال پورټ به وروسته د فرم ویئر اپلوډ کولو لپاره د لاسرسي وړ نه وي.
Example وتل یو پخوانیample log لاندې ښودل شوی دی. که تاسو هیڅ شی ونه ګورئ نو بورډ بیا تنظیم کړئ. ets جون 8 2016 00:22:57
لومړی: 0x5 (DEEPSLEEP_RESET)، بوټ: 0x13 (SPI_FAST_FLASH_BOOT) ets د جون ۸، ۲۰۱۶ ۰۰:۲۲:۵۷
rst:0x7 (TG0WDT_SYS_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) configsip: 0, SPIWP:0x00 clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00 mode:DIO, clock div:2 load:0x3fff0008,len:8 load:0x3fff0010,len:3464 load:0x40078000,len:7828 load:0x40080000,len:252 entry 0x40080034 I (44) boot: ESP-IDF v2.0-rc1-401-gf9fba35 2nd stagد ای بوټلوډر I (45) بوټ: د تالیف وخت 18:48:10
...
که تاسو د لوستلو وړ لاګ آوټ پټ وګورئ، دا پدې مانا ده چې سریال اړیکه کار کوي او تاسو چمتو یاست چې نصبولو ته دوام ورکړئ او په پای کې ESP32 ته غوښتنلیک اپلوډ کړئ.
یادونه: د ځینو سیریل پورټ وایرنګ ترتیباتو لپاره، د سیریل RTS او DTR پنونه باید د ټرمینل پروګرام کې غیر فعال شي مخکې لدې چې ESP32 بوټ شي او سیریل آوټ پټ تولید کړي. دا پخپله په هارډویر پورې اړه لري، ډیری پراختیایی بورډونه (د ټولو ایسپریسیف بورډونو په ګډون) دا ستونزه نلري. دا ستونزه شتون لري که چیرې RTS او DTR مستقیم EN او GPIO0 پنونو ته وصل وي. د نورو جزیاتو لپاره د esptool اسناد وګورئ.
که تاسو دلته د پنځم ګام څخه راغلي یاست. د ESP32 پراختیا لپاره د s/w نصبولو په وخت کې د ESP-IDF په اړه لومړني ګامونه، نو تاسو کولی شئ د پنځم ګام سره دوام ورکړئ. د ESP-IDF په اړه لومړني ګامونه.
د IDF مانیټر IDF مانیټر په عمده توګه یو سریال ټرمینل پروګرام دی چې د هدف وسیلو او سریال پورټ څخه سریال معلومات لیږدوي. دا د IDF ځینې ځانګړي ځانګړتیاوې هم چمتو کوي. د IDF مانیټر د IDF پروژې څخه د idf.py مانیټر په چلولو سره پیل کیدی شي.
د کیبورډ لنډلارې د IDF مانیټر سره د اسانه تعامل لپاره، په جدول کې ورکړل شوي د کیبورډ لنډلارې وکاروئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

د کیبورډ شارټ کټ Ctrl+] Ctrl+T
· Ctrl+T
· Ctrl+] · Ctrl+P
· Ctrl+R
· Ctrl+F
· Ctrl+A (یا A)
· Ctrl+Y
· Ctrl+L
· Ctrl+I (یا I)
· Ctrl+H (یا H)
· Ctrl+X (یا X)
Ctrl+C

عمل

تفصیل

د پروګرام څخه وتل د مینو د فرار کیلي د مینو کرکټر پخپله ریموټ ته واستوئ
د وتلو کرکټر پخپله ریموټ ته واستوئ
د RTS لاین له لارې د اپلیکیشن د بندولو لپاره هدف په بوټلوډر کې بیا تنظیم کړئ
د RTS له لارې د هدف بورډ بیا تنظیم کړئ
پروژه جوړه او فلش کړئ

یوازې اپلیکیشن جوړ او فلش کړئ

په سکرین کې د لاګ آوټ پټ چاپ بندول/بیا پیل کول

د لاګ ودرول/بیا پیل کول خوندي شوي file

د درولو/بیا پیلولو مهالویشamps

چاپول

د کیبورډ ټول لنډلارې ښکاره کړئ

لاندې ورکړل شوي کیليو څخه د یوې له لارې یې فشار ورکړئ او تعقیب یې کړئ.
هدف د RTS لاین له لارې بوټلوډر ته بیا تنظیموي (که وصل وي)، ترڅو بورډ هیڅ شی ونه چلوي. ګټور دی کله چې تاسو اړتیا لرئ د بل وسیلې د پیل کیدو انتظار وکړئ. د هدف بورډ بیا تنظیموي او د RTS لاین له لارې غوښتنلیک بیا پیلوي (که وصل وي).
د پروژې فلش هدف چلولو لپاره idf_monitor ودروي، بیا idf_monitor بیا پیلوي. هر ډول بدل شوی سرچینه files بیا تالیف کیږي او بیا بیا فلش کیږي. که چیرې idf_monitor د دلیل -E سره پیل شوی وي نو Target encrypted-flash چلیږي. د app-flash هدف چلولو لپاره idf_monitor ودروي، بیا idf_monitor بیا پیل کوي. د فلش هدف سره ورته، مګر یوازې اصلي اپلیکیشن جوړ شوی او بیا فلش شوی. که چیرې idf_monitor د دلیل -E سره پیل شوی وي نو Target encrypted-app-flash چلیږي. د فعالولو پرمهال ټول راتلونکي سریال ډیټا ردوي. د مانیټر پریښودو پرته د لاګ آوټ پټ په چټکۍ سره وقفه کولو او معاینه کولو ته اجازه ورکوي. یو جوړوي file د پروژې په ډایرکټرۍ کې او محصول ورته لیکل شوی دی file تر هغه چې دا د ورته کیبورډ شارټ کټ سره غیر فعال شي (یا IDF مانیټر بهر شي). IDF مانیټر کولی شي د وخت ترتیب چاپ کړيamp د هرې کرښې په پیل کې. د وخت ترټولوamp بڼه د -timest لخوا بدلیدلی شيamp- د کمانډ لاین دلیل بڼه.

د پروګرام څخه ووځي

د چلولو غوښتنلیک مداخله کړئ

د IDF مانیټر ودروي او د GDB پروژې ډیبګر چلوي ترڅو د چلولو په وخت کې اپلیکیشن ډیبګ کړي. دا د :ref:CONFIG_ESP_SYSTEM_GDBSTUB_RUNTIME اختیار فعالولو ته اړتیا لري.

د Ctrl-] او Ctrl-T پرته نورې ټولې کیلي به د سریال پورټ له لارې واستول شي.

د IDF ځانګړي ځانګړتیاوې

د پتې اتوماتیک کوډ کول کله چې ESP-IDF د 0x4_______ فورمې هیکساډیسیمل کوډ پته تولیدوي، IDF مانیټر د سرچینې کوډ کې موقعیت موندلو او د فعالیت نوم موندلو لپاره addr2line_ کاروي.
که چیرې د ESP-IDF اپلیکیشن خراب شي او ویره ولري، د راجستر ډمپ او بیکټریس تولید کیږي، لکه لاندې:

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

د ګورو مراقبت تېروتنه د StoreProhibited ډول په کور 0 کې رامنځته شوه. استثنا وه

بې کنټروله.

د نوم لیکنې ډمپ:

PC

: 0x400f360d پی ایس

: 0x00060330 A0

: 0x800dbf56 A1

:

0x3ffb7e00 د

A2

: 0x3ffb136c A3

: 0x00000005 A4

: 0x00000000 A5

:

0x00000000

A6

: 0x00000000 A7

: 0x00000080 A8

: 0x00000000 A9

:

0x3ffb7dd0

A10

: 0x00000003 A11

: 0x00060f23 A12

: 0x00060f20 A13

:

0x3ffba6d0 د

A14

: 0x00000047 A15

: 0x0000000f ریال

: 0x00000019 عذر:

0x0000001d

EXCVADDR: 0x00000000 LBEG : 0x4000c46c پور : 0x4000c477 LCOUNT :

0x00000000

Backtrace: 0x400f360d:0x3ffb7e00 0x400dbf56:0x3ffb7e20 0x400dbf5e:0x3ffb7e40 0x400dbf82:0x3ffb7e60 0x400d071d:0x3ffb7e90

د IDF مانیټر ډمپ ته نور جزئیات اضافه کوي:

د ګورو مراقبت تېروتنه د StoreProhibited ډول په کور 0 کې رامنځته شوه. استثنا وه

بې کنټروله.

د نوم لیکنې ډمپ:

PC

: 0x400f360d پی ایس

: 0x00060330 A0

: 0x800dbf56 A1

:

0x3ffb7e00 د

0x400f360d: په /home/gus/esp/32/idf/ex کې د یو څه_ټکر_کولو_لپاره_څه_کولوampلږ/پیل کول/

سلام_نړۍ/اصلي/./سلام_نړۍ_اصلي.c:57

(په لیکه کې) inner_dont_crash په /home/gus/esp/32/idf/ex کېampسلام/پیل یې کړئ/سلام_

نړۍ/اصلي/./سلام_د نړۍ_ماین.c:52

A2

: 0x3ffb136c A3

: 0x00000005 A4

: 0x00000000 A5

:

0x00000000

A6

: 0x00000000 A7

: 0x00000080 A8

: 0x00000000 A9

:

0x3ffb7dd0

A10

: 0x00000003 A11

: 0x00060f23 A12

: 0x00060f20 A13

:

0x3ffba6d0 د

A14

: 0x00000047 A15

: 0x0000000f ریال

: 0x00000019 عذر:

0x0000001d

EXCVADDR: 0x00000000 LBEG : 0x4000c46c پور : 0x4000c477 LCOUNT :

0x00000000

Backtrace: 0x400f360d:0x3ffb7e00 0x400dbf56:0x3ffb7e20 0x400dbf5e:0x3ffb7e40 0x400dbf82:0x3ffb7e60 0x400d071d:0x3ffb7e90 0x400f360d: do_something_to_crash at /home/gus/esp/32/idf/examples/get-started/ hello_world/main/./hello_world_main.c:57 (په لیکه کې) inner_dont_crash په /home/gus/esp/32/idf/ex کېamples/get-started/hello_ world/main/./hello_world_main.c:52 0x400dbf56: still_dont_crash په /home/gus/esp/32/idf/ex کېamples/get-started/hello_ world/main/./hello_world_main.c:47 0x400dbf5e: په /home/gus/esp/32/idf/ex کې د ټکر مخه ونیسئamples/get-started/hello_world/ main/./hello_world_main.c:42 0x400dbf82: app_main په /home/gus/esp/32/idf/ex کېamples/get-started/hello_world/main/ ./hello_world_main.c:33 0x400d071d: په /home/gus/esp/32/idf/components/esp32/./cpu_start.c:254 کې اصلي دنده

د هر پتې د ډیکوډ کولو لپاره، IDF مانیټر په شالید کې لاندې قومانده چلوي: xtensa-esp32-elf-addr2line -pfiaC -e build/PROJECT.elf ADDRESS

یادونه: د چاپیریال متغیر ESP_MONITOR_DECODE په 0 تنظیم کړئ یا د ځانګړي کمانډ لاین سره idf_monitor.py ته زنګ ووهئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
اختیار: idf_monitor.py –disable-address-decoding د پتې کوډ کولو غیر فعالولو لپاره.
په اتصال کې د هدف بیا تنظیم کول په ډیفالټ ډول، د IDF مانیټر به هدف بیا تنظیم کړي کله چې ورسره وصل شي. د هدف چپ بیا تنظیم کول د DTR او RTS سیریل لاینونو په کارولو سره ترسره کیږي. د IDF مانیټر څخه د اتصال په اتوماتيک ډول د هدف بیا تنظیم کولو څخه مخنیوي لپاره، د –no-reset اختیار سره IDF مانیټر ته زنګ ووهئ (د مثال په توګه، idf_monitor.py –no-reset).
یادونه: د –no-reset اختیار ورته چلند پلي کوي حتی کله چې IDF مانیټر یو ځانګړي پورټ سره وصل کیږي (د مثال په توګه، idf.py مانیټر –no-reset -p [PORT]).
د GDBStub سره د GDB پیل کول GDBStub د رن ټایم ډیبګ کولو یوه ګټوره ځانګړتیا ده چې په هدف باندې چلیږي او د سیریل پورټ له لارې کوربه سره وصل کیږي ترڅو د ډیبګ کولو امرونه ترلاسه کړي. GDBStub د یادښت او متغیراتو لوستلو، د کال سټیک چوکاټونو معاینه کولو او نورو په څیر امرونو ملاتړ کوي. که څه هم GDBStub د J په پرتله لږ متغیر دی.TAG ډیبګ کول، دا کوم ځانګړي هارډویر ته اړتیا نلري (لکه JTAG (USB bridge ته) ځکه چې اړیکه په بشپړه توګه د سیریل پورټ له لارې ترسره کیږي. یو هدف د چلولو لپاره په شالید کې د GDBStub چلولو لپاره تنظیم کیدی شي د CONFIG_ESP_SYSTEM_PANIC د چلولو وخت کې GDBStub ته تنظیم کولو سره. GDBStub به په شالید کې تر هغه وخته پورې چلیږي تر څو چې د سیریل پورټ له لارې Ctrl+C پیغام واستول شي او GDBStub ته د پروګرام د ماتولو لامل شي (یعنې، د اجرا کولو مخه ونیسي)، پدې توګه GDBStub ته اجازه ورکوي چې د ډیبګ کولو امرونه اداره کړي. سربیره پردې، د ویرې اداره کوونکی د ویرې په وخت کې د CONFIG_ESP_SYSTEM_PANIC د GDBStub ته تنظیم کولو سره د GDBStub چلولو لپاره تنظیم کیدی شي. کله چې حادثه رامنځته شي، GDBStub به د سیریل پورټ په اوږدو کې یو ځانګړی تار نمونه تولید کړي ترڅو وښيي چې دا روان دی. په دواړو حالتونو کې (یعنې، د Ctrl+C پیغام لیږل، یا د ځانګړي تار نمونه ترلاسه کول)، IDF مانیټر به په اتوماتيک ډول GDB پیل کړي ترڅو کارونکي ته اجازه ورکړي چې د ډیبګ کولو امرونه واستوي. د GDB له وتلو وروسته، هدف د RTS سریال لاین له لارې بیا تنظیم کیږي. که چیرې دا لاین وصل نه وي، کاروونکي کولی شي خپل هدف بیا تنظیم کړي (د بورډونو د بیا تنظیم کولو تڼۍ په فشارولو سره).
یادونه: په شاليد کې، IDF مانیټر د GDB د پیلولو لپاره لاندې قومانده چلوي:
xtensa-esp32-elf-gdb -ex "د سریال باډ تنظیم کړئ BAUD" -ex "د ریموټ هدف پورټ" -ex مداخله جوړونه/PROJECT.elf :idf_target: `سلام نوم چپ`

د آوټ پټ فلټر کول د IDF مانیټر د idf.py مانیټر –print-filter=”xyz” په توګه کارول کیدی شي، چیرې چې –print-filter د آوټ پټ فلټر کولو لپاره پیرامیټر دی. ډیفالټ ارزښت یو خالي تار دی، پدې معنی چې هرڅه چاپ شوي دي.
د چاپولو لپاره محدودیتونه د لړۍ په توګه مشخص کیدی شيtag>: توکي چیرته چېtag> دی tag تار او د {N, E, W, I, D, V, *} سیټ څخه یو کرکټر دی چې د ننوتلو لپاره یوې کچې ته اشاره کوي.
د مثال لپارهample، PRINT_FILTER="tag۱:W” یوازې د ESP_LOGW(“) سره لیکل شوي محصولات سره سمون خوري او چاپوي.tag۱”، …) یا د ټیټې فعلي کچې په توګه، د بیلګې په توګه ESP_LOGE(“tag۱″، …). د مشخص کولو نه یا د وربوز کچې ته د * ډیفالټ کارول.
یادونه: د لاګنګ کتابتون له لارې د غیر ضروري محصولاتو د تالیف کولو په وخت کې د لومړني لاګنګ څخه کار واخلئ. د IDF مانیټر سره د آوټ پټ فلټر کول یو ثانوي حل دی چې د غوښتنلیک بیا تالیف کولو پرته د فلټر کولو اختیارونو تنظیم کولو لپاره ګټور کیدی شي.
ستاسو اپلیکیشن tags باید تشې، ستوري *، یا کولونونه ونه لري: ترڅو د محصول فلټر کولو ځانګړتیا سره مطابقت ولري.
که ستاسو په اپلیکیشن کې د محصول وروستۍ کرښه د کیریج بیرته راستنیدو سره تعقیب نشي، د محصول فلټر کول ممکن ګډوډ شي، د بیلګې په توګه، مانیټر د کرښې چاپ کول پیل کوي او وروسته پوهیږي چې کرښه باید نه وي لیکل شوې. دا یوه پیژندل شوې ستونزه ده او تل د کیریج بیرته راستنیدو اضافه کولو سره مخنیوی کیدی شي (په ځانګړي توګه کله چې هیڅ محصول سمدلاسه وروسته نه تعقیب کیږي).

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
Exampد فلټر کولو قواعدو لنډیز:
· * د هر ډول سره سمون لپاره کارول کیدی شي tags. په هرصورت، د PRINT_FILTER=”*:I تار tag۱:E" په اړه tag۱ یوازې غلطۍ چاپوي، ځکه چې د دې لپاره قاعده tag۱ د * لپاره د قاعدې په پرتله لوړ لومړیتوب لري.
· د ډیفالټ (خالي) قاعده د *:V سره مساوي ده ځکه چې د هر سره سمون خوري tag په لفظي کچه یا ټیټه معنی د هرڅه سره سمون خوري.
· "*:N" نه یوازې د لاګ کولو دندو څخه ترلاسه شوي پایلې، بلکې د printf او نورو لخوا جوړ شوي چاپونه هم بندوي. د دې څخه د مخنیوي لپاره، *:E یا د لوړې فعلي کچې څخه کار واخلئ.
· قواعد “tag۱: وي"، "tag۱:v"، "tag۱:"، "tag۱:*"، او "tag۱” مساوي دي. · قاعده “tag۱: څ tag۱:E" د "سره برابر دی"tag۱:E" ځکه چې د ورته پیښې هر ډول پایله tag
نوم پخوانی نوم بدلوي. · قاعده "tag1: زه tag2:W” یوازې چاپ کوي tag۱ د معلوماتو د فعل په کچه یا ټیټ او tag۲ په خبرداري کې
د فعل کچه یا ټیټه. · قاعده "tag1: زه tag۱: څ tag۳:N" په اصل کې د مخکیني سره مساوي دی ځکه چې tag۳:N مشخص کوي
هغه tag۳ باید چاپ نشي. · tag۳:N په قاعده کې "tag1: زه tag۱: څ tag3:N *:V” ډیر معنی لري ځکه چې پرته له tag۳: د
tag۳ پیغامونه چاپ کېدای شول؛ د دې لپاره تېروتنې tag1 او tag۲ به په ټاکل شوي (یا ټیټ) فعلي کچه کې چاپ شي او نور هرڅه به په ډیفالټ ډول چاپ شي.
د فلټر کولو یو ډیر پیچلی مثالample لاندې د لاګ ټوټه د فلټر کولو اختیارونو پرته ترلاسه شوه:
load:0x40078000,len:13564 داخله 0x40078d4c E (31) esp_image: په 0x30000 کې انځور غلط جادو بایټ لري W (31) esp_image: په 0x30000 کې انځور غلط SPI حالت لري 255 E (39) بوټ: د فابریکې اپلیکیشن ویش د بوټ کولو وړ ندی I (568) cpu_start: Pro cpu up. I (569) heap_init: پیل کول. د متحرک تخصیص لپاره RAM شتون لري: I (603) cpu_start: Pro cpu د کارونکي کوډ D (309) light_driver: [light_init، 74]: حالت: 1، حالت: 2 D (318) vfs: esp_vfs_register_fd_range د رینج لپاره بریالی دی <54; 64) او VFS ID 1 I (328) wifi: wifi چلوونکي دنده: 3ffdbf84، prio:23، stack:4096، core=0
د فلټر کولو انتخابونو لپاره نیول شوی محصول PRINT_FILTER=”wifi esp_image:E light_driver:I” لاندې ورکړل شوی دی:
E (31) esp_image: په 0x30000 کې انځور ناسم جادو بایټ لري I (328) وائی فای: د وائی فای ډرایور دنده: 3ffdbf84، prio:23، سټیک:4096، کور=0
د "PRINT_FILTER="light_driver:D esp_image:N boot:N cpu_start:N vfs:N wifi:N *:V" انتخابونه لاندې محصول ښیې:
load:0x40078000,len:13564 داخله 0x40078d4c I (569) heap_init: پیل کول. د متحرک تخصیص لپاره RAM شتون لري: D (309) light_driver: [light_init, 74]: حالت: 1, حالت: 2
د IDF مانیټر سره پیژندل شوې ستونزې
په وینډوز کې لیدل شوي مسایل
· د وینډوز کنسول محدودیتونو له امله د تیر کیلي، او همدارنګه ځینې نورې کیلي، په GDB کې کار نه کوي. · کله ناکله، کله چې oidf.pypexits، دا ممکن د IDF مانیټر بیا پیل کیدو دمخه تر 30 ثانیو پورې ودریږي. · کله چې ogdbpis چلیږي، دا ممکن د GDBStub سره د اړیکو پیل کولو دمخه د لنډ وخت لپاره ودریږي.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. د لینکس او ماکوس لپاره د معیاري وسیلې زنځیر تنظیم پیل کړئ

ګام په ګام نصب کول دا یو مفصل سړک نقشه ده چې تاسو ته د نصبولو پروسې له لارې لارښوونه کوي.
د پراختیایي چاپیریال تنظیم کول دا ستاسو د ESP32 لپاره د ESP-IDF تنظیم کولو لپاره ګامونه دي. · لومړی ګام. د اړتیا وړ اړتیاوې نصب کړئ · دوهم ګام. د ESP-IDF ترلاسه کړئ · دریم ګام. وسایل تنظیم کړئ · څلورم ګام. د چاپیریال متغیرات تنظیم کړئ · پنځم ګام. د ESP-IDF په اړه لومړني ګامونه
لومړی ګام. د نصبولو اړتیاوې د ESP32 سره د ESP-IDF کارولو لپاره، تاسو اړتیا لرئ چې د خپل عملیاتي سیسټم پر بنسټ ځینې سافټویر پیکجونه نصب کړئ. دا د تنظیم لارښود به تاسو سره د لینکس او macOS پر بنسټ سیسټمونو کې هرڅه نصبولو کې مرسته وکړي.
د لینوکس کاروونکو لپاره د ESP-IDF په کارولو سره د تالیف کولو لپاره تاسو باید لاندې کڅوړې ترلاسه کړئ. د چلولو قومانده د لینکس کوم ویش پورې اړه لري چې تاسو یې کاروئ:
· اوبنټو او ډیبیان: sudo apt-get install git wget flex bison gperf python3 python3-pip python3venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
· CentOS 7 او 8: sudo yum -y تازه معلومات && sudo yum نصب کړئ git wget flex bison gperf python3 cmake ninja-build ccache dfu-util libusbx
CentOS 7 لا هم ملاتړ کیږي مګر د کاروونکي د غوره تجربې لپاره د CentOS نسخه 8 سپارښتنه کیږي. · Arch: sudo pacman -S –needed gcc git make flex bison gperf python cmake ninja ccache dfu-util libusb
یادونه: · د ESP-IDF سره د کارولو لپاره د CMake نسخه 3.16 یا نوي ته اړتیا ده. که ستاسو د عملیاتي سیسټم نسخې مناسب نسخه نه لري نو د نصبولو لپاره otools/idf_tools.py install cmakep چل کړئ. · که تاسو په پورته لیست کې خپل لینکس ویش نه ګورئ نو مهرباني وکړئ د هغې اسناد وګورئ ترڅو ومومئ چې د پیکج نصبولو لپاره کوم قومانده وکاروئ.
د macOS کاروونکو لپاره ESP-IDF به د macOS په ډیفالټ ډول د Python نصب شوی نسخه وکاروي. · د CMake او Ninja جوړونه نصب کړئ: که تاسو HomeBrew لرئ، تاسو کولی شئ دا چل کړئ: brew install cmake ninja dfu-util که تاسو MacPorts لرئ، تاسو کولی شئ دا چل کړئ: sudo port install cmake ninja dfu-util که نه نو، د macOS نصبولو ډاونلوډونو لپاره د CMake او Ninja کور پاڼو سره مشوره وکړئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
· د چټکو جوړونو لپاره د ccache نصبولو سپارښتنه هم کیږي. که تاسو HomeBrew لرئ، نو دا د brew install ccache یا sudo port install ccache له لارې په MacPorts کې ترسره کیدی شي.
یادونه: که چیرې د دې په څیر تېروتنه د هر ګام په جریان کې ښکاره شي: xcrun: تېروتنه: د فعال پراختیا کونکي ناسمه لاره (/Library/Developer/CommandLineTools)، په /Library/Developer/CommandLineTools/usr/bin/xcrun کې xcrun ورک دی
بیا به تاسو د دوام ورکولو لپاره د ایکس کوډ کمانډ لاین اوزار نصبولو ته اړتیا ولرئ. تاسو کولی شئ دا د ایکس کوډ-سیلیک -انسټال په چلولو سره نصب کړئ.
د ایپل M1 کاروونکي که تاسو د ایپل M1 پلیټ فارم کاروئ او د دې په څیر یوه تېروتنه وګورئ: خبرداری: د وسیلې xtensa-esp32-elf نسخه esp-2021r2-patch3-8.4.0 لپاره لارښود شتون لري، مګر وسیله ونه موندل شوه تېروتنه: وسیله xtensa-esp32-elf هیڅ نصب شوي نسخه نلري. مهرباني وکړئ د نصبولو لپاره 'install.sh' چل کړئ.
یا: zsh: د اجرا وړ وړ کې د CPU خراب ډول: ~/.espressif/tools/xtensa-esp32-elf/esp-2021r2patch3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
بیا به تاسو د /usr/sbin/softwareupdate –install-rosetta –agree-to-license په چلولو سره د Apple Rosetta 2 نصبولو ته اړتیا ولرئ.
د پایتون ۳ نصب کول د macOS Catalina 10.15 د خپریدو یادښتونو پراساس، د پایتون 2.7 کارول سپارښتنه نه کیږي او پایتون 2.7 به د macOS په راتلونکو نسخو کې په ډیفالټ ډول شامل نه شي. وګورئ چې تاسو اوس مهال کوم پایتون لرئ: python –version
که چیرې محصول د پایتون ۲.۷.۱۷ په څیر وي، نو ستاسو ډیفالټ ژباړونکی پایتون ۲.۷ دی. که داسې وي، نو دا هم وګورئ چې آیا پایتون ۳ لا دمخه ستاسو په کمپیوټر کې نصب شوی نه دی: python3 –version
که پورته کمانډ تېروتنه راولي، دا پدې مانا ده چې پایتون 3 نصب شوی نه دی. لاندې یو اوور دیview د پایتون ۳ نصبولو لپاره ګامونه.
· د هومبریو سره نصب کول په لاندې ډول ترسره کیدی شي: brew install python3
· که تاسو مک پورټونه لرئ، تاسو کولی شئ دا چل کړئ: sudo port install python38
دوهم ګام. د ESP-IDF ترلاسه کول د ESP32 لپاره د اپلیکېشنونو جوړولو لپاره، تاسو د Espressif لخوا د ESP-IDF ذخیره کې چمتو شوي سافټویر کتابتونونو ته اړتیا لرئ. د ESP-IDF ترلاسه کولو لپاره، خپل د نصبولو لارښود ته لاړ شئ او د git clone سره ذخیره کلون کړئ، لاندې لارښوونې تعقیب کړئ چې ستاسو د عملیاتي سیسټم لپاره ځانګړي دي. ټرمینل پرانیزئ، او لاندې قوماندې پرمخ بوځئ:

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

mkdir -p ~/esp cd ~/esp git کلون -b v5.0.9 – تکراري https://github.com/espressif/esp-idf.git
ESP-IDF به په ~/esp/esp-idf کې ډاونلوډ شي. د معلوماتو لپاره د ESP-IDF نسخو سره مشوره وکړئ چې کوم ESP-IDF نسخه په ورکړل شوي حالت کې کارول کیږي.
دریم ګام. وسایل تنظیم کړئ د ESP-IDF سربیره، تاسو اړتیا لرئ هغه وسایل هم نصب کړئ چې د ESP-IDF لخوا کارول کیږي، لکه کمپائلر، ډیبګر، پایتون پیکجونه، او نور، د ESP32 ملاتړ کونکو پروژو لپاره. cd ~/esp/esp-idf ./install.sh esp32
یا د فش شیل سي ډي سره ~/esp/esp-idf ./install.fish esp32
پورته امرونه یوازې د ESP32 لپاره وسایل نصبوي. که تاسو د نورو چپ هدفونو لپاره پروژې رامینځته کولو اراده لرئ نو تاسو باید ټول یې لیست کړئ او د پخواني لپاره یې پرمخ بوځئample: سي ډي ~/esp/esp-idf ./install.sh esp32,esp32s2
یا د فش شیل سي ډي سره ~/esp/esp-idf ./install.fish esp32,esp32s2
د ټولو ملاتړ شویو هدفونو لپاره د وسایلو د نصبولو لپاره مهرباني وکړئ لاندې کمانډ چل کړئ: cd ~/esp/esp-idf ./install.sh all
یا د فش شیل سي ډي سره ~/esp/esp-idf ./install.fish ټول
یادونه: د macOS کاروونکو لپاره، که چیرې د هر ګام په جریان کې داسې تېروتنه ښکاره شي:urlد خلاصولو تېروتنه [SSL: CERTIFICATE_VERIFY_FAILED] د سند تایید ناکام شو: د سیمه ایز جاري کونکي سند ترلاسه کولو توان نلري (_ssl.c:xxx)
تاسو کولی شئ د خپل کمپیوټر په پایتون فولډر کې د سندونو نصبولو لپاره د Certificates.command نصب کړئ. د جزیاتو لپاره، د ESP-IDF وسیلو نصبولو پرمهال د ډاونلوډ تېروتنه وګورئ.

بدیل File ډاونلوډونه د وسیلو انسټالر یو شمیر ډاونلوډ کوي files د GitHub ریلیزونو سره وصل دي. که چیرې GitHub ته لاسرسی ورو وي نو دا ممکنه ده چې د GitHub شتمنیو ډاونلوډونو لپاره د Espressifns ډاونلوډ سرور غوره کولو لپاره د چاپیریال متغیر تنظیم کړئ.

یادونه: دا ترتیب یوازې د GitHub ریلیزونو څخه ډاونلوډ شوي انفرادي وسایل کنټرولوي، دا بدلون نه راوړي URLد Git زیرمو ته د لاسرسي لپاره کارول کیږي.

د وسیلو د نصبولو پر مهال د ایسپریسیف ډاونلوډ سرور غوره کولو لپاره، د install.sh چلولو پر مهال د لاندې امرونو لړۍ وکاروئ:

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

سي ډي ~/esp/esp-idf صادرات IDF_GITHUB_ASSETS=”dl.espressif.com/github_assets” ./install.sh
د وسیلو د نصبولو لاره تنظیمول په دې مرحله کې معرفي شوي سکریپټونه د ESP-IDF لخوا اړین د کارونکي کور ډایرکټرۍ کې د نصبولو تالیف وسیلې: $HOME/.espressif په لینکس کې. که تاسو غواړئ وسایل په بل ډایرکټرۍ کې نصب کړئ، د نصبولو سکریپټونو چلولو دمخه د چاپیریال متغیر IDF_TOOLS_PATH تنظیم کړئ. ډاډ ترلاسه کړئ چې ستاسو د کارونکي حساب د دې لارې لوستلو او لیکلو لپاره کافي اجازه لري. که چیرې IDF_TOOLS_PATH بدل کړئ، ډاډ ترلاسه کړئ چې دا هرکله چې د نصب سکریپټ (install.bat، install.ps1 یا install.sh) او د صادراتو سکریپټ (export.bat، export.ps1 یا export.sh) اجرا کیږي نو ورته ارزښت ته تنظیم شوی.
څلورم ګام. د چاپیریال متغیرات تنظیم کړئ نصب شوي وسایل لا تر اوسه د PATH چاپیریال متغیر ته ندي اضافه شوي. د دې لپاره چې وسایل د قوماندې لاین څخه د کارولو وړ شي، ځینې چاپیریال متغیرات باید تنظیم شي. ESP-IDF یو بل سکریپټ چمتو کوي چې دا کار کوي. په ټرمینل کې چیرې چې تاسو به ESP-IDF وکاروئ، لاندې چل کړئ:
. $HOME/esp/esp-idf/export.sh
یا د کب لپاره (یوازې د کب نسخې 3.0.0 راهیسې ملاتړ شوی):
. $HOME/esp/esp-idf/export.fish
د مخکښې نقطې او لارې ترمنځ ځای ته پام وکړئ! که تاسو پلان لرئ چې esp-idf په مکرر ډول وکاروئ، تاسو کولی شئ د export.sh اجرا کولو لپاره یو عرف جوړ کړئ:
۱. لاندې کمانډ کاپي او خپل shellns pro ته پیسټ کړئfile (.profile، .bashrc، .zprofileاو داسې نور)
alias get_idf='. $HOME/esp/esp-idf/export.sh' ۲. د ټرمینل سیشن بیا پیلولو یا د سرچینې [پرو ته لاره] چلولو سره ترتیب تازه کړئfile],
د مثال لپارهample، source ~/.bashrc. اوس تاسو کولی شئ په هر ټرمینل سیشن کې د esp-idf چاپیریال تنظیم یا تازه کولو لپاره get_idf چل کړئ. په تخنیکي توګه، تاسو کولی شئ export.sh خپل shellns pro ته اضافه کړئ.file مستقیم؛ په هرصورت، دا سپارښتنه نه کیږي. دا کار په هر ټرمینل سیشن کې د IDF مجازی چاپیریال فعالوي (په شمول د هغو کسانو چې IDF ته اړتیا نلري)، د مجازی چاپیریال هدف ماتوي او احتمال لري چې نور سافټویر اغیزمن کړي.
پنځم ګام. د ESP-IDF په اړه لومړني ګامونه اوس چې ټولې اړتیاوې پوره شوې، راتلونکې موضوع به تاسو ته لارښوونه وکړي چې څنګه خپل لومړی پروژه پیل کړئ. دا لارښود به تاسو سره د ESP-IDF کارولو په لومړیو مرحلو کې مرسته وکړي. دا لارښود تعقیب کړئ ترڅو په ESP32 کې نوې پروژه پیل کړئ او د وسیلې محصول جوړ کړئ، فلش کړئ او څارنه وکړئ.
یادونه: که تاسو تراوسه ESP-IDF نه دی نصب کړی، مهرباني وکړئ نصب ته لاړ شئ او لارښوونې تعقیب کړئ ترڅو د دې لارښود کارولو لپاره اړین ټول سافټویر ترلاسه کړئ.

پروژه پیل کړئ اوس تاسو د ESP32 لپاره خپل غوښتنلیک چمتو کولو ته چمتو یاست. تاسو کولی شئ د getstarted/hello_world پروژې سره د پخواني څخه پیل وکړئ.amples لارښود په ESP-IDF کې.

مهم: د ESP-IDF جوړونې سیسټم د ESP-IDF یا پروژو ته په لارو کې د ځایونو ملاتړ نه کوي.

پروژه get-started/hello_world د ~/esp ډایرکټرۍ ته کاپي کړئ:

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
cd ~/esp cp -r $IDF_PATH/examples/get-started/hello_world.
یادونه: د پخوانیو لړۍ شتون لريample پروژې په examples لارښود په ESP-IDF کې. تاسو کولی شئ هره پروژه په ورته ډول کاپي کړئ لکه څنګه چې پورته وړاندې شوي او پرمخ وړئ. دا هم ممکنه ده چې پخواني جوړ کړيampپرته له دې چې لومړی یې کاپي کړئ، په خپل ځای کې یې واچوئ.
خپل وسیله وصل کړئ اوس خپل ESP32 بورډ کمپیوټر سره وصل کړئ او وګورئ چې بورډ د کوم سیریل پورټ لاندې لیدل کیږي. سیریل پورټونه لاندې نومونې نمونې لري:
· لینکس: د /dev/tty سره پیل کیږي · macOS: د /dev/cu سره پیل کیږي. که تاسو ډاډه نه یاست چې څنګه د سریال پورټ نوم وګورئ، مهرباني وکړئ د بشپړ توضیحاتو لپاره د ESP32 سره د سریال اتصال رامینځته کولو ته مراجعه وکړئ.
یادونه: د پورټ نوم په لاس کې وساتئ ځکه چې تاسو به ورته په راتلونکو ګامونو کې اړتیا ولرئ.
خپل پروژه تنظیم کړئ خپل hello_world ډایرکټرۍ ته لاړ شئ، ESP32 د هدف په توګه وټاکئ، او د پروژې ترتیب کولو یوټیلټي مینوکونفګ چل کړئ. cd ~/esp/hello_world idf.py set-target esp32 idf.py menuconfig
د یوې نوې پروژې له پرانیستلو وروسته، تاسو باید لومړی د idf.py set-target esp32 سره هدف وټاکئ. په یاد ولرئ چې په پروژه کې موجوده جوړونه او تشکیلات، که کوم وي، به پدې پروسه کې پاک او پیل شي. هدف ممکن د چاپیریال متغیر کې خوندي شي ترڅو دا ګام په بشپړ ډول پریږدئ. د اضافي معلوماتو لپاره د هدف چپ غوره کړئ: set-target وګورئ. که چیرې مخکیني ګامونه په سمه توګه ترسره شوي وي، لاندې مینو ښکاري:

شکل ۱۷: د پروژې ترتیب - کور کړکۍ تاسو دا مینو د پروژې ځانګړي متغیراتو تنظیم کولو لپاره کاروئ، د بیلګې په توګه، د وای فای شبکې نوم او پټنوم، د پروسیسر سرعت، او نور. د مینو کنفیګ سره د پروژې تنظیم کول ممکن د ohello_worldp لپاره پریښودل شي، ځکه چې دا پخوانیampسره منډه وهي

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
ډیفالټ ترتیب.
پاملرنه: که تاسو د ESP32-SOLO-1 ماډل سره ESP32-DevKitC بورډ کاروئ، یا د ESP32-DevKitM-1 بورډ د ESP32-MIN1-1(1U) ماډل سره کاروئ، مهرباني وکړئ د فلش کولو دمخه په مینو کنفیګ کې د واحد کور حالت (CONFIG_FREERTOS_UNICORE) فعال کړئ.amples.
یادونه: د مینو رنګونه ستاسو په ټرمینل کې مختلف کیدی شي. تاسو کولی شئ د –style اختیار سره بڼه بدله کړئ. مهرباني وکړئ د نورو معلوماتو لپاره idf.py menuconfig –help چل کړئ.
که تاسو د ملاتړ شوي پراختیایي بورډونو څخه یو کاروئ، تاسو کولی شئ د بورډ ملاتړ کڅوړې په کارولو سره خپل پراختیا ګړندۍ کړئ. د نورو معلوماتو لپاره اضافي لارښوونې وګورئ.
پروژه جوړه کړئ پروژه د لاندې چلولو له لارې جوړه کړئ:
idf.py جوړول
دا کمانډ به غوښتنلیک او د ESP-IDF ټولې برخې تالیف کړي ، بیا به دا بوټلوډر ، د برخې جدول ، او غوښتنلیک بائنری رامینځته کړي.
$ idf.py build په /path/to/hello_world/build ډایرکټرۍ کې cmake چلول د "cmake -G Ninja –warn-uninitialized /path/to/hello_world" اجرا کول… د نه پیل شوي ارزښتونو په اړه خبرداری ورکول. — Git وموندل شو: /usr/bin/git (نسخه "2.17.0" وموندل شوه) — د ترتیب له امله د خالي aws_iot برخې جوړول — د اجزاو نومونه: … — د اجزاو لارې: …
… (د سیسټم تولید د جوړولو نورې کرښې)
[527/527] د hello_world.bin esptool.py v2.3.1 تولید کول
د پروژې جوړول بشپړ شول. د فلش کولو لپاره، دا قومانده پرمخ بوځئ: ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash -flash_mode dio –flash_size detect –flash_freq 40m 0x10000 build/hello_world. bin build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/ partition-table.bin یا 'idf.py -p PORT flash' چل کړئ
که کومه تېروتنه نه وي، جوړونه به د فرم ویئر بائنری .bin په جوړولو سره پای ته ورسیږي files.
په وسیله فلش کړئ هغه بائنریونه چې تاسو یې جوړ کړي دي (bootloader.bin، partition-table.bin او hello_world.bin) په خپل ESP32 بورډ کې د لاندې چلولو سره فلش کړئ:
idf.py -p پورټ [-b BAUD] فلش
PORT د خپل ESP32 بورډونو سیریل پورټ نوم سره بدل کړئ. تاسو کولی شئ د فلشیر باډ نرخ د BAUD په ځای د هغه باډ نرخ سره بدل کړئ چې تاسو ورته اړتیا لرئ. د ډیفالټ باډ نرخ 460800 دی. د idf.py دلیلونو په اړه د نورو معلوماتو لپاره، idf.py وګورئ.
یادونه: د فلش اختیار په اتوماتيک ډول پروژه جوړوي او فلش کوي، نو د idf.py build چلول اړین ندي.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ

د فلش کولو پرمهال له ستونزو سره مخ شوي یاست؟ که تاسو ورکړل شوی قومانده پرمخ وړئ او د oFailed to connectp په څیر غلطۍ وګورئ، نو د دې لپاره ډیری دلیلونه کیدی شي. یو دلیل ممکن د esptool.py لخوا ورسره مخ شوي ستونزې وي، هغه یوټیلټي چې د جوړونکي سیسټم لخوا د چپ بیا تنظیمولو، د ROM بوټلوډر سره تعامل کولو، او فلش فرم ویئر لپاره ویل کیږي. د هڅه کولو لپاره یوه ساده حل د لاسي بیا تنظیم کول دي چې لاندې تشریح شوي، او که دا مرسته ونکړي تاسو کولی شئ د ستونزو حل کولو کې د ممکنه ستونزو په اړه نور توضیحات ومومئ.
esptool.py د USB د DTR او RTS کنټرول لاینونو ته د سیریل کنورټر چپ، یعنې FTDI یا CP210x په تاییدولو سره ESP32 په اتوماتيک ډول بیا تنظیموي (د نورو معلوماتو لپاره، د ESP32 سره د سریال اتصال رامینځته کول وګورئ). د DTR او RTS کنټرول لاینونه په بدل کې د ESP32 د GPIO0 او CHIP_PU (EN) پنونو سره وصل دي، پدې توګه په حجم کې بدلون راځي.tagد DTR او RTS e کچه به ESP32 د فرم ویئر ډاونلوډ حالت کې بوټ کړي. د مثال په توګهample، د ESP32 DevKitC پراختیایي بورډ لپاره سکیماتیک وګورئ.
په عمومي توګه، تاسو باید د رسمي esp-idf پراختیایي بورډونو سره کومه ستونزه ونلرئ. په هرصورت، esptool.py نشي کولی ستاسو هارډویر په لاندې قضیو کې په اتوماتيک ډول بیا تنظیم کړي:
· ستاسو هارډویر د GPIO0 او CHIP_PU سره د DTR او RTS لاینونه نه لري · د DTR او RTS لاینونه په مختلف ډول تنظیم شوي · داسې هیڅ سریال کنټرول لاینونه شتون نلري.
د هغه هارډویر ډول پورې اړه لري چې تاسو یې لرئ، دا هم ممکن وي چې خپل ESP32 بورډ په لاسي ډول د فرم ویئر ډاونلوډ حالت (ری سیٹ) ته واچوئ.
· د ایسپریسیف لخوا تولید شوي پراختیایي بورډونو لپاره، دا معلومات د پیل کولو اړوند لارښودونو یا د کارونکي لارښودونو کې موندل کیدی شي. د مثال په توګهampد ESP-IDF پراختیایي بورډ په لاسي ډول بیا تنظیمولو لپاره، د بوټ تڼۍ (GPIO0) ونیسئ او د EN تڼۍ (CHIP_PU) فشار ورکړئ.
· د نورو ډولونو هارډویر لپاره، هڅه وکړئ چې GPIO0 ښکته کش کړئ.

نورمال عملیات کله چې چمکۍ، تاسو به د محصول لاګ د لاندې سره ورته وګورئ:
… esptool.py –chip esp32 -p /dev/ttyUSB0 -b 460800 –before=default_reset -after=hard_reset write_flash –flash_mode dio –flash_freq 40m –flash_size 2MB 0x8000 partition_table/partition-table.bin 0x1000 bootloader/bootloader.bin 0x10000 hello_world.bin esptool.py v3.0-dev سیریل پورټ /dev/ttyUSB0 نښلول…….._ چپ ESP32D0WDQ6 دی (بیاکتنه 0) ځانګړتیاوې: وای فای، BT، دوه ګونی کور، د کوډ کولو سکیم هیڅ نه کرسټال 40MHz دی MAC: 24:0a:c4:05:b9:14 سټب اپلوډ کول… سټب چلول… سټب چلول… د باډ نرخ 460800 ته بدلول بدل شوي. د فلش اندازه تنظیمول… ۳۰۷۲ بایټونه تر ۱۰۳ پورې کمپریس شوي… په ۰x۰۰۰۰۸۰۰۰ لیکل… (۱۰۰٪) په ۰.۰ ثانیو کې په ۰x۰۰۰۰۸۰۰۰ کې ۳۰۷۲ بایټونه (۱۰۳ کمپریس شوي) لیکلي (مؤثر ۵۹۶۲.۸ کیلوبایټ/سیکنډ)… د معلوماتو هش تایید شوی. ۲۶۰۹۶ بایټونه تر ۱۵۴۰۸ پورې کمپریس شوي… په ۰x۰۰۰۰۱۰۰۰ کې لیکل… (۱۰۰٪) په ۰.۴ ثانیو کې په ۰x۰۰۰۰۱۰۰۰ کې ۲۶۰۹۶ بایټونه (۱۵۴۰۸ کمپریس شوي) لیکلي (مؤثر ۵۴۶.۷ کیلوبایټ/سیکنډ)… د معلوماتو هش تایید شوی. ۱۴۷۱۰۴ بایټونه تر ۷۷۳۶۴ پورې کمپریس شوي… په ۰x۰۰۱۰۰۰۰۰۰ لیکل… (۲۰٪) په ۰x۰۰۱۴۰۰۰ لیکل… (۴۰٪) په ۰x۰۰۱۸۰۰۰ لیکل… (۶۰٪) په ۰x۰۰۱c۰۰۰ لیکل… (۸۰٪)
(په راتلونکې پاڼه کې دوام لري)

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
(له پخوانۍ پاڼې څخه دوام لري) په 0x00020000 لیکل… (100%) په 0x00010000 کې په 1.9 ثانیو کې 147104 بایټس (77364 کمپریس شوي) لیکلي (مؤثر 615. 5 kbit/s)… د معلوماتو هش تایید شوی.
پریښودل… د RTS پن له لارې سخت بیا تنظیم کول… بشپړ شو
که چیرې د فلش پروسې تر پایه پورې کومه ستونزه نه وي، نو بورډ به ریبوټ شي او theohello_worldp اپلیکیشن به پیل کړي. که تاسو غواړئ د idf.py چلولو پرځای د Eclipse یا VS Code IDE وکاروئ، نو د Eclipse Plugin، VSCode Extension وګورئ.
د محصول څارنه د دې لپاره چې وګورئ چې ohello_worldpis په ریښتیا سره روان دی، idf.py -p PORT monitor ولیکئ (مه هیروئ چې PORT د خپل سریال پورټ نوم سره بدل کړئ). دا قومانده د IDF مانیټر اپلیکیشن پیلوي:
$ idf.py -p څارنه په ډایرکټرۍ کې د idf_monitor چلول […]/esp/hello_world/build د "python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_ world/build/hello_world.elf" اجرا کول… — idf_monitor فعال دی ۱۱۵۲۰۰ —– پریږدئ: Ctrl+] | مینو: Ctrl+T | مرسته: Ctrl+T ورپسې Ctrl+H –ets جون ۸ ۲۰۱۶ ۰۰:۲۲:۵۷
لومړی: 0x1 (POWERON_RESET)، بوټ: 0x13 (SPI_FAST_FLASH_BOOT) ets د جون ۸، ۲۰۱۶ ۰۰:۲۲:۵۷ …
د پیل او تشخیصي لاګونو پورته سکرول کولو وروسته، تاسو باید د oHello world! اپلیکیشن لخوا چاپ شوی وګورئ.
... سلام نړۍ! په ۱۰ ثانیو کې بیا پیل کیږي ... دا د esp32 چپ دی چې د ۲ CPU کور (کورونه)، وای فای/BT/BLE، سیلیکون بیاکتنه ۱، ۲MB بهرنۍ فلش لري لږترلږه وړیا هپ اندازه: ۲۹۸۹۶۸ بایټس په ۹ ثانیو کې بیا پیل کیږي ... په ۸ ثانیو کې بیا پیل کیږي ... په ۷ ثانیو کې بیا پیل کیږي ...
د IDF مانیټر څخه د وتلو لپاره د Ctrl+] لنډه لاره وکاروئ. که چیرې د IDF مانیټر د اپلوډ څخه لږ وروسته ناکام شي، یا، که د پورته پیغامونو پرځای، تاسو د هغه څه سره ورته ناڅاپي کثافات وګورئ چې لاندې ورکړل شوي، ستاسو بورډ احتمال لري چې د 26 MHz کرسټال کاروي. ډیری پراختیایی بورډ ډیزاینونه 40 MHz کاروي، نو ESP-IDF دا فریکونسي د ډیفالټ ارزښت په توګه کاروي.

که تاسو داسې ستونزه لرئ، لاندې کارونه وکړئ:
۱. له مانیټر څخه ووځئ. ۲. بیرته مینو کنفیګ ته لاړ شئ. ۳. د اجزاو ترتیب> هارډویر ترتیبات> اصلي XTAL ترتیب> اصلي XTAL ته لاړ شئ.
فریکونسی، بیا CONFIG_XTAL_FREQ_SEL 26 MHz ته بدل کړئ. 4. له هغې وروسته، اپلیکیشن بیا جوړ او فلش کړئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
د ESP-IDF په اوسني نسخه کې، د ESP32 لخوا ملاتړ شوي اصلي XTAL فریکونسۍ په لاندې ډول دي:
· ۲۶ میګاهرتز · ۴۰ میګاهرتز
یادونه: تاسو کولی شئ د idf.py -p PORT فلش مانیټر په چلولو سره په یوه مرحله کې جوړول، فلش کول او څارنه یوځای کړئ.
دا هم وګورئ: · د IDF مانیټر کارولو په اړه د اسانه شارټ کټونو او نورو جزیاتو لپاره IDF مانیټر. · د idf.py امرونو او اختیارونو بشپړ حوالې لپاره idf.py.
دا ټول هغه څه دي چې تاسو ورته اړتیا لرئ د ESP32 سره پیل وکړئ! اوس تاسو چمتو یاست چې یو بل پخوانی هڅه وکړئampکم، یا مستقیم د خپلو غوښتنلیکونو پراختیا ته لاړ شئ.
مهم: ځینې پخوانيampدا د ESP32 ملاتړ نه کوي ځکه چې اړین هارډویر په ESP32 کې شامل نه دی نو دا نشي ملاتړ کیدی. که چیرې یو پخوانی جوړ کړئample، مهرباني وکړئ README وګورئ file د ملاتړ شوي هدفونو جدول لپاره. که چیرې دا د ESP32 هدف په شمول شتون ولري، یا جدول په بشپړ ډول شتون ونلري، نو پخوانیampدا به په ESP32 کې کار وکړي.
اضافي لارښوونې
د اجازې مسلې /dev/ttyUSB0 د ځینو لینکس توزیعونو سره، تاسو ممکن د ESP32 فلش کولو پر مهال د /dev/ttyUSB0 پورټ خلاصولو کې ناکامۍ خطا پیغام ترلاسه کړئ. دا د اوسني کارونکي د ډایل آوټ ګروپ ته اضافه کولو سره حل کیدی شي.
د پایتون مطابقت ESP-IDF د پایتون 3.7 یا نوي ملاتړ کوي. سپارښتنه کیږي چې خپل عملیاتي سیسټم وروستي نسخې ته لوړ کړئ چې دا اړتیا پوره کوي. په نورو انتخابونو کې د سرچینو څخه د پایتون نصب کول یا د پایتون نسخې مدیریت سیسټم لکه pyenv کارول شامل دي.
د بورډ ملاتړ کڅوړې سره پیل وکړئ د ځینو پراختیایي بورډونو کې د پروټوټایپ کولو ګړندی کولو لپاره، تاسو کولی شئ د بورډ ملاتړ کڅوړې (BSPs) وکاروئ، کوم چې د یو ځانګړي بورډ پیل کول د څو فعالیت زنګونو په څیر اسانه کوي. BSP معمولا د پراختیایي بورډ کې چمتو شوي ټولو هارډویر برخو ملاتړ کوي. د پن آوټ تعریف او پیل کولو دندو سربیره، BSP د بهرنیو برخو لکه سینسرونو، ښودنې، آډیو کوډیکونو او نورو لپاره ډرایورونه لیږدوي. BSPs د IDF اجزا مدیر له لارې ویشل شوي، نو دوی د IDF اجزا راجسټری کې موندل کیدی شي. دلته یو مثال دیampستاسو په پروژه کې د ESP-WROVER-KIT BSP اضافه کولو څرنګوالی: idf.py add-dependency esp_wrover_kit
نور پخوانيampد BSP کارولو لنډیزونه په BSP ex کې موندل کیدی شيamples فولډر.
لارښوونه: د ESP-IDF تازه کول سپارښتنه کیږي چې وخت په وخت ESP-IDF تازه کړئ، ځکه چې نوي نسخې بګونه حل کوي او/یا نوي ځانګړتیاوې چمتو کوي. مهرباني وکړئ په یاد ولرئ چې د ESP-IDF هر لوی او کوچنی خوشې کولو نسخه د ملاتړ موده لري، او کله چې یو خوشې کولو څانګه د ژوند پای ته نږدې کیږي (EOL)، ټول کاروونکي هڅول کیږي چې خپلې پروژې د ESP-IDF وروستي خپریدو ته لوړ کړي، د ملاتړ دورې په اړه د نورو معلوماتو موندلو لپاره، د ESP-IDF نسخې وګورئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

لومړی فصل. پیل وکړئ
د تازه کولو لپاره تر ټولو ساده لاره دا ده چې موجوده esp-idf فولډر حذف کړئ او بیا یې کلون کړئ، لکه څنګه چې په دوهم ګام کې تشریح شوي لومړني نصب کول ترسره کوئ. ESP-IDF ترلاسه کړئ. بله حل دا دی چې یوازې هغه څه تازه کړئ چې بدل شوي دي. د تازه کولو پروسه د ESP-IDF په هغه نسخه پورې اړه لري چې تاسو یې کاروئ. د ESP-IDF تازه کولو وروسته، د نصب سکریپټ بیا اجرا کړئ، که چیرې د ESP-IDF نوې نسخه د وسیلو مختلف نسخو ته اړتیا ولري. په دریم ګام کې لارښوونې وګورئ. وسایل تنظیم کړئ. یوځل چې نوي وسایل نصب شي، د صادراتو سکریپټ په کارولو سره چاپیریال تازه کړئ. په څلورم ګام کې لارښوونې وګورئ. د چاپیریال متغیرات تنظیم کړئ.
اړوند اسناد · د ESP32 سره سریال اړیکه ټینګول · د ایکلیپس پلگ ان · د VSCode توسیع · د IDF مانیټر
۱.۴ خپله لومړۍ پروژه جوړه کړئ
که تاسو دمخه ESP-IDF نصب کړی وي او IDE نه کاروئ، تاسو کولی شئ خپله لومړۍ پروژه د وینډوز کې پروژه پیل کړئ یا په لینکس او macOS کې پروژه پیل کړئ وروسته د کمانډ لاین څخه جوړه کړئ.
۱.۵ د ESP-IDF غیر نصب کړئ
که تاسو غواړئ ESP-IDF لرې کړئ، مهرباني وکړئ د ESP-IDF غیر نصب کول تعقیب کړئ.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

څپرکی 2
د API حواله
۲.۱ د API کنوانسیونونه
دا سند هغه کنوانسیونونه او انګیرنې تشریح کوي چې د ESP-IDF د غوښتنلیک پروګرام کولو انٹرفیسونو (APIs) لپاره عام دي. ESP-IDF د پروګرام کولو انٹرفیسونو ډیری ډولونه چمتو کوي:
· د C دندې، جوړښتونه، enums، د ډول تعریفونه او د پری پروسسر میکرو په عامه سرلیک کې اعلان شوي fileد ESPIDF اجزاو. د پروګرام کولو لارښود د API حوالې برخې کې مختلف پاڼې د دې دندو، جوړښتونو او ډولونو توضیحات لري.
· د سیسټم دندې، مخکې ټاکل شوي متغیرات او اختیارونه جوړ کړئ. دا د جوړونې سیسټم لارښود کې مستند شوي دي. · د Kconfig اختیارونه په کوډ او د جوړونې سیسټم کې کارول کیدی شي (CMakeLists.txt) files. · کوربه وسیلې او د دوی د قوماندې لاین پیرامیټرونه هم د ESP-IDF انٹرفیس برخه ده. ESP-IDF هغه برخې لري چې په ځانګړي ډول د ESP-IDF او همدارنګه د دریمې ډلې کتابتونونو لپاره لیکل شوي. په ځینو مواردو کې، د ESP-IDF ځانګړي ریپر د دریمې ډلې کتابتون ته اضافه کیږي، یو انٹرفیس چمتو کوي چې یا ساده وي یا د نورو ESP-IDF اسانتیاوو سره ښه مدغم وي. په نورو قضیو کې، د دریمې ډلې کتابتون اصلي API د غوښتنلیک پراختیا کونکو ته وړاندې کیږي. لاندې برخې د ESP-IDF APIs او د دوی کارولو ځینې اړخونه تشریح کوي.
د ایکسینیم ایکسډ کولو تېروتنه
ډیری ESP-IDF APIs د esp_err_t ډول سره تعریف شوي د غلطۍ کوډونه بیرته راګرځوي. د غلطۍ اداره کولو طریقو په اړه د نورو معلوماتو لپاره د غلطۍ اداره کولو برخه وګورئ. د غلطۍ کوډ حواله د ESP-IDF اجزاو لخوا بیرته راستانه شوي د غلطۍ کوډونو لیست لري.
۲.۱.۲ د تشکیلاتو جوړښتونه
مهم: د ترتیب جوړښتونو سمه پیل کول د ESP-IDF د راتلونکو نسخو سره د غوښتنلیک مطابقت کولو کې یوه مهمه برخه ده.
په ESP-IDF کې ډیری ابتدايي یا ترتیب فعالیتونه د ترتیب جوړښت ته د اشارې په توګه د دلیل په توګه اخلي. د مثال په توګهampLe:
45

دوهم فصل. د API حواله

const esp_timer_create_args_t زما_timer_args = { .callback = & زما_timer_callback، .arg = د زنګ وهلو_arg، .name = "زما_timer"
}; زما ټایمر ته د esp_timer_handle_t; زما ټایمر ته د esp_err_t تېروتنه = esp_timer_create(&زما_ټایمر_ارګونه، &زما_ټایمر);
د پیل کولو دندې هیڅکله د ترتیب جوړښت ته اشاره کوونکی نه ذخیره کوي، نو دا خوندي ده چې جوړښت په سټیک کې تخصیص کړئ.
غوښتنلیک باید د جوړښت ټولې برخې پیل کړي. لاندې غلط دی:
esp_timer_create_args_t my_timer_args; my_timer_args.callback = &my_timer_callback; /* ناسم! ساحې .arg او .name پیل شوي ندي */ esp_timer_create(&my_timer_args, &my_timer);
ډیری ESP-IDF پخوانيampد جوړښت د پیل لپاره د C99 ټاکل شوي ابتدايي کونکي کاروي، ځکه چې دوی د ساحو د فرعي سیټ تنظیم کولو او پاتې ساحو د صفر پیل کولو لپاره یوه لنډه لاره چمتو کوي:
const esp_timer_create_args_t my_timer_args = { .callback = &my_timer_callback, /* سمه ده، ساحې .arg او .name صفر پیل شوي دي */
};
د C++ ژبه تر C++20 پورې د ټاکل شوي ابتدايي ترکیب ملاتړ نه کوي، په هرصورت، د GCC کمپیلر په جزوي ډول د توسیع په توګه ملاتړ کوي. کله چې په C++ کوډ کې د ESP-IDF APIs کاروئ، تاسو ممکن د لاندې نمونې کارولو په اړه فکر وکړئ:
esp_timer_create_args_t my_timer_args = {}; /* ټولې ساحې صفر پیل شوي دي */ my_timer_args.callback = &my_timer_callback;

ډیفالټ پیل کونکي
د ځینو ترتیب جوړښتونو لپاره، ESP-IDF د ساحو د ډیفالټ ارزښتونو تنظیم کولو لپاره میکرو چمتو کوي:
httpd_config_t config = HTTPD_DEFAULT_CONFIG(); /* HTTPD_DEFAULT_CONFIG یو ټاکل شوي پیل کونکي ته پراخیږي.
اوس ټول ساحې په ډیفالټ ارزښتونو تنظیم شوي دي. هر ساحه لاهم تعدیل کیدی شي: */ config.server_port = 8081; httpd_handle_t server; esp_err_t err = httpd_start(&server, &config);
سپارښتنه کیږي چې د ډیفالټ انیشیلیزر میکرو څخه کار واخلئ کله چې دوی د یو ځانګړي ترتیب جوړښت لپاره چمتو شوي وي.

۲.۱.۳ شخصي APIs
ټاکلی سرلیک fileپه ESP-IDF کې هغه API لري چې موخه یې یوازې د ESP-IDF سرچینې کوډ کې کارول کیږي، او نه د غوښتنلیکونو لخوا. دا ډول سرلیک fileډیری وختونه په خپل نوم یا لاره کې شخصي یا esp_private لري. ځینې برخې، لکه hal یوازې شخصي API لري. شخصي API ممکن د کوچني یا پیچ ریلیزونو ترمنځ په نامناسب ډول لرې یا بدل شي.

۲.۱.۴ په پخواني کې اجزاampد پروژې
د ESP-IDF پخوانیampپه دې کې د ESP-IDF APIs کارولو ښودلو لپاره مختلفې پروژې شاملې دي. د کوډ تکرار کمولو لپاره په پخواني کېampپه هرصورت، یو څو عام مرستندویان د هغو اجزاو دننه تعریف شوي چې د ډیری پخوانیو لخوا کارول کیږيamples.

د Espressif سیسټمونه

۱ د سند نظر وسپارئ

خپرونه v5.0.9

دوهم فصل. د API حواله
پدې کې هغه برخې شاملې دي چې موقعیت لري

اسناد / سرچینې

د ایسپریسیف سیسټمونه ESP32 ډیو کټ ایډویژن بورډ [pdf] د کارونکي لارښود
د ESP32 Dev Kitc پراختیایي بورډ، ESP32، Dev Kitc پراختیایي بورډ، Kitc پراختیایي بورډ، پراختیایي بورډ، بورډ

حوالې

یو نظر پریږدئ

ستاسو بریښنالیک پته به خپره نشي. اړین ساحې په نښه شوي *