.TH UCSIM 1

.SH "نام (NAME)"
ucsim \- شبیه‌ساز میکروکنترلر و ریزپردازنده

.SH "خلاصه دستور (SYNOPSIS)"
.B ucsim_i8051
.br
.B ucsim_51
.br
.B ucsim_xa
.br
.B ucsim_z80
.br
.B ucsim_tlcs
.br
.B ucsim_rxk
.br
.B ucsim_i8048
.br
.B ucsim_i8085
.br
.B ucsim_avr
.br
.B ucsim_pdk
.br
.B ucsim_st7
.br
.B ucsim_stm8
.br
.B ucsim_p1516
.br
.B ucsim_m6800
.br
.B ucsim_m6809
.br
.B ucsim_m68hc08
.br
.B ucsim_m68hc11
.br
.B ucsim_m68hc12
.br
.B ucsim_mos6502
.br
.B ucsim_plaze
.br
.B ucsim_f8
.br
.B ucsim_oisc
.br
.RS
.B \-a nr
.B \-A
.B \-b
.B \-B
.B \-c file
.B \-C cfg_file

.B \-e command
.B \-E
.B \-g
.B \-G
.B \-h
.B \-H
.B \-I options
.B \-k portnum
.B \-l
.B \-o colors
.B \-p prompt
.B \-P
.B \-q
.B \-R seed
.B \-s file
.B \-S options
.B \-t cpu_type
.B \-U uartnr
.B \-u hw
.B \-v
.B \-V
.B \-w
.B \-X freq[k|M]
.B \-z portnum
.B \-Z portnum
.RE

.SH "توضیحات (DESCRIPTION)"
برنامه
.B uCsim
یک شبیه‌ساز میکروکنترلر و ریزپردازنده برای چندین خانواده مختلف از پردازنده‌ها است. این برنامه می‌تواند با دستور
.B ucsim_XXXX
اجرا شود که در آن
.B XXXX
نوع پردازنده شبیه‌سازی‌شده را مشخص می‌کند. برای نمونه:
.I ucsim_51
شبیه‌ساز میکروکنترلر Intel MCS51،
.I ucsim_z80
شبیه‌ساز ریزپردازنده Zilog Z80 را اجرا می‌کند و غیره.

.SH "گزینه‌ها (OPTIONS)"

.B گزینه‌های دستور

.TP
.B \-a nr
تعیین اندازه فضای متغیرها (پیش‌فرض=۲۵۶).

.TP
.B \-A
اجبار به استفاده از خروجی رنگی؛ خنثی کردن تأثیر
.B \-b
و
.B \-q
بر رنگ‌ها.

.TP
.B \-b
پوسته سیاه‌وسفید (غیررنگی).

.TP
.B \-B
پخش بوق هشدار روی نقاط توقف (Breakpoints).

.TP
.B \-c file
باز کردن کنسول فرمان روی
.I file
(از
.B \-
برای ورودی/خروجی استاندارد استفاده کنید).

.TP
.B \-C file
خواندن دستورات اولیه از
.I file
و اجرای آن‌ها.

.TP
.B \-e command
اجرای
.I command
هنگام راه‌اندازی برنامه (پس از فایل پیکربندی).

.TP
.B \-E
شروع شبیه‌سازی در حالت شبیه‌سازی سخت‌افزاری (Emulation mode).

.TP
.B \-g
شروع اجرای شبیه‌سازی.

.TP
.B \-G
شروع اجرای شبیه‌سازی و خروج هنگام توقف.

.TP
.B \-h
نمایش این راهنما و خروج.

.TP
.B \-H
چاپ انواع پردازنده‌های شناخته‌شده و خروج.

.TP
.B \-I options
پارامتر
.I options
فهرستی جداشده با کاما از گزینه‌های مربوط به رابط شبیه‌ساز است. گزینه‌های شناخته‌شده عبارتند از:
.br
.I if=memory[address]
فعال کردن رابط روی موقعیت حافظه داده‌شده.
.br
.I in=file
تعیین فایل ورودی برای ورودی/خروجی.
.br
.I out=file
تعیین فایل خروجی برای ورودی/خروجی.
.PP

.TP
.B \-k portnum
استفاده از
.I localhost:portnum
برای ورودی/خروجی سریال. این گزینه منسوخ شده است؛ به جای آن از
.B \-S
استفاده کنید.

