راهنمای کاربر ماژول Wi-Fi و بلوتوث اینترنت اشیا ESPRESSIF ESP32-C3-MINI-1

درباره این سند
این راهنمای کاربر نحوه شروع کار با ماژول ESP32-C3-MINI-1 را نشان می دهد.

به روز رسانی اسناد
لطفا همیشه به آخرین نسخه مراجعه کنید https://www.espressif.com/en/support/download/documents.

تاریخچه تجدید نظر
برای تاریخچه ویرایش این سند، لطفاً به صفحه آخر مراجعه کنید.

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

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

تمام شدview

1. ماژول تمام شدview
   ESP32-C3-MINI-1 یک ماژول Wi-Fi و بلوتوث LE همه منظوره است. مجموعه ای غنی از تجهیزات جانبی و اندازه کوچک این ماژول را به گزینه ای ایده آل برای خانه های هوشمند، اتوماسیون صنعتی، مراقبت های بهداشتی، لوازم الکترونیکی مصرفی و غیره تبدیل کرده است.
   جدول 1: مشخصات ESP32C3MINI1
   

   دسته بندی ها	پارامترها	مشخصات
   وای فای	پروتکل ها	802.11 b/g/n (تا 150 مگابیت در ثانیه)
   	محدوده فرکانس	2412 ~ 2462 مگاهرتز
   بلوتوث®	پروتکل ها	بلوتوث® LE: بلوتوث 5 و مش بلوتوث
   	رادیو	فرستنده کلاس 1، کلاس 2 و کلاس 3
   سخت افزار	رابط های ماژول	GPIO، SPI، UART، I2C، I2S، کنترل از راه دور، کنترلر LED PWM، کنترلر DMA عمومی، TWAI® کنترلر (سازگار با ISO 11898-1)، سنسور دما، SAR ADC
   	کریستال یکپارچه	کریستال 40 مگاهرتز
   	جلد عملیاتیtage/ منبع تغذیه	3.0 ولت ~ 3.6 ولت
   	جریان عملیاتی	میانگین: 80 میلی آمپر
   	حداقل جریان ارائه شده توسط برق عرضه	500 میلی آمپر
   	دمای محیط	-40 درجه سانتیگراد ~ +105 درجه سانتیگراد
   	سطح حساسیت به رطوبت (MSL)	سطح 3

3. پین توضیحات
   شکل 1: چیدمان پین (بالا View)
   
   ماژول دارای 53 پین است. تعاریف پین را در جدول 2 ببینید.
   برای پیکربندی پین های جانبی، لطفاً به صفحه داده خانواده ESP32-C3 مراجعه کنید.
   جدول 2: تعاریف پین
   

   نام	خیر	تایپ کنید	تابع
   GND	1، 2، 11، 14، 36 53	P	زمین
   3V3	3	P	منبع تغذیه
   NC	4	—	NC
   IO2	5	I/O/T	GPIO2، ADC1_CH2، FSPIQ
   IO3	6	I/O/T	GPIO3، ADC1_CH3
   NC	7	—	NC
   EN	8	I	High: روشن، تراشه را فعال می کند. کم: خاموش، تراشه خاموش می شود. توجه: پین EN را شناور نگذارید.
   NC	9	—	NC
   NC	10	—	NC
   IO0	12	I/O/T	GPIO0، ADC1_CH0، XTAL_32K_P
   IO1	13	I/O/T	GPIO1، ADC1_CH1، XTAL_32K_N
   NC	15	—	NC
   IO10	16	I/O/T	GPIO10، FSPICS0
   NC	17	—	NC
   IO4	18	I/O/T	GPIO4، ADC1_CH4، FSPIHD، MTMS
   IO5	19	I/O/T	GPIO5، ADC2_CH0، FSPIWP، MTDI
   IO6	20	I/O/T	GPIO6، FSPICLK، MTCK
   IO7	21	I/O/T	GPIO7، FSPID، MTDO
   IO8	22	I/O/T	GPIO8
   IO9	23	I/O/T	GPIO9
   NC	24	—	NC
   NC	25	—	NC
   IO18	26	I/O/T	GPIO18
   IO19	27	I/O/T	GPIO19
   NC	28	—	NC
   NC	29	—	NC
   RXD0	30	I/O/T	GPIO20، U0RXD،
   TXD0	31	I/O/T	GPIO21، U0TXD
   NC	32	—	NC
   NC	33	—	NC
   NC	34	—	NC
   NC	35	—	NC

