'\" t
.\"     Title: nutdrv_qx
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/21/2026
.\"    Manual: NUT Manual
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: English
.\"
.TH "NUTDRV_QX" "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)"
nutdrv_qx \- درایور دستگاه‌های یوپی‌اس مبتنی بر پروتکل QX در مجموعه NUT
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnutdrv_qx\fR \-h
.sp
\fBnutdrv_qx\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
این صفحه راهنما صرفاً ویژگی‌های وابسته به سخت‌افزار درایور \fBnutdrv_qx\fR را مستند می‌کند\&. برای اطلاعات پیرامون درایور هسته، \fBnutupsdrv\fR(8) را ببینید\&.
.sp .5v
.RE
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
این پروتکل اصالتاً توسط Mega System Technologies, Inc\&. در تایوان ایجاد شد و توسط سازندگان پرشماری مورد استفاده قرار گرفت و در گذر زمان با افزوده‌شدن قابلیت‌ها و ناسازگاری‌های جزئی توسعه یافت\&. مستندات NUT معمولاً این خانواده بزرگ از گویش‌های مشابه را خانواده پروتکل‌های \fIMegatec Q*\fR یا \fIMegatec Qx\fR می‌نامد\&.
.sp
مشخص شده است که درایور \fBnutdrv_qx\fR با یوپی‌اس‌های مختلفی از برندهای \fIArmac\fR، \fIBlazer\fR، \fIEnergy Sistem\fR، \fIFenton Technologies\fR، \fIGeneral Electric\fR، \fIGtec\fR، \fIHunnox\fR، \fIMasterguard\fR، \fIMustek\fR، \fIPowercool\fR، \fIVoltronic Power\fR، \fISKE\fR (که توسط بسیاری دیگر بازنشر یا ری‌برند شده‌اند) و موارد بسیار دیگر کار می‌کند\&.
.sp
به طور خلاصه: اگر یوپی‌اس شما با نرم‌افزاری به نام \fIViewpower\fR عرضه شده است، احتمال زیادی وجود دارد که با این درایور با استفاده از یکی از پروتکل‌های \fIvoltronic*\fR یا پروتکل \fImecer\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
به دلایل تاریخی، دو گزینه تنظیم‌پذیر مهم این درایور تا حدی با نام‌گذاری نامناسب \fBprotocol\fR (برای گویش Qx) و \fBsubdriver\fR (برای تبدیل ارتباط USB به سریال) نامیده شده‌اند\&. سایر درایورهای چندگویشی، ماژول‌های گویشی خود را به عنوان \fBsubdrivers\fR معرفی می‌کنند و در واقع کد منبع ماژولار nutdrv_qx نیز همین کار را انجام می‌دهد\&.
.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
به دلیل تعداد بالای گویش‌های Qx پشتیبانی‌شده و مدت زمانی که برای ارسال ترکیب‌های مرتبط دستورات و انتظار برای دریافت پاسخ یا عدم دریافت آن نیاز است تا پشتیبانی سخت‌افزار/سفت‌افزار از یک شیوه خاص ارتباطی بررسی شود، راه‌اندازی اولیه خودکار درایور nutdrv_qx ممکن است حدود یک دقیقه طول بکشد\&. توصیه می‌شود مقادیر پروتکل یا زیردرایور تشخیص داده شده و گزارش‌شده را در فایل \fBups.conf\fR(5) خود ذخیره کنید تا راه‌اندازی‌های بعدی درایور سریع‌تر انجام شود و از مهلت زمانی احتمالی سرویس جلوگیری به عمل آید\&.
.sp .5v
.RE
.sp
جدول سازگاری NUT همه مدل‌های پشتیبانی‌شده شناخته‌شده را فهرست می‌کند\&. به یاد داشته باشید که ممکن است مدل‌های دیگری که در آنجا ذکر نشده‌اند نیز پشتیبانی شوند، اما هنوز آزمایش نشده یا گزارش داده نشده‌اند\&.
.sp
همه دستگاه‌های دارای رابط سریال و بسیاری از دستگاه‌های دارای رابط USB پشتیبانی می‌شوند\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
بسته به ساخت و مدل یوپی‌اس خود، ممکن است نیاز به بازنویسی یا تعیین مقادیر پیش‌فرض برای برخی پارامترها داشته باشید\&.
.sp
موارد زیر محتمل‌ترین گزینه‌هایی هستند که نیاز به تغییر خواهند داشت (\fBups.conf\fR(5) را ببینید):
.PP
\fBondelay =\fR \fIمقدار\fR
.RS 4
مدت زمان انتظار پیش از روشن کردن یوپی‌اس (به ثانیه)\&. این مقدار به مضارب ۶۰ ثانیه گرد می‌شود\&.
.sp
توجه داشته باشید که مقداری کمتر از ۳ دقیقه ممکن است باعث شود نسخه‌های اولیه سفت‌افزار به طور خودکار روشن نشوند، بنابراین پیش‌فرض آن ۳ دقیقه (یعنی ۱۸۰ ثانیه) است\&.
.sp
این گزینه یک مقدار پیش‌فرض برای
\fBups\&.delay\&.start\fR
فراهم می‌کند که در ادامه توسط درایور در توالی خاموش شدن خودکار استفاده خواهد شد (یعنی فراخوانی درایور با گزینه
\fB\-k\fR،
فراخوانی
\fBupsdrvctl\fR(8)
با گزینه
\fBshutdown\fR
یا زمانی که پرچم
FSD
تنظیم شده و
\fBupsmon\fR(8)
وارد توالی خاموش شدن خود می‌شود): با این حال می‌توانید این مقدار را در طول نشست جاری و صرفاً برای استفاده در دستورات فوری با تنظیم
\fBups\&.delay\&.start\fR
توسط
\fBupsrw\fR(8)
به صورت زنده تغییر دهید\&.
.RE
.PP
\fBoffdelay =\fR \fIمقدار\fR
.RS 4
مدت زمان انتظار پیش از خاموش کردن یوپی‌اس (به ثانیه)\&. این مقدار به مضارب ۶ ثانیه (برای کمتر از ۶۰ ثانیه) یا مضارب ۶۰ ثانیه (برای بیشتر از ۶۰ ثانیه) گرد می‌شود\&. مقدار پیش‌فرض ۳۰ ثانیه است\&.
.sp
این گزینه یک مقدار پیش‌فرض برای
\fBups\&.delay\&.shutdown\fR
فراهم می‌کند که در ادامه توسط درایور در توالی خاموش شدن خودکار استفاده خواهد شد (یعنی فراخوانی درایور با گزینه
\fB\-k\fR،
فراخوانی
\fBupsdrvctl\fR(8)
با گزینه
\fBshutdown\fR
یا زمانی که پرچم
FSD
تنظیم شده و
\fBupsmon\fR(8)
وارد توالی خاموش شدن خود می‌شود): با این حال می‌توانید این مقدار را در طول نشست جاری و صرفاً برای استفاده در دستورات فوری با تنظیم
\fBups\&.delay\&.shutdown\fR
توسط
\fBupsrw\fR(8)
به صورت زنده تغییر دهید\&.
.RE
.PP
\fBstayoff\fR
.RS 4
اگر stayoff را در
\fBups.conf\fR(5)
تنظیم کنید، هنگام بروز وضعیت FSD، یوپی‌اس دستور
\fBshutdown\&.stayoff\fR
را اجرا کرده و پس از
\fBups\&.delay\&.shutdown\fR
ثانیه خاموش می‌شود و دیگر روشن نخواهد شد (بخش
مشکلات شناخته‌شده را ببینید)، در غیر این صورت (رفتار استاندارد) یوپی‌اس دستور
\fBshutdown\&.return\fR
را فراخوانی کرده و پس از
\fBups\&.delay\&.shutdown\fR
ثانیه خاموش شده و سپس پس از
\fBups\&.delay\&.start\fR
ثانیه روشن می‌شود (در صورتی که برق شهر در این میان وصل شده باشد)\&.
.RE
.PP
\fBprotocol =\fR \fIرشته\fR
.RS 4
رد کردن تشخیص خودکار پروتکل و استفاده انحصاری از پروتکل مشخص‌شده\&. مقادیر پشتیبانی‌شده:
\fIbestups\fR,
\fIgtec\fR,
\fIhunnox\fR,
\fIinnovart31\fR,
\fIinnovart33\fR,
\fIinnovatae\fR,
\fImasterguard\fR,
\fImecer\fR,
\fImegatec\fR,
\fImegatec/old\fR,
\fImustek\fR,
\fIq1\fR,
\fIq2\fR,
\fIq6\fR,
\fIvoltronic\fR,
\fIvoltronic\-axpert\fR,
\fIvoltronic\-qs\fR,
\fIvoltronic\-qs\-hex\fR
و
\fIzinto\fR\&.
.sp
برنامه درایور را با گزینه
\-\-help
اجرا کنید تا فهرست دقیق مقادیر
protocol
که در حال حاضر شناسایی می‌کند را مشاهده فرمایید\&.
.sp
توجه داشته باشید که اگر در نهایت از پروتکل
\fIq1\fR
استفاده کردید، ممکن است بخواهید پروتکل‌های
\fImecer\fR,
\fImegatec\fR
و
\fIzinto\fR
را با تنظیم پرچم‌های
\fBnovendor\fR/\fBnorating\fR
(یکی از آن‌ها یا هر دو) نیز امتحان کنید\&.
.RE
.PP
\fBpollfreq =\fR \fIعدد\fR
.RS 4
تنظیم بازه زمانی نظرسنجی برای به‌روزرسانی‌های کامل (به ثانیه) جهت کاهش ترافیک پیام‌ها\&. بین دو درخواست نظرسنجی، درایور با بازه زمانی تعیین‌شده در گزینه
\fBpollinterval\fR
نظرسنجی‌های سریعی انجام می‌دهد که صرفاً به
\fBups\&.status\fR
رسیدگی می‌کنند (جزئیات در
\fBups.conf\fR(5))\&. مقدار پیش‌فرض ۳۰ (به ثانیه) است\&.
.RE
.sp
اگر یوپی‌اس شما هیچ‌یک از مقادیر \fBbattery\&.charge\fR یا \fBbattery\&.runtime\fR را گزارش نمی‌کند، ممکن است بخواهید گزینه‌های زیر را اضافه کنید تا مقادیر تخمینی محاسبه شوند:
.PP
\fBdefault\&.battery\&.voltage\&.high =\fR \fIمقدار\fR
.RS 4
حداکثر ولتاژ باتری که پس از حدود ۱۲ تا ۲۴ ساعت شارژ حاصل می‌شود\&. اگر می‌خواهید درایور مقدار تخمینی
\fBbattery\&.charge\fR
را گزارش کند، باید این گزینه را مشخص فرمایید (بخش
تخمین شارژ باتری را ببینید)\&.
.RE
.PP
\fBdefault\&.battery\&.voltage\&.low =\fR \fIمقدار\fR
.RS 4
حداقل ولتاژ باتری درست پیش از آنکه یوپی‌اس به طور خودکار خاموش شود\&. اگر می‌خواهید درایور مقدار تخمینی
\fBbattery\&.charge\fR
را گزارش کند، باید این گزینه را مشخص فرمایید (بخش
تخمین شارژ باتری را ببینید)\&.
.RE
.PP
\fBdefault\&.battery\&.voltage\&.nominal =\fR \fIمقدار\fR, \fBoverride\&.battery\&.voltage\&.nominal =\fR \fIمقدار\fR
.RS 4
برخی دستگاه‌ها ولتاژ نامی باتری را نادرست نشان می‌دهند (یا اصلاً نشان نمی‌دهند)، بنابراین ممکن است لازم باشد مقداری را بازنویسی کرده یا یک مقدار پیش‌فرض تعیین کنید\&.
.RE
.PP
\fBoverride\&.battery\&.packs =\fR \fIمقدار\fR
.RS 4
برخی دستگاه‌ها به صورت «محلی» فقط بخشی از ولتاژ کل باتری را گزارش می‌کنند (همچنین
\fBbattery_voltage_reports_one_pack\fR
در زیر را ببینید)\&.
.sp
به عنوان مثال، اگر
\fBbattery\&.voltage\&.nominal\fR
برابر با 24 ولت باشد، اما مقدار
\fBbattery\&.voltage\fR
حدود 2 ولت گزارش شود، تعداد
\fBbattery\&.packs\fR
برای تصحیح این قرائت باید 12 باشد\&.
.sp
درایور تلاش می‌کند این عدد را به طور خودکار شناسایی کند، اما اگر به هر دلیلی با شکست مواجه شد، می‌توانید این مقدار را به صورت دستی بازنویسی کنید\&.
.sp
توجه داشته باشید که این ویژگی در وهله اول برای «تخمین»
battery\&.charge
یا
battery\&.runtime
(با تنظیم
runtimecal)
مفید است، در صورتی که این قرائت‌ها مستقیماً توسط دستگاه ارائه نشوند\&.
.RE
.PP
\fBbattery_voltage_reports_one_pack\fR
.RS 4
برخی دستگاه‌ها به طور پیش‌فرض و محلی فقط بخشی از کل ولتاژ باتری را گزارش می‌کنند (در صورتی که مقدار توسط دستگاه گزارش نشود یا درایور به درستی تخمین نزند،
\fBoverride\&.battery\&.packs\fR
در بالا را نیز ببینید)\&.
.sp
اگر این پرچم تنظیم شود، اکثر زیردرایورها (به جز آن‌هایی که از ظرافت‌های پیچیده‌تر و خاص هر دستگاه آگاهند، در حال حاضر:
\fBablerex\fR,
\fBmasterguard\fR
و
\fBvoltronic\-qs\-hex\fR)
مقدار نهایی گزارش‌شده
\fBbattery\&.voltage\fR
را به عنوان مضربی از
\fBbattery\&.packs\fR
و مقدار محلی
\fBbattery\&.voltage\fR
تنظیم می‌کنند\&.
.sp
توجه داشته باشید که این گزینه اصولاً برای سازگاری در عیب‌یابی و رسم نمودار داده‌ها کاربرد دارد و نباید بر تخمین
battery\&.charge
یا
battery\&.runtime
تأثیر بگذارد \(em بنابراین بیش از آنکه حیاتی باشد، یک اصلاح ظاهری است\&.
.RE
.PP
\fBruntimecal =\fR \fIمقدار,مقدار,مقدار,مقدار\fR
.RS 4
پارامتر مورداستفاده در برآورد زمان کارکرد (اختیاری)\&. این گزینه دو زمان کارکرد را در بارگذاری‌های مختلف دریافت می‌کند\&. به طور معمول، این تنظیم زمان کارکرد در بار کامل و زمان کارکرد در نصف بار را به کار می‌گیرد\&. به عنوان مثال، اگر یوپی‌اس شما زمان کارکرد اسمی ۲۴۰ ثانیه در بار کامل و ۷۲۰ ثانیه در نصف بار دارد، این‌گونه وارد می‌کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
runtimecal = 240,100,720,50
.fi
.if n \{\
.RE
.\}
.sp
بار اول همیشه باید بیشتر از بار دوم باشد\&. اگر مقادیری برای بارهایی غیر از ۱۰۰٪ و ۵۰٪ دارید، می‌توانید از آن‌ها نیز استفاده کنید، اما فاصله آن‌ها را تا جای ممکن دور از هم نگه دارید\&. فقط خیلی به حالت بدون بار نزدیک نشوید (پیش‌بینی زمان کارکرد در آن حالت بیشتر به بار بی‌باری باتری وابسته می‌شود)\&.
.RE
.PP
\fBchargetime =\fR \fIمقدار\fR
.RS 4
زمان مورد نیاز برای شارژ کامل باتری پس از تخلیه کامل\&. در صورت عدم تعیین، درایور پیش‌فرض ۴۳۲۰۰ ثانیه (۱۲ ساعت) را در نظر می‌گیرد\&. تنها در صورتی استفاده می‌شود که
\fBruntimecal\fR
نیز مشخص شده باشد\&.
.RE
.PP
\fBidleload =\fR \fIمقدار\fR
.RS 4
حداقل بار باتری مورد استفاده درایور برای تخمین زمان کارکرد\&. در صورت عدم تعیین، درایور پیش‌فرض ۱۰٪ را در نظر می‌گیرد\&. تنها در صورتی استفاده می‌شود که
\fBruntimecal\fR
نیز مشخص شده باشد\&.
.RE
.SS "پروتکل‌های BESTUPS, INNOVART31, INNOVART33, INNOVATAE, MECER, MEGATEC, MEGATEC/OLD, MUSTEK, Q1, Q2, Q6, VOLTRONIC\-QS, VOLTRONIC\-QS\-HEX, ZINTO"
.PP
\fBignoresab\fR
.RS 4
برخی از یوپی‌اس‌ها بیت «خاموشی فعال» (Shutdown Active) را به اشتباه همیشه روشن گزارش می‌کنند و در نتیجه باعث می‌شوند درایور تصور کند یوپی‌اس در آستانه خاموش شدن است (و در نتیجه، ups\&.status همیشه حاوی
FSD
است... و شما می‌دانید این به چه معناست)\&. تنظیم این پرچم باعث می‌شود که درایور بیت «خاموشی فعال» را نادیده بگیرد\&.
.RE
.SS "پروتکل‌های MECER, MEGATEC, MEGATEC/OLD, MUSTEK, ZINTO"
.PP
\fBondelay\fR
.RS 4
محدوده قابل قبول
0\&.\&.599940
ثانیه است\&.
.RE
.PP
\fBoffdelay\fR
.RS 4
محدوده قابل قبول
12\&.\&.600
ثانیه است\&.
.RE
.PP
\fBnorating\fR
.RS 4
برخی یوپی‌اس‌ها در صورت تلاش برای خواندن اطلاعات درجه‌بندی (Rating) قفل می‌شوند\&. تنظیم این پرچم باعث می‌شود درایور از این مرحله صرف‌نظر کند\&.
.RE
.PP
\fBnovendor\fR
.RS 4
برخی یوپی‌اس‌ها در صورت تلاش برای خواندن اطلاعات سازنده قفل می‌شوند\&. تنظیم این پرچم باعث می‌شود درایور از این مرحله صرف‌نظر کند\&.
.RE
.SS "پروتکل BESTUPS"
.PP
\fBondelay\fR
.RS 4
محدوده قابل قبول
60\&.\&.599940
ثانیه است\&.
.RE
.PP
\fBoffdelay\fR
.RS 4
محدوده قابل قبول
12\&.\&.5940
ثانیه است\&.
.RE
.PP
\fBpins_shutdown_mode =\fR \fIمقدار\fR
.RS 4
تنظیم عملکرد حالت خاموشی پایه ۱ و پایه ۷ در درگاه ارتباطی DB9 یوپی‌اس (مطابق با مشخصه EPS\-0059 شرکت Best Power) روی
\fIمقدار\fR
[0\&.\&.6]\&.
.RE
.SS "پروتکل MASTERGUARD"
.PP
\fBslave_addr =\fR \fIمقدار\fR
.RS 4
وادار کردن تابع تصاحب (claim) به بررسی اینکه آیا با
\fIنشانی پیرو (slave address)\fR
مشخص‌شده
(\fBups\&.id\fR)
ارتباط برقرار می‌کند یا خیر\&. این یک اقدام حفاظتی در برابر ارتباط با یوپی‌اس اشتباهی از میان چند یوپی‌اس یکسان روی یک گذرگاه USB است\&. توجه داشته باشید که هنگام تغییر
\fBups\&.id\fR
(از طریق
\fBupsrw\fR(8))
درایور به برقراری ارتباط با یوپی‌اس با
\fIنشانی پیرو\fR
جدید ادامه می‌دهد، اما پس از راه‌اندازی مجدد تا زمانی که پارامتر
\fBslave_addr\fR
تنظیم نشود، مجدداً آن را تصاحب نخواهد کرد\&.
.RE
.SS "پروتکل‌های INNOVART31, INNOVART33, INNOVATAE, Q1, Q2, Q6"
.PP
\fBondelay\fR
.RS 4
محدوده قابل قبول
0\&.\&.599940
ثانیه است\&.
.RE
.PP
\fBoffdelay\fR
.RS 4
محدوده قابل قبول
12\&.\&.600
ثانیه است\&.
.RE
.SS "پروتکل‌های Q2, Q6"
.PP
\fBnooutstats\fR
.RS 4
برخی یوپی‌اس‌ها از دستور
WA
که آمار بار خروجی را برمی‌گرداند پشتیبانی نمی‌کنند\&. استفاده از این پرچم باعث می‌شود که درایور این درخواست‌ها را نادیده بگیرد\&.
.RE
.SS "پروتکل‌های VOLTRONIC\-QS, VOLTRONIC\-QS\-HEX"
.PP
\fBondelay\fR
.RS 4
محدوده قابل قبول
60\&.\&.599940
ثانیه است\&.
.RE
.PP
\fBoffdelay\fR
.RS 4
محدوده قابل قبول
12\&.\&.540
ثانیه است\&.
.RE
.SS "پروتکل VOLTRONIC\-AXPERT"
.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
این پروتکل در حال حاضر عمدتاً آزمایشی است و بسیاری از ویژگی‌های آن ممکن است تنها در ساخت‌های ویژه‌ای از برنامه درایور NUT ارائه شوند\&.
.sp .5v
.RE
.PP
\fBreset_to_default\fR
.RS 4
بازنشانی گزینه‌های قابلیت‌ها و محدودیت‌های آن‌ها به مقادیر پیش‌فرض امن
.RE
.PP
\fBbypass_alarm\fR
.RS 4
هشدار صوتی (بوق!) در حالت گذرگاه فرعی (Bypass) [فعال/غیرفعال]
.RE
.PP
\fBbattery_alarm\fR
.RS 4
هشدار صوتی (بوق!) در حالت باتری [فعال/غیرفعال]
.RE
.SS "پروتکل VOLTRONIC"
.sp
گزینه‌های زیر تنها توسط پروتکل \fIvoltronic\fR پشتیبانی می‌شوند\&. همه آن‌ها در تمامی یوپی‌اس‌های پشتیبانی‌شده توسط این پروتکل در دسترس نیستند\&.
.PP
\fBondelay\fR
.RS 4
محدوده قابل قبول
0\&.\&.599940
ثانیه است\&.
.RE
.PP
\fBoffdelay\fR
.RS 4
محدوده قابل قبول
12\&.\&.5940
ثانیه است\&.
.RE
.PP
\fBbattery_number =\fR \fIمقدار\fR
.RS 4
تنظیم تعداد باتری‌هایی که یک بسته را تشکیل می‌دهند روی
\fIمقدار\fR
[1\&.\&.9]\&. این تنظیم برآورد شارژ و زمان کارکرد گزارش‌شده توسط یوپی‌اس را تغییر خواهد داد\&.
.RE
.PP
\fBoutput_phase_angle =\fR \fIمقدار\fR
.RS 4
تغییر زاویه فاز خروجی به مقدار ارائه‌شده [000, 120, 180, 240]\(de\&.
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBتنظیمات قابلیت‌های یوپی‌اس\fR
.RS 4
.PP
\fBreset_to_default\fR
.RS 4
بازنشانی گزینه‌های قابلیت‌ها و محدودیت‌های ولتاژ و بسامد آن‌ها به مقادیر پیش‌فرض امن\&. (\fBتنها زمانی امکان‌پذیر است که یوپی‌اس در حالت آماده‌به‌کار (Standby) باشد\fR)
.sp
توجه داشته باشید که تنظیم این گزینه موارد زیر را نیز بازنشانی خواهد کرد:
\fBups\&.start\&.auto\fR،
\fBbattery\&.protection\fR،
\fBbattery\&.energysave\fR،
\fBups\&.start\&.battery\fR،
\fBoutlet\&.0\&.switchable\fR،
\fBinput\&.transfer\&.high\fR،
\fBinput\&.transfer\&.low\fR،
\fBinput\&.frequency\&.high\fR
و
\fBinput\&.frequency\&.low\fR\&.
.RE
.sp
این یوپی‌اس‌ها را می‌توان با فعال یا غیرفعال کردن گزینه‌های زیر برای برآوردن نیازهای خود تنظیم دقیق کرد (درایور در هنگام راه‌اندازی باید به شما بگوید یوپی‌اس توانایی کدام موارد را دارد: گزینه‌های قابل تنظیم در لاگ‌ها به صورت \fIenabled\fR یا \fIdisabled\fR گزارش می‌شوند):
.PP
\fBalarm_control =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن هشدار صوتی (بوق!) [enabled/disabled]\&. همچنین با دستورات فوری
\fBbeeper\&.enable\fR
و
\fBbeeper\&.disable\fR
به صورت زنده قابل تنظیم است\&.
.RE
.PP
\fBbypass_alarm =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن هشدار صوتی (بوق!) در حالت گذرگاه فرعی (Bypass) [enabled/disabled]\&.
.RE
.PP
\fBbattery_alarm =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن هشدار صوتی (بوق!) در حالت باتری [enabled/disabled]\&.
.RE
.PP
\fBbypass_when_off =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن بای‌پس در هنگام خاموش بودن یوپی‌اس [enabled/disabled]\&. در صورت فعال بودن، هنگام خاموش بودن یوپی‌اس برق متناوب (AC) مستقیماً برق دستگاه‌های متصل را تأمین می‌کند\&.
.RE
.PP
\fBbypass_forbidding =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن ممنوعیت بای‌پس [enabled/disabled]\&. در صورت فعال بودن، یوپی‌اس تحت هیچ شرایطی به حالت بای‌پس منتقل نخواهد شد\&.
.RE
.PP
\fBconverter_mode =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن حالت مبدل [enabled/disabled]\&. هنگامی که بسامد ورودی بین ۴۰ تا ۷۰ هرتز باشد، می‌توان یوپی‌اس را روی بسامد خروجی ثابت ۵۰ هرتز یا ۶۰ هرتز تنظیم کرد\&. یوپی‌اس در این حالت همچنان باتری را شارژ می‌کند\&.
.RE
.PP
\fBeco_mode =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن حالت اکو (ECO) [enabled/disabled]\&. هنگامی که ولتاژ/بسامد ورودی در محدوده قابل قبول باشد، یوپی‌اس ولتاژ را برای صرفه‌جویی در مصرف انرژی مستقیماً به خروجی هدایت می‌کند\&. مدارهای PFC و اینورتر در این حالت همچنان فعال هستند\&. همچنین با دستورات فوری
\fBbypass\&.start\fR
و
\fBbypass\&.stop\fR
به صورت زنده قابل تنظیم است\&.
.RE
.PP
\fBadvanced_eco_mode =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن حالت اکوی پیشرفته [enabled/disabled]\&. هنگامی که ولتاژ/بسامد ورودی در محدوده قابل قبول باشد، یوپی‌اس ولتاژ را برای صرفه‌جویی در انرژی به خروجی هدایت می‌کند\&. در این حالت PFC و اینورتر خاموش هستند\&.
.RE
.PP
\fBbattery_open_status_check =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن بررسی وضعیت اتصال باتری [enabled/disabled]\&. در صورت فعال بودن، هنگامی که یوپی‌اس روشن می‌شود، متصل بودن یا نبودن باتری را بررسی می‌کند\&.
.RE
.PP
\fBsite_fault_detection =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن تشخیص خطای سیم‌کشی محل [enabled/disabled]\&. در صورت فعال بودن، در صورت معکوس بودن سیم‌های فاز و نول ورودی، یوپی‌اس بوق می‌زند\&.
.RE
.PP
\fBconstant_phase_angle =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن تابع زاویه فاز ثابت (برابر نبودن زاویه‌های فاز خروجی و ورودی) [enabled/disabled]\&.
.RE
.PP
\fBlimited_runtime_on_battery =\fR \fIرشته\fR
.RS 4
فعال یا غیرفعال کردن زمان کارکرد محدود در حالت باتری [enabled/disabled]\&.
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBمحدودیت‌های ولتاژ/بسامد حالت بای‌پس\fR
.RS 4
.sp
متغیرهایی برای تنظیم دقیق محدودیت‌های ولتاژ و بسامد برای حالت بای‌پس\&. این محدودیت‌ها با گزینه \fBreset_to_default\fR به مقادیر پیش‌فرض امن بازنشانی می‌شوند\&.
.sp
اگر ولتاژ و بسامد برق AC در محدوده قابل قبول باشد، حالت بای‌پس استفاده خواهد شد (در صورتی که یوپی‌اس توانایی آن را داشته باشد و فعال شده باشد)\&.
.sp
از آنجا که این مقادیر وابسته به دستگاه هستند، اگر یوپی‌اس شما از آن‌ها پشتیبانی کند، محدودیت‌های قابل تنظیم آن‌ها در هنگام راه‌اندازی در لاگ‌ها چاپ می‌شود\&.
.PP
\fBmax_bypass_volt =\fR \fIمقدار\fR
.RS 4
حداکثر ولتاژ برای حالت بای‌پس (ولت)\&.
.RE
.PP
\fBmin_bypass_volt =\fR \fIمقدار\fR
.RS 4
حداقل ولتاژ برای حالت بای‌پس (ولت)\&.
.RE
.PP
\fBmax_bypass_freq =\fR \fIمقدار\fR
.RS 4
حداکثر بسامد برای حالت بای‌پس (هرتز)\&.
.RE
.PP
\fBmin_bypass_freq =\fR \fIمقدار\fR
.RS 4
حداقل بسامد برای حالت بای‌پس (هرتز)\&.
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBگزینه‌های ویژه برای یوپی‌اس‌های P31\fR
.RS 4
.sp
گزینه‌های زیر تنها در یوپی‌اس‌های P31 در دسترس هستند\&.
.PP
\fBwork_range_type =\fR \fIرشته\fR
.RS 4
محدوده کاری شبکه دستگاه برای یوپی‌اس‌های P31 [Appliance/UPS]\&.
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBآزمایش (TESTING)\fR
.RS 4
.sp
این پروتکل همراه با دو تابع ارائه می‌شود که به دلیل عدم آگاهی توسعه‌دهندگان از بخشی از پروتکل ارتباطی مورد استفاده این یوپی‌اس‌ها، به طور پیش‌فرض فعال نیستند\&. از آنجا که این توابع صرفاً درخواست‌هایی برای دریافت اطلاعات از یوپی‌اس هستند، \fIنباید\fR آسیبی به یوپی‌اس شما وارد کنند\&. بنابراین اگر شجاعت کافی دارید تا برای کمک به توسعه‌دهندگان، سلامت یوپی‌اس و دستگاه‌های متصل را به خطر بیندازید، از شما بسیار قدردانی خواهد شد\&. \fBاین کار را با مسئولیت خودتان انجام دهید\fR\&.
.PP
\fBtesting\fR
.RS 4
در صورت فراخوانی، درایور دستوراتی را که هنوز نیاز به آزمایش دارند نیز اجرا می‌کند\&.
.RE
.RE
.SS "فقط برای رابط سریال"
.PP
\fBcablepower =\fR \fIرشته\fR
.RS 4
به طور پیش‌فرض درایور خط DTR را تنظیم و RTS را پاک می‌کند (\fInormal\fR)\&. اگر متوجه شدید که یوپی‌اس شما شناسایی نمی‌شود یا ارتباط با آن نامطمئن است، می‌توانید امتحان کنید که آیا پاک کردن DTR و تنظیم RTS (\fIreverse\fR)، تنظیم هر دو DTR و RTS (\fIboth\fR) یا پاک کردن هر دو DTR و RTS (\fInone\fR) این وضعیت را بهبود می‌بخشد یا خیر\&.
.RE
.SS "فقط برای رابط USB"
.PP
\fBport =\fR \fIرشته\fR
.RS 4
گزینه الزامی برای همه درایورهای NUT\&. باید یک
\fIمقدار\fR
تعیین شود، معمولاً
\fBauto\fR
برای درایورهایی که اتصالات USB را مدیریت می‌کنند\&.
.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
این مقدار می‌تواند یک مسیر سیستم‌فایلی دستگاه مانند
/dev/usb/hiddev0
باشد، اما استفاده کنونی از API کتابخانه libusb مانع از شناخت و تطبیق با چنین شناسه‌هایی می‌شود\&. همچنین ممکن است این شناسه‌ها ذاتاً ناپایدار باشند (وابسته به اتصال مجدد کابل و ترتیب شمارش دستگاه‌ها)\&. در حال حاضر مقدار واقعی
\fIمقدار\fR
نادیده گرفته می‌شود، اما از نظر ساختاری وجود مقداری برای پیکربندی
\fIport\fR
همچنان الزامی است\&.
.sp .5v
.RE
.RE
.sp
امکان کنترل هم‌زمان چندین دستگاه یوپی‌اس با اجرای چند نمونه از این درایور وجود دارد، به شرطی که بتوان آن‌ها را با تنظیم ترکیبی از گزینه‌های \fBvendor\fR، \fBproduct\fR، \fBvendorid\fR، \fBproductid\fR، \fBserial\fR، \fBbus\fR یا \fBdevice\fR که در زیر شرح داده شده‌اند به طور یکتا متمایز کرد\&. برای دستگاه‌ها یا سیستم‌عامل‌هایی که اطلاعات کافی ارائه نمی‌دهند، گزینه \fBallow_duplicates\fR می‌تواند کاربردی باشد (محدود و پرخطر!)\&
.PP
\fBvendorid =\fR \fIregex\fR, \fBproductid =\fR \fIregex\fR, \fBvendor =\fR \fIregex\fR, \fBproduct =\fR \fIregex\fR, \fBserial =\fR \fIregex\fR
.RS 4
انتخاب یک یوپی‌اس خاص، در صورتی که بیش از یک دستگاه از طریق USB متصل باشد\&. هر گزینه یک عبارت باقاعده گسترده (برای اطلاعات بیشتر پیرامون عبارت‌های باقاعده
\fBregex\fR(7)
را ببینید) را مشخص می‌کند که باید با کل رشته مربوطه
vendor/product/serial
یوپی‌اس (بدون فاصله‌های خالی ابتدا و انتها) یا کل کد هگزادسیمال ۴ رقمی برای
vendorid
و
productid
مطابقت داشته باشد\&.
.sp
دستور
\fBlsusb\fR(8)
یا اجرای این درایور NUT با آرگومان خط فرمان
\-DD
را برای پیدا کردن رشته‌های مورد تطبیق امتحان کنید\&.
.sp
مثال‌ها:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x vendor="Foo\&.Corporation\&.*"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x vendorid="051d*"
(APC)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x product="\&.*(Smart|Back)\-?UPS\&.*"
.RE
.RE
.PP
\fBbus =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
انتخاب یک یوپی‌اس روی یک گذرگاه USB یا گروهی از گذرگاه‌های خاص\&. آرگومان یک عبارت باقاعده است که باید با نام گذرگاهی که یوپی‌اس به آن متصل است مطابقت داشته باشد (به عنوان مثال
bus="002"
یا
bus="00[2\-3]")
همان‌طور که در لینوکس در
/sys/bus/usb/devices
یا
\fBlsusb\fR(8)
مشاهده می‌شود؛ شامل صفرهای ابتدایی\&.
.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
سیستم‌عامل تضمین نمی‌کند که شماره‌های گذرگاه پس از راه‌اندازی مجدد سیستم، بارگذاری مجدد درایور هسته یا اتصال مجدد دستگاه (مانند تغییر وضعیت دستگاه‌های متصل به هاب‌های USB) پایدار بمانند\&.
.sp .5v
.RE
.RE
.PP
\fBdevice =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
انتخاب یک یوپی‌اس روی یک دستگاه USB خاص یا گروهی از دستگاه‌ها\&. آرگومان یک عبارت باقاعده است که باید با نام دستگاهی که یوپی‌اس به آن متصل است مطابقت داشته باشد (به عنوان مثال
device="001"
یا
device="00[1\-2]")
همان‌طور که در لینوکس در
/sys/bus/usb/devices
یا
\fBlsusb\fR(8)
مشاهده می‌شود؛ شامل صفرهای ابتدایی\&.
.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 .5v
.RE
.RE
.PP
\fBbusport =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
در صورتی که توسط سخت‌افزار، سیستم‌عامل و libusb در استقرار خاص پشتیبانی شود، این گزینه باید اجازه دهد تا به جای مقادیر منطقی شماره‌گذاری
device
، شماره درگاه‌های فیزیکی روی یک هاب USB مشخص شود که در نتیجه \(em باید در طول راه‌اندازی‌های مجدد یا اتصال مجدد نوسان کمتری داشته باشد\&. این مقدار را می‌توان در خروجی ساختار درختی USB ابزار
lsusb \-tv
روی سیستم‌هایی که این ابزار را دارند، مشاهده کرد\&.
.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
این گزینه در عمل توسط برخی ساخت‌های NUT پشتیبانی نمی‌شود (در این صورت باید با یک هشدار نادیده گرفته شود)، و همچنین در همه سیستم‌هایی که NUT می‌تواند روی آن‌ها اجرا شود نیز پشتیبانی نمی‌شود\&.
.sp .5v
.RE
.RE
.PP
\fBallow_duplicates\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
اگر چندین دستگاه یوپی‌اس دارید که ممکن است توسط گزینه‌های بالا به طور یکتا شناسایی نشوند (مثلاً فقط
\fIVID:PID\fR
در آنجا قابل شناسایی باشد)، این پرچم به هر نمونه از درایور که این گزینه در آن تنظیم شده اجازه می‌دهد اولین تطابق موجود را در دست بگیرد یا به تلاش برای مورد دیگر ادامه دهد\&.
.sp
به طور معمول راه‌اندازی درایور در این مرحله با اعلام خطای "Resource busy" یا خطای مشابه متوقف می‌شود، با این فرض که دستگاهی که به درستی تطبیق یافته یکتا است \(em و فرآیند دیگری در حال حاضر آن را مدیریت می‌کند\&.
.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
اگر فقط برایتان مهم است که بدانید
\fBحداقل\fR
یکی از یوپی‌اس‌های بدون‌نام شما برخط است، این گزینه می‌تواند کمک کند\&.
.sp
اما اگر واقعاً باید بدانید
\fBکدام‌یک\fR
از آن‌ها است، کمکی نخواهد کرد!
.sp .5v
.RE
.RE
.PP
\fBusb_set_altinterface =\fR \fIbAlternateSetting\fR
.RS 4
اجبار به فراخوانی افزونه
usb_set_altinterface()
، به ویژه در صورت نیاز برای دستگاه‌هایی که چندین نقش USB دارند و یوپی‌اس با شماره رابط
0
(پیش‌فرض) نمایش داده نمی‌شود\&.
.RE
.PP
\fBusb_config_index\fR, \fBusb_hid_rep_index\fR, \fBusb_hid_desc_index\fR, \fBusb_hid_ep_in\fR, \fBusb_hid_ep_out\fR
.RS 4
اجبار به استفاده از شماره‌های خاص رابط، نقطه پایانی (Endpoint)، شاخص توصیف‌گر و غیره، به جای مقدار پیش‌فرض
\fI0\fR
(به ندرت مقادیر دیگر در برخی درایورها برای دستگاه‌هایی که مشخصاً از اعداد غیر صفر استفاده می‌کنند)\&. به صورت یک عدد هگزادسیمال مشخص می‌شود\&.
.sp
به عنوان یک قاعده سرانگشتی برای کشف
usb_hid_desc_index
می‌توانید مقادیر بزرگ‌تر
wDescriptorLength
(تقریباً بیش از ۶۰۰ بایت) را در گزارش‌های
lsusb
یا ابزارهای مشابه مشاهده کنید\&.
.RE
.PP
\fBLIBUSB_DEBUG =\fR \fIعدد_صحیح\fR
.RS 4
عیب‌یابی زمان اجرای درایورهای NUT با قابلیت USB نه تنها شامل افزایش سطح گزارش‌دهی اشکال‌زدایی عمومی NUT (مثلاً با استفاده از تنظیم
DEBUG_MIN
در
\fBups.conf\fR(5)
یا دستورات پروتکل برای تغییر مقدار
driver\&.debug)
است، بلکه ممکن است از اشکال‌زدایی اختصاصی LibUSB نیز بهره‌مند شود\&.
.sp
برای مورد اخیر، می‌توانید گزینه درایور
LIBUSB_DEBUG
را تنظیم کنید؛ روش دیگر این است که به صورت سنتی متغیر محیطی
LIBUSB_DEBUG
را پیش از شروع برنامه درایور NUT (می‌تواند در اسکریپت راه‌اندازی درایور یا متد سرویس، شاید از طریق
\fBnut.conf\fR(5)
تنظیم و صادر شود) روی یک مقدار عددی مانند
4
("تمام پیام‌ها منتشر شوند") تنظیم کنید\&.
.sp
برای جزئیات بیشتر، از جمله مقادیر پشتیبانی‌شده کنونی برای نسخه کتابخانه شما، به عنوان مثال ببینید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://libusb\&.sourceforge\&.io/api\-1\&.0
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://libusb\&.sourceforge\&.io/api\-1\&.0/group__libusb__lib\&.html
.RE
.RE
.PP
\fBsubdriver =\fR \fIرشته\fR
.RS 4
انتخاب یک زیردرایور سریال روی USB برای استفاده\&. گزینه‌های انتخابی شما عبارتند از:
\fBablerex\fR,
\fBarmac\fR,
\fBcypress\fR,
\fBfabula\fR,
\fBfuji\fR,
\fBgtec\fR,
\fBhunnox\fR,
\fBippon\fR,
\fBkrauler\fR,
\fBphoenix\fR,
\fBphoenixtec\fR,
\fBsgs\fR
و
\fBsnr\fR\&.
.sp
برنامه درایور را با گزینه
\-\-help
اجرا کنید تا فهرست دقیق مقادیر
subdriver
که در حال حاضر شناسایی می‌کند را مشاهده کنید\&.
.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
هنگام استفاده از این گزینه، تعیین پارامترهای تطبیق
\fBvendorid\fR
و
\fBproductid\fR
نیز الزامی است\&.
.sp .5v
.RE
.RE
.PP
\fBlangid_fix =\fR \fIمقدار\fR
.RS 4
اعمال راهکار رفع اشکال شناسه زبان (language ID) روی زیردرایور
\fBkrauler\fR\&.
این کار برای کارکرد برخی دستگاه‌ها (LDLC، Dynamix و موارد دیگر) الزامی است\&. شما باید
\fIمقدار\fR
(0x409
یا
0x4095)
را مطابق با مدخل دستگاه خود در فهرست سازگاری سخت‌افزار NUT (HCL) ارائه دهید\&.
.RE
.PP
\fBnoscanlangid\fR
.RS 4
در صورت تنظیم این پرچم، محدوده معتبر برای langid به صورت خودکار پویش نمی‌شود\&.
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکات پیاده‌سازی (IMPLEMENTATION NOTES)\fR
.RS 4
.PP
\fBزیردرایور \fIarmac\fR\fR
.RS 4
زیردرایور ارتباطی Armac پروتکل ارتباطی مورد استفاده در نسخه قدیمی نرم‌افزار "PowerManagerII" را بازتولید می‌کند که به نظر نمی‌رسد اختصاصی Armac باشد: بنر آن "2004 Richcomm Technologies, Inc\&. Dec 27 2005 ver 1\&.1\&." است\&. شاید سایر یوپی‌اس‌های Richcomm نیز با این زیردرایور کار کنند \(em شاید حتی بهتر از درایور مستقل و قدیمی‌تر
richcomm_usb\&.
.RE
.PP
\fBزیردرایور \fIfabula\fR\fR
.RS 4
این زیردرایور که برای استفاده با پروتکل
\fImegatec\fR
طراحی شده است، از دستورات مختلف
\fBtest\&.battery\fR
پشتیبانی
\fBنمی‌کند\fR\&.
به علاوه، دستور
\fBshutdown\&.return\fR
مقادیر تنظیم‌شده در
\fIups\&.delay\&.start\fR/\fBondelay\fR
را نادیده می‌گیرد و باعث می‌شود یوپی‌اس به محض بازگشت برق، بار را روشن کند\&.
.RE
.PP
\fBزیردرایور \fIgtec\fR\fR
.RS 4
در حال حاضر، پشتیبانی اختصاصی Gtec تنها برای دستگاه‌های USB شناخته شده است (آزمایش‌شده با Gtec ZP120N) و با درگاه سریال مشاهده نشده است\&.
.sp
این حالت به صورت خودکار شناسایی نمی‌شود و باید به صورت دستی در
\fIups\&.conf\fR
شما فعال گردد، مانند:
.sp
.if n \{\
.RS 4
.\}
.nf
[gtec\-ups]
    driver = "nutdrv_qx"
    port = "auto"
    subdriver = "gtec"
    protocol = "gtec"
.fi
.if n \{\
.RE
.\}
.sp
پیاده‌سازی‌های دیگر زیردرایورها و پروتکل‌ها (از جمله
\fBblazer_usb\fR(8))
تا حدی کار می‌کنند، اما هر دو دو مشکل دارند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
آن‌ها از پرس‌وجوی ساده "Q1" استفاده می‌کنند که نتیجه آخرین آزمایش باتری را گزارش نمی‌دهد\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
به دلایلی یوپی‌اس حتی زمانی که باتری کاملاً قطع است ولتاژ باتری را عادی گزارش می‌دهد\&. بنابراین تا زمان قطع برق متوجه خراب بودن باتری نخواهید شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
این درایور به جای آن، درخواست پیشرفته‌تر "Q4" را ارسال می‌کند\&. در اینجا پاسخ شامل حروف وضعیتی با اطلاعات بیشتری نسبت به پرچم‌های دودویی Q1، از جمله وضعیت باتری است\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
پاسخ USB در قطعات ۸ بایتی خوانده می‌شود که باعث می‌شود یوپی‌اس از USB قطع شود\&. یوپی‌اس در عرض یک ثانیه دوباره متصل می‌شود، اما همچنان راه‌اندازی اولیه
nutdrv_qx
را با خطا مواجه می‌کند، جایی که پرس‌وجو بر خلاف
blazer_usb
دو بار در مدت کوتاهی ارسال می‌شود\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
راه‌حل ساده است: کل پاسخ به یکباره خوانده شود\&.
.RE
.RE
.RE
.PP
\fBزیردرایور \fIhunnox\fR\fR
.RS 4
این زیردرایور پروتکل ارتباط نزدیکی با زیردرایور
\fIfabula\fR
دارد و با چند تغییر جزئی برای دستگاه‌هایی تنظیم شده که مستقیماً توسط آن درایور پشتیبانی نمی‌شوند\&.
.RE
.PP
\fBزیردرایور \fIfuji\fR\fR
.RS 4
این زیردرایور که برای استفاده با پروتکل
\fImegatec\fR
طراحی شده است، از دستورات
\fBshutdown\&.stayoff\fR
و
\fBload\&.off\fR
پشتیبانی
\fBنمی‌کند\fR\&.
به علاوه، دستور
\fBshutdown\&.return\fR
مقادیر تعیین‌شده در
\fIups\&.delay\&.start\fR/\fBondelay\fR
را نادیده می‌گیرد و باعث می‌شود یوپی‌اس به محض بازگشت برق، بار را روشن کند\&.
.RE
.PP
\fBزیردرایور \fIkrauler\fR\fR
.RS 4
این زیردرایور که برای استفاده با پروتکل
\fImegatec\fR
طراحی شده است، از دستورات خاموش کردن پشتیبانی
\fBنمی‌کند\fR،
یعنی:
\fBshutdown\&.return\fR،
\fBshutdown\&.stayoff\fR
و
\fBload\&.off\fR\&.
.RE
.PP
\fBزیردرایور \fIsnr\fR\fR
.RS 4
این زیردرایور که برای استفاده با پروتکل
\fImegatec\fR
طراحی شده است، از دستورات خاموش کردن پشتیبانی
\fBنمی‌کند\fR،
یعنی:
\fBshutdown\&.return\fR،
\fBshutdown\&.stayoff\fR
و
\fBload\&.off\fR\&.
.RE
.RE
.SH "دستورات یوپی‌اس (UPS COMMANDS)"
.sp
این درایور از برخی دستورات فوری پشتیبانی می‌کند (\fBupscmd\fR(8) را ببینید):
.PP
\fBbeeper\&.toggle\fR
.RS 4
تغییر وضعیت بوق یوپی‌اس (در برخی سخت‌افزارها موجود نیست)\&.
.RE
.PP
\fBload\&.on\fR
.RS 4
روشن کردن فوری بار (در برخی سخت‌افزارها موجود نیست)\&.
.RE
.PP
\fBload\&.off\fR
.RS 4
خاموش کردن فوری بار (بخش
مشکلات شناخته‌شده را ببینید)\&.
.RE
.PP
\fBshutdown\&.return\fR
.RS 4
خاموش کردن بار و بازگشت با وصل مجدد برق\&. از تایمرهای تعریف‌شده توسط
\fBups\&.delay\&.start\fR
و
\fBups\&.delay\&.shutdown\fR
استفاده می‌کند\&.
.RE
.PP
\fBshutdown\&.stayoff\fR
.RS 4
خاموش کردن بار و خاموش ماندن (بخش
مشکلات شناخته‌شده را ببینید)\&. از تایمر تعریف‌شده توسط
\fBups\&.delay\&.shutdown\fR
استفاده می‌کند\&.
.RE
.PP
\fBshutdown\&.stop\fR
.RS 4
توقف فرایند خاموش شدن در حال انجام\&.
.RE
.PP
\fBtest\&.battery\&.start\&.deep\fR
.RS 4
انجام آزمایش عمیق باتری (در برخی سخت‌افزارها موجود نیست)\&.
.RE
.PP
\fBtest\&.battery\&.start\&.quick\fR
.RS 4
انجام آزمایش سریع باتری (۱۰ ثانیه)\&.
.RE
.PP
\fBtest\&.battery\&.stop\fR
.RS 4
توقف آزمایش باتری در حال اجرا (در برخی سخت‌افزارها موجود نیست)\&.
.RE
.SS "پروتکل‌های BESTUPS, INNOVART31, INNOVART33, INNOVATAE, MECER, MEGATEC, MEGATEC/OLD, MUSTEK, Q1, Q2, Q6, ZINTO"
.PP
\fBtest\&.battery\&.start\fR \fIمقدار\fR
.RS 4
انجام آزمایش باتری به مدت
\fIمقدار\fR
ثانیه (گردشده به ۶۰ ثانیه) [60\&.\&.5940]\&.
.RE
.SS "پروتکل MASTERGUARD"
.PP
\fBclear\&.fault\&.record\fR
.RS 4
پاک کردن سابقه خطاها/ایرادها
.RE
.PP
\fBbeeper\&.enable\fR
.RS 4
فعال کردن بوق یوپی‌اس\&.
.RE
.PP
\fBbeeper\&.disable\fR
.RS 4
غیرفعال کردن بوق یوپی‌اس\&.
.RE
.PP
\fBtest\&.battery\&.start\&.low\fR
.RS 4
انجام آزمایش باتری تا زمان کم شدن شارژ باتری\&.
.sp
تفاوت بین «آزمایش باتری تا زمان کاهش شارژ باتری» و «آزمایش عمیق باتری» در این است که مورد دوم در واقع یک آزمایش کالیبراسیون باتری است و نیاز به برآورده شدن برخی پیش‌شرط‌ها دارد، یعنی بار باید بین ۳۰٪ تا ۱۰۰٪ بوده و ظرفیت اولیه باتری بیش از ۹۹٪ باشد\&.
.sp
«آزمایش باتری تا زمان کاهش شارژ» در هر زمانی قابل شروع است\&.
.sp
این قابلیت روی دستگاه‌های Masterguard A1000 و A2000 آزمایش شده است\&.
.RE
.PP
\fBtest\&.battery\&.start\fR \fIمقدار\fR
.RS 4
انجام آزمایش باتری به مدت
\fIمقدار\fR
ثانیه (گردشده به ۶۰ ثانیه) [0\&.\&.5940]\&. این مقدار به واحدهای ۶ ثانیه‌ای (برای کمتر از ۶۰ ثانیه) یا ۶۰ ثانیه‌ای (برای بیشتر از ۶۰ ثانیه) گرد می‌شود\&.
.RE
.PP
\fBbypass\&.start\fR
.RS 4
قرار دادن یوپی‌اس در حالت بای‌پس
.RE
.PP
\fBbypass\&.stop\fR
.RS 4
انتقال یوپی‌اس به حالت عادی
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBدستگاه‌های VOLTRONIC POWER P98 (با پروتکل MECER)\fR
.RS 4
.PP
\fBtest\&.battery\&.start\fR \fIمقدار\fR
.RS 4
انجام آزمایش باتری به مدت
\fIمقدار\fR
ثانیه (گردشده به ۶۰ ثانیه) [12\&.\&.5940]\&. این مقدار به واحدهای ۶ ثانیه‌ای (برای کمتر از ۶۰ ثانیه) یا ۶۰ ثانیه‌ای (برای بیشتر از ۶۰ ثانیه) گرد می‌شود\&.
.RE
.RE
.SS "پروتکل VOLTRONIC"
.sp
دستورات فوری زیر برای پروتکل \fIvoltronic\fR در دسترس هستند\&. همه آن‌ها روی تمامی یوپی‌اس‌های پشتیبانی‌شده توسط این پروتکل موجود نیستند\&.
.PP
\fBbeeper\&.enable\fR
.RS 4
فعال کردن بوق یوپی‌اس\&.
.RE
.PP
\fBbeeper\&.disable\fR
.RS 4
غیرفعال کردن بوق یوپی‌اس\&.
.RE
.PP
\fBtest\&.battery\&.start\fR \fIمقدار\fR
.RS 4
انجام آزمایش باتری به مدت
\fIمقدار\fR
ثانیه [12\&.\&.5940]\&. این مقدار به واحدهای ۶ ثانیه‌ای (برای کمتر از ۶۰ ثانیه) یا ۶۰ ثانیه‌ای (برای بیشتر از ۶۰ ثانیه) گرد می‌شود\&.
.RE
.PP
\fBoutlet\&.1\&.load\&.off\fR
.RS 4
خاموش کردن فوری بار خروجی ۱\&.
.RE
.PP
\fBoutlet\&.1\&.load\&.on\fR
.RS 4
روشن کردن فوری بار خروجی ۱\&.
.RE
.PP
\fBoutlet\&.2\&.load\&.off\fR
.RS 4
خاموش کردن فوری بار خروجی ۲\&.
.RE
.PP
\fBoutlet\&.2\&.load\&.on\fR
.RS 4
روشن کردن فوری بار خروجی ۲\&.
.RE
.PP
\fBoutlet\&.3\&.load\&.off\fR
.RS 4
خاموش کردن فوری بار خروجی ۳\&.
.RE
.PP
\fBoutlet\&.3\&.load\&.on\fR
.RS 4
روشن کردن فوری بار خروجی ۳\&.
.RE
.PP
\fBoutlet\&.4\&.load\&.off\fR
.RS 4
خاموش کردن فوری بار خروجی ۴\&.
.RE
.PP
\fBoutlet\&.4\&.load\&.on\fR
.RS 4
روشن کردن فوری بار خروجی ۴\&.
.RE
.PP
\fBbypass\&.start\fR
.RS 4
قرار دادن یوپی‌اس در حالت اکو (ECO Mode)\&.
.RE
.PP
\fBbypass\&.stop\fR
.RS 4
خارج کردن یوپی‌اس از حالت اکو (ECO Mode)\&.
.RE
.SH "تخمین شارژ باتری (BATTERY CHARGE GUESSTIMATION)"
.sp
با توجه به تقاضای مکرر کاربران، این درایور در صورتی که تعدادی از آرگومان‌های اضافی فهرست‌شده در بالا را مشخص کرده باشید، مقدار تخمینی \fBbattery\&.charge\fR و به صورت اختیاری \fBbattery\&.runtime\fR را گزارش می‌دهد\&.
.sp
اگر هر دو گزینه \fBbattery\&.voltage\&.high\fR و \fBbattery\&.voltage\&.low\fR را در \fBups.conf\fR(5) مشخص کنید اما \fBruntimecal\fR را وارد نکنید، درایور وضعیت شارژ را صرفاً با بررسی ولتاژ باتری تخمین می‌زند\&. این مقدار تحت بار قابل اعتماد نیست، زیرا چنین روشی تنها در صورتی مقادیر نسبتاً دقیقی می‌دهد که بار را قطع کنید، اجازه دهید باتری چند دقیقه استراحت کند و سپس ولتاژ مدار باز سلول را اندازه‌گیری نمایید\&. این کار در زمانی که برق قطع شده و یوپی‌اس در حال تأمین برق سیستم‌های شماست، اصلاً عملی نیست\&.
.sp
.if n \{\
.RS 4
.\}
.nf
                     battery\&.voltage \- battery\&.voltage\&.low
battery\&.charge =  \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- x 100 %
                  battery\&.voltage\&.high \- battery\&.voltage\&.low
.fi
.if n \{\
.RE
.\}
.sp
روشی برای به دست آوردن خوانش‌های بهتر بدون قطع بار وجود دارد، اما این کار مستلزم آن است که میزان (و سرعت) ورود و خروج جریان به باتری ثبت شود\&. اگر \fBruntimecal\fR را مشخص کرده باشید، درایور تلاش خواهد کرد این کار را انجام دهد\&. با این حال توجه داشته باشید که این روش به شدت به مقادیر واردشده توسط شما متکی است و یوپی‌اس نیز باید بتواند میزان بار را گزارش کند\&. دستگاه‌های متعددی وجود دارند که در تمام اوقات مقدار 0% (یا هر مقدار ثابت دیگر) را گزارش می‌کنند، که در این صورت بدیهی است این روش کار نخواهد کرد\&.
.sp
همچنین درایور هیچ راهی برای تعیین میزان افت ظرفیت باتری در طول زمان ندارد، بنابراین باید خودتان این موضوع را مدیریت کنید (با تنظیم مقادیر در \fBruntimecal\fR)\&. همچنین توجه داشته باشید که درایور وضعیت اولیه شارژ را بر اساس ولتاژ باتری حدس می‌زند، بنابراین این مقدار ممکن است حتی زمانی که مطمئنید باتری‌ها پر هستند کمتر از ۱۰۰٪ باشد\&. هیچ راهی برای اندازه‌گیری مطمئن این مقدار بین ۰ تا ۱۰۰٪ شارژ کامل وجود ندارد\&.
.sp
این وضعیت بهتر از هیچ است (اما نه خیلی بهتر)\&. اگر هر یک از محاسبات بالا قرائت‌های نادرستی به شما می‌دهد، خود شما مقادیر را در \fBups.conf\fR(5) وارد کرده‌اید، بنابراین از نویسنده گله نکنید\&. اگر چیز بهتری می‌خواهید، یوپی‌آسی بخرید که خودش به تنهایی و بدون کمک درایور NUT مقادیر \fBbattery\&.charge\fR و \fBbattery\&.runtime\fR را گزارش کند\&.
.SH "نکاتی برای کاربران قبلی درایورهای MEGATEC (NOTES FOR THE PREVIOUS USER OF MEGATEC DRIVERS)"
.sp
با جایگزینی درایورهای megatec توسط درایور \fBnutdrv_qx\fR، ممکن است کاربرانی که به \fBnutdrv_qx\fR مهاجرت می‌کنند نیاز به تغییراتی در پیکربندی داشته باشند\&.
.sp
به عنوان بخشی از این امر، گزینه‌های زیر از megatec در \fBups.conf\fR(5) باید تغییر یابند:
.PP
\fBbattvolts\fR
.RS 4
باید از
\fIdefault\&.battery\&.voltage\&.high\fR
و
\fIdefault\&.battery\&.voltage\&.low\fR
استفاده کنید\&.
.RE
.PP
\fBdtr\fR و \fBrts\fR
.RS 4
باید از
\fIcablepower\fR
استفاده کنید\&.
.RE
.PP
\fBignoreoff\fR
.RS 4
این پارامتر را می‌توان به سادگی کنار گذاشت، زیرا ناشی از درک نادرست مشخصات فنی بوده است\&.
.RE
.SH "نکاتی برای کاربران قبلی درایورهای BLAZER (NOTES FOR THE PREVIOUS USER OF BLAZER DRIVERS)"
.sp
با جایگزینی درایورهای blazer توسط درایور \fBnutdrv_qx\fR، ممکن است کاربرانی که به \fBnutdrv_qx\fR مهاجرت می‌کنند نیاز به تغییراتی در پیکربندی داشته باشند\&.
.sp
به عنوان بخشی از این امر، گزینه زیر از blazer در \fBups.conf\fR(5) باید تغییر کند:
.PP
\fBondelay\fR
.RS 4
در حالی که درایورهای قبلی blazer دقیقه را انتظار داشتند، درایور جدید
\fBnutdrv_qx\fR
ثانیه را می‌خواهد\&.
.RE
.sp
دستور فوری زیر نیز تغییر کرده است:
.PP
\fBtest\&.battery\&.start\fR \fIمقدار\fR
.RS 4
در حالی که درایورهای قدیمی blazer یک
\fIمقدار\fR
به دقیقه را انتظار داشتند، درایور
\fBnutdrv_qx\fR
یک
\fIمقدار\fR
به ثانیه را می‌خواهد\&.
.RE
.SH "نکاتی برای کاربران قبلی درایور BESTUPS (NOTES FOR THE PREVIOUS USER OF BESTUPS DRIVER)"
.sp
با جایگزینی درایور bestups توسط درایور \fBnutdrv_qx\fR، ممکن است کاربرانی که به \fBnutdrv_qx\fR مهاجرت می‌کنند نیاز به تغییراتی در پیکربندی داشته باشند\&.
.sp
به عنوان بخشی از این امر، گزینه‌های زیر از bestups در \fBups.conf\fR(5) دیگر توسط این درایور پشتیبانی نمی‌شوند:
.PP
\fBnombattvolt\fR, \fBbattvoltmult\fR
.RS 4
بخش
تخمین شارژ باتری را ببینید\&.
.RE
.PP
\fBID\fR
.RS 4
کنار گذاشته شد\&.
.RE
.SH "نکاتی برای کاربران قبلی درایورهای VOLTRONIC (NOTES FOR THE PREVIOUS USER OF VOLTRONIC DRIVERS)"
.sp
با جایگزینی درایورهای voltronic توسط درایور \fBnutdrv_qx\fR، ممکن است کاربرانی که به \fBnutdrv_qx\fR مهاجرت می‌کنند نیاز به تغییراتی در پیکربندی داشته باشند\&.
.sp
به عنوان بخشی از این امر، گزینه‌های زیر از voltronic در \fBups.conf\fR(5) باید تغییر یابند:
.PP
\fBondelay\fR
.RS 4
در حالی که درایورهای قبلی voltronic دقیقه را انتظار داشتند، درایور جدید
\fBnutdrv_qx\fR
ثانیه را می‌خواهد\&. این مقدار برای سازگاری با کاربرانی که از درایورهای قدیمی blazer مهاجرت می‌کنند، دیگر به صورت پیش‌فرض ۰ دقیقه نیست بلکه ۳ دقیقه (یعنی ۱۸۰ ثانیه) است\&.
.RE
.PP
\fBbattnumb\fR
.RS 4
نام این گزینه به
\fBbattery_number\fR
تغییر یافته است\&.
.RE
.sp
گزینه‌های زیر دیگر توسط این درایور پشتیبانی نمی‌شوند، اکنون می‌توانید آن‌ها را بسیار راحت‌تر به صورت زنده با فراخوانی \fBupsrw\fR(8) همراه با متغیر مناسب NUT تغییر دهید \(em به شرطی که یوپی‌اس شما از آن‌ها پشتیبانی کند\&.
.TS
tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
.sp
\fBbattpacks\fR
T}:T{
.sp
→ \fBbattery\&.packs\fR
.sp
تنظیم تعداد بسته‌های باتری موازی [1\&.\&.99]\&. این تنظیم تخمین شارژ و زمان کارکرد گزارش‌شده توسط یوپی‌اس را تغییر خواهد داد\&.
T}
T{
.sp
\fBbattlow\fR
T}:T{
.sp
→ \fBbattery\&.voltage\&.low\fR
.sp
تنظیم حداقل ولتاژ باتری درست پیش از آنکه یوپی‌اس به طور خودکار خاموش شود\&. این تنظیم تخمین شارژ و زمان کارکرد گزارش‌شده توسط یوپی‌اس را تغییر خواهد داد\&.
T}
T{
.sp
\fBauto_reboot\fR
T}:T{
.sp
→ \fBups\&.start\&.auto\fR
.sp
فعال یا غیرفعال کردن راه‌اندازی مجدد خودکار [enabled/disabled]\&. در صورت فعال بودن، با بازگشت برق AC یوپی‌اس به طور خودکار بازیابی می‌شود\&.
T}
T{
.sp
\fBbattery_protection\fR
T}:T{
.sp
→ \fBbattery\&.protection\fR
.sp
فعال یا غیرفعال کردن حفاظت در برابر تخلیه عمیق باتری [enabled/disabled]\&.
T}
T{
.sp
\fBenergy_saving\fR
T}:T{
.sp
→ \fBbattery\&.energysave\fR
.sp
فعال یا غیرفعال کردن قابلیت انرژی سبز [enabled/disabled]\&. در صورت فعال بودن، برای صرفه‌جویی در مصرف انرژی، یوپی‌اس در صورت عدم وجود بار به طور خودکار خاموش می‌شود\&.
T}
T{
.sp
\fBcold_start\fR
T}:T{
.sp
→ \fBups\&.start\&.battery\fR
.sp
فعال یا غیرفعال کردن راه‌اندازی سرد [enabled/disabled]\&. در صورت فعال بودن، یوپی‌اس می‌تواند حتی در صورت عدم اتصال برق AC نیز روشن شود\&.
T}
T{
.sp
\fBoutlet_control\fR
T}:T{
.sp
→ \fBoutlet\&.0\&.switchable\fR
.sp
فعال یا غیرفعال کردن کنترل پریزهای برنامه‌پذیر در حالت باتری [enabled/disabled]\&. در صورت فعال بودن، یوپی‌اس پس از فرا رسیدن زمان پشتیبان‌گیری (تنظیم‌شده از طریق \fBoutlet\&.\fR{\fB1\fR,\fB2\fR,\fB3\fR,\fB4\fR}\fB\&.delay\&.shutdown\fR) پریزهای برنامه‌پذیر را قطع می‌کند\&. در صورت غیرفعال بودن، یوپی‌اس برق مداوم پریزهای برنامه‌پذیر را تا زمان اتمام شارژ باتری تأمین می‌کند\&.
T}
T{
.sp
\fBmax_eco_volt\fR
T}:T{
.sp
→ \fBinput\&.transfer\&.high\fR
.sp
حداکثر ولتاژ برای حالت اکو (ولت)\&. اگر ولتاژ AC در محدوده قابل قبول باشد، حالت اکو استفاده خواهد شد (در صورتی که یوپی‌اس توانایی آن را داشته باشد و فعال شده باشد)\&.
T}
T{
.sp
\fBmin_eco_volt\fR
T}:T{
.sp
→ \fBinput\&.transfer\&.low\fR
.sp
حداقل ولتاژ برای حالت اکو (ولت)\&. اگر ولتاژ AC در محدوده قابل قبول باشد، حالت اکو استفاده خواهد شد (در صورتی که یوپی‌اس توانایی آن را داشته باشد و فعال شده باشد)\&.
T}
T{
.sp
\fBmax_eco_freq\fR
T}:T{
.sp
→ \fBinput\&.frequency\&.high\fR
.sp
حداکثر بسامد برای حالت اکو (هرتز)\&. اگر بسامد AC در محدوده قابل قبول باشد، حالت اکو استفاده خواهد شد (در صورتی که یوپی‌اس توانایی آن را داشته باشد و فعال شده باشد)\&.
T}
T{
.sp
\fBmin_eco_freq\fR
T}:T{
.sp
→ \fBinput\&.frequency\&.low\fR
.sp
حداقل بسامد برای حالت اکو (هرتز)\&. اگر بسامد AC در محدوده قابل قبول باشد، حالت اکو استفاده خواهد شد (در صورتی که یوپی‌اس توانایی آن را داشته باشد و فعال شده باشد)\&.
T}
T{
.sp
\fBoutlet1_delay\fR
T}:T{
.sp
→ \fBoutlet\&.1\&.delay\&.shutdown\fR
.sp
مدت زمان تأخیر پیش از آنکه پریز برنامه‌پذیر ۱ بار را در حالت باتری قطع کند [0\&.\&.59940] (ثانیه)\&.
T}
T{
.sp
\fBoutlet2_delay\fR
T}:T{
.sp
→ \fBoutlet\&.2\&.delay\&.shutdown\fR
.sp
مدت زمان تأخیر پیش از آنکه پریز برنامه‌پذیر ۲ بار را در حالت باتری قطع کند [0\&.\&.59940] (ثانیه)\&.
T}
T{
.sp
\fBoutlet3_delay\fR
T}:T{
.sp
→ \fBoutlet\&.3\&.delay\&.shutdown\fR
.sp
مدت زمان تأخیر پیش از آنکه پریز برنامه‌پذیر ۳ بار را در حالت باتری قطع کند [0\&.\&.59940] (ثانیه)\&.
T}
T{
.sp
\fBoutlet4_delay\fR
T}:T{
.sp
→ \fBoutlet\&.4\&.delay\&.shutdown\fR
.sp
مدت زمان تأخیر پیش از آنکه پریز برنامه‌پذیر ۴ بار را در حالت باتری قطع کند [0\&.\&.59940] (ثانیه)\&.
T}
T{
.sp
\fBbatt_type\fR
T}:T{
.sp
→ \fBbattery\&.type\fR
.sp
نوع باتری (صرفاً برای یوپی‌اس‌های P31) [Li/Flooded/AGM]\&.
T}
.TE
.sp 1
.SH "مشکلات شناخته‌شده (KNOWN PROBLEMS)"
.sp
برخی دستورات یوپی‌اس توسط همه مدل‌ها پشتیبانی نمی‌شوند\&. در اغلب موارد، زمانی که کاربر تلاش کند یک دستور پشتیبانی‌نشده را اجرا نماید، درایور پیامی به لاگ سیستم ارسال می‌کند\&. متأسفانه برخی مدل‌ها حتی راهی برای درایور فراهم نمی‌کنند تا این موضوع را بررسی کند، بنابراین دستورات پشتیبانی‌نشده بدون هیچ پیامی شکست می‌خورند\&.
.sp
هر دو دستور فوری \fBload\&.off\fR و \fBshutdown\&.stayoff\fR به منظور خاموش کردن نامحدود بار در نظر گرفته شده‌اند\&. با این حال برخی مدل‌های یوپی‌اس این اجازه را نمی‌دهند\&.
.sp
برخی مدل‌ها مقدار نادرستی برای وضعیت بیپر گزارش می‌کنند (همیشه \fIenabled\fR یا \fIdisabled\fR خواهد بود)\&. بنابراین، دستور \fBbeeper\&.toggle\fR ممکن است در وضعیتی که درایور گزارش می‌دهد بی‌اثر به نظر برسد در حالی که در واقعیت به درستی کار می‌کند\&.
.sp
مشخص شده است که مقدار دما و بار در برخی مدل‌ها ساختگی و نادرست است\&.
.SS "دستگاه‌های MASTERGUARD"
.sp
قرار است درایور از هر دو سری «جدید» A (شامل A700/1000/2000/3000 و مدل‌های ۱۹\- متناظر آن‌ها) و سری E (شامل E60/100/200) پشتیبانی کند، اما به دلیل عدم دسترسی به سخت‌افزار سری E، تنها روی سری A آزمایش شده است\&.
.SS "دستگاه‌های VOLTRONIC\-AXPERT"
.sp
این پروتکل از اینورترهای Voltronic Power Axpert مبتنی بر پروتکل P30 (مورد استفاده مثلاً در تجهیزات فتوولتائیک، اغلب همراه با یک یوپی‌اس شارژشونده توسط پنل‌های خورشیدی) پشتیبانی می‌کند\&.
.sp
کد در حال حاضر تا حد زیادی آزمایشی است و نقاط داده و نام دستورات با مفاهیمی که بخشی از واژگان استاندارد NUT هستند همسو نشده‌اند (بسیاری از آن‌ها با پیشوند فضای نام experimental\&. مشخص شده‌اند)\&. در حقیقت بسیاری از ویژگی‌ها ممکن است تنها در نسخه‌هایی با پیکربندی ویژه از برنامه درایور NUT ارائه شوند\&.
.SS "دستگاه‌های VOLTRONIC\-QS"
.sp
مشخص شده است که هر دو دستور فوری \fBload\&.off\fR و \fBshutdown\&.stayoff\fR تنها در صورت وجود برق شهر همان‌طور که انتظار می‌رود کار می‌کنند (یعنی بار را به طور نامحدود خاموش می‌کنند)، در غیر این صورت به محض بازگشت برق شهر به بار برق‌رسانی خواهد شد\&.
.sp
پس از صدور دستور فوری \fBshutdown\&.return\fR، در صورتی که شرایط زیر برقرار باشد، یوپی‌اس پیش از برق‌رسانی به بار منتظر \fBondelay\fR نخواهد ماند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر بار قبلاً (مهم نیست چه مدت قبل) از طریق
\fBload\&.off\fR/\fBshutdown\&.stayoff\fR
خاموش شده باشد
\fIو\fR
از طریق
\fBload\&.on\fR/\fBshutdown\&.stop\fR
روشن شده باشد
\fIو\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر پس از صدور
\fBload\&.off\fR/\fBshutdown\&.stayoff\fR
برق AC قطع نشده باشد (یعنی یوپی‌اس خودش خاموش نشده باشد)
\fIو\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر پس از صدور دستور
\fBshutdown\&.return\fR
قطعی برق رخ دهد
.RE
.sp
در این حالت، به محض بازگشت برق شهر، به بار برق‌رسانی خواهد شد\&.
.SS "دستگاه‌های VOLTRONIC\-QS\-HEX"
.sp
مشخص شده است که دستورات فوری \fBshutdown\&.return\fR، \fBload\&.off\fR و \fBshutdown\&.stayoff\fR تنها در صورت وجود برق شهر همان‌طور که انتظار می‌رود کار می‌کنند، در غیر این صورت به محض بازگشت برق شهر، بار برق‌دار خواهد شد\&.
.SH "هشدارهای یوپی‌اس (پروتکل VOLTRONIC) (UPS WARNINGS (VOLTRONIC PROTOCOL))"
.sp
یوپی‌اس‌های پشتیبانی‌شده توسط پروتکل \fIvoltronic\fR هشدارها را از طریق یک پرچم ۶۴ بیتی (bit1bit2\&...bit63bit64) گزارش می‌دهند که در آن ۱ به معنای بروز هشدار و ۰ به معنای عدم وجود هشدار است\&. از آنجا که بیش از یک هشدار می‌تواند در یک زمان اعلام شود و به دلیل فضای محدود در متغیر ups\&.alarm، در صورتی که طول هشدارها از متغیر ups\&.alarms فراتر رود، آن‌ها به صورت بیت گزارش خواهند شد\&. اگر می‌خواهید شرح آن بیت را بدانید، می‌توانید لاگ را بررسی کرده یا جدول زیر را ببینید (بیت‌های فهرست‌نشده معادل هشدارهای ناشناخته هستند)\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&۱.\ \&هشدارهای یوپی‌اس برای یوپی‌اس‌های \fIvoltronic\fR
.TS
allbox tab(:);
ltB ltB.
T{
#
T}:T{
هشدار متناظر
T}
.T&
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
.sp
1
T}:T{
.sp
باتری قطع است
T}
T{
.sp
2
T}:T{
.sp
سیم نول متصل نیست
T}
T{
.sp
3
T}:T{
.sp
خطای سیم‌کشی محل
T}
T{
.sp
4
T}:T{
.sp
توالی فازها نادرست است
T}
T{
.sp
5
T}:T{
.sp
توالی فازها در بای‌پس نادرست است
T}
T{
.sp
6
T}:T{
.sp
بسامد ورودی در بای‌پس ناپایدار است
T}
T{
.sp
7
T}:T{
.sp
شارژ بیش از حد باتری
T}
T{
.sp
8
T}:T{
.sp
باتری ضعیف است
T}
T{
.sp
9
T}:T{
.sp
هشدار اضافه‌بار
T}
T{
.sp
10
T}:T{
.sp
هشدار فن
T}
T{
.sp
11
T}:T{
.sp
وضعیت EPO فعال است
T}
T{
.sp
12
T}:T{
.sp
ناتوانی در روشن کردن یوپی‌اس
T}
T{
.sp
13
T}:T{
.sp
هشدار دمای بیش از حد
T}
T{
.sp
14
T}:T{
.sp
هشدار شارژر
T}
T{
.sp
15
T}:T{
.sp
خاموش شدن خودکار از راه دور
T}
T{
.sp
16
T}:T{
.sp
فیوز ورودی L1 کار نمی‌کند
T}
T{
.sp
17
T}:T{
.sp
فیوز ورودی L2 کار نمی‌کند
T}
T{
.sp
18
T}:T{
.sp
فیوز ورودی L3 کار نمی‌کند
T}
T{
.sp
19
T}:T{
.sp
وضعیت غیرعادی PFC مثبت در L1
T}
T{
.sp
20
T}:T{
.sp
وضعیت غیرعادی PFC منفی در L1
T}
T{
.sp
21
T}:T{
.sp
وضعیت غیرعادی PFC مثبت در L2
T}
T{
.sp
22
T}:T{
.sp
وضعیت غیرعادی PFC منفی در L2
T}
T{
.sp
23
T}:T{
.sp
وضعیت غیرعادی PFC مثبت در L3
T}
T{
.sp
24
T}:T{
.sp
وضعیت غیرعادی PFC منفی در L3
T}
T{
.sp
25
T}:T{
.sp
وضعیت غیرعادی در ارتباط گذرگاه CAN
T}
T{
.sp
26
T}:T{
.sp
وضعیت غیرعادی در مدار سیگنال هم‌زمان
T}
T{
.sp
27
T}:T{
.sp
وضعیت غیرعادی در مدار سیگنال پالس هم‌زمان
T}
T{
.sp
28
T}:T{
.sp
وضعیت غیرعادی در مدار سیگنال میزبان
T}
T{
.sp
29
T}:T{
.sp
کانکتور نری کابل موازی به خوبی متصل نشده است
T}
T{
.sp
30
T}:T{
.sp
کانکتور مادگی کابل موازی به خوبی متصل نشده است
T}
T{
.sp
31
T}:T{
.sp
کابل موازی به خوبی متصل نشده است
T}
T{
.sp
32
T}:T{
.sp
اتصال باتری در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
33
T}:T{
.sp
اتصال AC در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
34
T}:T{
.sp
اتصال بای‌پس در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
35
T}:T{
.sp
انواع مدل یوپی‌اس در سیستم‌های موازی هم‌خوانی ندارند
T}
T{
.sp
36
T}:T{
.sp
ظرفیت یوپی‌اس‌ها در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
37
T}:T{
.sp
تنظیم راه‌اندازی مجدد خودکار در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
38
T}:T{
.sp
شارژ بیش از حد سلول باتری
T}
T{
.sp
39
T}:T{
.sp
تنظیم حفاظت باتری در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
40
T}:T{
.sp
تنظیم تشخیص باتری در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
41
T}:T{
.sp
تنظیم مجاز نبودن بای‌پس در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
42
T}:T{
.sp
تنظیم مبدل در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
43
T}:T{
.sp
نقطه افت بالای بسامد در حالت بای‌پس در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
44
T}:T{
.sp
نقطه افت پایین بسامد در حالت بای‌پس در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
45
T}:T{
.sp
نقطه افت بالای ولتاژ در حالت بای‌پس در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
46
T}:T{
.sp
نقطه افت پایین ولتاژ در حالت بای‌پس در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
47
T}:T{
.sp
نقطه افت بالای بسامد در حالت AC در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
48
T}:T{
.sp
نقطه افت پایین بسامد در حالت AC در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
49
T}:T{
.sp
نقطه افت بالای ولتاژ در حالت AC در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
50
T}:T{
.sp
نقطه افت پایین ولتاژ در حالت AC در سیستم‌های موازی هم‌خوانی ندارد
T}
T{
.sp
51
T}:T{
.sp
هشدار قفل شدن در حالت بای‌پس پس از ۳ بار اضافه‌بار متوالی ظرف ۳۰ دقیقه
T}
T{
.sp
52
T}:T{
.sp
هشدار عدم تعادل جریان ورودی سه‌فاز AC
T}
T{
.sp
53
T}:T{
.sp
هشدار عدم تعادل جریان ورودی سه‌فاز شناسایی‌شده در حالت باتری
T}
T{
.sp
54
T}:T{
.sp
هشدار عدم تعادل جریان داخلی اینورتر
T}
T{
.sp
55
T}:T{
.sp
پیش‌هشدار قطع پریزهای برنامه‌پذیر
T}
T{
.sp
56
T}:T{
.sp
هشدار تعویض باتری
T}
T{
.sp
57
T}:T{
.sp
هشدار غیرعادی بودن زاویه فاز ورودی
T}
T{
.sp
58
T}:T{
.sp
هشدار!! درپوش کلید تعمیر و نگهداری باز است
T}
T{
.sp
62
T}:T{
.sp
خطای عملیات EEPROM
T}
.TE
.sp 1
.SH "نویسندگان (AUTHORS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Daniele Pezzini <hyouko@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Arnaud Quette <arnaud\&.quette@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
John Stamp <kinsayder@hotmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Peter Selinger <selinger@users\&.sourceforge\&.net>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Arjen de Korte <adkorte\-guest@alioth\&.debian\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Alexander Gordeev <lasaine@lvk\&.cs\&.msu\&.su>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Edgar Fuß <ef@math\&.uni\-bonn\&.de>
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBblazer_ser\fR(8), \fBblazer_usb\fR(8), \fBnutupsdrv\fR(8), \fBups.conf\fR(5), \fBupsc\fR(8), \fBupscmd\fR(8), \fBupsdrvctl\fR(8), \fBupsmon\fR(8), \fBupsrw\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
.\}
فهرست سازگاری سخت‌افزار (HCL) در NUT:
https://www\&.networkupstools\&.org/stable\-hcl\&.html
.RE