نام (NAME)

apctest — برنامه آزمون و کالیبراسیون سخت‌افزار UPS در apcupsd

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

apctest

توضیحات (DESCRIPTION)

apctest برنامه‌ای است که امکان اجرای برخی از آزمون‌های سطح‌پایین را برای بررسی عملکرد UPS متصل شرکت American Power Conversion Corp (APC) با سیگنال‌دهی ساده و همچنین بررسی این‌که پیکربندی apcupsd(8) شما به‌درستی تنظیم شده و می‌تواند با UPS ارتباط برقرار کند، فراهم می‌آورد.

برای یک APC UPS که در حالت پروتکل هوشمند APC (smart protocol mode) کار می‌کند، apctest خواندن و برنامه‌ریزی مقادیر متغیرهای پیکربندی EEPROM در UPS و همچنین انجام کالیبراسیون زمان کارکرد باتری (battery runtime calibration) را امکان‌پذیر می‌سازد. این برنامه همچنین یک حالت گفتگوی متنی ساده (TTY chat mode) فراهم می‌کند که امکان تعامل مستقیم با UPS را از طریق پروتکل هوشمند APC می‌دهد. برای جزئیات این پروتکل و دستورهای موجود، به بخش تفصیلی "APC Smart Protocol" در کتابچه راهنمای apcupsd مراجعه کنید.

مهم: پیش از اجرای apctest

بررسی کنید که دستورالعمل‌های پیکربندی UPSCABLE، UPSTYPE و DEVICE در پروندهٔ پیکربندی apcupsd.conf(5) به‌درستی تنظیم شده باشند؛ و
اگر apcupsd در حال اجرا است آن را متوقف کنید. شما نمی‌توانید هم‌زمان هر دو برنامهٔ apcupsd(8) و apctest را اجرا نمایید.

هنگام اجرا، apctest منویی از گزینه‌ها را نمایش می‌دهد که بسته به اتصال UPS به درگاه USB یا درگاه سریال، متفاوت هستند. برای اتصال از طریق درگاه سریال، دو منوی مختلف بسته به این‌که UPS در حالت پروتکل هوشمند APC کار می‌کند یا حالت سیگنال‌دهی ساده (simple signalling mode) وجود دارد - این موضوع همچنین به کابلی که برای اتصال به UPS استفاده می‌شود بستگی دارد. اگر از یک کابل سیگنال‌دهی ساده برای اتصال به یک Smart-UPS استفاده شود، UPS تنها قادر خواهد بود در حالت سیگنال‌دهی ساده کار کند.

apctest رونوشتی از نشست را در پروندهٔ apctest.out در دایرکتوری‌ای که برنامه از آن فراخوانی شده است ذخیره می‌کند. محتوای آن برای اهداف اشکال‌زدایی مفید است.

درگاه USB (USB PORT)

هنگام استفاده از یک UPS متصل به درگاه USB (مانند Back-UPS RS 1500)، گزینه‌های منوی زیر نمایش داده خواهند شد:

Option 1) Test kill UPS power

خاموش کردن UPS و بردن آن به حالت خواب زمستانی (hibernate mode) را انجام می‌دهد.

Option 2) Perform self-test

یک خودآزمایی (self-test) فوری انجام می‌دهد (برای انجام این کار به برق باتری سوئیچ می‌کند).

Option 3) Read last self-test result

نتیجهٔ آخرین خودآزمایی را نمایش می‌دهد.

Option 4) View/Change battery date

تاریخ فعلی تعویض باتری را نمایش می‌دهد و امکان تغییر اختیاری آن را فراهم می‌کند - هنگام تعویض باتری کاربرد دارد تا بتوانید سن باتری را به‌طور دقیق پیگیری کنید.

Option 5) View manufacturing date

تاریخ ساخت UPS را نمایش می‌دهد.

Option 6) View/Change alarm behavior

مدت‌زمان تاخیر پیش از به صدا درآمدن بوق هشدار UPS هنگام قطع برق شهری را تنظیم می‌کند.

Option 7) View/Change sensitivity

میزان حساسیت UPS به کیفیت برق شهری و نوسانات ولتاژ را تغییر می‌دهد - گزینه‌های (H)igh (زیاد)، (M)edium (متوسط) یا (L)ow (کم). هرچه حساسیت بالاتر باشد، UPS سریع‌تر به برق باتری سوئیچ می‌کند یا قابلیت‌های SmartBoost/SmartTrim را فعال می‌سازد (ویژگی‌هایی که در صورت قرار داشتن افت یا افزایش ولتاژ در محدودهٔ ۱۲٪ مقدار نامی، از مصرف برق باتری جلوگیری می‌کنند). این تنظیم معمولاً باید روی High قرار گیرد، مگر این‌که UPS به‌طور مکرر به برق باتری سوئیچ کند؛ در این حالت، تنظیم حساسیت کمتر باعث حفظ باتری‌های UPS خواهد شد... البته اگر تجهیزات متصل بتوانند کیفیت برق را تحمل کنند.