با ESP32C3MINI1 شروع کنید

آنچه شما نیاز دارید

برای توسعه برنامه های کاربردی برای ماژول ESP32-C3-MINI-1 شما نیاز دارید:

• 1 عدد ماژول ESP32-C3-MINI-1
• 1 عدد برد تست اسپرسف RF
• 1 عدد برد USB-to-Serial
• 1 عدد کابل میکرو USB
• 1 عدد کامپیوتر با لینوکس

در این راهنمای کاربر، سیستم عامل لینوکس را به عنوان یک نسخه قبلی در نظر می گیریمampله برای اطلاعات بیشتر در مورد پیکربندی ویندوز و macOS، لطفاً به راهنمای برنامه نویسی ESP-IDF مراجعه کنید.

اتصال سخت افزاری

1. همانطور که در شکل 32 نشان داده شده است، ماژول ESP3-C1-MINI-2 را به برد تست RF لحیم کنید.
   
2. برد تست RF را از طریق TXD، RXD و GND به برد USB-to-Serial متصل کنید.
3. برد USB-to-Serial را به کامپیوتر وصل کنید.
4. برای فعال کردن منبع تغذیه 5 ولت، از طریق کابل Micro-USB، برد تست RF را به رایانه شخصی یا آداپتور برق وصل کنید.
5. در حین دانلود، IO0 را از طریق یک جامپر به GND وصل کنید. سپس، برد تست را "روشن" کنید.
6. سیستم عامل را در فلش دانلود کنید. برای جزئیات، بخش های زیر را ببینید.
7. پس از دانلود، جامپر را روی IO0 و GND بردارید.
8. برد تست RF را دوباره روشن کنید. ESP32-C3-MINI-1 به حالت کار می رود. تراشه برنامه ها را پس از شروع اولیه از فلش می خواند.
   توجه داشته باشید
   IO0 از نظر منطق داخلی بالاست. اگر IO0 روی pull-up تنظیم شده باشد، حالت Boot انتخاب می شود. اگر این پین به صورت کششی یا شناور باقی بماند،
   حالت دانلود انتخاب شده است. برای اطلاعات بیشتر در مورد ESP32-C3 MINI-1، لطفاً به صفحه داده ESP32-C3-MINI-1 مراجعه کنید.

محیط توسعه را راه اندازی کنید

چارچوب توسعه اینترنت اشیا Espressif (به اختصار ESP-IDF) چارچوبی برای توسعه برنامه‌های کاربردی مبتنی بر تراشه‌های Espressif است. کاربران می توانند برنامه هایی را با تراشه های ESP در Windows/Linux/macOS بر اساس ESP-IDF توسعه دهند. در اینجا ما سیستم عامل لینوکس را به عنوان یک سیستم عامل سابق در نظر می گیریمampله

1. پیش نیازها را نصب کنید
   برای کامپایل با ESP-IDF باید بسته های زیر را دریافت کنید:
   • CentOS 7:
     1 sudo yum نصب git wget flex bison gperf python cmake ninja-build ccache dfuutil
   • اوبونتو و دبیان (یک فرمان به دو خط تقسیم می شود):
     1. sudo apt-get install git wget flex bison gperf python python-pip pythonsetuptools cmake
     2. ninja-build ccache libffi-dev libssl-dev dfu-util
   • قوس:
     • 1 sudo pacman -S –needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
       توجه داشته باشید
     • این راهنما از دایرکتوری ~/esp در لینوکس به عنوان پوشه نصب برای ESP-IDF استفاده می کند.
     • به خاطر داشته باشید که ESP-IDF از فضاهای موجود در مسیرها پشتیبانی نمی کند.
