'\" t
.\"     Title: blazer_ser
.\"    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_SER" "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_ser \- درایور برای تجهیزات UPS مبتنی بر پورت سریال با پروتکل Megatec/Q1
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBblazer_ser\fR \-h
.sp
\fBblazer_ser\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 "فقط رابط سریال (SERIAL INTERFACE ONLY)"
.PP
\fBcablepower =\fR \fIstring\fR
.RS 4
به‌طور پیش‌فرض درایور DTR را تنظیم (set) و RTS را پاک (clear) می‌کند (\fInormal\fR)\&. اگر متوجه شدید که UPS شما شناسایی نمی‌شود یا ارتباط با UPS غیرقابل اعتماد است، می‌توانید بررسی کنید که آیا پاک کردن DTR و تنظیم RTS (\fIreverse\fR)، تنظیم هم‌زمان DTR و RTS (\fIboth\fR) یا پاک کردن DTR و RTS (\fInone\fR) این وضعیت را بهبود می‌بخشد یا خیر\&.
.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_usb\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