.TP
.B \-l
استفاده از رنگ‌های پوسته روشن (پیش‌فرض پوسته تیره است).
.PP

.TP
.B \-m
بازگرداندن مقدار بازگشتی تابع ()main شبیه‌سازی‌شده.
.PP

.TP
.B \-o colors
فهرست مشخصات رنگ به صورت what=colspec,... که در آن colspec فهرستی از گزینه‌های رنگی جداشده با دونقطه (:) است؛ مانند prompt=b:white:black (سفید توپر روی سیاه).

.TP
.B \-p prompt
تعیین رشته اعلان (Prompt).

.TP
.B \-P
تنظیم رشته اعلان روی نویسه تهی ('\0').
.PP

.TP
.B \-q
حالت بی‌صدا؛ چاپ اطلاعات کمتر (شامل
.B \-b
نیز می‌شود).

.TP
.B \-R seed
تنظیم مقدار بذر (Seed) برای تولیدکننده اعداد تصادفی.

.TP
.B \-s file
اتصال رابط سریال uart0 به
.I file
این گزینه منسوخ شده است؛ به جای آن از
.B \-S
استفاده کنید.

.TP
.B \-S options
پارامتر
.I options
فهرستی جداشده با کاما از گزینه‌های رابط سریال است. گزینه‌های شناخته‌شده عبارتند از:
.br
.I uart=nr
شماره uart (پیش‌فرض=۰)
.br
.I in=file
ورودی سریال از فایلی به نام `file' خوانده خواهد شد.
.br
.I out=file
خروجی سریال در `file' نوشته خواهد شد.
.br
.I port=nr
استفاده از localhost:nr به عنوان کارساز (سرور) برای خط سریال.
.br
.I iport=nr
استفاده از localhost:nr به عنوان کارساز برای ورودی سریال.
.br
.I oport=nr
استفاده از localhost:nr به عنوان کارساز برای خروجی سریال.
.br
.I raw
برقراری ارتباط غیرتعاملی حتی روی tty.

.TP
.B \-t cpu_type
تعیین نوع کنترلر. از
.B \-H
برای فهرست کردن مقادیر مجاز استفاده کنید.

.TP
.B \-U uartnr
استفاده از کنسول استاندارد به عنوان پایانه برای شناسه UART برابر uartnr.

.TP
.B \-u hw
استفاده از کنسول استاندارد به عنوان نمایشگر برای سخت‌افزار (hw) مشخص‌شده.

.TP
.B \-v
چاپ شماره نسخه و خروج.

.TP
.B \-V
حالت پرگو (نمایش گزارش دقیق).

.TP
.B \-w
حافظه فلش قابل نوشتن.

.TP
.B \-X freq[k|M]
فرکانس کریستال (XTAL) بر حسب هرتز. از پسوند
.I k
یا
.I M
برای تعیین فرکانس بر حسب کیلوهرتز یا مگاهرتز استفاده کنید.

.TP
.B \-z portnum
گوش دادن به
.I portnum
برای کنسول فرمان.

.TP
.B \-Z portnum
گوش دادن به
.I portnum
برای کنسول فرمان (بدون کنسول روی stdio).

.SH "مثال‌ها (EXAMPLES)"
هنوز مثالی ثبت نشده است.

.SH "همچنین ببینید (SEE ALSO)"
.BR sdcc (1),
.BR sdcdb (1),
.BR serialview (1).

.SH "اشکالات (BUGS)"
احتمالاً موارد زیادی وجود دارد.

.SH "نویسندگان (AUTHORS)"
Daniel Drotos,
Gunar Holm,
Sandeep Dutta,
Salvador Eduardo Tropea,
Josef Wolf,
Stephane Meyer,
Larry Doolittle,
Timothy Hurman,
Karl-Max Wagner,
Edmar Wienskoski Jr,
Alexandre Frey,
Kaido Karner,
Kalr Bongers,
Alexis Pavlov,
Davine Zanni,
Anton Persson,
Nicolas Lesser,
Mike Jagdis,
Jiri Simek,
Zbynek Krivka,
Vaclav Peroutka,
Valentin Dudouyt,
Erik Petrich,
Leland Morrison,
Johan Knol.