نام (NAME)

bcmxcp_usb - درایور یوپی‌اس مبتنی بر پروتکل BCM/XCP از طریق درگاه USB در NUT

خلاصه دستور (SYNOPSIS)

bcmxcp_usb -h

bcmxcp_usb -a UPS_NAME [OPTIONS]

نکته

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

نکته

این درایور نسخه‌ای دیگر از درایور سریال bcmxcp(8) است و از همان کد هسته استفاده می‌کند.

سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)

این درایور باید تمام دستگاه‌های یوپی‌اس سازگار با BCM/XCP را که از طریق USB متصل شده‌اند، شناسایی کند. این درایور بر روی سخت‌افزار Powerware PW3501 توسعه یافته و آزمایش شده است. همچنین بر روی سخت‌افزار PW5110 نیز آزمایش شده است.

آرگومان‌های اضافی (EXTRA ARGUMENTS)

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

shutdown_delay = delay

تعداد ثانیه‌هایی که یوپی‌اس باید بین دریافت دستور خاموش‌سازی و خاموش شدن واقعی منتظر بماند.

نکته

این درایور در حال حاضر از تنظیمات تطبیق USB که در سایر درایورها رایج است، مانند vendor، vendorid، product، productid، serial، device یا bus پشتیبانی نمی‌کند.

مقادیر پیش‌فرض برای آرگومان‌های اضافی (DEFAULT VALUES FOR THE EXTRA ARGUMENTS)

shutdown_delay =120

دستورات فوری (INSTANT COMMANDS)

این درایور از دستورات فوری (Instant Commands) زیر پشتیبانی می‌کند:

shutdown.return

خاموش کردن بار مصرفی و بازگشت به مدار هنگام اتصال مجدد برق.

shutdown.stayoff

خاموش کردن بار مصرفی و باقی ماندن در حالت خاموش.

test.battery.start

شروع آزمایش باتری.

فهرست کارهای آینده (TODO LIST)

گزارش وضعیت هشدار یوپی‌اس

پروتکل BCM/XCP از گزارش‌گیری طیف گسترده‌ای از شرایط هشدار یوپی‌اس پشتیبانی می‌کند.

گزارش اطلاعات آماری یوپی‌اس

پروتکل BCM/XCP از گزارش‌گیری داده‌های آماری یوپی‌اس پشتیبانی می‌کند.

درایور آزمایشی (EXPERIMENTAL DRIVER)

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

نصب (INSTALLATION)

این درایور ممکن است به‌طور پیش‌فرض ساخته نشود. می‌توانید با استفاده از ./configure --with-usb=yes ساخت آن را درخواست کنید (توجه داشته باشید که این گزینه سایر درایورهای USB را نیز نصب خواهد کرد)، یا از ./configure --with-drivers=bcmxcp_usb استفاده کنید. در هر دو حالت، به libusb-dev (بسته کتابخانه‌ها و فایل‌های هدر) یا معادل آن در سایر پلتفرم‌ها نیاز خواهید داشت.

همچنین برای برطرف کردن مشکل تنظیمات دسترسی، باید فایل‌های hotplug (یعنی libhidups و libhid.usermap) را به‌صورت دستی، معمولاً در مسیر etc/hotplug/usb/ نصب کنید. در نهایت توجه داشته باشید که فایل libhidups باید پرچم اجرایی داشته باشد (یعنی با استفاده از chmod +x ...).

پیاده‌سازی (IMPLEMENTATION)

درایور bcmxcp_usb در حال حاضر تنها از ۱ یوپی‌اس پشتیبانی می‌کند. می‌توانید مقدار "auto" را برای پورت در ups.conf قرار دهید، یعنی:

[pw3105]
        driver = bcmxcp_usb
        port = auto

مشکلات و باگ‌های شناخته‌شده (KNOWN ISSUES AND BUGS)

دریافت خطای EPERM: Operation not permitted در زمان شروع به کار درایور (Got EPERM: Operation not permitted upon driver startup)

شما فراموش کرده‌اید فایل‌های hotplug را همان‌طور که در بخش نصب در بالا توضیح داده شد نصب کنید. فراموش نکنید که hotplug را مجدداً راه‌اندازی نمایید تا این تغییرات اعمال شوند.

نویسندگان (AUTHORS)

•Tore Ørpetveit <tore@orpetveit.net>

•Wolfgang Ocker <weo@weo1.de>

همچنین ببینید (SEE ALSO)

درایور اصلی (The core driver):

nutupsdrv(8)

منابع اینترنتی (Internet resources):

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