نام (NAME)

genericups - درایور عمومی دستگاه‌های یوپی‌اس تماسی در NUT

خلاصه دستور (SYNOPSIS)

genericups -h

genericups -a UPS_NAME [OPTIONS]

سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)

این درایور از سخت‌افزارهای تولیدکنندگان مختلفی پشتیبانی می‌کند، زیرا تنها از ساده‌ترین روش‌های سیگنال‌دهی استفاده می‌کند. اتصال تماسی (Contact closure) به نوعی رابط اشاره دارد که در آن سیگنال‌های پایه‌ای بالا/پایین (high/low) برای نشان دادن وضعیت ارائه می‌شوند. این نوع یوپی‌اس تنها می‌تواند وضعیت برق شهر و باتری را گزارش کند.

این بدان معناست که در ups.status فقط موارد اساسی را دریافت خواهید کرد: OL، OB و LB (برخی از یوپی‌اس‌ها ممکن است از RB و BYPASS نیز پشتیبانی کنند). هر چیز دیگری نیازمند یک یوپی‌اس هوشمندتر است.

کابل‌کشی (CABLING)

کابل‌کشی برای هر نوع یوپی‌اس متفاوت است. برای اطلاعات درباره آنچه که با یک نوع یوپی‌اس مشخص کار می‌کند، به جدول زیر مراجعه کنید.

آرگومان‌های اضافی (EXTRA ARGUMENTS)

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

upstype=type

mfr=string

model=string

serial=string

sdtime=value

پیکربندی‌های سفارشی (CUSTOM CONFIGURATIONS)

شما می‌توانید با تعریف مقادیر CP، OL، LB و SD پس از تنظیم upstype در ups.conf(5)، آن‌ها را بازنویسی کنید.

برای مثال، برای تنظیم برق کابل روی DTR و مقدار باتری ضعیف روی DCD، به این شکل خواهد بود:

CP = DTR
LB = DCD

مقادیر شناخته‌شده برای خطوط ورودی عبارتند از CTS، DCD و RNG. مقادیر شناخته‌شده برای خطوط خروجی عبارتند از DTR، RTS و ST. برای اطلاعات بیشتر در مورد معنای این سیگنال‌ها، بخش زیر را ببینید.

این مقادیر را می‌توان برای سیگنال‌های با منطق فعال منفی (Active Low) نقیض کرد. به عنوان مثال، LB=-DCD وضعیت باتری ضعیف را زمانی تشخیص می‌دهد که DCD در سطح بالا (High) نباشد.

اطلاعات انواع (TYPE INFORMATION)

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

OL

LB

RB

BYPASS

SD

CP

CTS

RTS

DCD

RNG

DTR

DSR

ST

NULL

none

علامت - در جلوی نام یک سیگنال (مانند -RNG) به این معنی است که شرایط مشخص‌شده با یک سیگنال فعال در سطح پایین (Active Low) اعلام می‌شود. برای مثال، [LB=-RNG] یعنی زمانی که خط نشانگر زنگ (Ring indicate) به سطح پایین می‌رود باتری ضعیف است، و زمانی که آن خط در سطح بالا نگه داشته می‌شود باتری سالم (OK) است.

انواع یوپی‌اس (UPS TYPES)

0 = UPSonic LAN Saver 600

[CP=DTR+RTS] [OL=-CTS] [LB=DCD] [SD=DTR]

1 = APC Back-UPS/Back-UPS Pro/Smart-UPS با کابل 940-0095A/C

[CP=DTR] [OL=-RNG] [LB=DCD] [SD=RTS]

2 = APC Back-UPS/Back-UPS Pro/Smart-UPS با کابل 940-0020B (نکته: گزارش شده که نوع ۲ با کابل 940-0020C نیز کار می‌کند).

[CP=RTS] [OL=-CTS] [LB=DCD] [SD=DTR+RTS]

3 = PowerTech Comp1000 با برق کابل DTR

[CP=DTR] [OL=CTS] [LB=DCD] [SD=DTR+RTS]

4 = Generic RUPS Model

