BCMXCP_USB(8)                     NUT Manual                     BCMXCP_USB(8)

نام (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

Network UPS Tools 2.8.5           06/21/2026                     BCMXCP_USB(8)