'\" t
.\"     Title: meanwell_ntu
.\"    Author: [see the "AUTHOR" 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 "MEANWELL_NTU" "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)"
meanwell_ntu \- درایور اینورترها و یوپی‌اس‌های سری NTU/NTN برند MEAN WELL در NUT
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBmeanwell_ntu\fR \-h
.sp
\fBmeanwell_ntu\fR \-a \fIUPS_NAME\fR [\fIOPTIONS\fR]
.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
این صفحه راهنما ویژگی‌های سخت‌افزاری خاص درایور \fBmeanwell_ntu\fR را مستند می‌کند\&. برای اطلاعات عمومی درباره درایورهای NUT، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.sp .5v
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
درایور \fBmeanwell_ntu\fR از واحدهای اینورتر/یوپی‌اس سری NTU برند Mean Well که پروتکل سریال اسکی (ASCII) اختصاصی سازنده را پیاده‌سازی کرده‌اند، پشتیبانی می‌کند\&.
.sp
این درایور در حال حاضر آزمایشی است و برای کاربران اولیه در نظر گرفته شده است\&. با آزمایش مدل‌ها و بازنگری‌های میان‌افزار بیشتر، رفتار و متغیرهای گزارش‌شده ممکن است تکامل یابند\&.
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
مشخص شده است که این درایور با مدل‌های NTU زیر کار می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NTU\-1200
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NTU\-1700
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NTU\-2200
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NTU\-3200
.RE
.sp
انواع ولتاژهای DC پشتیبانی‌شده عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NTU\-1200\-112, \-124, \-148
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NTU\-1700\-112, \-124, \-148
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NTU\-2200\-112, \-124, \-148
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NTU\-3200\-212, \-224, \-248
.RE
.sp
سایر دستگاه‌های سری NTU که از پروتکل یکسانی استفاده می‌کنند نیز ممکن است کار کنند\&.
.sp
ارتباطات از یک اتصال سریال 9600\-8\-N\-1 از طریق RS\-232 یا یک مبدل USB به سریال که توسط سیستم‌عامل به عنوان پورت سریال شناخته می‌شود (مانند /dev/ttyUSB0 در لینوکس) استفاده می‌کند\&.
.SH "کابل‌ها (CABLES)"
.sp
MEAN WELL p/n: RJ11\-RS232
.sp
یک کابل سریال مستقیم (straight\-through، بدون کنترل مودم) مورد نیاز است\&.
.sp
مبدل‌های USB به RS\-232 تا زمانی که یک دستگاه TTY استاندارد ارائه دهند، کار می‌کنند\&.
.SH "پیکربندی (CONFIGURATION)"
.sp
پیکربندی درایور از طریق \fBups.conf\fR(5) انجام می‌شود\&.
.sp
یک پیکربندی حداقلی:
.sp
.if n \{\
.RS 4
.\}
.nf
[meanwell\-ntu]
    driver = meanwell_ntu
    port   = /dev/ttyUSB0
    desc   = "Mean Well NTU\-1200\-124"
