بردهای توسعه ESPRESSIF ESP32-JCI-R

درباره این راهنما

این سند برای کمک به کاربران در راه اندازی محیط توسعه نرم افزار پایه برای توسعه برنامه های کاربردی با استفاده از سخت افزار مبتنی بر ماژول ESP32-JCI-R در نظر گرفته شده است.

یادداشت های انتشار

تاریخ	نسخه	یادداشت های انتشار
2020.7	V0.1	انتشار اولیه.

اطلاعیه تغییر اسناد

Espressif اعلان های ایمیلی را برای به روز نگه داشتن مشتریان در مورد تغییرات اسناد فنی ارائه می دهد. لطفا مشترک شوید در www.espressif.com/en/subscribe.

گواهینامه

گواهینامه های محصولات اسپرسیف را از www.espressif.com/en/certificates.

مقدمه

ESP32-JCI-R

ESP32-JCI-R یک ماژول قدرتمند و عمومی Wi-Fi+BT+BLE MCU است که طیف گسترده ای از برنامه ها را هدف قرار می دهد، از شبکه های حسگر کم مصرف تا سخت ترین وظایف، مانند رمزگذاری صدا، پخش موسیقی و رمزگشایی MP3. . هسته اصلی این ماژول تراشه ESP32-D0WD-V3 است. تراشه تعبیه شده به گونه ای طراحی شده است که مقیاس پذیر و سازگار باشد. دو هسته CPU وجود دارد که به صورت جداگانه قابل کنترل هستند و فرکانس ساعت CPU از 80 مگاهرتز تا 240 مگاهرتز قابل تنظیم است. کاربر همچنین ممکن است CPU را خاموش کند و از پردازنده کمکی کم مصرف برای نظارت مداوم بر تجهیزات جانبی برای تغییرات یا عبور از آستانه ها استفاده کند. ESP32 مجموعه ای غنی از تجهیزات جانبی، از حسگرهای لمسی خازنی، حسگرهای هال، رابط کارت SD، اترنت، SPI پرسرعت، UART، I2S و I2C را ادغام می کند. ادغام بلوتوث، بلوتوث LE و Wi-Fi تضمین می کند که می توان طیف گسترده ای از برنامه ها را هدف قرار داد و این ماژول در آینده مقاوم است: استفاده از Wi-Fi به برد فیزیکی بزرگ و اتصال مستقیم به اینترنت از طریق Wi-Fi اجازه می دهد. روتر در حین استفاده از بلوتوث به کاربر این امکان را می دهد که به راحتی به تلفن متصل شود یا چراغ های کم مصرف را برای تشخیص آن پخش کند. جریان خواب تراشه ESP32 کمتر از 5 μA است که آن را برای کاربردهای الکترونیکی با باتری و پوشیدنی مناسب می‌کند. ESP32 از سرعت داده تا 150 مگابیت بر ثانیه و توان خروجی 20 دسی بل در متر در آنتن پشتیبانی می کند تا از وسیع ترین برد فیزیکی اطمینان حاصل کند. به این ترتیب تراشه مشخصات پیشرو در صنعت و بهترین عملکرد را برای یکپارچه سازی الکترونیکی، برد، مصرف انرژی و اتصال ارائه می دهد. سیستم عامل انتخاب شده برای ESP32 freeRTOS با LwIP است. TLS 1.2 با شتاب سخت افزاری نیز تعبیه شده است. ارتقای ایمن (رمزگذاری شده) از طریق هوا (OTA) نیز پشتیبانی می شود تا توسعه دهندگان بتوانند به طور مداوم محصولات خود را حتی پس از انتشار آنها ارتقا دهند.

ESP-IDF

چارچوب توسعه اینترنت اشیاء Espressif (به اختصار ESP-IDF) چارچوبی برای توسعه برنامه‌های کاربردی مبتنی بر Espressif ESP32 است. کاربران می توانند برنامه های کاربردی را در Windows/Linux/MacOS بر اساس ESP-IDF توسعه دهند.

آماده سازی

برای توسعه برنامه های کاربردی برای ESP32-JCI-R شما نیاز دارید:

• رایانه لود شده با سیستم عامل ویندوز، لینوکس یا مک
• زنجیره ابزار برای ساخت اپلیکیشن برای ESP32
• ESP-IDF اساسا حاوی API برای ESP32 و اسکریپت هایی برای کار با زنجیره ابزار است
• یک ویرایشگر متن برای نوشتن برنامه ها (پروژه ها) به زبان C، به عنوان مثال، Eclipse
• خود برد ESP32 و یک کابل USB برای اتصال آن به کامپیوتر

شروع کنید

راه اندازی زنجیره ابزار

سریعترین راه برای شروع توسعه با ESP32، نصب یک زنجیره ابزار از پیش ساخته شده است. سیستم عامل خود را در زیر انتخاب کنید و دستورالعمل های ارائه شده را دنبال کنید.

• ویندوز
• لینوکس
• سیستم عامل مک

