! نکته مهم در نصب درایور

اگر برد شما توسط ویندوز شناسایی نمی‌شود یا پورت COM نمایش داده نمی‌شود، ابتدا درایور مربوطه را نصب کنید.

اگر در نصب به مشکل بر خوردید می‌توانید از طریق آموزش نصب دستی درایور اقدام به نصب درایور نمایید.

نکته برای کاربران برد توسعه (Dev Board):

اگر از بردهای توسعه آماده مانند NodeMCU، Wemos D1 Mini یا ESP32 DevKit استفاده می‌کنید، این بردها معمولاً چیپ USB-TTL (معمولاً CH340 یا CP2102) را روی خود برد دارند و نیازی به مبدل جداگانه نیست. کافی است برد را مستقیماً با کابل USB به کامپیوتر وصل کنید.

توجه: پین‌های GPIO1 (TX) و GPIO3 (RX) در ESP8266 و ESP32 یکسان هستند. تفاوت اصلی در پین‌های کنترل بوت (GPIO0، GPIO2، GPIO15) است که در بخش‌های بعدی توضیح داده می‌شود.

pip install esptool pyserial

راهنمای کاربران ویندوز:

اگر دستور pip شناسایی نشد، مسیر Python را به PATH اضافه کنید یا از py -m pip install esptool pyserial استفاده کنید.

نکته: در Linux ممکن است نیاز به pip3 یا اجرا با sudo داشته باشید.

نکته مهم:

در نسخه‌های قدیمی‌تر esptool از دستور esptool.py version استفاده می‌شد. در نسخه‌های جدیدتر (4.x به بالا) دستور صحیح esptool version است (بدون .py). اگر دستور اول کار نکرد، دستور دوم را امتحان کنید.

esptool version

توجه: GPIO2 دارای مقاومت Pull-up داخلی است و نیازی به مقاومت خارجی ندارد. GPIO15 باید همیشه LOW باشد (مقاومت Pulldown خارجی 10K).

ets Jan 8 2013,rst cause:2, boot mode:(3,6) load 0x40100000, len 1856, room 16 tail 0 chksum 0x63

مثال تفسیر:

boot mode:(3,6) → GPIO15=LOW, GPIO0=HIGH, GPIO2=HIGH → بوت از فلش (Normal Mode). SDIO LowSpeed V1 IO, UART1 booting.

boot mode:(1,6) → GPIO15=LOW, GPIO0=LOW, GPIO2=HIGH → UART Bootloader (Download Mode). SDIO LowSpeed V1 IO, UART1 booting.

! هشدار مهم GPIO12

اگر GPIO12 در زمان بوت HIGH شود، ولتاژ فلش به 1.8V تغییر می‌کند و چیپ نمی‌تواند بوت شود! این پین دارای Pull-down داخلی است، اما از اتصال مقاومت Pull-up به آن خودداری کنید.

ets Jun 8 2016 00:22:57 rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) configsip: 0, SPIWP:0xee clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00 mode:DIO, clock div:2 load:0x3fff0018,len:4 entry 0x400806ac

# شناسایی خودکار چیپ esptool --port COM3 chip_id # خواندن MAC Address esptool --port COM3 read_mac # خواندن اطلاعات فلش esptool --port COM3 flash_id

# پاک کردن کل فلش esptool --port COM3 erase_flash # پاک کردن یک ناحیه خاص esptool --port COM3 erase_region 0x10000 0x40000

# پروگرام ساده ESP8266 esptool --port COM3 --baud 460800 write_flash 0x0 firmware.bin # پروگرام ESP32 با پارامترهای کامل esptool --chip esp32 --port COM3 --baud 921600 --before default_reset --after hard_reset write_flash -z --flash_mode dio --flash_freq 80m --flash_size 4MB 0x1000 bootloader.bin 0x8000 partitions.bin 0x10000 app.bin # حالت‌های فلش: qio, qout, dio, dout # فرکانس: 40m, 26m, 20m, 80m # سایز: 1MB, 2MB, 4MB, 8MB, 16MB

! تفاوت حالت‌های فلش:

• QIO (Quad I/O): 4 خط داده - سریع‌ترین
• QOUT (Quad Output): 4 خط خروجی
• DIO (Dual I/O): 2 خط داده - سازگارتر
• DOUT (Dual Output): 2 خط خروجی - سازگارترین

اگر برد شما با QIO کار نکرد، از DIO یا DOUT استفاده کنید.

# خواندن کل فلش 4MB و ذخیره در فایل esptool --port COM3 read_flash 0 0x400000 backup.bin # خواندن یک ناحیه کوچک esptool --port COM3 read_flash 0x10000 0x10000 section.bin

# اطلاعات فایل باینری esptool --chip esp32 image_info firmware.bin # تبدیل ELF به BIN esptool --chip esp32 elf2image firmware.elf # ادغام چند فایل باینری esptool --chip esp32 merge_bin -o merged.bin --flash_mode dio --flash_size 4MB 0x1000 bootloader.bin 0x8000 partitions.bin 0x10000 app.bin