2. ESPIDF را دریافت کنید
   برای ساخت برنامه های کاربردی برای ماژول ESP32-C3-MINI-1، به کتابخانه های نرم افزاری که توسط Espressif در مخزن ESP-IDF ارائه شده است نیاز دارید.
   برای دریافت ESP-IDF، یک دایرکتوری نصب (~/esp) ایجاد کنید تا ESP-IDF را دانلود کنید و مخزن را با 'git clone' کلون کنید:
   1. mkdir -p ~/esp
   2. cd ~/esp
   3. git clone – بازگشتی https://github.com/espressif/esp-idf.git
      ESP-IDF در ~/esp/esp-idf دانلود خواهد شد. برای اطلاعات در مورد اینکه در یک موقعیت خاص از کدام نسخه ESP-IDF استفاده کنید، با نسخه های ESP-IDF مشورت کنید.
3. راه اندازی ابزار
   علاوه بر ESP-IDF، شما همچنین باید ابزارهای مورد استفاده توسط ESP-IDF مانند کامپایلر، دیباگر، بسته های پایتون و غیره را نصب کنید. در یک حرکت
   1. سی دی ~/esp/esp-idf
   2. /install.sh
4. متغیرهای محیطی را تنظیم کنید
   ابزارهای نصب شده هنوز به متغیر محیطی PATH اضافه نشده اند. برای اینکه ابزارها از خط فرمان قابل استفاده باشند، باید برخی از متغیرهای محیطی تنظیم شوند. ESP-IDF اسکریپت دیگری به نام export.sh ارائه می کند که این کار را انجام می دهد. در ترمینالی که می‌خواهید از ESP-IDF استفاده کنید، اجرا کنید:
   • $HOME/esp/esp-idf/export.sh
     اکنون همه چیز آماده است، می توانید اولین پروژه خود را بر روی ماژول ESP32-C3 MINI-1 بسازید.

اولین پروژه خود را ایجاد کنید 

1. شروع یک پروژه
   اکنون شما آماده هستید تا درخواست خود را برای ماژول ESP32-C3-MINI-1 آماده کنید. می توانید با پروژه get-started/hello_world از سابق شروع کنیدampدایرکتوری les در ESP-IDF.
   get-started/hello_world را در دایرکتوری ~/esp کپی کنید:
   1. cd ~/esp
   2. cp -r $IDF_PATH/examples/get-started/hello_world.
      طیفی از سابق وجود داردampپروژه های قبلیampدایرکتوری les در ESP-IDF. می توانید هر پروژه ای را به همان روشی که در بالا ارائه شد کپی کنید و آن را اجرا کنید. امکان ساخت سابق نیز وجود داردampبدون اینکه ابتدا آنها را کپی کنید.
      طیفی از سابق وجود داردampپروژه های قبلیampدایرکتوری les در ESP IDF. می توانید هر پروژه ای را به همان روشی که در بالا ارائه شد کپی کنید و آن را اجرا کنید. امکان ساخت سابق نیز وجود داردampبدون اینکه ابتدا آنها را کپی کنید.
2. دستگاه خود را وصل کنید
   اکنون ماژول ESP32-C3-MINI-1 خود را به رایانه وصل کنید و بررسی کنید که ماژول تحت کدام پورت سریال قابل مشاهده است. پورت های سریال در لینوکس با '/dev/tty' در نام خود شروع می شوند. دستور زیر را دو بار اجرا کنید، ابتدا با
   برد جدا شده و سپس وصل شده است. پورتی که برای بار دوم ظاهر می شود همان پورتی است که شما نیاز دارید:
   • ls /dev/tty*
     توجه داشته باشید
     نام پورت را در دسترس داشته باشید زیرا در مراحل بعدی به آن نیاز خواهید داشت.
3. پیکربندی کنید
   از مرحله 2.4.1 به دایرکتوری 'hello_world' خود بروید. یک پروژه را شروع کنید، ESP32-C3 را به عنوان هدف تنظیم کنید و ابزار پیکربندی پروژه 'menuconfig' را اجرا کنید.
   1. سی دی ~/esp/hello_world
   2. idf.py تعیین هدف esp32c3
   3. پیکربندی منو idf.py
      تنظیم هدف با 'idf.py set-target esp32c3' باید یک بار، پس از باز کردن یک پروژه جدید انجام شود. اگر پروژه شامل برخی از بیلدها و پیکربندی های موجود باشد، آنها پاک و مقداردهی اولیه می شوند. هدف ممکن است در متغیر محیطی ذخیره شود تا اصلاً از این مرحله رد شود. برای اطلاعات بیشتر به انتخاب هدف مراجعه کنید.
      اگر مراحل قبلی به درستی انجام شده باشد، منوی زیر ظاهر می شود:
      شکل 3: پنجره اصلی پیکربندی پروژه
      
      رنگ های منو می تواند در ترمینال شما متفاوت باشد. می توانید ظاهر را با گزینه '–style' تغییر دهید. لطفاً برای اطلاعات بیشتر 'idf.py menuconfig –help' را اجرا کنید