توجه:
ما از دایرکتوری ~/esp برای نصب زنجیره ابزار از پیش ساخته شده، ESP-IDF و s استفاده می کنیم.ampبرنامه های کاربردی می توانید از دایرکتوری دیگری استفاده کنید، اما باید دستورات مربوطه را تنظیم کنید. بسته به تجربه و ترجیحات خود، به جای استفاده از زنجیره ابزار از پیش ساخته شده، ممکن است بخواهید محیط خود را سفارشی کنید. برای راه اندازی سیستم به روش خود به بخش تنظیم سفارشی زنجیره ابزار بروید.
پس از اتمام راه‌اندازی زنجیره ابزار، به بخش دریافت ESP-IDF بروید.

ESP-IDF را دریافت کنید

علاوه بر زنجیره ابزار (که شامل برنامه هایی برای کامپایل و ساخت برنامه است)، شما همچنین به API / کتابخانه های خاص ESP32 نیاز دارید. آنها توسط Espressif در مخزن ESP-IDF ارائه شده اند.
برای دریافت آن، ترمینال را باز کنید، به دایرکتوری مورد نظر برای قرار دادن ESP-IDF بروید و با استفاده از دستور git clone آن را کلون کنید:

• cd ~/esp
• git clone – بازگشتی https://github.com/espressif/esp-idf.git 

ESP-IDF در ~/esp/esp-idf دانلود خواهد شد.

توجه:
گزینه بازگشتی را از دست ندهید. اگر قبلاً ESP-IDF را بدون این گزینه کلون کرده‌اید، دستور دیگری را برای دریافت همه زیر ماژول‌ها اجرا کنید:

• سی دی ~/esp/esp-idf
• به روز رسانی زیر ماژول git –init

مسیر ESP-IDF را تنظیم کنید 

برنامه های زنجیره ابزار با استفاده از متغیر محیطی IDF_PATH به ESP-IDF دسترسی دارند. این متغیر باید بر روی رایانه شخصی شما تنظیم شود، در غیر این صورت، پروژه ها ساخته نمی شوند. تنظیمات ممکن است به صورت دستی انجام شود، هر بار که رایانه شخصی مجدداً راه اندازی می شود. گزینه دیگر تنظیم دائمی آن با تعریف IDF_PATH در نمایه کاربر است. برای انجام این کار، دستورالعمل‌های افزودن IDF_PATH به نمایه کاربر را دنبال کنید.

شروع یک پروژه

اکنون شما آماده هستید تا درخواست خود را برای ESP32 آماده کنید. برای شروع سریع، از پروژه hello_world از قبلی استفاده می کنیمampدایرکتوری les در IDF.
get-started/hello_world را در دایرکتوری ~/esp کپی کنید:

• cd ~/esp
• cp -r $IDF_PATH/examples/get-started/hello_world.

همچنین می توانید طیفی از موارد قبلی را پیدا کنیدampپروژه های زیرampدایرکتوری les در ESP-IDF. این سابقampدایرکتوری های پروژه را می توان به همان روشی که در بالا ارائه شد کپی کرد تا پروژه های خود را شروع کنید.

توجه:
سیستم ساخت ESP-IDF از فضاها در مسیرهای ESP-IDF یا پروژه ها پشتیبانی نمی کند.

اتصال

شما تقریباً آنجا هستید. برای اینکه بتوانید ادامه دهید، برد ESP32 را به رایانه شخصی متصل کنید، بررسی کنید که برد زیر کدام پورت سریال قابل مشاهده است و بررسی کنید که آیا ارتباط سریال کار می کند یا خیر. اگر مطمئن نیستید که چگونه این کار را انجام دهید، دستورالعمل های موجود در برقراری اتصال سریال با ESP32 را بررسی کنید. به شماره پورت توجه کنید، زیرا در مرحله بعد لازم است.

پیکربندی کنید

با قرار گرفتن در یک پنجره ترمینال، با تایپ cd ~/esp/hello_world به دایرکتوری برنامه hello_world بروید. سپس منوی تنظیمات پیکربندی پروژه را شروع کنید:

• cd ~/esp/hello_world make menuconfig

اگر مراحل قبلی به درستی انجام شده باشد، منوی زیر نمایش داده می شود:

در منو، به Serial flasher config > Default serial port بروید تا پورت سریال را که پروژه در آن بارگذاری می‌شود، پیکربندی کنید. انتخاب را با فشار دادن اینتر، ذخیره کنید
پیکربندی با انتخاب و سپس با انتخاب از برنامه خارج شوید .

توجه:
در ویندوز، پورت های سریال نام هایی مانند COM1 دارند. در macOS، آنها با /dev/cu شروع می‌شوند. در لینوکس، آنها با /dev/tty شروع می شوند. (برای جزئیات کامل به برقراری اتصال سریال با ESP32 مراجعه کنید.)

در اینجا چند نکته در مورد ناوبری و استفاده از منوی پیکربندی وجود دارد:

