'\" t
.\"     Title: powervar_cx_usb
.\"    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 "POWERVAR_CX_USB" "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)"
powervar_cx_usb \- درایور برای تجهیزات یوپی‌اس سری GTS و UPM از Powervar با اتصال USB
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpowervar_cx_usb\fR \-h
.sp
\fBpowervar_cx_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نکته (Note)\fR
.ps -1
.br
.sp
این صفحه راهنما فقط ویژگی‌های خاص سخت‌افزاری درایور Powervar را مستند می‌کند\&. برای اطلاعات بیشتر درباره درایور اصلی، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.sp .5v
.RE
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
این درایور از دو خانواده یوپی‌اس Powervar با اتصال USB پشتیبانی می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
UPM (چه USB یا سریال)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
GTS (فقط USB)
.RE
.sp
برای دستگاه‌های سری UPM با اتصال سریال، همچنین به \fBpowervar_cx_ser\fR(8) مراجعه کنید\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از تنظیمات اختیاری زیر در فایل \fBups.conf\fR(5) پشتیبانی می‌کند:
.PP
\fBport =\fR \fIstring\fR
.RS 4
گزینه الزامی برای همه درایورهای NUT\&. مقداری
\fIvalue\fR
باید تنظیم شود، که معمولاً برای درایورهای مدیریت‌کننده اتصالات USB برابر با
\fBauto\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نکته (Note)\fR
.ps -1
.br
این مقدار می‌تواند یک مسیر در سیستم‌فایل دستگاه مانند
/dev/usb/hiddev0
باشد، اما استفاده کنونی از API کتابخانه libusb مانع از شناسایی و تطبیق بر اساس چنین شناسه‌هایی می‌شود\&. همچنین این شناسه‌ها ممکن است ذاتاً غیرقابل‌اطمینان باشند (وابسته به اتصال مجدد فیزیکی و ترتیب شمارش)\&. در حال حاضر مقدار واقعی
\fIvalue\fR
نادیده گرفته می‌شود، اما از نظر ساختاری هنوز باید مقداری برای پیکربندی
\fIport\fR
وجود داشته باشد\&.
.sp .5v
.RE
.RE
.sp
امکان کنترل هم‌زمان چندین واحد یوپی‌اس با اجرای چند نمونه از این درایور وجود دارد، به شرطی که بتوان آن‌ها را با تنظیم ترکیبی از گزینه‌های \fBvendor\fR، \fBproduct\fR، \fBvendorid\fR، \fBproductid\fR، \fBserial\fR، \fBbus\fR یا \fBdevice\fR که در ادامه شرح داده شده‌اند به طور یکتا متمایز کرد\&. برای دستگاه‌ها یا سیستم‌عامل‌هایی که اطلاعات کافی ارائه نمی‌دهند، گزینه \fBallow_duplicates\fR می‌تواند کاربرد داشته باشد (محدود و پرریسک!)\&.
.PP
\fBvendorid =\fR \fIregex\fR, \fBproductid =\fR \fIregex\fR, \fBvendor =\fR \fIregex\fR, \fBproduct =\fR \fIregex\fR, \fBserial =\fR \fIregex\fR
.RS 4
انتخاب یک یوپی‌اس مشخص، در صورتی که بیش از یک دستگاه از طریق USB متصل باشد\&. هر گزینه یک عبارت منظم گسترده (برای اطلاعات بیشتر درباره عبارت‌های منظم به
\fBregex\fR(7)
مراجعه کنید) تعیین می‌کند که باید با کل مقادیر رشته‌ای مربوط به
vendor/product/serial
دستگاه (بدون فاصله‌های خالی ابتدا و انتها) یا کل کد هگزادسیمال ۴ رقمی برای
vendorid
و
productid
مطابقت داشته باشد\&.
.sp
برای یافتن رشته‌های مورد نیاز جهت تطبیق، اجرای
\fBlsusb\fR(8)
یا اجرای این درایور NUT را با آرگومان خط فرمان
\-DD
امتحان کنید\&.
.sp
مثال‌ها:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x vendor="Foo\&.Corporation\&.*"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x vendorid="051d*"
(APC)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x product="\&.*(Smart|Back)\-?UPS\&.*"
.RE
.RE
.PP
\fBbus =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
انتخاب یک یوپی‌اس روی یک گذرگاه (bus) خاص یا گروهی از گذرگاه‌های USB\&. این آرگومان یک عبارت منظم است که باید با نام گذرگاهی که یوپی‌اس به آن متصل است (مانند
bus="002"
یا
bus="00[2\-3]")
همان‌طور که در لینوکس در
/sys/bus/usb/devices
یا
\fBlsusb\fR(8)
دیده می‌شود، با احتساب صفرهای ابتدایی مطابقت داشته باشد\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته (Note)\fR
.ps -1
.br
سیستم‌عامل تضمین نمی‌کند که شماره‌های گذرگاه در طول راه‌اندازی‌های مجدد، بارگذاری‌های مجدد درایور هسته، یا اتصال‌های مجدد دستگاه (مانند تغییر وضعیت دستگاه‌های متصل به هاب‌های USB) پایدار بمانند\&.
.sp .5v
.RE
.RE
.PP
\fBdevice =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
انتخاب یک یوپی‌اس روی یک دستگاه یا گروهی از دستگاه‌های خاص USB\&. این آرگومان یک عبارت منظم است که باید با نام دستگاهی که یوپی‌اس به آن متصل است (مانند
device="001"
یا
device="00[1\-2]")
همان‌طور که در لینوکس در
/sys/bus/usb/devices
یا
\fBlsusb\fR(8)
دیده می‌شود، با احتساب صفرهای ابتدایی مطابقت داشته باشد\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته (Note)\fR
.ps -1
.br
سیستم‌عامل تضمین نمی‌کند که شماره‌های دستگاه در طول راه‌اندازی‌های مجدد یا اتصال‌های مجدد دستگاه پایدار بمانند\&.
.sp .5v
.RE
.RE
.PP
\fBbusport =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
در صورتی که توسط سخت‌افزار، سیستم‌عامل و libusb در استقرار مورد نظر پشتیبانی شود، این گزینه باید اجازه دهد به جای مقادیر شمارشی منطقی
device
شماره درگاه‌های فیزیکی روی یک هاب USB مشخص شوند، که به نوبه خود \(em باید در هنگام راه‌اندازی‌های مجدد یا اتصال‌های مجدد کمتر دستخوش تغییر شود\&. این مقدار ممکن است به عنوان مثال در خروجی ساختار درختی USB ابزار
lsusb \-tv
روی سیستم‌های دارای این ابزار دیده شود\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته (Note)\fR
.ps -1
.br
این گزینه در عمل توسط برخی ساخت‌های NUT پشتیبانی نمی‌شود (در این حالت باید همراه با یک هشدار نادیده گرفته شود)، و همچنین در همه سیستم‌هایی که NUT می‌تواند روی آن‌ها اجرا شود پشتیبانی نمی‌گردد\&.
.sp .5v
.RE
.RE
.PP
\fBallow_duplicates\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
اگر چندین دستگاه یوپی‌اس دارید که ممکن است توسط گزینه‌های بالا به طور یکتا شناسایی نشوند (برای مثال در آنجا فقط
\fIVID:PID\fR
قابل کشف باشد)، این پرچم به هر نمونه از درایور که در آن تنظیم شده اجازه می‌دهد اولین تطابق موجود را در نظر بگیرد، یا به بررسی مورد بعدی بپردازد\&.
.sp
به طور معمول راه‌اندازی درایور در این مرحله با خطای «Resource busy» یا خطای مشابه متوقف می‌شود، با این فرض که دستگاهی که به درستی تطبیق داده شده یکتا است \(em و فرآیند دیگری در حال حاضر آن را مدیریت می‌کند\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBهشدار (Warning)\fR
.ps -1
.br
این ویژگی ذاتاً غیرقطعی است! انتساب نام نمونه درایور به دستگاه واقعی ممکن است بین دفعات اجرا متفاوت باشد!
.sp
اگر فقط می‌خواهید بدانید که
\fBحداقل\fR
یکی از یوپی‌اس‌های بدون‌نام شما آنلاین است، این گزینه می‌تواند مفید باشد\&.
.sp
اگر حتماً باید بدانید
\fBکدام\fR
دستگاه آنلاین است، این گزینه کمکی نخواهد کرد!
.sp .5v
.RE
.RE
.PP
\fBusb_set_altinterface =\fR \fIbAlternateSetting\fR
.RS 4
اجبار به فراخوانی زائد
usb_set_altinterface()
به ویژه در صورت نیاز برای دستگاه‌هایی با چند نقش USB که در آن‌ها یوپی‌اس با شماره رابط
0
(پیش‌فرض) ارائه نشده است\&.
.RE
.PP
\fBusb_config_index\fR, \fBusb_hid_rep_index\fR, \fBusb_hid_desc_index\fR, \fBusb_hid_ep_in\fR, \fBusb_hid_ep_out\fR
.RS 4
اجبار به استفاده از شماره‌های خاص برای رابط، نقطه پایانی (endpoint)، نمایه توصیف‌گر و غیره، به جای مقدار پیش‌فرض
\fI0\fR
(به ندرت مقادیر دیگر در درایورهای خاص برای برخی دستگاه‌ها که به استفاده از اعداد غیرصفر معروف هستند)\&. به عنوان یک عدد هگزادسیمال مشخص می‌شود\&.
.sp
به عنوان یک قاعده کلی برای کشف
usb_hid_desc_index
می‌توانید مقادیر بزرگ‌تر
wDescriptorLength
(تقریباً بیش از ۶۰۰ بایت) را در گزارش‌های
lsusb
یا ابزارهای مشابه مشاهده کنید\&.
.RE
.PP
\fBLIBUSB_DEBUG =\fR \fIINTEGER\fR
.RS 4
عیب‌یابی زمان اجرای درایورهای NUT با قابلیت USB نه تنها می‌تواند شامل افزایش سطح گزارش‌گیری معمول خطایابی NUT باشد (به عنوان مثال با استفاده از تنظیم
DEBUG_MIN
در
\fBups.conf\fR(5)
یا دستورات پروتکل برای تغییر مقدار
driver\&.debug)،
بلکه ممکن است از خطایابی ویژه LibUSB نیز بهره‌مند شود\&.
.sp
برای مورد دوم، می‌توانید گزینه درایور
LIBUSB_DEBUG
را تنظیم کنید؛ روش جایگزین کلاسیک این است که پیش از اجرای برنامه درایور NUT، متغیر محیطی
LIBUSB_DEBUG
را (می‌تواند در اسکریپت راه‌اندازی اولیه درایور یا متد سرویس، احتمالاً از طریق
\fBnut.conf\fR(5)
تنظیم و صادر شود) به یک مقدار عددی مانند
4
(«همه پیام‌ها ارسال می‌شوند») تنظیم و export کنید\&.
.sp
برای جزئیات بیشتر، از جمله مقادیر پشتیبانی‌شده کنونی برای نسخه کتابخانه شما، به عنوان مثال ببینید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://libusb\&.sourceforge\&.io/api\-1\&.0
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://libusb\&.sourceforge\&.io/api\-1\&.0/group__libusb__lib\&.html
.RE
.RE
.PP
\fBstartdelay\fR=\fInum\fR
.RS 4
تغییر مدت‌زمان تاخیر راه‌اندازی از مقدار پیش‌فرض ۱ ثانیه\&.
.RE
.PP
\fBoffdelay\fR=\fInum\fR
.RS 4
تغییر مدت‌زمان تاخیر خاموش‌سازی از مقدار پیش‌فرض ۰ ثانیه\&.
.RE
.PP
\fBdisptesttime\fR=\fInum\fR
.RS 4
تغییر مدت‌زمان آزمایش نمایشگر از مقدار پیش‌فرض ۱۰ ثانیه (فقط UPM)\&.
.RE
.SH "دستورات فوری (INSTANT COMMANDS)"
.sp
این درایور از دستورات فوری زیر پشتیبانی می‌کند (به \fBupscmd\fR(8) مراجعه کنید):
.SS "تمام واحدهای یوپی‌اس GTS و UPM"
.PP
\fBbeeper\&.disable\fR
.RS 4
غیرفعال کردن بوق هشدار یوپی‌اس\&.
.RE
.PP
\fBbeeper\&.enable\fR
.RS 4
فعال کردن بوق هشدار یوپی‌اس\&.
.RE
.PP
\fBbeeper\&.mute\fR
.RS 4
قطع موقت صدای بوق هشدار یوپی‌اس\&.
.RE
.PP
\fBshutdown\&.return\fR
.RS 4
قطع تغذیه بار مصرفی احتمالاً پس از یک تاخیر و وصل مجدد آن با بازگشت برق\&.
.RE
.PP
\fBshutdown\&.stop\fR
.RS 4
متوقف کردن فرآیند خاموش‌سازی در حال انجام\&.
.RE
.PP
\fBshutdown\&.reboot\fR
.RS 4
قطع کوتاه‌مدت تغذیه بار مصرفی هم‌زمان با راه‌اندازی مجدد یوپی‌اس\&.
.RE
.PP
\fBshutdown\&.stayoff\fR
.RS 4
قطع تغذیه بار مصرفی و خاموش ماندن آن\&.
.RE
.PP
\fBtest\&.battery\&.start\&.deep\fR
.RS 4
شروع آزمایش «عمیق» باتری\&. این آزمایش یوپی‌اس را تا رسیدن به نقطه باتری ضعیف به کار می‌گیرد و سپس به برق شهری بازمی‌گردد\&.
.RE
.PP
\fBtest\&.battery\&.start\&.quick\fR
.RS 4
شروع آزمایش «سریع» باتری\&. زمان پیش‌فرض ۲ دقیقه است\&. این زمان را می‌توان در فایل
\fBups\&.conf\fR
تنظیم کرد\&. به
\fBtestime\fR
در بالا مراجعه کنید\&.
.RE
.PP
\fBtest\&.battery\&.stop\fR
.RS 4
متوقف کردن آزمایش باتری در حال انجام\&.
.RE
.PP
\fBtest\&.failure\&.start\fR
.RS 4
شروع شبیه‌سازی قطعی برق ورودی\&.
.RE
.PP
\fBtest\&.failure\&.stop\fR
.RS 4
متوقف کردن شبیه‌سازی قطعی برق ورودی\&.
.RE
.SS "تمام واحدهای یوپی‌اس UPM"
.PP
\fBtest\&.panel\&.start\fR
.RS 4
شروع آزمایش پنل نمایشگر یوپی‌اس\&.
.RE
.PP
\fBreset\&.input\&.minmax\fR
.RS 4
بازنشانی وضعیت حداقل و حداکثر ولتاژ ورودی\&.
.RE
.SH "متغیرهای قابل نوشتن (WRITABLE VARIABLES)"
.sp
برای مشاهده متغیرهای قابل نوشتن برای یوپی‌اس، به \fBupsrw\fR(8) مراجعه کنید\&.
.SH "نویسندگان (AUTHORS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Bill Elliot <bill@wreassoc\&.com>
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
برای دستگاه‌های سری UPM با اتصال سریال، همچنین به \fBpowervar_cx_ser\fR(8) مراجعه کنید\&.
.SS "درایور اصلی (The core driver):"
.sp
\fBnutupsdrv\fR(8)
.SS "منابع اینترنتی (Internet resources):"
.sp
صفحه اصلی ابزارهای یوپی‌اس تحت شبکه (NUT): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5