4. پروژه را بسازید
   ساخت پروژه با اجرای:
   1. idf.py ب
      این دستور برنامه و تمام اجزای ESP-IDF را کامپایل می کند، سپس بوت لودر، جدول پارتیشن و باینری های برنامه را تولید می کند.
      1. $ idf.py ساخت
      2. اجرای cmake در دایرکتوری /path/to/hello_world/build
      3. در حال اجرای «cmake -G Ninja –warn-unitialized /path/to/hello_world»…
      4. در مورد مقادیر غیر اولیه هشدار دهید.
      5. - Found Git: /usr/bin/git (نسخه یافت شده "2.17.0")
      6.  - ساخت جزء خالی aws_iot به دلیل پیکربندی
      7. - نام اجزاء: …
      8. - مسیرهای مؤلفه: …
      10. … (خطوط بیشتری از سیستم ساخت بیرون
      12. [527/527] ایجاد hello-world.bin
      13. esptool.py نسخه 2.3.1
      15. ساخت پروژه کامل شد برای فلش کردن این دستور را اجرا کنید:
      16. ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash –flash_ mode dio
      17. –فلش_اندازه تشخیص –flash_freq 40m 0x10000 build/hello world.bin build 0x1000
      18. build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin
      19. یا «idf.py -p PORT flash» را اجرا کنید
          اگر خطایی وجود نداشته باشد، ساخت با ایجاد میان‌افزار باینری .bin به پایان می‌رسد file.
5. روی دستگاه فلش بزنید
   باینری هایی را که به تازگی بر روی ماژول ESP32-C3-MINI-1 خود ساخته اید با اجرای:
   1. idf.py -p PORT [-b BAUD] فلش
      PORT را با نام پورت سریال ماژول خود از مرحله: اتصال دستگاه خود جایگزین کنید.
      همچنین می توانید با جایگزین کردن BAUD با نرخ باود مورد نیاز خود، نرخ باود فلاشر را تغییر دهید. نرخ باود پیش فرض 460800 است.
      برای اطلاعات بیشتر در مورد آرگومان های idf.py، به idf.py مراجعه کنید.
      

توجه داشته باشید
گزینه "flash" به طور خودکار پروژه را می سازد و فلش می کند، بنابراین اجرای "idf.py build" ضروری نیست.

1. …
2. esptool.py –chip esp32c3 -p /dev/ttyUSB0 -b 460800 –before=default_reset –after =hard_reset write_flash –flash_mode dio –flash_freq 80m –flash_size 2MB 0x 8000/binitionerboot-0xt. -world.bin
3. esptool.py نسخه 3.0
4. پورت سریال /dev/ttyUSB0
5. برقراری ارتباط….
6. تراشه ESP32-C3 است
7. ویژگی ها: وای فای
8. کریستال 40 مگاهرتز است
9. MAC: 7c:df:a1:40:02:a4
10. در حال بارگذاری خرد…
11. خرد در حال اجرا…
12. دویدن خرد…
13. تغییر نرخ باود به 460800
14. تغییر کرد.
15. در حال پیکربندی اندازه فلاش…
16. فشرده سازی 3072 بایت به 103 …
17. نوشتن در 0x00008000… (100 %)
18. 3072 بایت (103 بایت فشرده) در 0x00008000 در 0.0 ثانیه (موثر 4238.1 کیلوبیت بر ثانیه) نوشت...
19. هش داده ها تأیید شد.
20. فشرده سازی 18960 بایت به 11311 …
21. نوشتن در 0x00000000… (100 %)
22. 18960 بایت (11311 فشرده) در 0 در 00000000 ثانیه (موثر 0.3 کیلوبیت بر ثانیه) نوشت...
23. هش داده ها تأیید شد.
24. فشرده سازی 145520 بایت به 71984 …
25. نوشتن در 0x00010000… (20 %)
26. نوشتن در 0x00014000… (40 %)
27. نوشتن در 0x00018000… (60 %)
28. نوشتن در 0x0001c000… (80 %)
29. نوشتن در 0x00020000… (100 %)
30. 145520 بایت (71984 فشرده) در 0x00010000 در 2.3 ثانیه (مؤثر 504.4 kbit/s) نوشت...
31. هش داده ها تأیید شد.
33. ترک…
34. بازنشانی سخت از طریق پین RTS…
35. انجام شد

اگر همه چیز خوب پیش برود، پس از حذف جامپر روی IO0 و GND، و دوباره روشن کردن برد تست، برنامه “hello_world” شروع به اجرا می‌کند.

نظارت کنید

برای بررسی اینکه آیا "hello_world" واقعا در حال اجرا است، "idf.py -p PORT monitor" را تایپ کنید (فراموش نکنید که PORT را با نام پورت سریال خود جایگزین کنید).
این دستور برنامه IDF Monitor را راه اندازی می کند:

1. مانیتور $ idf.py -p /dev/ttyUSB0
2. اجرای idf_monitor در فهرست [...]/esp/hello_world/build
3. در حال اجرای «python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf»…
4. — idf_monitor در /dev/ttyUSB0 115200 —
5. — خروج: Ctrl+] | منو: Ctrl+T | راهنما: Ctrl+T و سپس Ctrl+H -
6. ets 8 ژوئن 2016 00:22:57
8. rst: 0x1 (POWERON_RESET)، بوت: 0x13 (SPI_FAST_FLASH_BOOT)
9. ets 8 ژوئن 2016 00:22:57
10. …

