.\" Load the www device when using groff; provide a fallback for groff's MTO macro that formats email addresses.
.ie \n[.g] \
.  mso www.tmac
.el \{
.  de MTO
     \\$2 \(la\\$1 \(ra\\$3 \
.  .
.\}
.\" Create wrappers for .MTO and .URL that print only text on systems w/o groff or if not outputting to a HTML
.\" device. To that end we need to distinguish HTML output on groff from other configurations first.
.nr groffhtml 0
.if \n[.g] \
.  if "\*[.T]"html" \
.    nr groffhtml 1
.\" For code reuse it would be nice to have a single wrapper that gets its target macro as parameter.
.\" However, this did not work out with NetBSD's and OpenBSD's groff...
.de URLB
.  ie (\n[groffhtml]==1) \{\
.    URL \\$@
.  \}
.  el \{\
.    ie "\\$2"" \{\
.      BR "\\$1" "\\$3"
.    \}
.    el \{\
.      RB "\\$2 \(la" "\\$1" "\(ra\\$3"
.    \}
.  \}
..
.de MTOB
.  ie (\n[groffhtml]==1) \{\
.    MTO \\$@
.  \}
.  el \{\
.    ie "\\$2"" \{\
.      BR "\\$1" "\\$3"
.    \}
.    el \{\
.      RB "\\$2 \(la" "\\$1" "\(ra\\$3"
.    \}
.  \}
..
.TH FLASHPROG-CONFIG 8 "2026-07-17" "flashprog-config-v1.6-dirty" "2026-07-17"
.SH "نام (NAME)"
flashprog-config \- خواندن و نوشتن ثبات‌های وضعیت و پیکربندی تراشه‌های فلش
.SH "خلاصه دستور (SYNOPSIS)"
.I flashprog config \fR[\fIget\fR] <options> <setting>
.br
.I flashprog config \ set \ \fR<options> [\fB\-\-temporary\fR] <setting> <value>
.sp
که در آن <options> عمومی عبارتند از:
.RS 4
\fB\-p\fR <programmername>[:<parameters>] [\fB\-c\fR <chipname>]
.br
[\fB\-V\fR[\fBV\fR[\fBV\fR]]] [\fB-o\fR <logfile>] [\fB\-h\fR]
.RE

.SH "توضیحات (DESCRIPTION)"
.B flashprog-config
ابزاری برای خواندن و نوشتن بیت‌های ثبات وضعیت و پیکربندی تراشه‌های فلش است. در حال حاضر، تنها از تراشه‌های SPI NOR پشتیبانی می‌کند.

.SH "عملیات‌ها (OPERATIONS)"
می‌توانید یکی از
.BR get " یا " set "،"
یا هیچ عملیاتی را مشخص نکنید که در حالت پیش‌فرض خواندن یک تنظیم است.
.PP
.BR get " <setting>"
.RS 4
خواندن و چاپ مقدار تنظیم داده‌شده. بخش
.BR "تنظیمات (SETTINGS)" " در زیر را ببینید."
.RE
.PP
.BR set " [" \-\-temporary "] <setting> <value>"
.RS 4
نوشتن مقدار داده‌شده در تنظیم. بخش‌های
.BR "تنظیمات (SETTINGS)" " و " "مقادیر (VALUES)"
در زیر را ببینید.
.sp
هنگامی که گزینه
.B \-\-temporary
مشخص شود، flashprog تلاش می‌کند مقداری موقت بنویسد که در حافظه فلش ذخیره نمی‌شود. این قابلیت نیازمند پشتیبانی ویژه تراشه فلش از دستور نوشتن ناپایدار در ثبات وضعیت (volatile write status register) است. مقدار جدید پس از بازنشانی (reset) تراشه فلش از دست خواهد رفت. بنابراین، استفاده از این گزینه همراه با پروگرامرهای خارجی که برق تراشه فلش را قطع و وصل می‌کنند (مانند Dediprog) بی‌فایده است.
.RE

.SH "تنظیمات (SETTINGS)"
.PP
.B qe, quad-enable
.RS 4
تراشه‌های فلش SPI NOR اغلب از مالتی‌پلکس کردن برخی پایه‌های خود (معمولاً /WP و /HOLD) با خطوط ورودی/خروجی اضافه پشتیبانی می‌کنند. این ویژگی به آن‌ها امکان می‌دهد تا با تنظیم بیت
.B quad-enable
چهار بیت را به طور هم‌زمان منتقل کنند.
.RE

.SH "مقادیر (VALUES)"
.PP
.BR false ", " true
.RS 4
مقادیر
.BR false " و " true
به ترتیب به
.BR 0 " و " 1
تبدیل خواهند شد.
.RE
.PP
.RB "اعداد طبیعی: " 0 ", " 1 ", ..."
.RS 4
هنگامی که اعداد طبیعی داده شوند، کم‌ارزش‌ترین بیت‌های نمایش دودویی آن‌ها در تنظیم نوشته خواهد شد.
.RE

