MEANWELL_NTU(8) NUT Manual MEANWELL_NTU(8)

meanwell_ntu - درایور اینورترها و یوپی‌اس‌های سری NTU/NTN برند MEAN WELL در NUT

meanwell_ntu -h

meanwell_ntu -a UPS_NAME [OPTIONS]


نکته

این صفحه راهنما ویژگی‌های سخت‌افزاری خاص درایور meanwell_ntu را مستند می‌کند. برای اطلاعات عمومی درباره درایورهای NUT، به nutupsdrv(8) مراجعه کنید.

درایور meanwell_ntu از واحدهای اینورتر/یوپی‌اس سری NTU برند Mean Well که پروتکل سریال اسکی (ASCII) اختصاصی سازنده را پیاده‌سازی کرده‌اند، پشتیبانی می‌کند.

این درایور در حال حاضر آزمایشی است و برای کاربران اولیه در نظر گرفته شده است. با آزمایش مدل‌ها و بازنگری‌های میان‌افزار بیشتر، رفتار و متغیرهای گزارش‌شده ممکن است تکامل یابند.

مشخص شده است که این درایور با مدل‌های NTU زیر کار می‌کند:

•NTU-1200
•NTU-1700
•NTU-2200
•NTU-3200

انواع ولتاژهای DC پشتیبانی‌شده عبارتند از:

•NTU-1200-112, -124, -148
•NTU-1700-112, -124, -148
•NTU-2200-112, -124, -148
•NTU-3200-212, -224, -248

سایر دستگاه‌های سری NTU که از پروتکل یکسانی استفاده می‌کنند نیز ممکن است کار کنند.

ارتباطات از یک اتصال سریال 9600-8-N-1 از طریق RS-232 یا یک مبدل USB به سریال که توسط سیستم‌عامل به عنوان پورت سریال شناخته می‌شود (مانند /dev/ttyUSB0 در لینوکس) استفاده می‌کند.

MEAN WELL p/n: RJ11-RS232

یک کابل سریال مستقیم (straight-through، بدون کنترل مودم) مورد نیاز است.

مبدل‌های USB به RS-232 تا زمانی که یک دستگاه TTY استاندارد ارائه دهند، کار می‌کنند.

پیکربندی درایور از طریق ups.conf(5) انجام می‌شود.

یک پیکربندی حداقلی:

[meanwell-ntu]
    driver = meanwell_ntu
    port   = /dev/ttyUSB0
    desc   = "Mean Well NTU-1200-124"

نمونه پارامترهای استاندارد:

driver

باید روی meanwell_ntu تنظیم شود.

port

دستگاه tty سریال/USB (مانند /dev/ttyS0, /dev/ttyUSB0).

این درایور در حال حاضر فقط به پارامترهای استاندارد NUT متکی است:

pollinterval

فاصله زمانی بین نظرسنجی‌های وضعیت (پیش‌فرض: ۲ ثانیه).

synchronous

حالت ورودی/خروجی سریال همان‌طور که در nutupsdrv(8) مستند شده است.

دستورات آنی زیر در صورتی که سخت‌افزار متصل آن‌ها را پیاده‌سازی کرده باشد پشتیبانی می‌شوند (به upscmd(8) مراجعه کنید):

load.off

درخواست خاموش کردن خروجی اینورتر و قطع برق بار (دستور سازنده C100000000000000).

load.on

درخواست روشن کردن خروجی اینورتر (دستور سازنده C010000000000000).

پشتیبانی در میان بازنگری‌های مختلف میان‌افزار متفاوت است؛ پیش از اتکا به آن‌ها تست کنید.

درایور به طور منظم دستورات Q (وضعیت) و I (اطلاعات) را ارسال کرده و فیلدهای آن‌ها را به متغیرهای استاندارد NUT نگاشت می‌کند.

battery.voltage

ولتاژ باتری/باس DC (بر حسب V).

battery.charge

ظرفیت باقی‌مانده (٪).

battery.alarm.voltage

آستانه هشدار ولتاژ پایین (V).

battery.shutdown.voltage

آستانه خاموشی به دلیل ولتاژ پایین (V).

input.voltage

ولتاژ برق شهر AC ورودی (در حالت خط یا بای‌پاس غیر صفر است).

output.voltage

ولتاژ خروجی اینورتر (V).

output.frequency

فرکانس خروجی هنگام کار روی باتری (Hz).

ups.temperature

دمای اینورتر (°C).

ups.load

درصد تقریبی بار، به‌دست‌آمده از بیت‌های PPP.

device.mfr

رشته نام سازنده (معمولاً MEANWELL).

device.model, ups.model

توصیف‌گر مدل (مانند NTU-1200-124).

device.serial

شماره سریال در صورت گزارش شدن.

device.firmware

رشته نسخه میان‌افزار.

پروتکل NTU یک کلمه وضعیت ۱۹ بیتی را ارائه می‌دهد.

درایور بیت‌های منتخب را به کلمات کلیدی ups.status نگاشت می‌کند:

OB

روی باتری / حالت اینورتر (On battery).

BYPASS

حالت بای‌پاس فعال است.

OL

برق شهر متصل است / آنلاین (Online).

LB

باتری ضعیف است (Battery low).

OVER

وضعیت دمای بیش از حد مجاز (Over-temperature).

فیلدهای بیتی خام همچنین به عنوان متغیرهای اطلاعاتی مانند battery.low، utility.present، bypass.mode، overtemp و غیره صادر می‌شوند.

این درایور به عنوان آزمایشی علامت‌گذاری شده است:

•تفسیر پروتکل بر اساس نمونه‌های آزمایشی محدودی صورت گرفته است.
•برخی از فیلدها در پاسخ‌های Q/I در حال حاضر استفاده نمی‌شوند.
•گزارش‌دهی بار و ظرفیت ممکن است با آزمایش‌های بیشتر پالایش شود.
•رفتار خاموشی و راه‌اندازی مجدد در حد پایه‌ای است و ممکن است با تمام منطق مسیر برق در NUT سازگار نباشد.

برای اشکال‌زدایی، درایور را با سطح پرگویی (verbosity) بالا اجرا کنید، مانند:

/usr/local/ups/bin/meanwell_ntu -DDDDD -a meanwell-ntu

لطفاً هنگام گزارش مشکلات، جزئیات مدل، نسخه میان‌افزار و حالت عملکرد را درج نمایید.

توجه داشته باشید که پروتکل در ظاهر شبیه به Megatec Qx به نظر می‌رسد، اما تفاوت‌های آن به اندازه‌ای است که وجود یک درایور جداگانه را توجیه کند و نه اینکه به عنوان زیردرایوری از مثلاً nutdrv_qx(8) باشد.

درایور meanwell_ntu توسط Jonathan Hite ارائه شده است.

بهبودهای بیشتر ممکن است توسط جامعه NUT ارائه شود. برای تاریخچه بازنگری به مخزن پروژه مراجعه کنید.

ups.conf(5), nutupsdrv(8), upsd(8), upsmon(8), upsc(8), upscmd(8)

•صفحه اصلی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5
06/21/2026 Network UPS Tools 2.8.5