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

powervar_cx_usb - درایور برای تجهیزات یوپی‌اس سری GTS و UPM از Powervar با اتصال USB

powervar_cx_usb -h

powervar_cx_usb -a UPS_NAME [OPTIONS]


نکته (Note)

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

این درایور از دو خانواده یوپی‌اس Powervar با اتصال USB پشتیبانی می‌کند:

•UPM (چه USB یا سریال)
•GTS (فقط USB)

برای دستگاه‌های سری UPM با اتصال سریال، همچنین به powervar_cx_ser(8) مراجعه کنید.

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

port = string

گزینه الزامی برای همه درایورهای NUT. مقداری value باید تنظیم شود، که معمولاً برای درایورهای مدیریت‌کننده اتصالات USB برابر با auto است.

نکته (Note)
این مقدار می‌تواند یک مسیر در سیستم‌فایل دستگاه مانند /dev/usb/hiddev0 باشد، اما استفاده کنونی از API کتابخانه libusb مانع از شناسایی و تطبیق بر اساس چنین شناسه‌هایی می‌شود. همچنین این شناسه‌ها ممکن است ذاتاً غیرقابل‌اطمینان باشند (وابسته به اتصال مجدد فیزیکی و ترتیب شمارش). در حال حاضر مقدار واقعی value نادیده گرفته می‌شود، اما از نظر ساختاری هنوز باید مقداری برای پیکربندی port وجود داشته باشد.

امکان کنترل هم‌زمان چندین واحد یوپی‌اس با اجرای چند نمونه از این درایور وجود دارد، به شرطی که بتوان آن‌ها را با تنظیم ترکیبی از گزینه‌های vendor، product، vendorid، productid، serial، bus یا device که در ادامه شرح داده شده‌اند به طور یکتا متمایز کرد. برای دستگاه‌ها یا سیستم‌عامل‌هایی که اطلاعات کافی ارائه نمی‌دهند، گزینه allow_duplicates می‌تواند کاربرد داشته باشد (محدود و پرریسک!).

vendorid = regex, productid = regex, vendor = regex, product = regex, serial = regex

انتخاب یک یوپی‌اس مشخص، در صورتی که بیش از یک دستگاه از طریق USB متصل باشد. هر گزینه یک عبارت منظم گسترده (برای اطلاعات بیشتر درباره عبارت‌های منظم به regex(7) مراجعه کنید) تعیین می‌کند که باید با کل مقادیر رشته‌ای مربوط به vendor/product/serial دستگاه (بدون فاصله‌های خالی ابتدا و انتها) یا کل کد هگزادسیمال ۴ رقمی برای vendorid و productid مطابقت داشته باشد.

برای یافتن رشته‌های مورد نیاز جهت تطبیق، اجرای lsusb(8) یا اجرای این درایور NUT را با آرگومان خط فرمان -DD امتحان کنید.

مثال‌ها:

•-x vendor="Foo.Corporation.*"
•-x vendorid="051d*" (APC)
•-x product=";.*(Smart|Back)-?UPS.*"

bus = regex

اختیاری، توصیه نمی‌شود.

انتخاب یک یوپی‌اس روی یک گذرگاه (bus) خاص یا گروهی از گذرگاه‌های USB. این آرگومان یک عبارت منظم است که باید با نام گذرگاهی که یوپی‌اس به آن متصل است (مانند bus="002" یا bus="00[2-3]") همان‌طور که در لینوکس در /sys/bus/usb/devices یا lsusb(8) دیده می‌شود، با احتساب صفرهای ابتدایی مطابقت داشته باشد.


نکته (Note)
سیستم‌عامل تضمین نمی‌کند که شماره‌های گذرگاه در طول راه‌اندازی‌های مجدد، بارگذاری‌های مجدد درایور هسته، یا اتصال‌های مجدد دستگاه (مانند تغییر وضعیت دستگاه‌های متصل به هاب‌های USB) پایدار بمانند.

device = regex

اختیاری، توصیه نمی‌شود.

انتخاب یک یوپی‌اس روی یک دستگاه یا گروهی از دستگاه‌های خاص USB. این آرگومان یک عبارت منظم است که باید با نام دستگاهی که یوپی‌اس به آن متصل است (مانند device="001" یا device="00[1-2]") همان‌طور که در لینوکس در /sys/bus/usb/devices یا lsusb(8) دیده می‌شود، با احتساب صفرهای ابتدایی مطابقت داشته باشد.


نکته (Note)
سیستم‌عامل تضمین نمی‌کند که شماره‌های دستگاه در طول راه‌اندازی‌های مجدد یا اتصال‌های مجدد دستگاه پایدار بمانند.

busport = regex

اختیاری، توصیه نمی‌شود.

در صورتی که توسط سخت‌افزار، سیستم‌عامل و libusb در استقرار مورد نظر پشتیبانی شود، این گزینه باید اجازه دهد به جای مقادیر شمارشی منطقی device شماره درگاه‌های فیزیکی روی یک هاب USB مشخص شوند، که به نوبه خود — باید در هنگام راه‌اندازی‌های مجدد یا اتصال‌های مجدد کمتر دستخوش تغییر شود. این مقدار ممکن است به عنوان مثال در خروجی ساختار درختی USB ابزار lsusb -tv روی سیستم‌های دارای این ابزار دیده شود.


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

allow_duplicates

اختیاری، توصیه نمی‌شود.