.SH "گزینه‌ها (OPTIONS)"
تمام عملیات‌ها نیازمند استفاده از گزینه
.B -p/--programmer
هستند (لطفاً برای اطلاعات بیشتر پیرامون پشتیبانی از پروگرامر و پارامترها به
.MR flashprog 8
مراجعه کنید).
.PP
.BR \-p ", " \-\-programmer " <name>[" : "<parameter>[" , "<parameter>]...]"
.RS 4
دستگاه پروگرامر را مشخص می‌کند. این گزینه برای تمامی عملیات‌ها الزامی است. لطفاً برای فهرستی از پروگرامرهای پشتیبانی‌شده فعلی و پارامترهای آن‌ها به صفحه راهنمای
.MR flashprog 8
مراجعه کنید.
.RE
.PP
.BR \-c ", " \-\-chip " <chipname>"
.RS 4
فقط تراشه رام فلش مشخص‌شده را بررسی می‌کند. این گزینه نام تراشه را همان‌گونه که توسط
.B "flashprog \-L"
چاپ می‌شود بدون نام سازنده به‌عنوان پارامتر می‌پذیرد. لطفاً توجه داشته باشید که نام تراشه به حروف بزرگ و کوچک حساس است.
.RE
.PP
.BR \-V ", " \-\-verbose
.RS 4
خروجی با جزئیات بیشتر. این گزینه می‌تواند چندین بار (حداکثر ۳ بار، یعنی
.BR \-VVV )
برای دریافت گزارش‌های اشکال‌زدایی بیشتر ارائه شود.
.RE
.PP
.BR \-o ", " \-\-output " <logfile>"
.RS 4
ذخیره گزارش کامل اشکال‌زدایی در
.BR <logfile> .
اگر فایل از قبل موجود باشد، بازنویسی خواهد شد. این شیوه توصیه‌شده برای جمع‌آوری گزارش‌ها از flashprog است، زیرا حتی اگر پیام‌های روی صفحه پرجزئیات نباشند، گزارش فایل پرجزئیات خواهد بود و نیازی به تغییر مسیر خروجی ندارد.
.RE
.PP
.BR \-h ", " \-\-help
.RS 4
نمایش متن راهنما و خروج.
.RE
.PP
.BR \-\-temporary
.RS 4
تلاش برای استفاده از دستور نوشتن ناپایدار در ثبات وضعیت. بخش
.BR set " در " "عملیات‌ها (OPERATIONS)"
در بالا را ببینید.
.RE

.SH "مثال‌ها (EXAMPLES)"
برای خواندن تنظیم
.B quad-enable
حافظه فلش داخلی بایوس (BIOS):
.sp
.RS 2
.B flashprog config -p internal quad-enable
.sp
.RE
یا
.sp
.RS 2
.B flashprog config get -p internal quad-enable
.sp
.RE
برای تنظیم موقت بیت
.B quad-enable
یک تراشه متصل به FT4222H:
.sp
.RS 2
.B flashprog config set -p ft4222_spi --temporary quad-enable 1
.RE

.SH "وضعیت خروج (EXIT STATUS)"
دستور flashprog با کد ۰ در صورت موفقیت خارج می‌شود، در بیشتر شکست‌ها با ۱ و در صورت ناموفق بودن فراخوانی mmap() با ۳ خارج می‌شود.

.SH "نیازمندی‌ها (REQUIREMENTS)"
برنامه flashprog برای پروگرامرهای مختلف به دسترسی‌های متفاوتی نیاز دارد. برای جزئیات به این بخش در صفحه راهنمای
.MR flashprog 8
مراجعه کنید.

.SH "گزارش اشکالات (BUGS)"
می‌توانید اشکالات را گزارش دهید، سؤالات خود را بپرسید یا گزارش‌های موفقیت را از طریق کانال‌های ارتباطی ما ارسال کنید:
.URLB "https://www.flashprog.org/Contact" "" .
.sp

.SH "مجوز (LICENSE)"
برنامه
.B flashprog
تحت مجوز عمومی همگانی گنو (GPL)، نسخه ۲ پوشش داده شده است. برخی از فایل‌ها علاوه بر این تحت هر نسخه بعدی GPL در دسترس هستند.

.SH "حق نشر (COPYRIGHT)"
.br
لطفاً فایل‌های مجزا را ببینید.
.PP
این صفحه راهنما توسط Nico Huber نوشته شده و از صفحه راهنمای
.MR flashprog 8
مشتق شده است. این اثر تحت شرایط مجوز GNU GPL (نسخه ۲ یا بالاتر) منتشر شده است.

.SH "همچنین ببینید (SEE ALSO)"
.MR flashprog 8