POWERPANEL(8) راهنمای NUT POWERPANEL(8)

powerpanel - درایور برای تجهیزات یوپی‌اس سازگار با PowerPanel Plus از طریق درگاه سریال

powerpanel -h

powerpanel -a UPS_NAME [OPTIONS]


نکته

این صفحه راهنما تنها ویژگی‌های مختص سخت‌افزار درایور powerpanel را مستند می‌کند. برای اطلاعات درباره درایور اصلی، به nutupsdrv(8) مراجعه کنید.

این درایور از مدل‌های CyberPower BC1200، PR2200 و بسیاری از دستگاه‌های مشابه دیگر، هم برای پروتکل متنی و هم باینری پشتیبانی می‌کند. درایور پروتکل مورد استفاده را به صورت خودکار شناسایی خواهد کرد.

اگر یوپی‌اس Cyber Power Systems شما دارای درگاه USB است، ممکن است بخواهید از درایور usbhid-ups(8) استفاده کنید. درایور snmp-ups(8) از چندین کارت شبکه از طریق SNMP پشتیبانی می‌کند.

این درایور از تنظیمات اختیاری زیر در ups.conf(5) پشتیبانی می‌کند:

protocol=[text,binary]

شناسایی خودکار پیش‌فرض پروتکل را بازنویسی می‌کند.

manufacturer=value

اگر مقدار شناسایی‌شده به‌صورت خودکار را نمی‌پسندید، می‌توانید آن را با تنظیم مقدار در اینجا بازنویسی کنید.

model=value

مشابه manufacturer در بالا.

serial=value

مشابه manufacturer در بالا.

ondelay=value

مدت زمان انتظار پیش از روشن کردن یوپی‌اس (۱ - ۹۹۹۹ دقیقه، ۰=نامحدود). تنها در درایور با پروتکل متنی در دسترس است (بخش وضعیت پشتیبانی را ببینید).

offdelay=value

مدت زمان انتظار پیش از خاموش کردن یوپی‌اس (۶ - ۶۰۰ ثانیه). مقادیر کمتر از ۶۰ ثانیه به فواصل ۶ ثانیه‌ای، و مقادیر بالای ۶۰ ثانیه به فواصل ۶۰ ثانیه‌ای کوتاه می‌شوند. تنها در درایور با پروتکل متنی در دسترس است (بخش وضعیت پشتیبانی را ببینید).

بسته به نوع دستگاه یوپی‌اس شما، برخی از متغیرهای زیر ممکن است با استفاده از upsrw(8) تغییر داده شوند. اگر درایور نتواند متغیری را از یوپی‌اس بخواند، در دسترس قرار نخواهد گرفت.

input.transfer.high

قابل نوشتن: نقطه ولتاژ بالای انتقال برحسب ولت (V)

input.transfer.low

قابل نوشتن: نقطه ولتاژ پایین انتقال برحسب ولت (V)

battery.charge.low

قابل نوشتن: درصد شارژ باقیمانده باتری برای هشدار باتری ضعیف

output.voltage.nominal

قابل نوشتن: ولتاژ اسمی خروجی برحسب ولت (V)

ups.start.battery

قابل نوشتن: اجازه راه‌اندازی سرد از طریق باتری

بسته به نوع دستگاه یوپی‌اس شما، برخی از دستورهای زیر ممکن است در دسترس باشند.

•test.battery.start.quick, test.battery.stop
•beeper.enable, beeper.disable, beeper.toggle
•shutdown.return, shutdown.reboot, shutdown.stayoff

روی بسیاری از دستگاه‌ها، این دستورها غیرقابل‌اطمینان هستند؛ بنابراین پیش از استفاده از آن‌ها باید بررسی کنید که آیا مطابق انتظار کار می‌کنند یا خیر (بخش مشکلات خاموش شدن را ببینید).

•shutdown.stop

پشتیبانی از سوی سازنده برای این درایور وجود ندارد؛ بنابراین اگر به قابلیت‌هایی نیاز دارید که در حال حاضر موجود نیستند، مستندات کاملی در مورد آنچه درایور باید برای کارکرد آن به یوپی‌اس بفرستد ارائه دهید. اگر اطلاعات بیشتری درباره پروتکل باینری در دسترس بود، احتمالاً امکان پیکربندی ondelay و offdelay فراهم می‌شد. تاکنون، هیچ‌کس زمانی را برای بررسی اینکه چه چیزی باید به یوپی‌اس ارسال شود تا این قابلیت کار کند اختصاص نداده است، و شرکت CyberPower نیز تمایلی به اشتراک‌گذاری این اطلاعات با ما ندارد.

اگر به نظر می‌رسد دستور shutdown.return روی یوپی‌اس شما کار نمی‌کند، این احتمال وجود دارد که یوپی‌اس شما از یک مدل قدیمی‌تر باشد. چند تنظیم مختلف را برای offdelay امتحان کنید. اگر هیچ مقداری در محدوده ۶..۶۰۰ کار نکرد، احتمالاً یوپی‌اس شما از این قابلیت پشتیبانی نمی‌کند. برای به دست آوردن رفتار مورد انتظار، نیاز به دستورهای shutdown.stayoff (هنگام استفاده از باتری) و shutdown.reboot (هنگام اتصال به برق شهر) است. درایور در صورت ناموفق بودن shutdown.return به‌طور خودکار به این دستورها بازمی‌گردد، و هنگامی که با گزینه -k (یا از طریق upsdrvctl shutdown) فراخوانی شود، تلاش می‌کند تشخیص دهد که کدام دستور باید استفاده شود.

با این حال، این روش کاملاً بدون نقص و مطمئن نیست و باید آمادگی داشته باشید که برق یا قطع نشود، یا در زمان وصل مجدد برق شهر جریان وصل نگردد. تمامی مدل‌های پشتیبانی‌شده توسط پروتکل باینری و بسیاری از مدل‌های پشتیبانی‌شده از طریق پروتکل متنی تحت تأثیر این مشکل قرار دارند.

سری CyberPower OP خوانش مستقیم مقادیر ولتاژ، شارژ، فرکانس و دما را ارائه نمی‌دهند. در عوض، آن‌ها یک مقدار باینری برمی‌گردانند که نیاز به تبدیل به مقدار واقعی دارد.

تبدیل دقیق مورد نیاز در زمان نگارش این متن نامشخص است، از این رو تخمینی بر اساس خوانش‌های به‌دست‌آمده از دستگاه‌های واقعی انجام شده است. این تخمین ممکن است (و احتمالاً خواهد بود) دارای خطا باشد، که احتمالاً خطای زیادی است. مگر اینکه بتوانید نگاشت دقیق بین مقادیر دریافتی از یوپی‌اس و خوانش‌های واقعی را به ما بگویید، به خود زحمت شکایت ندهید. ما بر اساس اطلاعات محدود موجود نهایت تلاش خود را کرده‌ایم. به یاد داشته باشید که یوپی‌اس یک ابزار اندازه‌گیری نیست.

Arjen de Korte <arjen@de-korte.org>, Doug Reynolds <mav@wastegate.net>

nutupsdrv(8)

usbhid-ups(8), snmp-ups(8)

صفحه اصلی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5/

06/21/2026 Network UPS Tools 2.8.5