سه مسیر مستقل برای توسعه
ESP-Prog ابزار توسعه و عیب‌یابی Espressif است که دانلود خودکار میان‌افزار، ارتباط سریال و اشکال‌زدایی JTAG را در یک برد جمع می‌کند. ارزش این ترکیب زمانی مشخص می‌شود که برنامه روی برد اجرا می‌شود، اما مشاهده چند پیام سریال برای پیدا کردن علت خطا کافی نیست. مسیر برنامه‌ریزی برای نوشتن فایل، مسیر سریال برای مشاهده گزارش و مسیر JTAG برای کنترل اجرای پردازنده کاربرد دارند. این سه کار مرتبط هستند، ولی موفقیت یکی به معنای سالم بودن تنظیمات دو مسیر دیگر نیست. بهتر است آزمایش اولیه نیز آنها را جداگانه بررسی کند تا عیب سیم‌کشی با مشکل نرم‌افزار اشتباه نشود.
راهنمای رسمی می‌گوید دانلود و ارتباط سریال روی تراشه‌های Espressif پشتیبانی می‌شوند، اما استفاده از JTAG نیازمند تراشه‌ای است که این رابط را ارائه کند. بنابراین نام خانواده ESP به تنهایی برای انتخاب پایه‌ها کافی نیست. مدل دقیق تراشه، طراحی برد، کاربرد پایه‌های مشترک و وضعیت تنظیمات امنیتی باید بررسی شود. در برخی طرح‌ها رابط داخلی USB نقش دیگری در توسعه دارد و ممکن است نیاز به پروب خارجی کمتر باشد. این نوشته درباره ESP-Prog اصلی است؛ مشخصات مدل‌های دیگر مانند ESP-Prog-2 را نباید بدون بررسی به آن نسبت داد.
تغذیه قابل انتخاب و سیگنال ثابت
مهم‌ترین نکته الکتریکی برد این است که انتخاب تغذیه پنج ولت یا ۳٫۳ ولت، سطح خطوط RX و TX یا JTAG را عوض نمی‌کند. طبق راهنمای سازنده، سیگنال‌ها همیشه در سطح ۳٫۳ ولت باقی می‌مانند. جامپرهای PROG PWR SEL و JTAG PWR SEL خروجی تغذیه رابط مربوط را انتخاب می‌کنند. اگر هدف با منطق ۱٫۸ ولت کار می‌کند، انتخاب یک جامپر مشکل سازگاری را حل نخواهد کرد و باید مدار واسط مناسب و شرایط پشتیبانی رابط بررسی شود. اتصال به هدف پنج ولتی نیز باید بر اساس تحمل واقعی پایه‌ها باشد، نه صرفاً ولتاژ منبع تغذیه آن.
پیش از اتصال، مشخص کنید کدام منبع هدف را روشن می‌کند. بردی که از آداپتور خودش تغذیه می‌شود معمولاً نباید بدون طراحی مناسب، خروجی تغذیه پروب را نیز دریافت کند. زمین مشترک برای ارتباط لازم است، اما اتصال دو منبع می‌تواند مسیر جریان ناخواسته ایجاد کند. راهنمای رسمی برای تغذیه خود ESP-Prog مسیرهای USB، پایه پنج ولت و پایه ۳٫۳ ولت را به صورت گزینه‌های متقابلاً انحصاری بیان می‌کند. روی میز کار، استفاده از USB برای پروب و منبع مشخص برای هدف، همراه با ثبت وضعیت جامپرها، بررسی خطاهای بعدی را ساده می‌کند.
پیدا کردن رابط درست در رایانه
کابل USB باید خطوط داده داشته باشد. یک کابل شارژ می‌تواند چراغ برد را روشن کند، در حالی که هیچ رابطی در سیستم عامل ظاهر نمی‌شود. بنابراین روشن شدن چراغ به تنهایی آزمون اتصال موفق نیست. راهنمای سازنده انتظار دارد رایانه دو رابط مربوط به Program و JTAG را شناسایی کند و در صورت شناسایی نشدن، بررسی درایور FT2232HL را پیشنهاد می‌کند. نام و نمایش این رابط‌ها به سیستم عامل و درایور بستگی دارد؛ نباید هر شماره پورت را بدون تطبیق به کار مشخصی نسبت داد.
یک بار کابل را قطع و وصل کنید و تغییر فهرست دستگاه‌ها را ببینید. مدل برد، شناسه رابط و مسیر انتخاب‌شده در محیط توسعه را ثبت کنید. اگر چند مبدل USB روی میز دارید، برچسب‌گذاری آنها از نوشتن برنامه روی هدف اشتباه جلوگیری می‌کند. در لینوکس، تشخیص دستگاه و داشتن مجوز استفاده دو موضوع جداگانه‌اند. در ویندوز نیز تغییر درایور رابط JTAG نباید کورکورانه روی رابط سریال اعمال شود. هر تغییر را مطابق راهنمای ابزار رسمی انجام دهید و بعد عملکرد هر دو مسیر را دوباره بسنجید.
سیم‌کشی مسیر Program
رابط Program شش وظیفه دارد: فعال‌سازی یا بازنشانی از طریق ESP_EN، تغذیه VDD، خطوط ESP_TXD و ESP_RXD، زمین و پایه حالت بوت ESP_IO0. شماره پایه را از نمای مشخص‌شده در مستندات رسمی بخوانید؛ نگاه کردن از پشت سوکت می‌تواند ترتیب را معکوس نشان دهد. وجود دو اندازه کانکتور به معنای دو پروتکل متفاوت نیست. هنگام ساخت کابل سفارشی، اتصال هر سیم را با ابزار مناسب بررسی و جهت پایه نخست را علامت‌گذاری کنید. کابل کوتاه و اتصال محکم برای آزمایش اولیه بهتر از مجموعه‌ای از سیم‌های آزاد و بلند است.
نام خطوط را در شماتیک پروب و هدف تطبیق دهید تا جهت ارسال و دریافت روشن شود. به حافظه یا رنگ سیم تکیه نکنید، چون رنگ کابل تخت یا سیم‌های جامپر استاندارد تضمین‌شده‌ای ندارد. مسیرهای EN و IO0 برای توالی ورود به حالت دانلود اهمیت دارند. ممکن است خواندن خروجی سریال سالم باشد ولی برنامه‌ریزی خودکار شکست بخورد، زیرا این دو مسیر متصل نیستند یا مدار هدف آنها را به شکل دیگری کنترل می‌کند. در چنین وضعی، تعویض بی‌دلیل درایور نخستین اقدام مناسب نیست.
دانلود نخستین برنامه
محیط ESP-IDF را بر اساس راهنمای رسمی برای مدل دقیق هدف آماده کنید و با یک پروژه کوچک شناخته‌شده آغاز کنید. هدف این مرحله اثبات مسیر بارگذاری است، نه اجرای همزمان همه امکانات محصول نهایی. پیش از نوشتن حافظه، فایل انتخاب‌شده، مدل تراشه، تنظیمات حافظه و درگاه را کنترل کنید. اگر برد متعلق به یک سامانه در حال استفاده است، نسخه فعلی میان‌افزار و روش بازیابی باید معلوم باشد. نوشتن برنامه آزمایشی روی سخت‌افزاری که تنها نسخه داده ارزشمند را نگه می‌دارد، آزمون اولیه مناسبی نیست.
پس از بارگذاری، خروجی سریال را بررسی کنید و مطمئن شوید همان نسخه مورد انتظار اجرا می‌شود. یک شناسه نسخه یا پیام آغاز روشن، تمایز میان برنامه تازه و برنامه قبلی را آسان می‌کند. اگر دانلود انجام شد ولی برد پیوسته بازنشانی می‌شود، خطا ممکن است از برنامه، تنظیم حافظه، پایه‌های راه‌اندازی یا تغذیه باشد. لاگ کامل آغاز را نگه دارید. تغییر همزمان نرخ سریال، منبع برق و فایل برنامه تشخیص علت را دشوار می‌کند؛ هر بار تنها یک فرضیه را امتحان کنید و نتیجه را بنویسید.
وقتی ورود خودکار به دانلود شکست می‌خورد
راهنمای برد دکمه Boot و Reset را برای کنترل حالت راه‌اندازی معرفی می‌کند. توالی دستی می‌تواند به تشخیص مشکل کمک کند: اگر حالت دانلود دستی کار می‌کند اما روش خودکار نه، بررسی مسیرهای بازنشانی و پایه حالت بوت اولویت دارد. این نتیجه به معنی خرابی کل ESP-Prog نیست. طراحی هدف ممکن است خازن، مقاومت یا اتصال جانبی داشته باشد که رفتار این خطوط را تغییر دهد. شماتیک همان برد را با مدار مرجع مقایسه کنید و از افزودن قطعه بدون اندازه‌گیری و توضیح روشن خودداری کنید.
اگر حتی حالت دستی هم پاسخ نمی‌دهد، ابتدا برق و زمین، سپس رابط انتخاب‌شده و بعد مسیر داده بررسی شود. وجود پیام بوت روی UART شاهد مفیدی است، ولی باید نرخ و جهت خطوط درست باشد. برخی خطاهای ارتباطی فقط در سرعت بالاتر ظاهر می‌شوند. کاهش سرعت برای تشخیص کیفیت اتصال مفید است؛ با این حال نباید یک اتصال مرزی را بدون یافتن علت به عنوان راه حل نهایی پذیرفت. برای تولید یا آزمایش تکراری، کابل و منبع تغذیه باید در شرایط واقعی نیز قابل اعتماد باشند.
راه‌اندازی JTAG با هدف مشخص
رابط JTAG شامل TMS، TCK، TDO و TDI به همراه زمین و تغذیه است. وظیفه پایه‌ها با UART متفاوت است و اتصال آنها به پایه‌های سریال نتیجه‌ای نمی‌دهد. پایه‌های متناظر روی تراشه و برد هدف را از راهنمای همان مدل پیدا کنید. ممکن است یک پایه در برنامه کاربردی برای وسیله جانبی استفاده شده باشد و پس از شروع برنامه دیگر برای عیب‌یابی آماده نباشد. برای اولین اتصال، برنامه‌ای ساده انتخاب کنید که با مسیر عیب‌یابی تداخل نداشته باشد و امکان بازنشانی قابل پیش‌بینی فراهم کند.
نرم‌افزار دیباگ باید پیکربندی رابط و هدف را درست بشناسد. در مجموعه ابزار رسمی Espressif، انتخاب فایل پیکربندی مناسب و نسخه هماهنگ ابزارها مهم است. دستورهای تصادفی از یک برد مشابه ممکن است اتصال ظاهری بسازند ولی نگاشت هسته یا حافظه را اشتباه بگیرند. ابتدا شناسایی هدف، سپس توقف و ادامه اجرای یک برنامه ساده و در پایان مشاهده متغیر مشخص را آزمایش کنید. هر مرحله باید نتیجه روشن داشته باشد تا زمان رسیدن به پروژه اصلی، مسیر پایه از قبل اثبات شده باشد.
فایل نماد و نقطه توقف
فایلی که دیباگر برای نگاشت آدرس‌ها به کد استفاده می‌کند باید متعلق به همان ساختی باشد که روی هدف اجرا می‌شود. اگر فایل اجرایی و میان‌افزار تفاوت داشته باشند، خط نمایش‌داده‌شده یا مقدار متغیر می‌تواند گمراه‌کننده باشد. بهینه‌سازی کامپایلر نیز ممکن است متغیر را حذف کند، چند دستور را جابه‌جا کند یا یک تابع را درون تابع دیگر قرار دهد. بنابراین دیدن پیام «متغیر در دسترس نیست» همیشه خطای پروب نیست. تنظیم ساخت مناسب برای عیب‌یابی و ثبت شناسه ساخت، بخش مهمی از آزمایش است.
نقطه توقف را ابتدا در مسیری قرار دهید که اجرای آن قابل پیش‌بینی است. توقف پردازنده زمان‌بندی سامانه را تغییر می‌دهد؛ تایمرهای بیرونی، تجهیزات ارتباطی یا نگهبان سخت‌افزاری ممکن است همچنان رفتار دیگری داشته باشند. اگر خطا فقط در اجرای آزاد رخ می‌دهد، استفاده زیاد از توقف می‌تواند آن را پنهان کند. در این حالت ترکیب لاگ محدود، مشاهده وضعیت و آزمایش کوچک‌تر مفیدتر است. قابلیت عیب‌یابی به شما دید بهتری می‌دهد، اما هر مشاهده باید با اثر خود ابزار بر رفتار هدف تفسیر شود.
مثال عملی برای یک بازنشانی نامنظم
فرض کنید بردی پس از دریافت چند پیام شبکه بازنشانی می‌شود. ابتدا با سریال دلیل بازنشانی و آخرین پیام‌ها را ثبت کنید. سپس یک ورودی آزمایشی قابل تکرار بسازید تا خطا به بار تصادفی شبکه وابسته نماند. با JTAG در بخش پردازش پیام متوقف شوید و طول داده، وضعیت بافر و مسیر خطا را بررسی کنید. اگر توقف باعث ناپدید شدن مشکل شد، احتمال وابستگی زمانی را جدی بگیرید و آزمایش را به مشاهده کمتر تهاجمی تغییر دهید. نتیجه باید یک فرضیه قابل آزمون درباره برنامه باشد، نه صرفاً تصویری از چند ثبات.
پس از اصلاح، برنامه را بدون دیباگر نیز در شرایط مشابه اجرا کنید. رفع خطایی که تنها هنگام اتصال پروب ناپدید شده قابل اتکا نیست. تعداد اجرای آزمایش، نسخه برنامه و شرایط برق را ثبت کنید. اگر مشکل از تغذیه هنگام فعالیت رادیو باشد، JTAG به تنهایی آن را اندازه‌گیری نمی‌کند و ابزار مشاهده برق لازم می‌شود. ESP-Prog برای جدا کردن مرحله وقوع خطا و مشاهده اجرای نرم‌افزار مفید است؛ نتیجه نهایی گاهی شما را به حوزه دیگری مانند طراحی تغذیه یا کیفیت سیگنال هدایت می‌کند.
معیار یک میز توسعه قابل تکرار
پیکربندی موفق را به همراه نقشه اتصال، نسخه ابزارها، مدل هدف، وضعیت جامپرها و یک پروژه آزمایشی کوچک نگه دارید. این بسته به همکار بعدی اجازه می‌دهد پیش از بررسی برنامه پیچیده، صحت محیط را تأیید کند. از ثبت صرف عبارت «کار کرد» پرهیز کنید؛ مشخص کنید دانلود، ارتباط سریال و توقف از طریق JTAG هر کدام چگونه آزموده شده‌اند. اگر هر مسیر شاهد جداگانه داشته باشد، خرابی بعدی سریع‌تر محدود می‌شود و تعویض غیرضروری سخت‌افزار کمتر رخ می‌دهد.
ESP-Prog زمانی انتخاب مناسبی است که چند مرحله توسعه روی سخت‌افزار سازگار Espressif را در یک ابزار بخواهید. شرط استفاده درست، شناخت مرز میان تغذیه و سیگنال، توجه به مدل دقیق هدف و آزمایش مرحله‌ای رابط‌هاست. عدد سرعت یا تعداد کانکتورها جای این روش را نمی‌گیرد. یک کابل درست، پیکربندی ثبت‌شده و فایل اجرایی منطبق معمولاً بیش از پیچیده کردن آزمایش به یافتن خطا کمک می‌کند. با چنین روشی، پروب به بخشی از فرایند تشخیص قابل تکرار تبدیل می‌شود و نتیجه بررسی برای دیگران نیز قابل فهم خواهد بود.
