'\" t
.\" Title: belkinunv
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 06/21/2026
.\" Manual: NUT Manual
.\" Source: Network UPS Tools 2.8.5
.\" Language: Persian
.\"
.TH "BELKINUNV" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
belkinunv \- درایور برای «Universal UPS» بلکین و دستگاههای سازگار
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBbelkinunv\fR \-h
.sp
\fBbelkinunv\fR \-a \fIUPS_NAME\fR [\fIOPTIONS\fR]
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
این صفحه راهنما تنها ویژگیهای مختص سختافزار درایور belkin را مستند میکند\&. برای اطلاعات بیشتر درباره درایور اصلی، \fBnutupsdrv\fR(8) را ببینید\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
این درایور تنها از اتصالات سریال پشتیبانی میکند\&. اگر UPS شما دارای درگاه USB است، لطفاً به فهرست سازگاری سختافزار (HCL) مراجعه کنید تا ببینید کدامیک از درایورهای USB را باید استفاده کنید\&.
.sp .5v
.RE
.SH "سختافزارهای پشتیبانیشده (SUPPORTED HARDWARE)"
.sp
درایور belkinunv برای کارکرد با مدلهای F6C800\-UNV و F6C120\-UNV از Belkin Universal UPS شناخته شده است و انتظار میرود با سایر مدلهای Belkin Universal UPS نیز کار کند\&. این درایور تنها از ارتباط سریال پشتیبانی میکند، نه USB\&.
.sp
مدلهای Trust UPS و دستگاههای قدیمیتر Belkin توسط این درایور پشتیبانی نمیشوند، و همچنین مدلهای Belkin Home Office (مانند F6H500\-SER و غیره) نیز پشتیبانی نمیشوند\&. با این حال، برخی از مدلهای Belkin مانند Regulator Pro توسط درایور \fBbelkin\fR(8) پشتیبانی میشوند، و مدلهای Home Office با استفاده از درایور \fBgenericups\fR(8) با upstype=7 پشتیبانی میشوند\&.
.SH "راهکار خاموشسازی نرم (SOFT SHUTDOWN WORKAROUND)"
.sp
یک مشکل در Belkin Universal UPS این است که نمیتواند وارد وضعیت خاموشسازی نرم (قطع بار خروجی تا زمان بازگشت برق شهر AC) شود، مگر اینکه باتریها کاملاً خالی شده باشند\&. از این رو، نمیتوان پس از خاموش شدن سیستمعامل صرفاً UPS را خاموش کرد؛ زیرا با وصل مجدد برق، روشن نخواهد شد\&. بنابراین، درایور \fBbelkinunv\fR هرگز نباید با گزینه \fB\-k\fR استفاده شود\&. در عوض، گزینه \fB\-x wait\fR به عنوان یک راهکار ارائه شده است\&.
.sp
هنگامی که با گزینه \fB\-x wait\fR فراخوانی شود، \fBbelkinunv\fR به عنوان یک برنامه مستقل عمل میکند (یعنی به پسزمینه فورک نمیشود)\&. این برنامه یک وظیفه ساده را انجام میدهد: به UPS متصل میشود، تا زمان بازگشت برق شهر AC منتظر میماند، و سپس با وضعیت 0 خارج میشود\&.
.sp
هدف این است که این گزینه در اسکریپت خاموشسازی به این شکل استفاده شود: در طول فرآیند خاموش شدن سیستم، پس از آنکه تمام فایلسیستمها به صورت فقطخواندنی مجدداً مانت شدند و درست پیش از متوقف شدن عادی سیستم: فایل /etc/killpower (یا مشابه آن) را بررسی کنید تا ببینید آیا این خاموشسازی توسط \fBupsmon\fR(8) ایجاد شده است یا خیر، و در صورت مثبت بودن، \fBbelkinunv \-x wait\fR را فراخوانی کنید\&. اگر برق شهر AC وصل شود، \fBbelkinunv\fR خارج میشود و ساختار باید طوری ترتیب داده شود که در این حالت سیستم مجدداً راهاندازی (reboot) شود\&. اگر برق شهر AC وصل نشود، شارژ باتری UPS در نهایت به پایان میرسد، منبع تغذیه رایانه قطع میشود و UPS به حالت خاموشسازی نرم میرود؛ به این معنی که پس از وصل مجدد برق، همه چیز به درستی راهاندازی مجدد خواهد شد\&. در هر دو حالت، از بروز بنبست (deadlock) جلوگیری میشود\&.
.sp
علاوه بر این، اگر یک آرگومان عدد صحیح اختیاری به گزینه \fB\-x wait\fR داده شود، این کار باعث میشود \fBbelkinunv\fR نهتنها منتظر وصل بودن برق شهر AC، بلکه منتظر رسیدن شارژ باتری به سطح تعیینشده نیز بماند\&. من از این به عنوان بخشی از اسکریپتهای راهاندازی خود استفاده میکنم تا اطمینان یابم که باتریها پیش از ادامه بوت رایانه به میزان کافی شارژ شدهاند\&. این باید در بخشهای بسیار ابتدایی اسکریپت راهاندازی قرار گیرد، پیش از آنکه هر فایلسیستمی به صورت خواندن/نوشتن مانت شود و پیش از آنکه هرگونه بررسی فایلسیستم انجام گیرد\&.
.sp
چندین گزینه \fB\-x\fR دیگر برای تنظیم دقیق این رفتار فراهم شده است\&. برای توضیحات دقیق به گزینههای زیر مراجعه کنید\&. برای نمونههایی از نحوه استفاده از \fBbelkinunv\fR در اسکریپتهای خاموشسازی و راهاندازی، به بخش مثالها در ادامه مراجعه کنید\&.
.SH "گزینهها (OPTIONS)"
.sp
همچنین برای گزینههای عمومی \fBnutupsdrv\fR(8) را ببینید\&. هرگز از گزینه \fB\-k\fR با این درایور استفاده نکنید؛ زیرا به درستی کار نمیکند\&.
.PP
\fB\-x wait\fR[=\fIlevel\fR]
.RS 4
هنگامی که این گزینه استفاده میشود،
\fBbelkinunv\fR
به پسزمینه فورک نمیشود، بلکه به عنوان یک برنامه مستقل رفتار میکند\&. به UPS متصل میشود و تا زمان وصل شدن برق شهر AC منتظر میماند\&. اگر
\fIlevel\fR
مشخص شده باشد، همچنین تا رسیدن شارژ باتری حداقل به سطح ارائهشده بر حسب درصد منتظر میماند\&. سپس، و تنها در این صورت،
\fBbelkinunv\fR
خارج میشود\&. علاوه بر این، در حالی که
\fBbelkinunv\fR
در این حالت اجرا میشود، یک خط وضعیت همراه با اطلاعاتی از وضعیت UPS و سطح باتری نمایش میدهد\&. این برای استفاده در اسکریپتهای خاموشسازی و راهاندازی رایانه طراحی شده است، همانطور که در بخش
راهکار خاموشسازی نرم
در بالا شرح داده شد\&.
.RE
.PP
\fB\-x nohang\fR
.RS 4
این گزینه تنها زمانی اثرگذار است که در ترکیب با گزینه
\fB\-x wait\fR
استفاده شود\&. این گزینه سبب میشود که اگر ارتباط با UPS برقرار نشود یا قطع گردد،
\fBbelkinunv\fR
خارج شود، به جای آنکه به طور مداوم و همیشگی تلاش مجدد کند که رفتار پیشفرض است\&. گزینه
\fB\-x nohang\fR
باید در اسکریپت راهاندازی استفاده شود تا اطمینان حاصل شود که رایانه حتی در صورت جدا شدن UPS در حین قطعی برق (برای مثال متصل کردن رایانه به ژنراتور، انتقال آن به خانه همسایه یا موارد دیگر)، همچنان قابلیت بوت شدن را حفظ میکند\&.
.RE
.PP
\fB\-x flash\fR
.RS 4
این گزینه تنها زمانی اثرگذار است که در ترکیب با گزینه
\fB\-x wait\fR
استفاده شود\&. این گزینه باعث میشود بار خروجی UPS برای مدت کوتاهی («فلش») درست پس از بازگشت برق شهر AC و دستیابی به سطح باتری درخواستی (در صورت تعیین) قطع شود\&. این کار در صورتی مفید است که دستگاههای ثانویه (slaves) به این UPS متصل باشند؛ عمل فلش باعث راهاندازی مجدد همه آنها خواهد شد\&. توجه داشته باشید که با توجه به طراحی سختافزار Belkin UPS، قطع بار خروجی حدود ۱ تا ۲ دقیقه طول میکشد؛ فلش کوتاهتر به صورت قابلاطمینان انجامپذیر نیست\&. همچنین، رایانهها در زمان تعیینشده مجدداً راهاندازی میشوند، در صورت لزوم روی توان باتری، حتی اگر برق شهر AC در این بین دوباره قطع شود\&. این نباید مشکلی ایجاد کند، زیرا اسکریپتهای راهاندازی شما میتوانند این وضعیت را مدیریت کنند\&.
.RE
.PP
\fB\-x silent\fR
.RS 4
این گزینه تنها زمانی اثرگذار است که در ترکیب با گزینه
\fB\-x wait\fR
استفاده شود\&. این گزینه خط وضعیتی را که
\fBbelkinunv\fR
به طور معمول چاپ میکند پنهان میسازد\&.
.RE
.PP
\fB\-x dumbterm\fR
.RS 4
این گزینه تنها زمانی اثرگذار است که در ترکیب با گزینه
\fB\-x wait\fR
استفاده شود\&. این گزینه شیوه چاپ خط وضعیت توسط
\fBbelkinunv\fR
را تغییر میدهد\&. در حالت عادی، از دنبالههای کنترلی ترمینال برای بازنویسی همان سطر با اطلاعات وضعیت جدید در هر بار بهروزرسانی وضعیت استفاده میشود\&. این ممکن است در تمام ترمینالها کار نکند\&. اگر گزینه
\fB\-x dumbterm\fR
داده شود، هر بهروزرسانی وضعیت در یک خط جدید نوشته میشود\&.
.RE
.SH "متغیرها (VARIABLES)"
.PP
\fBbattery\&.charge\fR, \fBbattery\&.runtime\fR
.RS 4
توسط همه سختافزارها پشتیبانی نمیشود\&.
.RE
.PP
\fBbattery\&.voltage\fR, \fBbattery\&.voltage\&.nominal\fR, \fBinput\&.frequency\fR, \fBinput\&.frequency\&.nominal\fR
.RS 4
برای مثال 60 برای 60Hz
.RE
.PP
\fBinput\&.sensitivity\fR
.RS 4
قابل نوشتن: normal/medium/low
.RE
.PP
\fBinput\&.transfer\&.high\fR
.RS 4
قابل نوشتن: نقطه ولتاژ انتقال بالا بر حسب ولت (V)
.RE
.PP
\fBinput\&.transfer\&.low\fR
.RS 4
قابل نوشتن: نقطه ولتاژ انتقال پایین بر حسب ولت (V)
.RE
.PP
\fBinput\&.voltage\fR, \fBinput\&.voltage\&.maximum\fR, \fBinput\&.voltage\&.minimum\fR, \fBinput\&.voltage\&.nominal\fR, \fBoutput\&.frequency\fR, \fBoutput\&.voltage\fR, \fBups\&.beeper\&.status\fR
.RS 4
قابل نوشتن\&. مقادیر: enabled/disabled/muted\&. این متغیر وضعیت بوق هشدار پنل را کنترل میکند\&. مقدار enabled یعنی هنگام وجود هشدار صدا پخش شود، disabled به معنی هرگز صدا پخش نشدن است، و muted یعنی صدا موقتاً قطع شود تا زمانی که هشدار به طور معمول متوقف گردد\&. در وضعیت muted، بوق هشدار در رخداد بعدی (قطعی برق AC، آزمایش باتری و غیره) به طور خودکار دوباره فعال میشود\&. همچنین، بوق هشدار در طول یک رخداد بحرانی (باتری ضعیف) نمیتواند خاموش شود\&. توجه داشته باشید که همه مدلهای UPS از حالت «disabled» پشتیبانی نمیکنند\&.
.RE
.PP
\fBups\&.firmware\fR, \fBups\&.load\fR, \fBups\&.model\fR, \fBups\&.power\&.nominal\fR
.RS 4
برای مثال 800 برای یک سیستم 800VA
.RE
.PP
\fBups\&.status\fR
.RS 4
فهرستی از پرچمها؛ بخش
پرچمهای وضعیت
در ادامه را ببینید\&.
.RE
.PP
\fBups\&.temperature\fR
.RS 4
توسط همه سختافزارها پشتیبانی نمیشود\&.
.RE
.PP
\fBups\&.test\&.result\fR, \fBups\&.delay\&.restart\fR
.RS 4
زمان تا راهاندازی مجدد (فقطخواندنی)
.RE
.PP
\fBups\&.delay\&.shutdown\fR
.RS 4
زمان تا خاموشسازی (فقطخواندنی)\&. این مقدار همیشه مضربی از ۶۰ ثانیه است\&.
.RE
.PP
\fBups\&.type\fR
.RS 4
ONLINE/OFFLINE/LINEINT\&. این مقدار ساختار کلی این UPS را توصیف میکند (برای برنامههای مشتری دارای رابط گرافیکی که مایل به رسم تصویر متحرک از جریان برق هستند)\&. یک UPS آفلاین اتصالی مستقیم از ورودی AC به خروجی AC دارد، و همچنین اتصالی از ورودی AC به باتری، و از باتری به خروجی AC دارد\&. یک UPS آنلاین فاقد اتصال مستقیم از ورودی AC به خروجی AC است، در حالی که یک UPS لایناینتراکتیو فاقد اتصال از ورودی AC به باتری است\&.
.RE
.SH "دستورات (COMMANDS)"
.PP
\fBbeeper\&.enable, beeper\&.disable, beeper\&.mute\fR
.RS 4
فعالسازی، غیرفعالسازی یا بیصدا کردن بوق هشدار پنل\&. توجه داشته باشید که اگر بوق هشدار بیصدا (muted) شود، در رخداد بعدی (قطعی برق AC، آزمایش باتری و غیره) به طور خودکار دوباره روشن میشود\&. همچنین، بوق هشدار در طول یک رخداد بحرانی (باتری ضعیف) نمیتواند بیصدا شود\&.
.RE
.PP
\fBreset\&.input\&.minmax\fR
.RS 4
بازنشانی متغیرهای
\fBinput\&.voltage\&.minimum\fR
و
\fBinput\&.voltage\&.maximum\fR\&.
.RE
.PP
\fBshutdown\&.reboot\fR
.RS 4
قطع فوری بار خروجی برای حدود ۱ تا ۲ دقیقه\&.
.RE
.PP
\fBshutdown\&.reboot\&.graceful\fR
.RS 4
پس از ۴۰ ثانیه تاخیر، بار خروجی برای حدود ۱ تا ۲ دقیقه قطع میشود\&.
.RE
.PP
\fBshutdown\&.stayoff\fR
.RS 4
قطع فوری بار خروجی و خاموش ماندن\&. تنها راه روشن کردن مجدد آن فشردن دستی دکمه پنل جلویی است\&.
.RE
.PP
\fBtest\&.battery\&.start, test\&.battery\&.stop\fR
.RS 4
شروع/توقف آزمایش ۱۰ ثانیهای باتری\&.
.RE
.PP
\fBtest\&.failure\&.start, test\&.failure\&.stop\fR
.RS 4
شروع/توقف آزمایش باتری «عمیق»\&.
.RE
.SH "پرچمهای وضعیت (STATUS FLAGS)"
.PP
\fBOB\fR
.RS 4
بار روی باتری است، از جمله در طول آزمایشها
.RE
.PP
\fBOFF\fR
.RS 4
بار خروجی خاموش است
.RE
.PP
\fBOL\fR
.RS 4
بار برخط (آنلاین) است
.RE
.PP
\fBACFAIL\fR
.RS 4
قطعی برق شهر AC\&. توجه داشته باشید که این به ورودی AC اشاره دارد، بنابراین با «OB» یکسان نیست\&. قطعی برق AC میتواند در هر زمانی رخ دهد، برای مثال در طول آزمایش باتری، یا زمانی که بار UPS خاموش است\&.
.RE
.PP
\fBOVER\fR
.RS 4
اضافهبار
.RE
.PP
\fBOVERHEAT\fR
.RS 4
داغ شدن بیش از حد
.RE
.PP
\fBCOMMFAULT\fR
.RS 4
خطای UPS
.RE
.PP
\fBLB\fR
.RS 4
باتری ضعیف (low battery)
.RE
.PP
\fBCHRG\fR
.RS 4
در حال شارژ
.RE
.PP
\fBDEPLETED\fR
.RS 4
باتری خالی شده است\&. هنگامی که UPS این پرچم را برمیافرازد، به طور همزمان بار خروجی را قطع میکند\&.
.RE
.PP
\fBRB\fR
.RS 4
تعویض باتری
.RE
.SH "مثالها (EXAMPLES)"
.sp
در اینجا مثالی از نحوه استفاده از \fBbelkinunv\fR در اسکریپت خاموشسازی رایانه آورده شده است\&. این دستورات باید در واپسین بخش اسکریپت خاموشسازی، پس از مانت شدن تمام فایلسیستمها به صورت فقطخواندنی، و درست پیش از متوقف شدن رایانه قرار گیرند\&. توجه داشته باشید که \fBbelkinunv\fR باید در دایرکتوریای نصب شده باشد که در آن نقطه همچنان قابل خواندن باشد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# NEAR END OF SHUTDOWN SCRIPT:
# if shutdown was caused by UPS, perform Belkin UPS workaround\&.
if [ \-f /etc/killpower ] || /usr/sbin/upsmon \-K ; then
echo "Waiting for AC power, or for UPS batteries to run out\&.\&.\&."
/usr/bin/belkinunv \-x wait /dev/ttyS1
# we get here if the power came back on\&. Reboot\&.
echo "Power is back\&. Rebooting\&.\&.\&."
reboot
fi
.fi
.if n \{\
.RE
.\}
.sp
و در اینجا مثالی از نحوه استفاده از \fBbelkinunv\fR در اسکریپت راهاندازی آورده شده است\&. این دستورات باید نزدیک به ابتدای اسکریپت راهاندازی، پیش از آنکه هر فایلسیستمی به صورت خواندن/نوشتن مانت شود، و پیش از آنکه هرگونه بررسی صحت فایلسیستم انجام گیرد، قرار داده شوند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# NEAR BEGINNING OF STARTUP SCRIPT:
# if we are recovering from a power failure, wait for the UPS to
# charge to a comfortable level before writing anything to disk
if [ \-f /etc/killpower ] || /usr/sbin/upsmon \-K ; then
echo "Waiting for UPS battery charge to reach 60%\&.\&.\&."
/usr/bin/belkinunv \-x wait=60 \-x nohang /dev/ttyS1
fi
.fi
.if n \{\
.RE
.\}
.SH "وضعیت خروج (EXIT STATUS)"
.sp
هنگامی که به طور عادی استفاده شود، \fBbelkinunv\fR به پسزمینه فورک میشود و پیامهای تشخیصی آن همانند تمام درایورهای NUT است؛ \fBnutupsdrv\fR(8) را ببینید\&.
.sp
هنگامی که با گزینه \fB\-x wait\fR استفاده شود، وضعیت خروج معمولاً \fB0\fR است\&. اگر گزینه \fB\-x nohang\fR نیز مشخص شده باشد، وضعیت خروج \fB1\fR نشاندهنده از دست رفتن ارتباط با UPS است\&. اگر گزینه \fB\-x flash\fR مشخص شده باشد، وضعیت خروج \fB2\fR نشاندهنده ناموفق بودن خاموشسازی زمانبندیشده است\&.
.SH "آرگومانهای اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از هیچ تنظیمات اضافی در \fBups.conf\fR(5) پشتیبانی نمیکند\&.
.SH "نویسندگان (AUTHORS)"
.sp
Peter Selinger
.SH "همچنین ببینید (SEE ALSO)"
.SS "درایور اصلی:"
.sp
\fBnutupsdrv\fR(8)
.SS "سایر درایورهای بلکین:"
.sp
\fBbelkinunv\fR(8), \fBblazer_ser\fR(8), \fBblazer_usb\fR(8), \fBusbhid-ups\fR(8)
.SS "منابع اینترنتی:"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحه خانگی NUT (Network UPS Tools):
https://www\&.networkupstools\&.org/historic/v2\&.8\&.5
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مستندات پروتکل مورد استفاده توسط این UPS:
belkin\-universal\-ups\&.html
(نسخه بازتولیدشده در وبگاه NUT)
.RE