[CP=RTS] [OL=CTS] [LB=-DCD] [SD=-RTS]

5 = Tripp Lite UPS با رابط Lan2.2 (کابل مشکی 73-0844)

[CP=DTR] [OL=CTS] [LB=-DCD] [SD=DTR+RTS]

6 = Best Patriot با کابل INT51

[CP=DTR] [OL=CTS] [LB=-DCD] [SD=RTS]

7 = CyberPower Power99 همچنین Upsonic Power Guardian PG-500، Belkin Belkin Home Office، F6H350-SER، F6H500-SER، F6H650-SER، کارت مدیریت Eaton Contact — پیکربندی ۳ با کابل 66033 (خاموشی کار نمی‌کند)

[CP=RTS] [OL=CTS] [LB=-DCD] [SD=DTR]

8 = Nitram Elite 500

[CP=DTR] [OL=CTS] [LB=-DCD] [SD=???]

9 = APC Back-UPS/Back-UPS Pro/Smart-UPS با کابل 940-0023A

[CP=none] [OL=-DCD] [LB=CTS] [SD=RTS]

10 = Victron Lite با کابل crack

[CP=RTS] [OL=CTS] [LB=-DCD] [SD=DTR]

11 = Powerware 3115

[CP=DTR] [OL=-CTS] [LB=-DCD] [SD=ST]

12 = APC Back-UPS Office با کابل 940-0119A

[CP=RTS] [OL=-CTS] [LB=DCD] [SD=DTR]

13 = RPT Repoteck RPT-800A/RPT-162A

[CP=DTR+RTS] [OL=DCD] [LB=-CTS] [SD=ST]

14 = سری Online P

[CP=DTR] [OL=DCD] [LB=-CTS] [SD=RTS]

15 = Powerware 5119, 5125

[CP=DTR] [OL=CTS] [LB=-DCD] [SD=ST]

16 = Nitram Elite 2002

[CP=DTR+RTS] [OL=CTS] [LB=-DCD] [SD=???]

17 = PowerKinetics 9001

[CP=DTR] [OL=CTS] [LB=-DCD] [SD=???]

18 = TrippLite Omni 450LAN با کابل‌کشی مارتین (Martin’s cabling)

[CP=DTR] [OL=CTS] [LB=DCD] [SD=none]

19 = Fideltronic Ares Series

[CP=DTR] [OL=CTS] [LB=-DCD] [SD=RTS]

20 = Powerware 5119 RM (فایل docs/cables/powerware.txt را در سورس‌های NUT بررسی کنید)

[CP=DTR] [OL=-CTS] [LB=DCD] [SD=ST]

21 = Generic RUPS 2000 (کابل Megatec M2501)

[CP=RTS] [OL=CTS] [LB=-DCD] [SD=RTS+DTR]

22 = تمامی مدل‌های Gamatronic دارای رابط هشدار (همچنین سری CyberPower SL)

[CP=RTS] [OL=CTS] [LB=-DCD] [SD=DTR]

23 = باتری پشتیبان عمومی FTTx (فیبر به x) با رابط تله‌متری ۴ سیمه

[CP=RTS] [OL=CTS] [LB=-DCD] [RB=-RNG] [BYPASS=-DSR] [SD=none]

مدل‌های مشابه (SIMILAR MODELS)

شرکت‌های مختلف تولیدکننده یوپی‌اس، مدل‌هایی با رابط‌های مشابه تولید می‌کنند. به نظر می‌رسد کابل RUPS به‌ویژه در انواع یوپی‌اس‌های «چندراهی برقی» (power strip) که در فروشگاه‌های لوازم اداری یافت می‌شوند، بسیار محبوب است. اگر یوپی‌اس شما با یکی از ورودی‌های جدول بالا کار می‌کند، اما اطلاعات مدل یا سازنده مطابقت ندارد، نگران نباشید. می‌توانید این مورد را به‌راحتی با استفاده از متغیرهای mfr و model که در بالا مستند شده‌اند در ups.conf(5) خود اصلاح کنید.

آزمایش سازگاری (TESTING COMPATIBILITY)

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

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

