'\" t
.\"     Title: blazer_usb
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/21/2026
.\"    Manual: NUT Manual
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: Persian
.\"
.TH "BLAZER_USB" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
blazer_usb \- درایور برای تجهیزات UPS مبتنی بر USB با پروتکل Megatec/Q1
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBblazer_usb\fR \-h
.sp
\fBblazer_usb\fR \-a \fIUPS_NAME\fR [\fIOPTIONS\fR]
.SH "نکته (NOTE)"
.sp
این صفحه راهنما فقط ویژگی‌های خاص سخت‌افزاری درایور blazer را مستند می‌کند\&. برای اطلاعات بیشتر درباره درایور اصلی، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.SH "نکته (NOTE)"
.sp
لطفاً توجه داشته باشید که این درایور منسوخ شده است (deprecated) و هیچ توسعه جدیدی دریافت نخواهد کرد\&. اگر برای مدیریت دستگاه‌های شما کار می‌کند \(em عالی است، اما اگر در حال اجرای آن برای راه‌اندازی یک دستگاه جدید هستید، لطفاً درایور جدیدتر \fBnutdrv_qx\fR(8) را در نظر بگیرید که باید تمام انواع پروتکل \fIQ*\fR را برای NUT مدیریت کند\&.
.sp
همچنین لطفاً گزارش دهید اگر دستگاه شما با این درایور کار می‌کند، اما \fBnutdrv_qx\fR(8) واقعاً با هیچ زیردرایوری از آن پشتیبانی نمی‌کند!
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
مشخص شده است که درایور blazer با انواع مختلف UPS از شرکت‌های Blazer، Energy Sistem، Fenton Technologies، General Electric، Mustek و بسیاری دیگر کار می‌کند\&. جدول سازگاری NUT تمام مدل‌های پشتیبانی‌شده شناخته‌شده را فهرست می‌کند\&. با این حال به خاطر داشته باشید که سایر مدل‌هایی که در آنجا ذکر نشده‌اند نیز ممکن است پشتیبانی شوند، اما آزمایش نشده‌اند\&.
.sp
تمام دستگاه‌های دارای رابط سریال (از درایور \fBblazer_ser\fR استفاده کنید) و بسیاری از دستگاه‌های دارای رابط USB (از درایور \fBblazer_usb\fR استفاده کنید) پشتیبانی می‌شوند\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
بسته به سازنده و مدل UPS خود، ممکن است لازم باشد مقادیری را بازنویسی (override) کنید یا مقادیر پیش‌فرضی برای آن‌ها تعیین نمایید\&. موارد زیر احتمالاً مواردی هستند که بیش از همه نیاز به تغییر خواهند داشت (به \fBups.conf\fR(5) مراجعه کنید):
.PP
\fBdefault\&.battery\&.voltage\&.high =\fR \fIvalue\fR
.RS 4
حداکثر ولتاژ باتری که پس از حدود ۱۲ تا ۲۴ ساعت شارژ حاصل می‌شود\&. اگر می‌خواهید درایور یک مقدار تخمینی برای
\fBbattery\&.charge\fR
گزارش دهد، باید این مقدار را مشخص کنید (به بخش
BATTERY CHARGE GUESSTIMATION
مراجعه کنید)\&.
.RE
.PP
\fBdefault\&.battery\&.voltage\&.low =\fR \fIvalue\fR
.RS 4
حداقل ولتاژ باتری درست پیش از آن‌که UPS به‌طور خودکار خاموش شود\&. اگر می‌خواهید درایور یک مقدار تخمینی برای
\fBbattery\&.charge\fR
گزارش دهد، باید این مقدار را مشخص کنید (به بخش
BATTERY CHARGE GUESSTIMATION
مراجعه کنید)\&.
.RE
.PP
\fBdefault\&.battery\&.voltage\&.nominal =\fR \fIvalue\fR, \fBoverride\&.battery\&.voltage\&.nominal =\fR \fIvalue\fR
.RS 4
برخی دستگاه‌ها ولتاژ اسمی باتری نادرستی را نشان می‌دهند (یا اصلاً هیچ مقداری نشان نمی‌دهند)، بنابراین ممکن است لازم باشد مقدار پیش‌فرضی تعیین کنید یا آن را بازنویسی نمایید\&.
.RE
.PP
\fBoverride\&.battery\&.packs =\fR \fIvalue\fR
.RS 4
برخی دستگاه‌ها بخشی از ولتاژ کل باتری را گزارش می‌کنند\&. برای مثال، اگر
\fBbattery\&.voltage\&.nominal\fR
برابر با 24 V باشد، اما دستگاه مقدار
\fBbattery\&.voltage\fR
را حدود 2 V گزارش دهد، تعداد
\fBbattery\&.packs\fR
برای تصحیح این مقدار خوانده‌شده برابر ۱۲ خواهد بود\&. درایور تلاش می‌کند این مورد را به‌طور خودکار تشخیص دهد، اما اگر به هر دلیلی با شکست مواجه شد، ممکن است بخواهید این مقدار را بازنویسی کنید\&.
.RE
.PP
\fBondelay =\fR \fIvalue\fR
.RS 4
مدت‌زمان انتظار پیش از روشن کردن UPS (بر حسب دقیقه)\&. توجه داشته باشید که مقداری کمتر از ۳ دقیقه ممکن است باعث شود نسخه‌های اولیه سفت‌افزار (firmware) به‌طور خودکار روشن نشوند، بنابراین پیش‌فرض آن ۳ دقیقه است\&. محدوده قابل قبول
0\&.\&.9999
دقیقه است\&.
.RE
.PP
\fBoffdelay =\fR \fIvalue\fR
.RS 4
مدت‌زمان انتظار پیش از خاموش کردن UPS (بر حسب ثانیه)\&. این مقدار به مضارب ۶ ثانیه (برای کمتر از ۶۰ ثانیه) یا ۶۰ ثانیه (برای بیشتر از ۶۰ ثانیه) کوتاه (truncate) می‌شود\&. مقدار پیش‌فرض ۳۰ ثانیه است\&. محدوده قابل قبول
12\&.\&.600
ثانیه است\&.
.RE
.PP
\fBnorating\fR
.RS 4
اگر تلاش کنید اطلاعات مشخصات نامی (rating) را از برخی از UPSها بخوانید، قفل می‌کنند\&. تنظیم این فلگ باعث می‌شود درایور از این مرحله صرف‌نظر کند\&.
.RE
.PP
\fBnovendor\fR
.RS 4
اگر تلاش کنید اطلاعات سازنده (vendor) را از برخی از UPSها بخوانید، قفل می‌کنند\&. تنظیم این فلگ باعث می‌شود درایور از این مرحله صرف‌نظر کند\&.
.RE
.PP
\fBprotocol =\fR \fIstring\fR
.RS 4
صرف‌نظر کردن از تشخیص خودکار پروتکل و استفاده انحصاری از پروتکل مشخص‌شده\&. مقادیر پشتیبانی‌شده عبارتند از
\fImegatec\fR،
\fImegatec/old\fR،
\fImustek\fR
و
\fIzinto\fR\&.
.RE
.PP
\fBruntimecal =\fR \fIvalue,value,value,value\fR
.RS 4
پارامتر مورد استفاده در تخمین زمان کارکرد (اختیاری)\&. این پارامتر دو زمان کارکرد را در بارهای متفاوت می‌گیرد\&. معمولاً زمان کارکرد در بار کامل (full load) و زمان کارکرد در نیمه‌بار (half load) استفاده می‌شود\&. برای مثال، اگر UPS شما دارای زمان کارکرد نامی ۲۴۰ ثانیه در بار کامل و ۷۲۰ ثانیه در نیمه‌بار باشد، باید مقدار زیر را وارد کنید
.sp
.if n \{\
.RS 4
.\}
.nf
runtimecal = 240,100,720,50
.fi
.if n \{\
.RE
.\}
.sp
بار اول همیشه باید بیشتر از بار دوم باشد\&. اگر مقادیری برای بارهایی غیر از ۱۰۰ و ۵۰ درصد در دسترس دارید، می‌توانید از آن‌ها نیز استفاده کنید، اما فاصله آن‌ها را تا حد ممکن از یکدیگر حفظ کنید\&. فقط بیش از حد به وضعیت بدون بار (no load) نزدیک نشوید (در این حالت پیش‌بینی زمان کارکرد بیشتر به بار بی‌باری باتری وابسته می‌شود)\&.
.RE
.PP
\fBchargetime =\fR \fIvalue\fR
.RS 4
زمان مورد نیاز برای شارژ کامل باتری پس از تخلیه کامل\&. در صورت عدم تعیین، پیش‌فرض درایور ۴۳۲۰۰ ثانیه (۱۲ ساعت) است\&. تنها زمانی استفاده می‌شود که
\fBruntimecal\fR
نیز مشخص شده باشد\&.
.RE
.PP
\fBidleload =\fR \fIvalue\fR
.RS 4
حداقل بار باتری مورد استفاده درایور برای تخمین زمان کارکرد\&. در صورت عدم تعیین، پیش‌فرض درایور 10% است\&. تنها زمانی استفاده می‌شود که
\fBruntimecal\fR
نیز مشخص شده باشد\&.
.RE
.SS "فقط رابط USB (USB INTERFACE ONLY)"
.PP
\fBport =\fR \fIstring\fR
.RS 4
گزینه‌ای الزامی برای تمامی درایورهای NUT\&. مقداری مانند
\fIvalue\fR
باید تعیین شود، معمولاً
\fBauto\fR
برای درایورهایی که اتصالات USB را مدیریت می‌کنند\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
این مقدار می‌تواند یک مسیر در سیستم‌فایل دستگاه مانند
/dev/usb/hiddev0
باشد اما استفاده فعلی از API مربوط به libusb مانع از شناخت و تطبیق از طریق چنین شناسه‌هایی می‌شود\&. همچنین ممکن است ذاتاً غیرقابل اعتماد باشند (وابسته به اتصال مجدد کابل و ترتیب شمارش دستگاه‌ها)\&. در حال حاضر مقدار واقعی
\fIvalue\fR
نادیده گرفته می‌شود، اما از نظر ساختاری وجود مقداری برای پیکربندی
\fIport\fR
همچنان الزامی است\&.
.sp .5v
.RE
.RE
.sp
امکان کنترل چندین دستگاه UPS به‌طور هم‌زمان از طریق اجرای چندین نمونه از این درایور وجود دارد، به شرطی که بتوان آن‌ها را با تنظیم ترکیبی از گزینه‌های \fBvendor\fR، \fBproduct\fR، \fBvendorid\fR، \fBproductid\fR، \fBserial\fR، \fBbus\fR یا \fBdevice\fR که در ادامه توضیح داده شده‌اند، به‌طور یکتا متمایز کرد\&. برای دستگاه‌ها یا سیستم‌عامل‌هایی که اطلاعات کافی ارائه نمی‌دهند، گزینه \fBallow_duplicates\fR می‌تواند کاربردی باشد (محدود و پرخطر!)\&.
.PP
\fBvendorid =\fR \fIregex\fR, \fBproductid =\fR \fIregex\fR, \fBvendor =\fR \fIregex\fR, \fBproduct =\fR \fIregex\fR, \fBserial =\fR \fIregex\fR
.RS 4
انتخاب یک UPS مشخص، در صورتی که بیش از یک دستگاه از طریق USB متصل باشد\&. هر گزینه یک عبارت منظم گسترده را مشخص می‌کند (برای اطلاعات بیشتر در مورد عبارات منظم به
\fBregex\fR(7)
مراجعه کنید)، که باید با مقادیر رشته‌ای کامل مربوط به
vendor/product/serial
دستگاه UPS (بدون احتساب فاصله‌های سفید پیرامون) یا کل کد هگزادسیمال ۴ رقمی برای
vendorid
و
productid
مطابقت داشته باشد\&.
.sp
برای یافتن رشته‌های مناسب جهت تطبیق، اجرای
\fBlsusb\fR(8)
یا اجرای این درایور NUT با آرگومان خط فرمان
\-DD
را امتحان کنید\&.
.sp
مثال‌ها:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x vendor="Foo\&.Corporation\&.*"
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x vendorid="051d*"
(APC)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-x product="\&.*(Smart|Back)\-?UPS\&.*"
.RE
.RE
.PP
\fBbus =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
انتخاب یک UPS روی یک گذرگاه USB مشخص یا گروهی از گذرگاه‌ها\&. آرگومان یک عبارت منظم است که باید با نام گذرگاهی که UPS به آن متصل است مطابقت داشته باشد (مثلاً
bus="002"
یا
bus="00[2\-3]")
همان‌طور که در لینوکس در مسیر
/sys/bus/usb/devices
یا در خروجی
\fBlsusb\fR(8)
دیده می‌شود؛ شامل صفرهای ابتدایی\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
سیستم‌عامل تضمین نمی‌کند که شماره‌های گذرگاه در طول راه‌اندازی‌های مجدد، بارگذاری مجدد درایورهای هسته یا اتصال مجدد دستگاه (مثلاً تغییر تعداد دستگاه‌های متصل به هاب‌های USB) پایدار باقی بمانند\&.
.sp .5v
.RE
.RE
.PP
\fBdevice =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
انتخاب یک UPS روی یک دستگاه USB مشخص یا گروهی از دستگاه‌ها\&. آرگومان یک عبارت منظم است که باید با نام دستگاهی که UPS به آن متصل است مطابقت داشته باشد (مثلاً
device="001"
یا
device="00[1\-2]")
همان‌طور که در لینوکس در مسیر
/sys/bus/usb/devices
یا در خروجی
\fBlsusb\fR(8)
دیده می‌شود؛ شامل صفرهای ابتدایی\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
سیستم‌عامل تضمین نمی‌کند که شماره‌های دستگاه در طول راه‌اندازی‌های مجدد یا اتصال مجدد دستگاه پایدار باقی بمانند\&.
.sp .5v
.RE
.RE
.PP
\fBbusport =\fR \fIregex\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
در صورت پشتیبانی توسط سخت‌افزار، سیستم‌عامل و libusb در محیط پیاده‌سازی‌شده خاص، این گزینه باید اجازه دهد به جای مقادیر شمارشی منطقی
device
شماره درگاه‌های فیزیکی روی یک هاب USB مشخص شود، و در نتیجه \(em این مورد باید در طول راه‌اندازی‌های مجدد یا اتصال‌های مجدد نوسان کمتری داشته باشد\&. برای مثال، این مقدار ممکن است در خروجی توپولوژی USB دستور
lsusb \-tv
روی سیستم‌هایی که این ابزار را دارند، مشاهده شود\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
این گزینه در عمل توسط برخی از بیلد‌های NUT پشتیبانی نمی‌شود (در این حالت باید همراه با یک هشدار نادیده گرفته شود)، و همچنین توسط تمام سیستم‌هایی که NUT می‌تواند روی آن‌ها اجرا شود نیز پشتیبانی نمی‌گردد\&.
.sp .5v
.RE
.RE
.PP
\fBallow_duplicates\fR
.RS 4
اختیاری، توصیه نمی‌شود\&.
.sp
اگر چندین دستگاه UPS دارید که ممکن است توسط گزینه‌های بالا به‌طور یکتا شناسایی نشوند (مثلاً فقط
\fIVID:PID\fR
در آنجا قابل کشف باشد)، این فلگ به هر نمونه درایور که در آن تنظیم شده اجازه می‌دهد اولین تطابق را در صورت موجود بودن انتخاب کند، یا برای بررسی مورد دیگر ادامه دهد\&.
.sp
به‌طور معمول، راه‌اندازی اولیه درایور در این مرحله با اعلام خطای «Resource busy» یا خطایی مشابه متوقف می‌شود، با این فرض که دستگاهی که به‌درستی تطبیق داده شده یکتا است \(em و فرایند دیگری در حال حاضر آن را مدیریت می‌کند\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBهشدار\fR
.ps -1
.br
این ویژگی ذاتاً غیرقطعی (non-deterministic) است! انتساب نام نمونه درایور به دستگاه واقعی ممکن است بین دفعات اجرا متفاوت باشد!
.sp
اگر فقط برایتان مهم است که بدانید
\fBحداقل\fR
یکی از UPSهای بی‌نام شما آنلاین است، این گزینه می‌تواند مفید باشد\&.
.sp
اما اگر واقعاً نیاز دارید بدانید
\fBکدام\fR
دستگاه است، این گزینه کمکی نخواهد کرد!
.sp .5v
.RE
.RE
.PP
\fBusb_set_altinterface =\fR \fIbAlternateSetting\fR
.RS 4
فراخوانی اجباری و مازاد
usb_set_altinterface()،
به‌ویژه در صورت نیاز برای دستگاه‌هایی که چندین نقش USB را ایفا می‌کنند و در آن‌ها UPS توسط شماره رابط
0
(پیش‌فرض) نشان داده نمی‌شود\&.
.RE
.PP
\fBusb_config_index\fR, \fBusb_hid_rep_index\fR, \fBusb_hid_desc_index\fR, \fBusb_hid_ep_in\fR, \fBusb_hid_ep_out\fR
.RS 4
استفاده اجباری از شماره‌های رابط، نقطه پایانی (endpoint)، شاخص توصیف‌گر (descriptor index) و غیره خاص، به جای استفاده از مقدار پیش‌فرض
\fI0\fR
(به ندرت مقادیر دیگر در برخی درایورها برای دستگاه‌های شناخته‌شده‌ای که از شماره‌های غیر صفر استفاده می‌کنند)\&. به‌صورت یک عدد هگزادسیمال مشخص می‌شود\&.
.sp
به‌عنوان یک قاعده کلی تجربی برای کشف
usb_hid_desc_index،
می‌توانید مقادیر بزرگتر
wDescriptorLength
(تقریباً ۶۰۰ بایت به بالا) را در گزارش‌های
lsusb
یا ابزارهای مشابه مشاهده کنید\&.
.RE
.PP
\fBLIBUSB_DEBUG =\fR \fIINTEGER\fR
.RS 4
عیب‌یابی زمان اجرای درایورهای دارای قابلیت USB در NUT می‌تواند نه تنها شامل افزایش سطح جزئیات اشکال‌زدایی عمومی NUT باشد (مثلاً با استفاده از تنظیم
DEBUG_MIN
در
\fBups.conf\fR(5)
یا دستورات پروتکل برای تغییر مقدار
driver\&.debug)،
بلکه ممکن است از اشکال‌زدایی اختصاصی LibUSB نیز بهره‌مند شود\&.
.sp
برای مورد اخیر، می‌توانید گزینه درایور
LIBUSB_DEBUG
را تنظیم کنید؛ همچنین به‌صورت سنتی می‌توانید پیش از شروع یک برنامه درایور NUT، متغیر محیطی
LIBUSB_DEBUG
را مقداردهی و export کنید (می‌تواند در اسکریپت راه‌اندازی اولیه درایور یا متد سرویس، احتمالاً از طریق
\fBnut.conf\fR(5)
تنظیم و "export" شود)، با یک مقدار عددی مانند
4
(«همه پیام‌ها منتشر می‌شوند»)\&.
.sp
برای جزئیات بیشتر، از جمله مقادیر پشتیبانی‌شده فعلی برای نسخه کتابخانه شما، به عنوان مثال ببینید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://libusb\&.sourceforge\&.io/api\-1\&.0
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
https://libusb\&.sourceforge\&.io/api\-1\&.0/group__libusb__lib\&.html
.RE
.RE
.PP
\fBsubdriver =\fR \fIstring\fR
.RS 4
انتخاب یک زیردرایور سریال روی USB (serial-over-USB)\&. می‌توانید از میان
\fBphoenix\fR،
\fBippon\fR،
\fBcypress\fR
و
\fBkrauler\fR
انتخاب کنید\&. هنگام استفاده از این گزینه، تعیین
\fBvendorid\fR
و
\fBproductid\fR
نیز الزامی است\&.
.RE
.PP
\fBlangid_fix =\fR \fIvalue\fR
.RS 4
اعمال راهکار رفع مشکل شناسه زبان (language ID) روی زیردرایور krauler\&. این گزینه برای کارکرد برخی دستگاه‌ها (مانند LDLC، Dynamix و دیگران) الزامی است\&. شما باید مقدار
\fBvalue\fR
را برابر (0x409 یا 0x4095)، مطابق با ورودی دستگاه خود در لیست سازگاری سخت‌افزار NUT (به اختصار HCL) تعیین کنید\&.
.RE
.SH "دستورات UPS (UPS COMMANDS)"
.sp
این درایور از برخی دستورات آنی پشتیبانی می‌کند (به \fBupscmd\fR(8) مراجعه کنید):
.PP
\fBbeeper\&.toggle\fR
.RS 4
تغییر وضعیت بیپر (هشدار صوتی) UPS\&. (روی برخی سخت‌افزارها در دسترس نیست\&.)
.RE
.PP
\fBload\&.on\fR
.RS 4
روشن کردن بار بلافاصله\&.
.RE
.PP
\fBload\&.off\fR
.RS 4
خاموش کردن بار بلافاصله (به بخش
KNOWN PROBLEMS
مراجعه کنید)\&.
.RE
.PP
\fBshutdown\&.return\fR
.RS 4
قطع بار و برقراری مجدد آن هنگام بازگشت برق\&. از تایمرهای تعریف‌شده توسط
\fBondelay\fR
و
\fBoffdelay\fR
استفاده می‌کند\&.
.RE
.PP
\fBshutdown\&.stayoff\fR
.RS 4
قطع بار و خاموش ماندن آن (به بخش
KNOWN PROBLEMS
مراجعه کنید)\&. از تایمر تعریف‌شده توسط
\fBoffdelay\fR
استفاده می‌کند\&.
.RE
.PP
\fBshutdown\&.stop\fR
.RS 4
توقف فرآیند خاموش شدن در حال انجام\&.
.RE
.PP
\fBtest\&.battery\&.start\&.deep\fR
.RS 4
انجام آزمایش عمیق باتری (روی برخی سخت‌افزارها در دسترس نیست\&.)
.RE
.PP
\fBtest\&.battery\&.start\&.quick\fR
.RS 4
انجام آزمایش سریع باتری (۱۰ ثانیه‌ای)\&.
.RE
.PP
\fBtest\&.battery\&.start\fR \fIvalue\fR
.RS 4
انجام آزمایش باتری به مدت
\fIvalue\fR
دقیقه\&.
.RE
.PP
\fBtest\&.battery\&.stop\fR
.RS 4
توقف آزمایش باتری در حال اجرا (روی برخی سخت‌افزارها در دسترس نیست\&.)
.RE
.SH "تخمین شارژ باتری (BATTERY CHARGE GUESSTIMATION)"
.sp
به دلیل تقاضای عمومی، این درایور یک مقدار تخمینی \fBbattery\&.charge\fR و به‌طور اختیاری \fBbattery\&.runtime\fR را گزارش می‌دهد، به شرطی که چند مورد از آرگومان‌های بخش EXTRA ARGUMENTS که در بالا ذکر شدند را مشخص کرده باشید\&.
.sp
اگر هر دو مقدار \fBbattery\&.voltage\&.high\fR و \fBbattery\&.voltage\&.low\fR را در \fBups.conf\fR(5) مشخص کنید، اما \fBruntimecal\fR را وارد نکنید، وضعیت شارژ را صرفاً با بررسی ولتاژ باتری تخمین می‌زند\&. این روش زیر بار قابل اعتماد نیست، زیرا تنها زمانی مقادیر خوانده‌شده نسبتاً دقیقی به دست می‌دهد که بار را قطع کنید، بگذارید باتری چند دقیقه استراحت کند و سپس ولتاژ مدار باز سلول را اندازه بگیرید\&. این کار در زمانی که برق قطع شده و UPS در حال تأمین انرژی سیستم‌های شما است، اصلاً عملی نیست\&.
.sp
.if n \{\
.RS 4
.\}
.nf
                     battery\&.voltage \- battery\&.voltage\&.low
battery\&.charge =  --------------------------------------------- x 100 %
                  battery\&.voltage\&.high \- battery\&.voltage\&.low
.fi
.if n \{\
.RE
.\}
.sp
راهی برای به دست آوردن مقادیر دقیق‌تر بدون قطع بار وجود دارد، اما این کار مستلزم رهگیری مقدار (و سرعت) جریان ورودی و خروجی به باتری است\&. اگر \fBruntimecal\fR را مشخص کرده باشید، درایور تلاش می‌کند این کار را انجام دهد\&. با این حال توجه داشته باشید که این موضوع به شدت به مقادیری که وارد می‌کنید وابسته است و UPS نیز باید قادر به گزارش میزان بار باشد\&. دستگاه‌های متعددی وجود دارند که در تمام زمان‌ها 0% (یا هر مقدار ثابت دیگری) را گزارش می‌دهند، که در این صورت بدیهی است این روش کار نخواهد کرد\&.
.sp
درایور همچنین راهی برای تعیین افت ظرفیت باتری در طول زمان ندارد، بنابراین خودتان باید این موضوع را مدیریت کنید (با تنظیم مقادیر در \fBruntimecal\fR)\&. همچنین توجه داشته باشید که درایور وضعیت اولیه شارژ را بر اساس ولتاژ باتری حدس می‌زند، بنابراین ممکن است حتی وقتی مطمئن هستید که باتری‌ها پر هستند، مقداری کمتر از 100% باشد\&. اصلاً هیچ راهی برای اندازه‌گیری قابل اعتماد این مورد بین 0 و 100% شارژ کامل وجود ندارد\&.
.sp
این تخمین بهتر از هیچی است (اما نه خیلی بهتر)\&. اگر هر یک از محاسبات فوق مقادیر نادرستی به شما ارائه می‌دهد، به یاد داشته باشید که این شما بوده‌اید که مقادیر را در \fBups.conf\fR(5) وارد کرده‌اید، بنابراین از نویسنده گلایه نکنید\&. اگر به چیزی بهتر نیاز دارید، خرید یک UPS را در نظر بگیرید که خودش \fBbattery\&.charge\fR و \fBbattery\&.runtime\fR را بدون کمک درایور NUT گزارش کند\&.
.SH "نکات برای کاربران قبلی درایورهای MEGATEC (NOTES FOR THE PREVIOUS USER OF MEGATEC DRIVERS)"
.sp
از آنجا که درایورهای blazer جایگزین درایورهای megatec شده‌اند، ممکن است برخی تغییرات در پیکربندی برای کاربرانی که به blazer مهاجرت می‌کنند مورد نیاز باشد\&.
.sp
بخشی از این موضوع شامل گزینه‌های زیر در megatec است که در ups\&.conf باید تغییر یابند:
.PP
\fBbattvolts\fR
.RS 4
باید از
\fIdefault\&.battery\&.voltage\&.high\fR
و
\fIdefault\&.battery\&.voltage\&.low\fR
استفاده کنید\&.
.RE
.PP
\fBdtr and rts\fR
.RS 4
باید از
\fIcablepower\fR
استفاده کنید\&.
.RE
.PP
\fBignoreoff\fR
.RS 4
این پارامتر را می‌توان به سادگی کنار گذاشت، زیرا ناشی از برداشتی نادرست از مشخصات فنی بود\&.
.RE
.SH "مشکلات شناخته‌شده (KNOWN PROBLEMS)"
.sp
برخی از دستورات UPS توسط همه مدل‌ها پشتیبانی نمی‌شوند\&. در بیشتر موارد، زمانی که کاربر تلاش می‌کند فرمانی پشتیبانی‌نشده را اجرا کند، درایور پیامی به گزارش سیستم (system log) ارسال می‌کند\&. متأسفانه برخی مدل‌ها حتی راهی برای بررسی این موضوع توسط درایور فراهم نمی‌کنند، بنابراین دستورات پشتیبانی‌نشده بدون هیچ پیامی با شکست مواجه می‌شوند\&.
.sp
هر دو دستور آنی \fBload\&.off\fR و \fBshutdown\&.stayoff\fR به این منظور در نظر گرفته شده‌اند که بار را به مدت نامحدود قطع کنند\&. با این حال، برخی از مدل‌های UPS اجازه این کار را نمی‌دهند\&.
.sp
برخی مدل‌ها مقداری ساختگی برای وضعیت بیپر گزارش می‌کنند (همیشه \fIenabled\fR یا \fIdisabled\fR خواهد بود)\&. بنابراین، ممکن است به نظر برسد دستور \fBbeeper\&.toggle\fR هیچ تأثیری در وضعیت گزارش‌شده توسط درایور ندارد، در حالی که در واقعیت به خوبی کار می‌کند\&.
.sp
مشخص شده است که مقدار دما و بار در برخی مدل‌ها ساختگی است\&.
.SH "نویسندگان (AUTHORS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Arjen de Korte <adkorte\-guest at alioth\&.debian\&.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Alexander Gordeev <lasaine at lvk\&.cs\&.msu\&.su>
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBblazer_ser\fR(8), \fBnutupsdrv\fR(8), \fBupsc\fR(8), \fBupscmd\fR(8), \fBupsrw\fR(8)
.SS "منابع اینترنتی (Internet Resources):"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحه خانگی NUT (Network UPS Tools):
https://www\&.networkupstools\&.org
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
لیست سازگاری سخت‌افزاری NUT (HCL):
https://www\&.networkupstools\&.org/stable\-hcl\&.html
.RE