# بررسی صحت نوشتن esptool --port COM3 verify_flash 0x10000 app.bin # خواندن RAM esptool --port COM3 read_mem 0x400C0000 # نوشتن در RAM esptool --port COM3 write_mem 0x400C0000 0xabad1dea # دامپ کردن حافظه esptool --port COM3 dump_mem 0x40000000 65536 rom.bin # اجرای کد از RAM esptool --port COM3 --no-stub load_ram program.bin

خطا: "Failed to connect to ESP32/ESP8266: Timed out waiting for packet header"

علت: چیپ وارد حالت Download Mode نشده است.

راه‌حل:

• دکمه BOOT (GPIO0) را نگه دارید، دکمه EN (RST) را فشار دهید و رها کنید، سپس BOOT را رها کنید
• خازن 10µF بین پین EN و GND لحیم کنید (برای اتوماتیک شدن)
• سرعت باد را کم کنید: --baud 115200
• کابل USB را عوض کنید
• مقاومت Pulldown 10K روی GPIO0 و GPIO15 بررسی کنید

خطا: "Wrong boot mode detected (0x13)! The chip needs to be in download mode"

علت: GPIO0 HIGH است و چیپ در حالت Normal Boot است.

راه‌حل:

• GPIO0 را به GND وصل کنید و دوباره ریست کنید
• مدار Auto-reset (DTR/RTS) را بررسی کنید
• مقاومت‌های Pull-up روی GPIO0 را بررسی کنید

خطا: "Invalid head of packet (0xXX): Possible serial noise or corruption"

علت: نویز سریال یا مشکل اتصال.

راه‌حل:

• کابل USB کوتاه و باکیفیت استفاده کنید
• برد را از بردبورد جدا کنید (ممکن است پین‌های فلش اتصال کوتاه شده باشند)
• سرعت باد را کم کنید: --baud 9600
• منبع تغذیه را بررسی کنید (FTDI داخلی 3.3V برای ESP کافی نیست)

خطا: "A serial exception error occurred: read failed"

علت: مشکل درایور یا دسترسی به پورت.

راه‌حل:

• درایور USB-TTL را نصب یا بروزرسانی کنید (راهنمای CH340)
• پورت صحیح را انتخاب کنید
• در Linux کاربر را به گروه dialout اضافه کنید: sudo usermod -a -G dialout $USER
• نرم‌افزار دیگری پورت را اشغال نکرده باشد

خطا: "Brownout detector was triggered" (ESP32)

علت: افت ولتاژ ناگهانی.

راه‌حل:

• کابل USB کوتاه و باکیفیت استفاده کنید
• از هاب USB با تغذیه خارجی استفاده کنید
• رگولاتور 3.3V برد را بررسی کنید
• بارهای سنگین (رله، سروو، LED) را از منبع جداگانه تغذیه کنید
• خازن Decoupling 100nF + 10µF نزدیک پین تغذیه اضافه کنید

خطا: "rst cause:4, boot mode:(3,6)" - ریست مکرر ESP8266

علت: Watchdog سخت‌افزاری به دلیل هنگ کردن.

راه‌حل:

• کد را بررسی کنید - حلقه‌های بی‌نهایت یا delay طولانی
• تابع ESP.wdtFeed() در loop اضافه کنید
• مقدار تغذیه را بررسی کنید (WiFi جریان زیادی مصرف می‌کند)
• از yield() یا delay(0) در حلقه‌های طولانی استفاده کنید

خطا: "Invalid header at 0x1000" (ESP32)

علت: بوت‌لودر خراب یا در آدرس اشتباه فلش شده.

راه‌حل:

• فلش را کاملاً پاک کنید: erase_flash
• بوت‌لودر صحیح را در آدرس 0x1000 بنویسید
• GPIO2 را بررسی کنید (نباید HIGH باشد در زمان GPIO0=LOW)
• ولتاژ VDD_SDIO را بررسی کنید (GPIO12 نباید HIGH باشد)

مشکل: پروگرام می‌شود اما برنامه اجرا نمی‌شود

علت‌های احتمالی:

• حالت فلش اشتباه (QIO به جای DIO) - با --flash_mode dio تست کنید
• سایز فلش اشتباه انتخاب شده
• بوت‌لودر موجود نیست یا خراب است
• پین‌های GPIO6-GPIO11 به فلش داخلی متصل هستند و نباید استفاده شوند

نکته برای کاربران برد توسعه:

بردهای توسعه مانند NodeMCU، Wemos D1 Mini و ESP32 DevKit معمولاً دکمه‌های BOOT (یا FLASH) و EN (یا RST) را روی برد دارند. از این دکمه‌ها استفاده کنید.

تبریک! با تمرین این روش، می‌توانید هر برد ESP را حتی بدون دکمه‌های اختصاصی پروگرام کنید.

نکته مهم برای کاربران ویندوز:

اگر Arduino IDE نمی‌تواند برد را پروگرام کند اما esptool کار می‌کند، ممکن است نسخه esptool داخلی Arduino IDE قدیمی باشد. از Tools → Board → Boards Manager بردها را بروزرسانی کنید.

خطا: esptool.py not found A fatal error occurred: esptool.py not found