اکنون می‌توانید بر اساس مستنداتی که سازنده شما ارائه داده است (در صورت وجود) یک حدس هوشمندانه بزنید، یا اینکه به ترتیب فهرست را بررسی کنید.

genericups -x upstype=n /dev/port

genericups -DDDDD -x upstype=n /dev/port

genericups -x upstype=n -k /dev/port

[myups]
        driver = genericups
        port = /dev/ttyS0
        upstype = 1

پشتیبانی جدید (NEW SUPPORT)

اگر توالی آزمایش بالا ناموفق بود، احتمالاً باید یک ورودی جدید برای پشتیبانی از سخت‌افزار خود ایجاد کنید. تمام انواع یوپی‌اس از جدول موجود در فایل genericups.h در درخت سورس‌کد تعیین می‌شوند.

در یک پورت سریال استاندارد ۹ پین، ۶ خط وجود دارد که به عنوان سطوح استاندارد سیگنال «بالا/پایین» (high/low) استفاده می‌شوند. ۴ مورد از آن‌ها ورودی هستند (به رایانه، از یوپی‌اس)، و ۲ تای دیگر خروجی هستند (به یوپی‌اس، از رایانه). ۳ تای دیگر خطوط دریافت/ارسال و اتصال زمین (گراند) هستند.

توجه داشته باشید که بسیاری از سازندگان، پین‌ها را در داخل کابل بازنگاشت (remap) می‌کنند. اگر شکی دارید، بررسی سریع با یک مولتی‌متر باید مشخص کند که کابل مستقیم (straight-through) است یا خیر. نکته دیگری که باید در نظر داشت این است که برخی کابل‌ها قطعات الکترونیکی درون خود دارند تا کارهای خاصی انجام دهند. برخی از آن‌ها دارای مقاومت‌ها و ترانزیستورهایی هستند تا رفتار را بسته به آنچه توسط رایانه تأمین می‌شود، تغییر دهند.

نکات مربوط به مدل‌های خاص (SPECIFIC MODEL NOTES)

این نکات توسط کاربران این درایور ارسال شده است.

سری Centralion CL ممکن است در صورتی که درایور در هنگام کار یوپی‌اس روی باتری راه‌اندازی شود، برق بار را قطع کند زیرا تنظیمات پیش‌فرض خطوط شامل توالی خاموشی است. - نیل مولر (Neil Muller)

مدل Tripp-Lite Internet Office 700 باید به‌جای کابل خاکستری 73-0743 با کابل مشکی 73-0844 استفاده شود. این ورودی باید با هر یک از مدل‌های آن‌ها با رابط Lan 2.2 کار کند — برچسب کنار کانکتور DB9 روی یوپی‌اس را ببینید. - استیون براون (Stephen Brown)

نوع ۵ باید با رابط Tripp-Lite Lan 2.1 و کابل 73-0724 کار کند. این مورد با OmniSmart 675 PNP روی ردهت ۷.۲ آزمایش شده است. - کیو گیزه (Q Giese)

انواع ۷ و ۱۰ هر دو باید با PhoenixTec A1000 کار کنند.

اشکالات (BUGS)

هیچ راهی برای تشخیص مطمئن یک یوپی‌اس اتصال تماسی (contact-closure) وجود ندارد. این بدان معناست که درایور حتی در صورت عدم شناسایی یوپی‌اس نیز بدون مشکل راه‌اندازی می‌شود. همچنین به این معنی است که اگر اتصال بین یوپی‌اس و رایانه قطع شود، ممکن است نتوانید این موضوع را در نرم‌افزار متوجه شوید.

اکثر یوپی‌اس‌های اتصال تماسی در صورت وجود برق شهری، برق بار را قطع نخواهند کرد. این موضوع می‌تواند هنگام استفاده از سیستم‌های ثانویه upsmon(8) شرایط رقابتی (race condition) ایجاد کند. برای اطلاعات بیشتر، صفحه راهنمای upsmon(8) را ببینید.

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

همچنین ببینید (SEE ALSO)