TRIPPLITE_USB(8) NUT Manual TRIPPLITE_USB(8)

tripplite_usb - درایور برای یوپی‌اس‌های قدیمی Tripp Lite مبتنی بر USB (غیر از PDC HID)

tripplite_usb -h

tripplite_usb -a UPS_NAME [گزینه‌ها]

این درایور باید با یوپی‌اس‌های قدیمی‌تر Tripp Lite که به عنوان دستگاه‌های رده USB HID شناسایی می‌شوند، اما دستگاه‌های واقعی رده دستگاه‌های برق (HID Power-Device Class یا PDC) نیستند، کار کند. تاکنون، دستگاه‌های پشتیبانی‌شده توسط tripplite_usb دارای شناسه محصول (PID) 0001 هستند و واحدهای جدیدتر (مانند دستگاه‌هایی با "LCD" در نام مدل) با شناسه محصول 2001 به جای این، به درایور usbhid-ups(8) نیاز دارند.

لطفاً گزارش موفقیت یا عدم موفقیت را به لیست پستی nut-upsuser ارسال کنید. یکی از اطلاعات کلیدی، شماره پروتکل است که در ups.firmware.aux بازگردانده می‌شود. همچنین حتماً اشکال‌زدایی (-DDD) را فعال کنید تا پیام‌های گزارش با جزئیات بیشتری تولید شوند.

اگر یوپی‌اس Tripp Lite شما از پورت سریال استفاده می‌کند، شاید مایل باشید درایورهای tripplite(8) یا tripplitesu(8) را بررسی کنید.

این درایور با مدل‌های زیر آزمایش شده است:

•INTERNETOFFICE700
•OMNIVS1000
•OMNIVS1500XL (همراه با برخی هشدارها)
•SMART700USB
•SMART1500RM2U
•SMART2200RMXL2U
•SMART3000RM2U

اگر برای اتصال به یوپی‌اس خود از نرم‌افزار PowerAlert شرکت Tripp Lite استفاده کرده‌اید، در صورتی که از یکی از پروتکل‌های زیر استفاده کند، احتمال زیادی وجود دارد که tripplite_usb کار کند:

•پروتکل 0004
•پروتکل 1001
•پروتکل 2001
•پروتکل 3003
•پروتکل 3005

از سوی دیگر، اگر در صفحه وب یوپی‌اس شما در وب‌سایت Tripp-Lite عبارت "HID-compliant USB port also enables direct integration with built-in power management and auto-shutdown features of Windows and MAC OS X" قید شده است، باید به جای این، از درایور usbhid-ups(8) استفاده کنید.

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

port = string

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

نکته
این مقدار می‌تواند یک مسیر در سیستم فایل دستگاه مانند /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) دیده می‌شود (شامل صفرهای ابتدا) تطبیق داشته باشد.


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

device = regex

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

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


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

busport = regex

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

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


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

allow_duplicates

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

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

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


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

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

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

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)، نمایه توصیف‌گر (descriptor index) و غیره، به جای پیش‌فرض 0 (به‌ندرت مقادیر دیگر در برخی درایورها برای دستگاه‌هایی که استفاده آن‌ها از شماره‌های غیرصفر مشخص شده است). به عنوان یک عدد هگزادسیمال تعیین می‌شود.

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

LIBUSB_DEBUG = INTEGER

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

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

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

•https://libusb.sourceforge.io/api-1.0
•https://libusb.sourceforge.io/api-1.0/group__libusb__lib.html
•-x upsid="12345";

انتخاب یک یوپی‌اس خاص با شناسه یکتای UPS ID آن. این آرگومان یک عبارت منظم است که باید با رشته UPS ID مطابقت داشته باشد. این قابلیت امکان شناسایی دقیق دستگاه‌های یوپی‌اس را در صورت اتصال چندین دستگاه از یک برند و مدل یکسان فراهم می‌کند. در ادامه، نحوه خواندن و نوشتن ups id (شناسه واحد) را با استفاده از upsrw(8) مشاهده کنید.


نکاتی درباره نحوه مدیریت تنظیمات مشترک تطبیق USB در درایور tripplite_usb:
•گزینه product یک عبارت منظم برای تطبیق با رشته محصول یوپی‌اس است. این گزینه در صورتی مفید است که دو مدل متفاوت از یوپی‌اس‌های Tripp Lite به یک سیستم مانیتورینگ متصل باشند و بخواهید مطمئن شوید که آن‌ها را با ترتیب صحیح خاموش می‌کنید.

این عبارت منظم در برابر رشته کامل محصول USB که در lsusb(8) دیده می‌شود تطبیق داده می‌شود. مقدار ups.model در خروجی upsc(8) تنها نام پس از TRIPP LITE را فهرست می‌کند، بنابراین برای تطبیق با یک SMART2200RMXL2U، می‌توانید از عبارت منظمی مانند .*SMART2200.* استفاده کنید.

