نام (NAME)

gpasm - اسمبلر GNU PIC

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

gpasm [options] file

هشدار (WARNING)

اطلاعات موجود در این صفحه راهنما، چکیده‌ای از مستندات کامل gputils است و به شرح معانی گزینه‌ها محدود می‌شود. برای مستندات کامل و به‌روز، به فایل "gputils.ps" واقع در دایرکتوری docs برنامه gputils مراجعه کنید.

توضیحات (DESCRIPTION)

gpasm یک اسمبلر برای میکروکنترلرهای Microchip (TM) PIC (TM) است. هدف آن سازگاری با اسمبلر MPASM متعلق به شرکت سازنده است. gpasm بخشی از gputils است. برای جزئیات درباره سایر ابزارهای GNU PIC، صفحه راهنمای gputils(1) را بررسی کنید.

گزینه‌ها (OPTIONS)

در زیر خلاصه‌ای از گزینه‌های gpasm آمده است. گزینه‌های gpasm همواره بر هرگونه تنظیماتی در کد مبدأ برتری دارند.

-a FMT, --hex-format FMT: برنامه GPASM از قالب‌های فایل هگز inhx8m، inhx8s، inhx16 و inhx32 پشتیبانی می‌کند. این گزینه تعیین می‌کند کدام قالب فایل هگز استفاده شود. حالت پیش‌فرض inhx32 است.
-c, --object: تولید یک شیء بازآدرس‌پذیر (قالب جدید COFF).
-C, --old-coff: تولید یک شیء بازآدرس‌پذیر (قالب قدیمی COFF).
-d, --debug: چاپ پیام‌های اشکال‌زدایی.
-D SYM=VAL, --define SYM=VAL: تعریف SYM با مقدار VAL. این کار معادل قرار دادن "#define SYM VAL" در کد مبدأ است.
-e [ON|OFF], --expand [ON|OFF]: بسط ماکرو در فایل لیست با استفاده از دستورالعمل‌های EXPAND و NOEXPAND کنترل می‌شود. این گزینه می‌تواند نادیده گرفتن هر یک از این دستورالعمل‌ها را اجبار کند. هنگامی که "ON" انتخاب شود، ماکروها همواره بدون در نظر گرفتن حضور NOEXPAND بسط داده می‌شوند. به همین ترتیب، "OFF" ماکروها را مجبور می‌کند که بسط داده نشوند.
-f, --full-address: نمایش نشانی کامل در ناحیه نگاشت حافظه درون فایل .lst.
-g, --debug-info: استفاده از دستورالعمل‌های اشکال‌زدایی برای COFF.
-h, --help: نمایش پیام راهنما و خروج.
-i, --ignore-case: تمام نمادها و ماکروهای تعریف‌شده توسط کاربر به بزرگی و کوچکی حروف حساس هستند. این گزینه آن‌ها را نسبت به بزرگی و کوچکی حروف غیرحساس می‌کند.
-I DIR, --include DIR: فایل اسمبلی سطح بالا به عنوان یک آرگومان به gpasm ارسال می‌شود. این فایل می‌تواند حاوی دستورالعمل‌های INCLUDE باشد. این دستورالعمل‌ها فایل مشخص‌شده را باز کرده و سپس محتوای آن اسمبل می‌شود. GPASM این فایل‌ها را در دایرکتوری جاری جستجو می‌کند. اگر فایل پیدا نشد، مسیر پیش‌فرض سرآیند بررسی می‌شود. در نهایت، تمامی مسیرهای مشخص‌شده با این آرگومان جستجو می‌شوند.
-j, --sdcc-dev16-list: کمک به گسترش فایل pic16devices.txt در پروژه sdcc. استفاده مستقل از آن، تمامی دستگاه‌های '16e' را نمایش می‌دهد. همراه با گزینه '-p'، تنها دستگاه مشخص‌شده را نشان می‌دهد.
-k, --error: فعال‌سازی ایجاد فایل خطاها.
-l[12[ce]|14[cef]|16[ce]], --list-chips[=([12[ce]|14[cef]|16[ce]])]: فهرست کردن پردازنده‌های پشتیبانی‌شده بر اساس جنبه‌های مختلف. (f => x)
-L, --force-list: نادیده گرفتن دستورالعمل‌های NOLIST. این کار gpasm را وادار می‌کند تا تمامی خطوط اسمبل‌شده را در خروجی فایل لیست چاپ کند.
-m, --dump: پس از اتمام مرحله نهایی اسمبل، محتویات حافظه دستورالعمل نمایش داده می‌شود.
--mpasm-compatible: این گزینه حالت سازگاری با MPASM را فعال می‌کند.
-M, --deps: تولید یک فایل وابستگی.
-n, --dos: به‌طور پیش‌فرض، gpasm فایل‌های هگز را با استفاده از قالب ISO تولید می‌کند. با این حال، برخی از پروگرامرهای دستگاه به فایلی با قالب DOS نیاز دارند. این گزینه باعث می‌شود gpasm یک فایل هگز با قالب DOS تولید کند.
-o FILE, --output FILE: نام جایگزین فایل‌های خروجی. تأثیر گزینه: -- اگر گزینه "-c" در خط فرمان آمده باشد: FILE.o, FILE.lst, FILE.err (باید "FILE.o" مشخص شود.) -- اگر گزینه "-c" در خط فرمان نیامده باشد: FILE.hex, FILE.cod, FILE.lst, FILE.err (باید "FILE.hex" مشخص شود.)
-p PROC, --processor PROC: انتخاب پردازنده.
-P FILE, --preprocess FILE: نوشتن فایل asm پیش‌پردازش‌شده در FILE.
-q, --quiet: فرونشاندن هر چیزی که به خروجی استاندارد ارسال می‌شود.
-r RADIX, --radix RADIX: مبناهای پشتیبانی‌شده عبارتند از BIN، DEC، OCT و HEX. حالت پیش‌فرض HEX است.
-s[12[ce]|14[cef]|16[ce]],: --list-processor-properties[=([12[ce]|14[cef]|16[ce]])]
ویژگی‌های پردازنده‌ها را فهرست می‌کند. استفاده مستقل از آن، تمامی دستگاه‌ها یا گروهی از دستگاه‌ها را نمایش می‌دهد. همراه با گزینه '-p'، تنها دستگاه مشخص‌شده را نشان می‌دهد. (f => x)
-S [0|1|2], --strict [0|1|2]: تنظیم سطح سخت‌گیری برای پارامترهای توصیه‌شدهٔ دستورالعمل‌ها (W یا F و A یا B). «پیام‌های سخت‌گیرانه» اولویت بالاتری نسبت به هشدارها دارند. (ببینید: -w [0|1|2]) [0] 0: مقدار پیش‌فرض است. هیچ پیام سخت‌گیرانه‌ای نمایش داده نمی‌شود. 1: در صورت نبود یکی از آن‌ها، پیام هشدار را نمایش می‌دهد. 2: در صورت نبود یکی از آن‌ها، پیام خطا را نمایش می‌دهد.
-t, --sdcc-dev14-list: کمک به گسترش فایل pic14devices.txt در پروژه sdcc. استفاده مستقل از آن، تمامی دستگاه‌های '14' و '14e' را نمایش می‌دهد. همراه با گزینه '-p'، تنها دستگاه مشخص‌شده را نشان می‌دهد.
--strict-options: اگر این گزینه تنظیم شود، یک گزینه نمی‌تواند پارامتر گزینهٔ دیگری باشد. برای مثال: -I -c
-u, --absolute: استفاده از مسیرهای مطلق.
-v, --version: نمایش اطلاعات نسخه و خروج.
-w [0|1|2], --warning [0|1|2]: این گزینه سطح پیام را تعیین می‌کند. 0: مقدار پیش‌فرض است. اجازه می‌دهد تمامی پیام‌ها، هشدارها و خطاها گزارش شوند. 1: پیام‌ها را فرومی‌نشاند. 2: پیام‌ها و هشدارها را فرومی‌نشاند.
-X, --macro-dereference: استفاده از مبدأیی که ماکرو از آن فراخوانی شده برای گزارش خطاها.
-y, --extended: فعال‌سازی حالت گسترش‌یافته 18xx.

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

gputils(1)

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

Craig Franklin <craigfranklin@users.sourceforge.net>

کپی‌رایت و تکثیر (COPYRIGHT)

این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بالاتری از آن، بازتوزیع کرده و/یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «پروانه عمومی همگانی گنو» مراجعه کنید.

شما باید به همراه این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر مکاتبه کنید: Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.