اگر چندین دستگاه یوپی‌اس دارید که ممکن است توسط گزینه‌های بالا به طور یکتا شناسایی نشوند (برای مثال در آنجا فقط VID:PID قابل کشف باشد)، این پرچم به هر نمونه از درایور که در آن تنظیم شده اجازه می‌دهد اولین تطابق موجود را در نظر بگیرد، یا به بررسی مورد بعدی بپردازد.

به طور معمول راه‌اندازی درایور در این مرحله با خطای «Resource busy» یا خطای مشابه متوقف می‌شود، با این فرض که دستگاهی که به درستی تطبیق داده شده یکتا است — و فرآیند دیگری در حال حاضر آن را مدیریت می‌کند.


هشدار (Warning)
این ویژگی ذاتاً غیرقطعی است! انتساب نام نمونه درایور به دستگاه واقعی ممکن است بین دفعات اجرا متفاوت باشد!

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

اگر حتماً باید بدانید کدام دستگاه آنلاین است، این گزینه کمکی نخواهد کرد!

usb_set_altinterface = bAlternateSetting

اجبار به فراخوانی زائد usb_set_altinterface() به ویژه در صورت نیاز برای دستگاه‌هایی با چند نقش USB که در آن‌ها یوپی‌اس با شماره رابط 0 (پیش‌فرض) ارائه نشده است.

usb_config_index, usb_hid_rep_index, usb_hid_desc_index, usb_hid_ep_in, usb_hid_ep_out

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

به عنوان یک قاعده کلی برای کشف usb_hid_desc_index می‌توانید مقادیر بزرگ‌تر wDescriptorLength (تقریباً بیش از ۶۰۰ بایت) را در گزارش‌های lsusb یا ابزارهای مشابه مشاهده کنید.

LIBUSB_DEBUG = INTEGER

عیب‌یابی زمان اجرای درایورهای NUT با قابلیت USB نه تنها می‌تواند شامل افزایش سطح گزارش‌گیری معمول خطایابی NUT باشد (به عنوان مثال با استفاده از تنظیم DEBUG_MIN در ups.conf(5) یا دستورات پروتکل برای تغییر مقدار driver.debug)، بلکه ممکن است از خطایابی ویژه LibUSB نیز بهره‌مند شود.

برای مورد دوم، می‌توانید گزینه درایور LIBUSB_DEBUG را تنظیم کنید؛ روش جایگزین کلاسیک این است که پیش از اجرای برنامه درایور NUT، متغیر محیطی LIBUSB_DEBUG را (می‌تواند در اسکریپت راه‌اندازی اولیه درایور یا متد سرویس، احتمالاً از طریق nut.conf(5) تنظیم و صادر شود) به یک مقدار عددی مانند 4 («همه پیام‌ها ارسال می‌شوند») تنظیم و export کنید.

برای جزئیات بیشتر، از جمله مقادیر پشتیبانی‌شده کنونی برای نسخه کتابخانه شما، به عنوان مثال ببینید:

•https://libusb.sourceforge.io/api-1.0
•https://libusb.sourceforge.io/api-1.0/group__libusb__lib.html

startdelay=num

تغییر مدت‌زمان تاخیر راه‌اندازی از مقدار پیش‌فرض ۱ ثانیه.

offdelay=num

تغییر مدت‌زمان تاخیر خاموش‌سازی از مقدار پیش‌فرض ۰ ثانیه.

disptesttime=num

تغییر مدت‌زمان آزمایش نمایشگر از مقدار پیش‌فرض ۱۰ ثانیه (فقط UPM).

این درایور از دستورات فوری زیر پشتیبانی می‌کند (به upscmd(8) مراجعه کنید):

beeper.disable

غیرفعال کردن بوق هشدار یوپی‌اس.

beeper.enable

فعال کردن بوق هشدار یوپی‌اس.

beeper.mute

قطع موقت صدای بوق هشدار یوپی‌اس.

shutdown.return

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

shutdown.stop

متوقف کردن فرآیند خاموش‌سازی در حال انجام.

shutdown.reboot

قطع کوتاه‌مدت تغذیه بار مصرفی هم‌زمان با راه‌اندازی مجدد یوپی‌اس.

shutdown.stayoff

قطع تغذیه بار مصرفی و خاموش ماندن آن.

test.battery.start.deep

شروع آزمایش «عمیق» باتری. این آزمایش یوپی‌اس را تا رسیدن به نقطه باتری ضعیف به کار می‌گیرد و سپس به برق شهری بازمی‌گردد.

test.battery.start.quick

شروع آزمایش «سریع» باتری. زمان پیش‌فرض ۲ دقیقه است. این زمان را می‌توان در فایل ups.conf تنظیم کرد. به testime در بالا مراجعه کنید.

test.battery.stop

متوقف کردن آزمایش باتری در حال انجام.

test.failure.start

شروع شبیه‌سازی قطعی برق ورودی.

test.failure.stop

متوقف کردن شبیه‌سازی قطعی برق ورودی.

test.panel.start

شروع آزمایش پنل نمایشگر یوپی‌اس.

reset.input.minmax

بازنشانی وضعیت حداقل و حداکثر ولتاژ ورودی.

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

•Bill Elliot <bill@wreassoc.com>

برای دستگاه‌های سری UPM با اتصال سریال، همچنین به powervar_cx_ser(8) مراجعه کنید.

nutupsdrv(8)

صفحه اصلی ابزارهای یوپی‌اس تحت شبکه (NUT): https://www.networkupstools.org/historic/v2.8.5

06/21/2026 Network UPS Tools 2.8.5