.\" manual page [] for apctest version 3.14.6
.Dd January 10, 2009
.Dt APCTEST 8
.Os apctest v3.14.6
.Sh "نام (NAME)"
.Nm apctest
.Nd برنامه آزمون و کالیبراسیون سخت‌افزار UPS در apcupsd
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Sh "توضیحات (DESCRIPTION)"
.Nm
برنامه‌ای است که امکان اجرای برخی از آزمون‌های سطح‌پایین را برای بررسی عملکرد UPS متصل شرکت American Power Conversion Corp (APC) با سیگنال‌دهی ساده و همچنین بررسی این‌که پیکربندی
.Xr apcupsd 8
شما به‌درستی تنظیم شده و می‌تواند با UPS ارتباط برقرار کند، فراهم می‌آورد.
.Pp
برای یک APC UPS که در حالت پروتکل هوشمند APC (smart protocol mode) کار می‌کند،
.Nm
خواندن و برنامه‌ریزی مقادیر متغیرهای پیکربندی EEPROM در UPS و همچنین انجام کالیبراسیون زمان کارکرد باتری (battery runtime calibration) را امکان‌پذیر می‌سازد. این برنامه همچنین یک حالت گفتگوی متنی ساده (TTY chat mode) فراهم می‌کند که امکان تعامل مستقیم با UPS را از طریق پروتکل هوشمند APC می‌دهد. برای جزئیات این پروتکل و دستورهای موجود، به بخش تفصیلی \(dqAPC Smart Protocol\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Pp
مهم: پیش از اجرای
.Nm
.Bl -bullet
.It
بررسی کنید که دستورالعمل‌های پیکربندی UPSCABLE، UPSTYPE و DEVICE در پروندهٔ پیکربندی
.Xr apcupsd.conf 5
به‌درستی تنظیم شده باشند؛ و
.It
اگر apcupsd در حال اجرا است آن را متوقف کنید. شما نمی‌توانید هم‌زمان هر دو برنامهٔ
.Xr apcupsd 8
و
.Nm
را اجرا نمایید.
.El
.Pp
هنگام اجرا،
.Nm
منویی از گزینه‌ها را نمایش می‌دهد که بسته به اتصال UPS به درگاه USB یا درگاه سریال، متفاوت هستند. برای اتصال از طریق درگاه سریال، دو منوی مختلف بسته به این‌که UPS در حالت پروتکل هوشمند APC کار می‌کند یا حالت سیگنال‌دهی ساده (simple signalling mode) وجود دارد \- این موضوع همچنین به کابلی که برای اتصال به UPS استفاده می‌شود بستگی دارد. اگر از یک کابل سیگنال‌دهی ساده برای اتصال به یک Smart-UPS استفاده شود، UPS تنها قادر خواهد بود در حالت سیگنال‌دهی ساده کار کند.
.Pp
.Nm
رونوشتی از نشست را در پروندهٔ
.Pa apctest.out
در دایرکتوری‌ای که برنامه از آن فراخوانی شده است ذخیره می‌کند. محتوای آن برای اهداف اشکال‌زدایی مفید است.
.Sh "درگاه USB (USB PORT)"
هنگام استفاده از یک UPS متصل به درگاه USB (مانند Back-UPS RS 1500)، گزینه‌های منوی زیر نمایش داده خواهند شد:
.Ss Option 1) Test kill UPS power
خاموش کردن UPS و بردن آن به حالت خواب زمستانی (hibernate mode) را انجام می‌دهد.
.Ss Option 2) Perform self-test
یک خودآزمایی (self-test) فوری انجام می‌دهد (برای انجام این کار به برق باتری سوئیچ می‌کند).
.Ss Option 3) Read last self-test result
نتیجهٔ آخرین خودآزمایی را نمایش می‌دهد.
.Ss Option 4) View/Change battery date
تاریخ فعلی تعویض باتری را نمایش می‌دهد و امکان تغییر اختیاری آن را فراهم می‌کند \- هنگام تعویض باتری کاربرد دارد تا بتوانید سن باتری را به‌طور دقیق پیگیری کنید.
.Ss Option 5) View manufacturing date
تاریخ ساخت UPS را نمایش می‌دهد.
.Ss Option 6) View/Change alarm behavior
مدت‌زمان تاخیر پیش از به صدا درآمدن بوق هشدار UPS هنگام قطع برق شهری را تنظیم می‌کند.
.Ss Option 7) View/Change sensitivity
میزان حساسیت UPS به کیفیت برق شهری و نوسانات ولتاژ را تغییر می‌دهد \- گزینه‌های (H)igh (زیاد)، (M)edium (متوسط) یا (L)ow (کم). هرچه حساسیت بالاتر باشد، UPS سریع‌تر به برق باتری سوئیچ می‌کند یا قابلیت‌های SmartBoost/SmartTrim را فعال می‌سازد (ویژگی‌هایی که در صورت قرار داشتن افت یا افزایش ولتاژ در محدودهٔ ۱۲٪ مقدار نامی، از مصرف برق باتری جلوگیری می‌کنند). این تنظیم معمولاً باید روی High قرار گیرد، مگر این‌که UPS به‌طور مکرر به برق باتری سوئیچ کند؛ در این حالت، تنظیم حساسیت کمتر باعث حفظ باتری‌های UPS خواهد شد... البته اگر تجهیزات متصل بتوانند کیفیت برق را تحمل کنند.
.Ss Option 8) View/Change low transfer voltage
سطح ولتاژ پایینی را که در آن UPS به باتری سوئیچ می‌کند یا SmartBoost را فعال می‌سازد تنظیم می‌کند.
.Ss Option 9) View/Change high transfer voltage
سطح ولتاژ بالایی را که در آن UPS به باتری سوئیچ می‌کند یا SmartTrim را فعال می‌سازد تنظیم می‌کند.
.Ss Option 10) Perform battery calibration
این گزینه کالیبراسیون زمان کارکرد باتری (battery runtime calibration) را انجام می‌دهد. این کار تنها در صورتی قابل انجام است که باتری شما تا ۱۰۰٪ ظرفیت شارژ شده باشد. کالیبراسیون زمان کارکرد، باتری UPS را تا حدود ۲۵٪ ظرفیت تخلیه می‌کند. درصد دقیق به مدل UPS بستگی دارد.
.Pp
مزیت انجام این کالیبراسیون این است که UPS شمارندهٔ زمان کارکرد باقی‌مانده را که نگهداری می‌کند مجدداً کالیبره کرده و در نتیجه تخمین دقیق‌تری از زمان کارکرد باقی‌مانده گزارش می‌دهد. با گذشت زمان و کهنه شدن باتری‌ها، توانایی آن‌ها در نگهداری شارژ کاهش می‌یابد، بنابراین ممکن است شمارندهٔ داخلی زمان کارکرد UPS پس از چند سال دقیق نباشد.
.Pp
توصیه می‌شود کالیبراسیون زمان کارکرد باتری سالانه انجام شود. انجام بیش از حد آن باعث کاهش طول عمر باتری‌های UPS می‌شود.
.Ss Option 11) Test Alarm
این گزینه باعث می‌شود بوق هشدار UPS برای چند ثانیه به صدا درآید.
.Ss Option 12) View/Change self-test interval
این گزینه به شما امکان می‌دهد بازهٔ زمانی بین خودآزمایی‌های خودکار UPS را تغییر دهید.
.Ss Option Q) Quit
از برنامه خارج می‌شود.
.Sh "درگاه سریال (حالت پروتکل هوشمند) (SERIAL PORT (SMART PROTOCOL MODE))"
هنگام استفاده از یک UPS که در حالت پروتکل هوشمند APC کار می‌کند (مانند Smart-UPS)، گزینه‌های منوی زیر نمایش داده خواهند شد:
.Ss Option 1) Query the UPS for all known values
انتخاب این گزینه، UPS را برای تمام مقادیر متغیرهای پیکربندی EEPROM شناخته‌شده برای
.Nm
پرس‌وجو (probe) می‌کند و آن‌ها را در قالبی تقریباً خام نمایش می‌دهد. این خروجی می‌تواند برای ارائهٔ پشتیبانی فنی در صورت بروز مشکل در رفتار UPS یا
.Xr apcupsd 8
مفید باشد.
.Ss Option 2) Perform a Battery Runtime Calibration
این گزینه کالیبراسیون زمان کارکرد باتری را انجام می‌دهد. این کار تنها در صورتی قابل انجام است که باتری شما تا ۱۰۰٪ ظرفیت شارژ شده باشد. کالیبراسیون زمان کارکرد، باتری UPS را تا حدود ۲۵٪ ظرفیت تخلیه می‌کند. درصد دقیق به مدل UPS بستگی دارد.
.Nm
می‌تواند در صورت تشخیص شارژ باتری کمتر از ۱۰٪، به‌صورت اختیاری کالیبراسیون را لغو کند.
.Pp
مزیت انجام این کالیبراسیون این است که UPS شمارندهٔ زمان کارکرد باقی‌مانده را که نگهداری می‌کند مجدداً کالیبره کرده و در نتیجه تخمین دقیق‌تری از زمان کارکرد باقی‌مانده گزارش می‌دهد. با فرسوده شدن باتری‌ها، توانایی آن‌ها در نگهداری شارژ کاهش می‌یابد، بنابراین ممکن است شمارندهٔ داخلی زمان کارکرد UPS پس از چند سال دقیق نباشد.
.Pp
توصیه می‌شود کالیبراسیون زمان کارکرد باتری سالانه انجام شود. انجام بیش از حد آن باعث کاهش طول عمر باتری‌های UPS می‌شود.
.Ss Option 3) Abort Battery Calibration
این گزینه کالیبراسیون زمان کارکرد باتری در حال اجرا را لغو می‌کند.
.Ss Option 4) Monitor Battery Calibration progress
امکان نظارت مجدد بر روند کالیبراسیون زمان کارکرد باتری را فراهم می‌کند.
.Ss Option 5) Program EEPROM
امکان برنامه‌ریزی مقادیر متغیرهای پیکربندی EEPROM در یک Smart-UPS را فراهم می‌کند.
.Pp
انتخاب این گزینه زیرمنویی از گزینه‌های برنامه‌ریزی را ارائه می‌دهد که در زیر با جزئیات آمده است:
.Bl -hang
.It Option 1)  Print EEPROM values
.Pp
مقدار تمام متغیرهای پیکربندی EEPROM شناخته‌شده برای
.Nm
را چاپ می‌کند.
.It Option 2)  Change Battery date
.Pp
تاریخ باتری را تغییر می‌دهد \- هنگام تعویض باتری کاربرد دارد تا بتوانید سن باتری را به‌طور دقیق پیگیری کنید.
.It Option 3)  Change UPS name
.Pp
نام UPS را تغییر می‌دهد \- برای نام‌گذاری UPS حداکثر از ۸ نویسه استفاده کنید.
.It Option 4)  Change sensitivity
.Pp
میزان حساسیت UPS به کیفیت برق شهری و نوسانات ولتاژ را تغییر می‌دهد \- گزینه‌های (H)igh (زیاد)، (M)edium (متوسط) یا (L)ow (کم). هرچه حساسیت بالاتر باشد، UPS سریع‌تر به برق باتری سوئیچ می‌کند یا قابلیت‌های SmartBoost/SmartTrim را فعال می‌سازد (ویژگی‌هایی که در صورت قرار داشتن افت یا افزایش ولتاژ در محدودهٔ ۱۲٪ مقدار نامی، از مصرف برق باتری جلوگیری می‌کنند). این تنظیم معمولاً باید روی High قرار گیرد، مگر این‌که UPS به‌طور مکرر به برق باتری سوئیچ کند؛ در این حالت، تنظیم حساسیت کمتر باعث حفظ باتری‌های UPS خواهد شد... البته اگر تجهیزات متصل بتوانند کیفیت برق را تحمل کنند.
.It Option 5)  Change alarm delay
.Pp
مدت‌زمان تاخیر پیش از به صدا درآمدن بوق هشدار UPS هنگام قطع برق شهری را تغییر می‌دهد.
.It Option 6)  Change low battery warning delay
.Pp
دقایق زمان کارکرد باقی‌مانده را که در آن UPS سیگنال باتری ضعیف را ارسال می‌کند تغییر می‌دهد. هنگامی که UPS طبق محاسبات داخلی تشخیص دهد که تعداد دقایق مشخص‌شده تا اتمام برق باتری باقی مانده است، هشدار باتری ضعیف را ارسال می‌کند.
.It Option 7)  Change wakeup delay
.Pp
میزان تاخیر پیش از برقراری مجدد برق تجهیزات متصل توسط UPS را پس از وصل مجدد برق شهری پس از خاموش شدن در حالت خواب زمستانی تغییر می‌دهد.
.It Option 8)  Change shutdown delay
.Pp
مدت تاخیری را که UPS پیش از قطع برق تجهیزات متصل، پس از دریافت فرمان خاموش شدن در حالت خواب زمستانی منتظر می‌ماند تغییر می‌دهد.
.It Option 9)  Change low transfer voltage
.Pp
سطح ولتاژ پایینی را که در آن UPS به باتری سوئیچ می‌کند یا SmartBoost را فعال می‌سازد تغییر می‌دهد.
.It Option 10) Change high transfer voltage
.Pp
سطح ولتاژ بالایی را که در آن UPS به باتری سوئیچ می‌کند یا SmartTrim را فعال می‌سازد تغییر می‌دهد.
.It Option 11) Change battery return threshold percent
.Pp
درصد شارژ باتری مورد نیاز پس از خاموش شدن در حالت خواب زمستانی را پیش از آن‌که UPS با بازگشت برق شهری مجدداً برق تجهیزات متصل را برقرار سازد، تغییر می‌دهد.
.It Option 12) Change output voltage when on batteries
.Pp
ولتاژ خروجی نامی را در زمانی که UPS با برق باتری کار می‌کند تغییر می‌دهد.
.It Option 13) Change the self test interval
.Pp
بازهٔ زمانی خودآزمایی خودکار را تغییر داده یا آن را غیرفعال می‌کند.
.It Option 14) Set EEPROM with configuration file values
.Pp
این گزینه امکان برنامه‌ریزی دسته‌جمعی متغیرهای پیکربندی EEPROM را از روی مقادیر موجود در پروندهٔ پیکربندی
.Pa /etc/apcupsd.conf
فراهم می‌کند. به بخش \(dqAPCTEST EEPROM CONFIGURATION DIRECTIVES\(dq در صفحهٔ راهنمای
.Xr apcupsd.conf 5
مراجعه کنید.
.It Option 15) Quit
.Pp
این گزینه به منوی قبلی (اصلی) بازمی‌گردد.
.El
.Ss Option 6) Enter TTY mode communicating with UPS
این گزینه امکان تعامل مستقیم با UPS متصل را با استفاده از دستورهای پروتکل هوشمند APC فراهم می‌کند.
.Pp
هشدار: در وارد کردن دستورها بسیار دقت کنید زیرا ممکن است باعث خاموش شدن ناگهانی UPS شود یا در بدترین حالت، UPS را به شکلی تغییر دهد که برای همیشه غیرفعال گردد. دستورهای ناشناخته یا پشتیبانی‌نشده را آزمایش نکنید. هوشیار باشید (Caveat Utilitor)!
.Ss Option 7) Quit
از برنامه خارج می‌شود.
.Sh "درگاه سریال (حالت سیگنال‌دهی ساده) (SERIAL PORT (SIMPLE SIGNALLING MODE))"
هنگام استفاده از یک APC UPS که در حالت سیگنال‌دهی ساده کار می‌کند، گزینه‌های منوی زیر نمایش داده خواهند شد:
.Ss Option 1) Test 1 - normal mode
نتیجهٔ آزمایش به مدل UPS و نوع کابل مورد استفاده بستگی دارد. برای جزئیات به بخش \(dqUsing apctest on Serial-Line UPSses\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Ss Option 2) Test 2 - no cable
نتیجهٔ آزمایش به مدل UPS و نوع کابل مورد استفاده بستگی دارد. برای جزئیات به بخش \(dqUsing apctest on Serial-Line UPSses\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Ss Option 3) Test 3 - no power
نتیجهٔ آزمایش به مدل UPS و نوع کابل مورد استفاده بستگی دارد. برای جزئیات به بخش \(dqUsing apctest on Serial-Line UPSses\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Ss Option 4) Test 4 - low battery (requires Test 3 first)
نتیجهٔ آزمایش به مدل UPS و نوع کابل مورد استفاده بستگی دارد. برای جزئیات به بخش \(dqUsing apctest on Serial-Line UPSses\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Ss Option 5) Test 5 - battery exhausted
نتیجهٔ آزمایش به مدل UPS و نوع کابل مورد استفاده بستگی دارد. برای جزئیات به بخش \(dqUsing apctest on Serial-Line UPSses\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Ss Option 6) Test 6 - kill UPS power
نتیجهٔ آزمایش به مدل UPS و نوع کابل مورد استفاده بستگی دارد. برای جزئیات به بخش \(dqUsing apctest on Serial-Line UPSses\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Ss Option 7) Test 7 - run tests 1 through 5
این گزینه باعث می‌شود
.Nm
حدس بزند که چه کابلی باید برای UPS متصل استفاده شود.
.Ss Option 9) Quit
از برنامه خارج می‌شود.
.Sh "فایل‌ها (FILES)"
.Pa /etc/apcupsd/apcupsd.conf
پروندهٔ پیکربندی پیش‌فرض
.Pp
.Pa apctest.out
رونوشت نشست
.Nm
.Sh "همچنین ببینید (SEE ALSO)"
.Xr apcupsd.conf 5 ,
.Xr apcupsd 8 .
.Pp
کتابچه راهنمای HTML برنامهٔ apcupsd که روی سیستم شما نصب شده یا به‌صورت برخط در
http://www.apcupsd.org
در دسترس است.
.Sh "نویسندگان (AUTHORS)"
.Ss "این صفحه"
.An Trevor Roydhouse (فعلی)
.An Robert Huff
.Ss "نرم‌افزار"
.An Adam Kropelin (مدیر پروژه و نگهدارندهٔ فعلی کد)
.An Kern Sibbald (مدیر پروژه و نگهدارندهٔ پیشین کد)
.An Riccardo Facchetti (مدیر پروژه و نگهدارندهٔ پیشین کد)
.An Andre M. Hedrick (بنیان‌گذار پروژه و نگهدارندهٔ پیشین کد)
.Ss "مشارکت‌کنندگان"
شمار بسیار زیادی از کاربران که وقت و انرژی خود را به این پروژه اختصاص دادند \-\- با سپاس.