.fi
.if n \{\
.RE
.\}
.SS "پارامترهای الزامی (Required parameters)"
.sp
نمونه پارامترهای استاندارد:
.PP
\fBdriver\fR
.RS 4
باید روی
meanwell_ntu
تنظیم شود\&.
.RE
.PP
\fBport\fR
.RS 4
دستگاه tty سریال/USB (مانند
/dev/ttyS0,
/dev/ttyUSB0)\&.
.RE
.SS "پارامترهای اختیاری (Optional parameters)"
.sp
این درایور در حال حاضر فقط به پارامترهای استاندارد NUT متکی است:
.PP
\fBpollinterval\fR
.RS 4
فاصله زمانی بین نظرسنجی‌های وضعیت (پیش‌فرض: ۲ ثانیه)\&.
.RE
.PP
\fBsynchronous\fR
.RS 4
حالت ورودی/خروجی سریال همان‌طور که در
\fBnutupsdrv\fR(8)
مستند شده است\&.
.RE
.SH "دستورات آنی (INSTANT COMMANDS)"
.sp
دستورات آنی زیر در صورتی که سخت‌افزار متصل آن‌ها را پیاده‌سازی کرده باشد پشتیبانی می‌شوند (به \fBupscmd\fR(8) مراجعه کنید):
.PP
\fBload\&.off\fR
.RS 4
درخواست خاموش کردن خروجی اینورتر و قطع برق بار (دستور سازنده
C100000000000000)\&.
.RE
.PP
\fBload\&.on\fR
.RS 4
درخواست روشن کردن خروجی اینورتر (دستور سازنده
C010000000000000)\&.
.RE
.sp
پشتیبانی در میان بازنگری‌های مختلف میان‌افزار متفاوت است؛ پیش از اتکا به آن‌ها تست کنید\&.
.SH "وضعیت و متغیرها (STATUS AND VARIABLES)"
.sp
درایور به طور منظم دستورات Q (وضعیت) و I (اطلاعات) را ارسال کرده و فیلدهای آن‌ها را به متغیرهای استاندارد NUT نگاشت می‌کند\&.
.SS "متغیرهای فقط‌خواندنی منتخب (Selected read\-only variables)"
.PP
\fBbattery\&.voltage\fR
.RS 4
ولتاژ باتری/باس DC (بر حسب V)\&.
.RE
.PP
\fBbattery\&.charge\fR
.RS 4
ظرفیت باقی‌مانده (٪)\&.
.RE
.PP
\fBbattery\&.alarm\&.voltage\fR
.RS 4
آستانه هشدار ولتاژ پایین (V)\&.
.RE
.PP
\fBbattery\&.shutdown\&.voltage\fR
.RS 4
آستانه خاموشی به دلیل ولتاژ پایین (V)\&.
.RE
.PP
\fBinput\&.voltage\fR
.RS 4
ولتاژ برق شهر AC ورودی (در حالت خط یا بای‌پاس غیر صفر است)\&.
.RE
.PP
\fBoutput\&.voltage\fR
.RS 4
ولتاژ خروجی اینورتر (V)\&.
.RE
.PP
\fBoutput\&.frequency\fR
.RS 4
فرکانس خروجی هنگام کار روی باتری (Hz)\&.
.RE
.PP
\fBups\&.temperature\fR
.RS 4
دمای اینورتر (\(deC)\&.
.RE
.PP
\fBups\&.load\fR
.RS 4
درصد تقریبی بار، به‌دست‌آمده از بیت‌های PPP\&.
.RE
.PP
\fBdevice\&.mfr\fR
.RS 4
رشته نام سازنده (معمولاً
MEANWELL)\&.
.RE
.PP
\fBdevice\&.model\fR, \fBups\&.model\fR
.RS 4
توصیف‌گر مدل (مانند
NTU\-1200\-124)\&.
.RE
.PP
\fBdevice\&.serial\fR
.RS 4
شماره سریال در صورت گزارش شدن\&.
.RE
.PP
\fBdevice\&.firmware\fR
.RS 4
رشته نسخه میان‌افزار\&.
.RE
.SS "فلگ‌های وضعیت یوپی‌اس (UPS status flags)"
.sp
پروتکل NTU یک کلمه وضعیت ۱۹ بیتی را ارائه می‌دهد\&.
.sp
درایور بیت‌های منتخب را به کلمات کلیدی ups\&.status نگاشت می‌کند:
.PP
\fBOB\fR
.RS 4
روی باتری / حالت اینورتر (On battery)\&.
.RE
.PP
\fBBYPASS\fR
.RS 4
حالت بای‌پاس فعال است\&.
.RE
.PP
\fBOL\fR
.RS 4
برق شهر متصل است / آنلاین (Online)\&.
.RE
.PP
\fBLB\fR
.RS 4
باتری ضعیف است (Battery low)\&.
.RE
.PP
\fBOVER\fR
.RS 4
وضعیت دمای بیش از حد مجاز (Over\-temperature)\&.
.RE
.sp
فیلدهای بیتی خام همچنین به عنوان متغیرهای اطلاعاتی مانند \fBbattery\&.low\fR، \fButility\&.present\fR، \fBbypass\&.mode\fR، \fBovertemp\fR و غیره صادر می‌شوند\&.
.SH "محدودیت‌ها (LIMITATIONS)"
.sp
این درایور به عنوان آزمایشی علامت‌گذاری شده است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تفسیر پروتکل بر اساس نمونه‌های آزمایشی محدودی صورت گرفته است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
برخی از فیلدها در پاسخ‌های
Q/I
در حال حاضر استفاده نمی‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
گزارش‌دهی بار و ظرفیت ممکن است با آزمایش‌های بیشتر پالایش شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
رفتار خاموشی و راه‌اندازی مجدد در حد پایه‌ای است و ممکن است با تمام منطق مسیر برق در NUT سازگار نباشد\&.
.RE
.sp
برای اشکال‌زدایی، درایور را با سطح پرگویی (verbosity) بالا اجرا کنید، مانند:
.sp
.if n \{\
.RS 4
.\}
.nf
/usr/local/ups/bin/meanwell_ntu \-DDDDD \-a meanwell\-ntu
.fi
.if n \{\
.RE
.\}
.sp
لطفاً هنگام گزارش مشکلات، جزئیات مدل، نسخه میان‌افزار و حالت عملکرد را درج نمایید\&.
.SH "پیاده‌سازی (IMPLEMENTATION)"
.sp
توجه داشته باشید که پروتکل در ظاهر شبیه به Megatec Qx به نظر می‌رسد، اما تفاوت‌های آن به اندازه‌ای است که وجود یک درایور جداگانه را توجیه کند و نه اینکه به عنوان زیردرایوری از مثلاً \fBnutdrv_qx\fR(8) باشد\&.
.SH "نویسنده (AUTHOR)"
.sp
درایور \fBmeanwell_ntu\fR توسط Jonathan Hite ارائه شده است\&.
.sp
بهبودهای بیشتر ممکن است توسط جامعه NUT ارائه شود\&. برای تاریخچه بازنگری به مخزن پروژه مراجعه کنید\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBups.conf\fR(5), \fBnutupsdrv\fR(8), \fBupsd\fR(8), \fBupsmon\fR(8), \fBupsc\fR(8), \fBupscmd\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/historic/v2\&.8\&.5
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مستندات سازنده:
https://www\&.meanwell\&.com/Upload/PDF/NTS,NTU\-E\&.pdf
.RE