'\" t
.\"     Title: powerpanel
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/21/2026
.\"    Manual: راهنمای NUT
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: Persian
.\"
.TH "POWERPANEL" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "راهنمای NUT"
.\" -----------------------------------------------------------------
.\" * 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)"
powerpanel \- درایور برای تجهیزات یوپی‌اس سازگار با PowerPanel Plus از طریق درگاه سریال
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpowerpanel\fR \-h
.sp
\fBpowerpanel\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
این صفحه راهنما تنها ویژگی‌های مختص سخت‌افزار درایور powerpanel را مستند می‌کند\&. برای اطلاعات درباره درایور اصلی، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.sp .5v
.RE
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
این درایور از مدل‌های CyberPower BC1200، PR2200 و بسیاری از دستگاه‌های مشابه دیگر، هم برای پروتکل متنی و هم باینری پشتیبانی می‌کند\&. درایور پروتکل مورد استفاده را به صورت خودکار شناسایی خواهد کرد\&.
.sp
اگر یوپی‌اس Cyber Power Systems شما دارای درگاه USB است، ممکن است بخواهید از درایور \fBusbhid-ups\fR(8) استفاده کنید\&. درایور \fBsnmp-ups\fR(8) از چندین کارت شبکه از طریق SNMP پشتیبانی می‌کند\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از تنظیمات اختیاری زیر در \fBups.conf\fR(5) پشتیبانی می‌کند:
.PP
\fBprotocol=\fR[\fItext,binary\fR]
.RS 4
شناسایی خودکار پیش‌فرض پروتکل را بازنویسی می‌کند\&.
.RE
.PP
\fBmanufacturer=\fR\fIvalue\fR
.RS 4
اگر مقدار شناسایی‌شده به‌صورت خودکار را نمی‌پسندید، می‌توانید آن را با تنظیم مقدار در اینجا بازنویسی کنید\&.
.RE
.PP
\fBmodel=\fR\fIvalue\fR
.RS 4
مشابه manufacturer در بالا\&.
.RE
.PP
\fBserial=\fR\fIvalue\fR
.RS 4
مشابه manufacturer در بالا\&.
.RE
.PP
\fBondelay=\fR\fIvalue\fR
.RS 4
مدت زمان انتظار پیش از روشن کردن یوپی‌اس (۱ \- ۹۹۹۹ دقیقه، ۰=نامحدود)\&. تنها در درایور با پروتکل متنی در دسترس است (بخش
وضعیت پشتیبانی را ببینید)\&.
.RE
.PP
\fBoffdelay=\fR\fIvalue\fR
.RS 4
مدت زمان انتظار پیش از خاموش کردن یوپی‌اس (۶ \- ۶۰۰ ثانیه)\&. مقادیر کمتر از ۶۰ ثانیه به فواصل ۶ ثانیه‌ای، و مقادیر بالای ۶۰ ثانیه به فواصل ۶۰ ثانیه‌ای کوتاه می‌شوند\&. تنها در درایور با پروتکل متنی در دسترس است (بخش
وضعیت پشتیبانی را ببینید)\&.
.RE
.SH "متغیرها (VARIABLES)"
.sp
بسته به نوع دستگاه یوپی‌اس شما، برخی از متغیرهای زیر ممکن است با استفاده از \fBupsrw\fR(8) تغییر داده شوند\&. اگر درایور نتواند متغیری را از یوپی‌اس بخواند، در دسترس قرار نخواهد گرفت\&.
.PP
\fBinput\&.transfer\&.high\fR
.RS 4
قابل نوشتن: نقطه ولتاژ بالای انتقال برحسب ولت (V)
.RE
.PP
\fBinput\&.transfer\&.low\fR
.RS 4
قابل نوشتن: نقطه ولتاژ پایین انتقال برحسب ولت (V)
.RE
.PP
\fBbattery\&.charge\&.low\fR
.RS 4
قابل نوشتن: درصد شارژ باقیمانده باتری برای هشدار باتری ضعیف
.RE
.PP
\fBoutput\&.voltage\&.nominal\fR
.RS 4
قابل نوشتن: ولتاژ اسمی خروجی برحسب ولت (V)
.RE
.PP
\fBups\&.start\&.battery\fR
.RS 4
قابل نوشتن: اجازه راه‌اندازی سرد از طریق باتری
.RE
.SH "دستورها (COMMANDS)"
.sp
بسته به نوع دستگاه یوپی‌اس شما، برخی از دستورهای زیر ممکن است در دسترس باشند\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
test\&.battery\&.start\&.quick, test\&.battery\&.stop
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
beeper\&.enable, beeper\&.disable, beeper\&.toggle
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
shutdown\&.return, shutdown\&.reboot, shutdown\&.stayoff
.RE
.sp
روی بسیاری از دستگاه‌ها، این دستورها غیرقابل‌اطمینان هستند؛ بنابراین پیش از استفاده از آن‌ها باید بررسی کنید که آیا مطابق انتظار کار می‌کنند یا خیر (بخش مشکلات خاموش شدن را ببینید)\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
shutdown\&.stop
.RE
.SH "وضعیت پشتیبانی (SUPPORT STATUS)"
.sp
پشتیبانی از سوی سازنده برای این درایور وجود ندارد؛ بنابراین اگر به قابلیت‌هایی نیاز دارید که در حال حاضر موجود نیستند، مستندات کاملی در مورد آنچه درایور باید برای کارکرد آن به یوپی‌اس بفرستد ارائه دهید\&. اگر اطلاعات بیشتری درباره پروتکل باینری در دسترس بود، احتمالاً امکان پیکربندی \fIondelay\fR و \fIoffdelay\fR فراهم می‌شد\&. تاکنون، هیچ‌کس زمانی را برای بررسی اینکه چه چیزی باید به یوپی‌اس ارسال شود تا این قابلیت کار کند اختصاص نداده است، و شرکت CyberPower نیز تمایلی به اشتراک‌گذاری این اطلاعات با ما ندارد\&.
.SH "مشکلات خاموش شدن (SHUTDOWN ISSUES)"
.sp
اگر به نظر می‌رسد دستور \fBshutdown\&.return\fR روی یوپی‌اس شما کار نمی‌کند، این احتمال وجود دارد که یوپی‌اس شما از یک مدل قدیمی‌تر باشد\&. چند تنظیم مختلف را برای \fIoffdelay\fR امتحان کنید\&. اگر هیچ مقداری در محدوده ۶\&.\&.۶۰۰ کار نکرد، احتمالاً یوپی‌اس شما از این قابلیت پشتیبانی نمی‌کند\&. برای به دست آوردن رفتار مورد انتظار، نیاز به دستورهای \fBshutdown\&.stayoff\fR (هنگام استفاده از باتری) و \fBshutdown\&.reboot\fR (هنگام اتصال به برق شهر) است\&. درایور در صورت ناموفق بودن \fBshutdown\&.return\fR به‌طور خودکار به این دستورها بازمی‌گردد، و هنگامی که با گزینه \fI\-k\fR (یا از طریق \fBupsdrvctl shutdown\fR) فراخوانی شود، تلاش می‌کند تشخیص دهد که کدام دستور باید استفاده شود\&.
.sp
با این حال، این روش کاملاً بدون نقص و مطمئن نیست و باید آمادگی داشته باشید که برق یا قطع نشود، یا در زمان وصل مجدد برق شهر جریان وصل نگردد\&. تمامی مدل‌های پشتیبانی‌شده توسط پروتکل باینری و بسیاری از مدل‌های پشتیبانی‌شده از طریق پروتکل متنی تحت تأثیر این مشکل قرار دارند\&.
.SH "مشکلات شناخته‌شده (KNOWN PROBLEMS)"
.sp
سری CyberPower OP خوانش مستقیم مقادیر ولتاژ، شارژ، فرکانس و دما را ارائه نمی‌دهند\&. در عوض، آن‌ها یک مقدار باینری برمی‌گردانند که نیاز به تبدیل به مقدار واقعی دارد\&.
.sp
تبدیل دقیق مورد نیاز در زمان نگارش این متن نامشخص است، از این رو تخمینی بر اساس خوانش‌های به‌دست‌آمده از دستگاه‌های واقعی انجام شده است\&. این تخمین ممکن است (و احتمالاً خواهد بود) دارای خطا باشد، که احتمالاً خطای زیادی است\&. مگر اینکه بتوانید نگاشت دقیق بین مقادیر دریافتی از یوپی‌اس و خوانش‌های واقعی را به ما بگویید، به خود زحمت شکایت ندهید\&. ما بر اساس اطلاعات محدود موجود نهایت تلاش خود را کرده‌ایم\&. به یاد داشته باشید که یوپی‌اس یک ابزار اندازه‌گیری نیست\&.
.SH "نویسندگان (AUTHORS)"
.sp
Arjen de Korte <arjen@de\-korte\&.org>, Doug Reynolds <mav@wastegate\&.net>
.SH "همچنین ببینید (SEE ALSO)"
.SS "درایور اصلی (The core driver):"
.sp
\fBnutupsdrv\fR(8)
.SS "سایر درایورها (Other drivers):"
.sp
\fBusbhid-ups\fR(8), \fBsnmp-ups\fR(8)
.SS "منابع اینترنتی (Internet resources):"
.sp
صفحه اصلی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5/