Option 8) View/Change low transfer voltage

سطح ولتاژ پایینی را که در آن UPS به باتری سوئیچ می‌کند یا SmartBoost را فعال می‌سازد تنظیم می‌کند.

Option 9) View/Change high transfer voltage

سطح ولتاژ بالایی را که در آن UPS به باتری سوئیچ می‌کند یا SmartTrim را فعال می‌سازد تنظیم می‌کند.

Option 10) Perform battery calibration

این گزینه کالیبراسیون زمان کارکرد باتری (battery runtime calibration) را انجام می‌دهد. این کار تنها در صورتی قابل انجام است که باتری شما تا ۱۰۰٪ ظرفیت شارژ شده باشد. کالیبراسیون زمان کارکرد، باتری UPS را تا حدود ۲۵٪ ظرفیت تخلیه می‌کند. درصد دقیق به مدل UPS بستگی دارد.

مزیت انجام این کالیبراسیون این است که UPS شمارندهٔ زمان کارکرد باقی‌مانده را که نگهداری می‌کند مجدداً کالیبره کرده و در نتیجه تخمین دقیق‌تری از زمان کارکرد باقی‌مانده گزارش می‌دهد. با گذشت زمان و کهنه شدن باتری‌ها، توانایی آن‌ها در نگهداری شارژ کاهش می‌یابد، بنابراین ممکن است شمارندهٔ داخلی زمان کارکرد UPS پس از چند سال دقیق نباشد.

توصیه می‌شود کالیبراسیون زمان کارکرد باتری سالانه انجام شود. انجام بیش از حد آن باعث کاهش طول عمر باتری‌های UPS می‌شود.

Option 11) Test Alarm

این گزینه باعث می‌شود بوق هشدار UPS برای چند ثانیه به صدا درآید.

Option 12) View/Change self-test interval

این گزینه به شما امکان می‌دهد بازهٔ زمانی بین خودآزمایی‌های خودکار UPS را تغییر دهید.

Option Q) Quit

از برنامه خارج می‌شود.

درگاه سریال (حالت پروتکل هوشمند) (SERIAL PORT (SMART PROTOCOL MODE))

هنگام استفاده از یک UPS که در حالت پروتکل هوشمند APC کار می‌کند (مانند Smart-UPS)، گزینه‌های منوی زیر نمایش داده خواهند شد:

Option 1) Query the UPS for all known values

انتخاب این گزینه، UPS را برای تمام مقادیر متغیرهای پیکربندی EEPROM شناخته‌شده برای apctest پرس‌وجو (probe) می‌کند و آن‌ها را در قالبی تقریباً خام نمایش می‌دهد. این خروجی می‌تواند برای ارائهٔ پشتیبانی فنی در صورت بروز مشکل در رفتار UPS یا apcupsd(8) مفید باشد.

Option 2) Perform a Battery Runtime Calibration

این گزینه کالیبراسیون زمان کارکرد باتری را انجام می‌دهد. این کار تنها در صورتی قابل انجام است که باتری شما تا ۱۰۰٪ ظرفیت شارژ شده باشد. کالیبراسیون زمان کارکرد، باتری UPS را تا حدود ۲۵٪ ظرفیت تخلیه می‌کند. درصد دقیق به مدل UPS بستگی دارد. apctest می‌تواند در صورت تشخیص شارژ باتری کمتر از ۱۰٪، به‌صورت اختیاری کالیبراسیون را لغو کند.

مزیت انجام این کالیبراسیون این است که UPS شمارندهٔ زمان کارکرد باقی‌مانده را که نگهداری می‌کند مجدداً کالیبره کرده و در نتیجه تخمین دقیق‌تری از زمان کارکرد باقی‌مانده گزارش می‌دهد. با فرسوده شدن باتری‌ها، توانایی آن‌ها در نگهداری شارژ کاهش می‌یابد، بنابراین ممکن است شمارندهٔ داخلی زمان کارکرد UPS پس از چند سال دقیق نباشد.

توصیه می‌شود کالیبراسیون زمان کارکرد باتری سالانه انجام شود. انجام بیش از حد آن باعث کاهش طول عمر باتری‌های UPS می‌شود.

Option 3) Abort Battery Calibration

این گزینه کالیبراسیون زمان کارکرد باتری در حال اجرا را لغو می‌کند.

Option 4) Monitor Battery Calibration progress

امکان نظارت مجدد بر روند کالیبراسیون زمان کارکرد باتری را فراهم می‌کند.

Option 5) Program EEPROM

امکان برنامه‌ریزی مقادیر متغیرهای پیکربندی EEPROM در یک Smart-UPS را فراهم می‌کند.

انتخاب این گزینه زیرمنویی از گزینه‌های برنامه‌ریزی را ارائه می‌دهد که در زیر با جزئیات آمده است:

