'\" t
.\"     Title: bcmxcp_usb
.\"    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 "BCMXCP_USB" "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)"
bcmxcp_usb \- درایور یوپی‌اس مبتنی بر پروتکل BCM/XCP از طریق درگاه USB در NUT
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBbcmxcp_usb\fR \-h
.sp
\fBbcmxcp_usb\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
این صفحه راهنما فقط ویژگی‌های مختص به سخت‌افزار درایور bcmxcp_usb را مستند می‌کند\&. برای کسب اطلاعات درباره درایور هسته، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.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
این درایور نسخه‌ای دیگر از درایور سریال \fBbcmxcp\fR(8) است و از همان کد هسته استفاده می‌کند\&.
.sp .5v
.RE
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
این درایور باید تمام دستگاه‌های یوپی‌اس سازگار با BCM/XCP را که از طریق USB متصل شده‌اند، شناسایی کند\&. این درایور بر روی سخت‌افزار Powerware PW3501 توسعه یافته و آزمایش شده است\&. همچنین بر روی سخت‌افزار PW5110 نیز آزمایش شده است\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از تنظیمات اختیاری زیر در \fBups.conf\fR(5) پشتیبانی می‌کند\&.
.PP
\fBshutdown_delay =\fR \fIdelay\fR
.RS 4
تعداد ثانیه‌هایی که یوپی‌اس باید بین دریافت دستور خاموش‌سازی و خاموش شدن واقعی منتظر بماند\&.
.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
این درایور در حال حاضر از تنظیمات تطبیق USB که در سایر درایورها رایج است، مانند \fBvendor\fR، \fBvendorid\fR، \fBproduct\fR، \fBproductid\fR، \fBserial\fR، \fBdevice\fR یا \fBbus\fR پشتیبانی نمی‌کند\&.
.sp .5v
.RE
.SH "مقادیر پیش‌فرض برای آرگومان‌های اضافی (DEFAULT VALUES FOR THE EXTRA ARGUMENTS)"
.sp
\fBshutdown_delay =\fR\fI120\fR
.SH "دستورات فوری (INSTANT COMMANDS)"
.sp
این درایور از دستورات فوری (Instant Commands) زیر پشتیبانی می‌کند:
.PP
\fBshutdown\&.return\fR
.RS 4
خاموش کردن بار مصرفی و بازگشت به مدار هنگام اتصال مجدد برق\&.
.RE
.PP
\fBshutdown\&.stayoff\fR
.RS 4
خاموش کردن بار مصرفی و باقی ماندن در حالت خاموش\&.
.RE
.PP
\fBtest\&.battery\&.start\fR
.RS 4
شروع آزمایش باتری\&.
.RE
.SH "فهرست کارهای آینده (TODO LIST)"
.PP
\fBگزارش وضعیت هشدار یوپی‌اس\fR
.RS 4
پروتکل BCM/XCP از گزارش‌گیری طیف گسترده‌ای از شرایط هشدار یوپی‌اس پشتیبانی می‌کند\&.
.RE
.PP
\fBگزارش اطلاعات آماری یوپی‌اس\fR
.RS 4
پروتکل BCM/XCP از گزارش‌گیری داده‌های آماری یوپی‌اس پشتیبانی می‌کند\&.
.RE
.SH "درایور آزمایشی (EXPERIMENTAL DRIVER)"
.sp
این درایور برچسب آزمایشی (experimental) خورده است، هرچند گزارش شده که پایدار است\&. بنابراین برای سیستم‌های عملیاتی مناسب نبوده و ممکن است به‌طور پیش‌فرض ساخته نشود\&. این مسئله عمدتاً به دلیل جدید بودن این درایور است\&.
.SH "نصب (INSTALLATION)"
.sp
این درایور ممکن است به‌طور پیش‌فرض ساخته نشود\&. می‌توانید با استفاده از \&./configure \-\-with\-usb=yes ساخت آن را درخواست کنید (توجه داشته باشید که این گزینه سایر درایورهای USB را نیز نصب خواهد کرد)، یا از \&./configure \-\-with\-drivers=bcmxcp_usb استفاده کنید\&. در هر دو حالت، به libusb\-dev (بسته کتابخانه‌ها و فایل‌های هدر) یا معادل آن در سایر پلتفرم‌ها نیاز خواهید داشت\&.
.sp
همچنین برای برطرف کردن مشکل تنظیمات دسترسی، باید فایل‌های hotplug (یعنی libhidups و libhid\&.usermap) را به‌صورت دستی، معمولاً در مسیر etc/hotplug/usb/ نصب کنید\&. در نهایت توجه داشته باشید که فایل libhidups باید پرچم اجرایی داشته باشد (یعنی با استفاده از chmod +x \&...)\&.
.SH "پیاده‌سازی (IMPLEMENTATION)"
.sp
درایور bcmxcp_usb در حال حاضر تنها از ۱ یوپی‌اس پشتیبانی می‌کند\&. می‌توانید مقدار "auto" را برای پورت در ups\&.conf قرار دهید، یعنی:
.sp
.if n \{\
.RS 4
.\}
.nf
[pw3105]
        driver = bcmxcp_usb
        port = auto
.fi
.if n \{\
.RE
.\}
.SH "مشکلات و باگ‌های شناخته‌شده (KNOWN ISSUES AND BUGS)"
.SS "دریافت خطای EPERM: Operation not permitted در زمان شروع به کار درایور (Got EPERM: Operation not permitted upon driver startup)"
.sp
شما فراموش کرده‌اید فایل‌های hotplug را همان‌طور که در بخش نصب در بالا توضیح داده شد نصب کنید\&. فراموش نکنید که hotplug را مجدداً راه‌اندازی نمایید تا این تغییرات اعمال شوند\&.
.SH "نویسندگان (AUTHORS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Tore Ørpetveit <tore@orpetveit\&.net>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Wolfgang Ocker <weo@weo1\&.de>
.RE
.SH "همچنین ببینید (SEE ALSO)"
.SS "درایور اصلی (The core driver):"
.sp
\fBnutupsdrv\fR(8)
.SS "منابع اینترنتی (Internet resources):"
.sp
صفحه اصلی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5