•گزینه productid یک عبارت منظم است که با PID یوپی‌اس به عنوان چهار رقم هگزادسیمال تطبیق می‌یابد. تاکنون، تنها دستگاه‌های شناخته‌شده‌ای که با این درایور کار می‌کنند دارای PID برابر با 0001 هستند.
•گزینه serial ممکن است مفید باشد یا نباشد: به نظر نمی‌رسد این یوپی‌اس‌های خاص Tripp Lite که با این درایور پشتیبانی می‌شوند، از فیلد توصیف‌گر iSerial برای بازگرداندن شماره سریال استفاده کنند. با این حال، در صورتی که دستگاه شما از آن استفاده می‌کند، می‌توانید آن را در اینجا مشخص کنید.

offdelay

این تنظیم میزان تأخیر بین دریافت دستور قطع برق (-k) و قطع واقعی برق رایانه را کنترل می‌کند.

battery_min, battery_max

این مقادیر ممیز شناور متناظر با ولتاژهای "خالی" (۱۰٪) و "پر" (۱۰۰٪) باتری هستند. از آن‌ها برای تقریب میزان شارژ باتری استفاده می‌شود. مقدار محاسبه‌شده battery.charge به بازه ۱۰٪ تا ۱۰۰٪ محدود می‌شود، بنابراین ولتاژ حالت استراحت باتری شارژشده می‌تواند برای battery_max استفاده شود، و ولتاژ بالاتر شارژ شناور (float charge) نباید مشکلی ایجاد کند.

ups.delay.shutdown

این متغیر مشابه تنظیم offdelay است، اما در زمان اجرا توسط upsrw(8) قابل تغییر است.

ups.id

برخی مدل‌های SMARTPRO دارای یک شناسه واحد (ups.id) هستند که قابل تنظیم و بازیابی است. اگر یوپی‌اس شما از این ویژگی پشتیبانی کند، این متغیر در خروجی upsrw(8) فهرست خواهد شد.

outlet.1.switch

برخی دستگاه‌های Tripp Lite دارای یک پریز قابل‌سوییچ هستند (معمولاً پریز شماره ۱) که می‌توان با نوشتن مقدار 1 یا 0 به ترتیب در outlet.1.switch به وسیله upsrw(8) آن را روشن یا خاموش کرد.

اگر دستگاه شما چندین پریز قابل‌سوییچ دارد، شماره پریز را در نام متغیر به جای 1 قرار دهید. حتماً ابتدا این مورد را آزمایش کنید — هیچ راه دیگری وجود ندارد تا اطمینان حاصل شود شماره استفاده‌شده توسط درایور با برچسب روی دستگاه مطابقت دارد.

این درایور بدون هیچ‌گونه مستندات رسمی از سوی Tripp Lite توسعه یافته است، بنابراین رویدادهای خاصی ممکن است درایور را دچار اختلال کند. در صورت مشاهده هرگونه رفتار غیرعادی، لطفاً درایور را با -DDD مجدداً اجرا کنید تا سطح جزئیات گزارش افزایش یابد.

تاکنون، به نظر نمی‌رسد یوپی‌اس‌های Tripp Lite دارای شماره سریال یا شناسه یکتای سراسری دیگری باشند که از طریق USB قابل دسترسی باشد. بنابراین هنگام پایش چندین یوپی‌اس USB شرکت Tripp Lite، باید از گزینه‌های پیکربندی bus، device یا product استفاده کنید تا به طور یکتا مشخص شود کدام نمونه درایور باید کدام یوپی‌اس را کنترل کند.

برای مثال، می‌توانید به راحتی یک OMNIVS1000 و یک SMART1500RM2U را به طور هم‌زمان پایش کنید، زیرا این دو دستگاه رشته‌های شناسه محصول USB متفاوتی دارند. اگر دو دستگاه SMART1500RM2U دارید، باید شماره گذرگاه و دستگاه USB هر یک را (از طریق lsusb(8)) مشخص کنید.

برخی مدل‌های *SMART*2U دارای شماره شناسه واحد (Unit ID) قابل‌پیکربندی هستند، و اکنون می‌توانید از آرگومان پیکربندی upsid استفاده کنید تا به طور یکتا مشخص شود کدام نمونه درایور باید کدام یوپی‌اس را کنترل کند. این امکان شناسایی دقیق دستگاه‌های یوپی‌اس را در صورت اتصال چندین دستگاه فراهم می‌آورد. برای بازیابی یا تنظیم upsid، می‌توانید از ابزار کاربردی upsrw(8) استفاده کنید.

نوشته‌شده توسط Charles Lepple، بر اساس درایور tripplite(8) اثر Rickard E. (Rik) Faith و Nicholas Kain.

لطفاً مستقیماً به نویسندگان ایمیل ارسال نکنید — از لیست پستی nut-upsdev استفاده کنید.

یک دستگاه Tripp Lite OMNIVS1000 سخاوتمندانه توسط Bradley Feldman (http://www.bradleyloritheo.com) به پروژه NUT اهدا شد.

nutupsdrv(8)

tripplite(8), tripplitesu(8), usbhid-ups(8)

regex(7), lsusb(8)

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

06/21/2026 Network UPS Tools 2.8.5