• برای پیمایش در منو، کلیدهای جهت‌نما را تنظیم و پایین ببرید.
• برای رفتن به منوی فرعی از کلید Enter و برای خروج یا خروج از کلید Escape استفاده کنید.
• نوع؟ برای دیدن صفحه راهنما کلید Enter از صفحه راهنما خارج می شود.
• از کلید Space یا کلیدهای Y و N برای فعال کردن (بله) و غیرفعال کردن (خیر) موارد پیکربندی با چک باکس "[*]" استفاده کنید.
• فشار دادن؟ در حالی که برجسته کردن یک آیتم پیکربندی، کمکی را در مورد آن مورد نمایش می دهد.
• برای جستجوی موارد پیکربندی، / را تایپ کنید.

توجه:
اگر کاربر Arch Linux هستید، به پیکربندی ابزار SDK بروید و نام مفسر Python 2 را از python به python2 تغییر دهید.

ساخت و فلش

اکنون می توانید برنامه را بسازید و فلش کنید. اجرا کن:

فلش درست کن

این برنامه و تمام اجزای ESP-IDF را کامپایل می کند، بوت لودر، جدول پارتیشن و باینری های برنامه را تولید می کند و این باینری ها را روی برد ESP32 شما فلش می کند.

اگر مشکلی وجود ندارد، در پایان فرآیند ساخت، باید پیام هایی را مشاهده کنید که پیشرفت فرآیند بارگذاری را توصیف می کند. در نهایت، ماژول پایانی بازنشانی می شود و برنامه "hello_world" شروع به کار می کند. اگر می خواهید به جای اجرای make از Eclipse IDE استفاده کنید، Build and Flash with Eclipse IDE را بررسی کنید.

نظارت کنید

برای اینکه ببینید آیا برنامه «hello_world» واقعاً در حال اجرا است، make monitor را تایپ کنید. این دستور برنامه IDF Monitor را راه اندازی می کند:

چندین خط در زیر، پس از راه اندازی و ثبت تشخیص، باید "سلام جهان!" چاپ شده توسط برنامه

برای خروج از مانیتور از میانبر Ctrl+] استفاده کنید.

توجه:
اگر به‌جای پیام‌های بالا، مشاهده کردید که زباله‌های تصادفی یا مانیتور در مدت کوتاهی پس از آپلود از کار می‌افتد، برد شما احتمالاً از یک کریستال 26 مگاهرتز استفاده می‌کند، در حالی که ESP-IDF پیش‌فرض 40 مگاهرتز را فرض می‌کند. از مانیتور خارج شوید، به منوی تنظیمات برگردید، CONFIG_ESP32_XTAL_FREQ_SEL را به 26 مگاهرتز تغییر دهید، سپس برنامه را بسازید و دوباره فلش کنید. این در زیر make menuconfig در قسمت Component config -> ESP32-specic - Main XTAL فرکانس یافت می شود. برای اجرای make flash و ساخت مانیتور به صورت یکجا، عبارت make the flash monitor را تایپ کنید. بخش مانیتور IDF را برای میانبرهای مفید و جزئیات بیشتر در مورد استفاده از این برنامه بررسی کنید. این تمام چیزی است که برای شروع کار با ESP32 نیاز دارید! اکنون شما آماده هستید که یک سابق دیگر را امتحان کنیدampیا به سمت توسعه برنامه های کاربردی خود بروید.

اعلامیه سلب مسئولیت و حق چاپ
اطلاعات موجود در این سند، از جمله URL منابع، ممکن است بدون اطلاع قبلی تغییر کند. این سند همانطور که هست و بدون هیچ ضمانتی ارائه می شود، از جمله ضمانت کالای تجاری، عدم نقض، تناسب برای هر هدف خاص، یا هر گونه ضمانت نامه ای، در هر مورد دیگر.AMPLE. کلیه مسئولیت ها، از جمله مسئولیت نقض هر گونه حقوق مالکانه، مربوط به استفاده از اطلاعات این سند سلب مسئولیت می شود. در اینجا هیچ مجوز صریح یا ضمنی، از طریق ممانعت یا موارد دیگر، برای حقوق مالکیت معنوی اعطا نمی شود. لوگوی Wi-Fi Alliance Member یک علامت تجاری Wi-Fi Alliance است. لوگوی بلوتوث یک علامت تجاری ثبت شده بلوتوث SIG است. کلیه نام های تجاری، علائم تجاری و علائم تجاری ثبت شده ذکر شده در این سند متعلق به صاحبان مربوطه بوده و بدین وسیله تایید می شوند.
حق چاپ © 2018 Espressif Inc. کلیه حقوق محفوظ است.

اسناد / منابع

بردهای توسعه ESPRESSIF ESP32-JCI-R [pdf] دفترچه راهنمای کاربر ESP32JCIR، 2AC7Z-ESP32JCIR، 2AC7ZESP32JCIR، ESP32-JCI-R، بردهای توسعه، بردهای توسعه ESP32-JCI-R، بردها

مراجع

• راهنمای کاربر