MEANWELL_NTU(8)                   NUT Manual                   MEANWELL_NTU(8)

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

خلاصه دستور (SYNOPSIS)
       meanwell_ntu -h

       meanwell_ntu -a UPS_NAME [OPTIONS]

           نکته

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

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

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

سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)
       مشخص شده است که این درایور با مدل‌های 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 در لینوکس) استفاده می‌کند.

کابل‌ها (CABLES)
       MEAN WELL p/n: RJ11-RS232

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

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

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

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

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

   پارامترهای الزامی (Required parameters)
       نمونه پارامترهای استاندارد:

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

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

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

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

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

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

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

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

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

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

   متغیرهای فقط‌خواندنی منتخب (Selected read-only variables)
       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
           رشته نسخه میان‌افزار.

   فلگ‌های وضعیت یوپی‌اس (UPS status flags)
       پروتکل NTU یک کلمه وضعیت ۱۹ بیتی را ارائه می‌دهد.

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

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

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

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

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

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

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

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

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

       •   برخی از فیلدها در پاسخ‌های Q/I در حال حاضر استفاده نمی‌شوند.

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

       •   رفتار خاموشی و راه‌اندازی مجدد در حد پایه‌ای است و ممکن است با تمام
           منطق مسیر برق در NUT سازگار نباشد.

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

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

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

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

نویسنده (AUTHOR)
       درایور meanwell_ntu توسط Jonathan Hite ارائه شده است.

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

همچنین ببینید (SEE ALSO)
       ups.conf(5), nutupsdrv(8), upsd(8), upsmon(8), upsc(8), upscmd(8)

   منابع اینترنتی (Internet resources):
       •   صفحه اصلی NUT (Network UPS Tools):
           https://www.networkupstools.org/historic/v2.8.5

       •   مستندات سازنده: https://www.meanwell.com/Upload/PDF/NTS,NTU-E.pdf

Network UPS Tools 2.8.5           06/21/2026                   MEANWELL_NTU(8)