پس از راه‌اندازی و گزارش‌های تشخیصی، باید «Hello world!» را ببینید. چاپ شده توسط برنامه

1. …
2. سلام دنیا!
3. شروع مجدد در 10 ثانیه…
4. این تراشه esp32c3 با 1 هسته CPU، WiFi/BLE، 4 مگابایت فلش خارجی است.
5. شروع مجدد در 9 ثانیه…
6. شروع مجدد در 8 ثانیه…
7. شروع مجدد در 7 ثانیه…

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

این تمام چیزی است که برای شروع با ماژول ESP32-C3-MINI-1 نیاز دارید! اکنون شما آماده هستید تا یک نمونه قبلی دیگر را امتحان کنیدampدر ESP-IDF، یا مستقیماً به سمت توسعه برنامه های کاربردی خود بروید.

منابع یادگیری

1. اسناد باید خوانده شود
   لطفا با مدارک زیر آشنا شوید:
2. برگه اطلاعات خانواده ESP32-C3
   این مقدمه ای است بر مشخصات سخت افزار ESP32-C3، از جمله overview، تعاریف پین،
   شرح عملکرد، رابط محیطی، مشخصات الکتریکی و غیره
3. راهنمای برنامه نویسی ESP-IDF
   اسناد گسترده برای چارچوب توسعه ESP-IDF، از راهنماهای سخت افزاری تا API
   مرجع.
4. راهنمای مرجع فنی ESP32-C3
   اطلاعات دقیق در مورد نحوه استفاده از حافظه ESP32-C3 و لوازم جانبی.
5. اطلاعات سفارش محصولات اسپرسف
   

منابع مهم

در اینجا منابع مهم مرتبط با ESP32-C3 آمده است.

• ESP32 BBS
  انجمن مهندس به مهندس (E2E) برای محصولات Espressif که در آن می توانید سوالات خود را ارسال کنید، دانش را به اشتراک بگذارید، ایده ها را بررسی کنید، و به حل مشکلات با مهندسان دیگر کمک کنید.

تاریخچه تجدید نظر

تاریخ	نسخه	یادداشت های انتشار
2021-02-01	V0.1	انتشار اولیه

 

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

https://www.espressif.com/

اسناد / منابع

ماژول ESPRESSIF ESP32-C3-MINI-1 Wi-Fi و بلوتوث اینترنت اشیا [pdf] دفترچه راهنمای کاربر ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 ماژول اینترنت اشیاء Wi-Fi و بلوتوث، ماژول اینترنت اشیاء Wi-Fi و بلوتوث، ماژول اینترنت اشیا

مراجع

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