نام (NAME)

openocd - ابزار آزاد و متن‌باز اشکال‌زدایی روی چیپ، برنامه‌نویسی درون‌سیستمی و آزمایش پویش مرزی برای سامانه‌های ARM و MIPS

خلاصه دستور (SYNOPSIS)

openocd [-fsdlcphv] [--file <filename>] [--search <dirname>] [--debug <debuglevel>] [--log_output <filename>] [--command <cmd>] [--pipe] [--help] [--version]

توضیحات (DESCRIPTION)

OpenOCD یک ابزار اشکال‌زدایی روی چیپ (on-chip debugging)، برنامه‌ریزی درون‌سیستمی (in-system programming) و آزمایش پویش مرزی (boundary-scan testing) برای سامانه‌های مختلف ARM و MIPS است.

این اشکال‌زدا از یک هسته اصلی باس TAP سازگار با استاندارد IEEE 1149-1 مربوط به JTAG برای دسترسی به قابلیت‌های اشکال‌زدایی روی چیپ موجود در میکروکنترلرهای مبتنی بر ARM یا راه‌حل‌های سامانه روی چیپ (SoC) استفاده می‌کند. برای سامانه‌های MIPS، رابط EJTAG پشتیبانی می‌شود.

تعامل با کاربر از طریق یک واسط خط فرمان telnet، یک کارگزار پروتکل از راه دور gdb (اشکال‌زدای GNU) و یک اتصال ساده‌شده RPC که می‌تواند برای برقراری ارتباط با موتور Jim Tcl در OpenOCD استفاده شود، انجام می‌گیرد.

نرم‌افزار OpenOCD از انواع مختلف واسط‌ها/پروگرامرهای JTAG پشتیبانی می‌کند؛ لطفاً برای فهرست کامل، صفحه info برنامه openocd را بررسی کنید.

گزینه‌ها (OPTIONS)

-f, --file <filename>: این یک میانبر برای دستور -c [script <filename>] است که از یک مسیر جستجو برای بارگذاری فایل پیکربندی <filename> استفاده می‌کند. به منظور تعیین چندین فایل پیکربندی، می‌توانید از چندین آرگومان --file استفاده کنید. اگر هیچ یک از این گزینه‌های -c گنجانده نشوند، نخستین فایل پیکربندی openocd.cfg موجود در مسیر جستجو استفاده خواهد شد.
-s, --search <dirname>: افزودن <dirname> به مسیر جستجوی مورد استفاده برای فایل‌های پیکربندی و اسکریپت‌ها. مسیر جستجو با دایرکتوری جاری آغاز می‌شود و سپس این دایرکتوری‌های اضافی را پیش از سایر مؤلفه‌ها مانند کتابخانه‌های اسکریپت استاندارد OpenOCD در بر می‌گیرد.
-d, --debug <debuglevel>: تنظیم سطح اشکال‌زدایی (debug level). مقادیر ممکن عبارتند از:
* 0 (خطاها)
* 1 (هشدارها)
* 2 (پیام‌های اطلاع‌رسانی)
* 3 (پیام‌های اشکال‌زدایی)
سطح پیش‌فرض 2 است.
-l, --log_output <filename>: هدایت خروجی گزارش وقایع (log) به فایل <filename>. به‌طور پیش‌فرض خروجی گزارش وقایع روی stderr چاپ می‌شود.
-c, --command <cmd>: افزودن دستور <cmd> به فهرست دستوراتی که هنگام راه‌اندازی کارگزار اجرا می‌شوند. توجه داشته باشید در صورتی که دستور نیازمند دسترسی به هدف (target) یا حافظه فلش باشد، باید به صراحت init را فراخوانی کنید.
-p, --pipe: استفاده از پایپ‌ها هنگام ارتباط با gdb.
-h, --help: نمایش متن راهنما و خروج.
-v, --version: نمایش اطلاعات نسخه و خروج.

گزارش اشکالات (BUGS)

لطفاً هرگونه اشکال را در فهرست پستی زیر گزارش دهید: openocd-devel@lists.sourceforge.net

مجوز (LICENCE)

OpenOCD تحت پوشش مجوز عمومی همگانی گنو (GNU GPL)، نسخه ۲ یا بالاتر منتشر می‌شود.

همچنین ببینید (SEE ALSO)

jtag(1)

مستندات کامل openocd به عنوان راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info (یا pinfo) و openocd به درستی روی سامانه شما نصب شده باشند، دستور info openocd باید دسترسی به راهنمای کامل را برای شما فراهم کند.

نویسندگان (AUTHORS)

لطفاً فایل AUTHORS را ببینید.

این صفحه راهنما توسط Uwe Hermann <uwe@hermann-uwe.de> نوشته شده است. این سند تحت شرایط مجوز GNU GPL (نسخه ۲ یا بالاتر) دارای مجوز است.