Option 1) Print EEPROM values: مقدار تمام متغیرهای پیکربندی EEPROM شناخته‌شده برای apctest را چاپ می‌کند.
Option 2) Change Battery date: تاریخ باتری را تغییر می‌دهد - هنگام تعویض باتری کاربرد دارد تا بتوانید سن باتری را به‌طور دقیق پیگیری کنید.
Option 3) Change UPS name: نام UPS را تغییر می‌دهد - برای نام‌گذاری UPS حداکثر از ۸ نویسه استفاده کنید.
Option 4) Change sensitivity: میزان حساسیت UPS به کیفیت برق شهری و نوسانات ولتاژ را تغییر می‌دهد - گزینه‌های (H)igh (زیاد)، (M)edium (متوسط) یا (L)ow (کم). هرچه حساسیت بالاتر باشد، UPS سریع‌تر به برق باتری سوئیچ می‌کند یا قابلیت‌های SmartBoost/SmartTrim را فعال می‌سازد (ویژگی‌هایی که در صورت قرار داشتن افت یا افزایش ولتاژ در محدودهٔ ۱۲٪ مقدار نامی، از مصرف برق باتری جلوگیری می‌کنند). این تنظیم معمولاً باید روی High قرار گیرد، مگر این‌که UPS به‌طور مکرر به برق باتری سوئیچ کند؛ در این حالت، تنظیم حساسیت کمتر باعث حفظ باتری‌های UPS خواهد شد... البته اگر تجهیزات متصل بتوانند کیفیت برق را تحمل کنند.
Option 5) Change alarm delay: مدت‌زمان تاخیر پیش از به صدا درآمدن بوق هشدار UPS هنگام قطع برق شهری را تغییر می‌دهد.
Option 6) Change low battery warning delay: دقایق زمان کارکرد باقی‌مانده را که در آن UPS سیگنال باتری ضعیف را ارسال می‌کند تغییر می‌دهد. هنگامی که UPS طبق محاسبات داخلی تشخیص دهد که تعداد دقایق مشخص‌شده تا اتمام برق باتری باقی مانده است، هشدار باتری ضعیف را ارسال می‌کند.
Option 7) Change wakeup delay: میزان تاخیر پیش از برقراری مجدد برق تجهیزات متصل توسط UPS را پس از وصل مجدد برق شهری پس از خاموش شدن در حالت خواب زمستانی تغییر می‌دهد.
Option 8) Change shutdown delay: مدت تاخیری را که UPS پیش از قطع برق تجهیزات متصل، پس از دریافت فرمان خاموش شدن در حالت خواب زمستانی منتظر می‌ماند تغییر می‌دهد.
Option 9) Change low transfer voltage: سطح ولتاژ پایینی را که در آن UPS به باتری سوئیچ می‌کند یا SmartBoost را فعال می‌سازد تغییر می‌دهد.
Option 10) Change high transfer voltage: سطح ولتاژ بالایی را که در آن UPS به باتری سوئیچ می‌کند یا SmartTrim را فعال می‌سازد تغییر می‌دهد.
Option 11) Change battery return threshold percent: درصد شارژ باتری مورد نیاز پس از خاموش شدن در حالت خواب زمستانی را پیش از آن‌که UPS با بازگشت برق شهری مجدداً برق تجهیزات متصل را برقرار سازد، تغییر می‌دهد.
Option 12) Change output voltage when on batteries: ولتاژ خروجی نامی را در زمانی که UPS با برق باتری کار می‌کند تغییر می‌دهد.
Option 13) Change the self test interval: بازهٔ زمانی خودآزمایی خودکار را تغییر داده یا آن را غیرفعال می‌کند.
Option 14) Set EEPROM with configuration file values: این گزینه امکان برنامه‌ریزی دسته‌جمعی متغیرهای پیکربندی EEPROM را از روی مقادیر موجود در پروندهٔ پیکربندی /etc/apcupsd.conf فراهم می‌کند. به بخش "APCTEST EEPROM CONFIGURATION DIRECTIVES" در صفحهٔ راهنمای apcupsd.conf(5) مراجعه کنید.
Option 15) Quit: این گزینه به منوی قبلی (اصلی) بازمی‌گردد.

Option 6) Enter TTY mode communicating with UPS

این گزینه امکان تعامل مستقیم با UPS متصل را با استفاده از دستورهای پروتکل هوشمند APC فراهم می‌کند.

هشدار: در وارد کردن دستورها بسیار دقت کنید زیرا ممکن است باعث خاموش شدن ناگهانی UPS شود یا در بدترین حالت، UPS را به شکلی تغییر دهد که برای همیشه غیرفعال گردد. دستورهای ناشناخته یا پشتیبانی‌نشده را آزمایش نکنید. هوشیار باشید (Caveat Utilitor)!

Option 7) Quit

از برنامه خارج می‌شود.

درگاه سریال (حالت سیگنال‌دهی ساده) (SERIAL PORT (SIMPLE SIGNALLING MODE))

هنگام استفاده از یک APC UPS که در حالت سیگنال‌دهی ساده کار می‌کند، گزینه‌های منوی زیر نمایش داده خواهند شد: