HUAWEI-UPS2000(8) NUT Manual HUAWEI-UPS2000(8)

huawei-ups2000 - درایور یوپی‌اس‌های سری UPS2000 هواوی (1kVA-3kVA) با اتصال مودباس USB یا سریال RS-232

huawei-ups2000 -h

huawei-ups2000 -a DEVICE_NAME [OPTIONS]


نکته

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

این درایور از یوپی‌اس‌های آنلاین (تبدیل دوگانه) سری UPS2000 هواوی با مشخصات زیر پشتیبانی می‌کند.

1.توان خروجی: ۱ کیلوولت‌آمپر تا ۳ کیلوولت‌آمپر (مدل‌های با توان بالاتر پشتیبانی نمی‌شوند).
2.اتصال: USB یا RS-232 (مسائل مربوط به سازگاری درایور وجود دارد، بخش کابل‌کشی (CABLING) را به دقت مطالعه کنید).
•اتصال USB: برای اکثر مدل‌ها هسته لینوکس 5.12 یا جدیدتر مورد نیاز است؛ ویندوز نیز به درایور پورت سریال اضافی نیاز دارد. برای سایر سیستم‌های شبه‌یونیکس ناسازگاری درایور وجود دارد و باید از RS-232 استفاده شود.
•اتصال RS-232: همیشه و در همه جا پشتیبانی می‌شود.
•اتصال RS-485: آزمایش نشده است؛ نیازمند آزمایش توسط کاربران.
3.سیستم‌عامل: یونیکس/لینوکس به طور پیش‌فرض پشتیبانی می‌شوند؛ ویندوز به NUT نسخه 2.8.5 یا جدیدتر نیاز دارد.

سری UPS2000 دو مدل کلی دارد: UPS2000-A با شاسی ایستاده (tower) و UPS2000-G با شاسی رکمونت (rack-mount). در هر یک از این دو مدل، دو زیرمدل وجود دارد: مدل با زمان کارکرد استاندارد مجهز به بسته باتری داخلی با پسوند "S"، و مدل با زمان کارکرد طولانی متصل به بسته باتری خارجی با پسوند "L".

تمامی این مدل‌ها باید به یک اندازه پشتیبانی شوند؛ در حال حاضر درایور روی مدل‌های زیر آزمایش شده است:

•UPS2000-A-1KTTS (firmware: UPS2000A, V2R1C1SPC40, P1.0-D1.0)
•UPS2000-A-1KTTS (firmware: UPS2000A, V2R1C1SPC50, P1.0-D1.0)
•UPS2000-A-2KTTS (firmware: UPS2000A, V2R1C1SPC50, P1.0-D1.0)
•UPS2000-G-1KRTS (firmware: UPS2000A, V2R1C1SPC40, P1.0-D1.0)
•UPS2000-G-1KRTS (firmware: UPS2000G, V2R1C1SPC50, P1.0-D1.0)
•UPS2000-G-3KRTS (firmware: UPS2000A, V2R1C1SPC40, P1.0-D1.0)
•UPS2000-G-3KRTS (firmware: UPS2000G, V2R1C1SPC50, P1.0-D1.0)
•UPS2000-G-3KRTL (firmware: UPS2000A, V2R1C1SPC40, P1.0-D1.0)

اگر مدل دستگاه شما در این فهرست نیست، از شما تقاضا می‌شود نتایج موفق یا ناموفق خود را به سیستم ردیابی باگ یا فهرست پستی گزارش دهید. حتماً شماره مدل کامل یوپی‌اس خود را به صورت دستی در گزارش قید کنید، زیرا بسیاری از دستگاه‌ها صرف‌نظر از مدل واقعی‌شان (حتی سری G) خود را به عنوان "UPS2000-A" معرفی می‌کنند.

از سال ۲۰۲۲، یک مدل سخت‌افزاری جدید نیز با تراشه مبدل سریال به یواس‌بی WCH CH341 به جای تراشه MaxLinear/Exar RX21V1410 عرضه شده که خود را "UPS2000G" معرفی می‌کند. پشتیبانی درایور از نسخه v0.03 به آن افزوده شده است.

درایور huawei-ups2000 برای پیاده‌سازی Modbus از پروژه libmodbus استفاده می‌کند.

یوپی‌اس دارای یک پورت USB و یک پورت RS-232 است. اتصال USB بسته به وجود درایور سخت‌افزاری به صورت مشروط پشتیبانی می‌شود. اتصال RS-232 همیشه در تمام سیستم‌های عامل پشتیبانی می‌شود و می‌تواند به عنوان راهکار پشتیبان به کار رود.

در اکثر مدل‌ها، اتصال USB از تراشه مبدل سریال Exar/MaxLinear RX21V1410 استفاده می‌کند. در لینوکس، این تراشه تنها در نسخه 5.12 و بالاتر از طریق ماژول هسته xr_serial قابل استفاده است. در ویندوز نیز نصب درایور سخت‌افزاری اضافی پیشنهاد می‌شود. در برخی مدل‌های جدیدتر از تراشه WCH CH341 استفاده شده که سازگاری بهتری دارد (از طریق ماژول هسته لینوکس ch341 یا Windows Update). برای جزئیات به زیربخش‌های Linux USB و Windows USB مراجعه کنید.

در هر زمان تنها از یک پورت می‌توان استفاده کرد. هنگامی که از USB استفاده می‌شود باید کابل RS-232 از دستگاه جدا باشد و برعکس. همچنین کارت‌های جانبی مانند RS-485 یا SNMP پشتیبانی نمی‌شوند و باید از یوپی‌اس خارج گردند.

از آنجا که پورت یوپی‌اس در شرایط خاصی ممکن است پاسخگو نباشد، اکیداً توصیه می‌شود پس از هرگونه تغییر در کابل‌کشی، به‌ویژه پس از تغییر نوع پورت، یوپی‌اس را خاموش و روشن (power cycle) کنید: خروجی برق یوپی‌اس را از طریق پنل جلو قطع کرده، سپس دوشاخه ورودی برق شهر را بکشید؛ منتظر بمانید تا صفحه LCD کاملاً خاموش شود و سپس برق را وصل کرده و یوپی‌اس را روشن کنید.

پورت USB روی UPS2000 در اصل مجهز به تراشه مبدل MaxLinear/Exar RX21V1410 است که تنها در لینوکس 5.12 یا جدیدتر از طریق ماژول xr_serial پشتیبانی می‌شود. گزارش lsusb آن به صورت زیر است:

04e2:1410 Exar Corp. XR21V1410 USB-UART IC

با این حال در مدل‌های سخت‌افزاری جدیدتر از تراشه سریال WCH CH341 استفاده شده است:

1a86:5523 QinHeng Electronics CH341 in serial mode, usb to serial port converter

اگر دستگاه شما مجهز به تراشه WCH CH341 باشد (احتمالاً در دستگاه‌های تولید پس از ۲۰۲۲)، هنگام اتصال از طریق USB پیام‌های زیر را در dmesg مشاهده خواهید کرد:

ch341 2-1.2:1.0: ch341-uart converter detected
usb 2-1.2: ch341-uart converter now attached to ttyUSB0

در این صورت می‌توانید بدون نگرانی از سازگاری هسته به کار خود ادامه دهید. این تراشه سال‌هاست که در بازار وجود دارد و باید با سیستم شما کاملاً سازگار باشد.

از سوی دیگر، اگر دستگاه شما مانند اکثر کاربران دارای تراشه MaxLinear/Exar XR21V1410 باشد، در اتصال به یک سیستم لینوکس پشتیبانی‌شده لاگ‌های زیر در dmesg نمایش داده می‌شود:

xr_serial 1-1.2:1.1: xr_serial converter detected
usb 1-1.2: xr_serial converter now attached to ttyUSB0

درایور حتماً باید xr_serial باشد. اگر سیستم شما فاقد این درایور باشد، این پیام را به جای آن دریافت خواهید کرد:

cdc_acm 1-1.2:1.0: ttyACM0: USB ACM device

درایور عمومی cdc_acm ناسازگار است و نمی‌توان از آن استفاده کرد. باید هسته لینوکس خود را به 5.12 یا جدیدتر ارتقا دهید.


هشدار

در یک سیستم پشتیبانی‌نشده، دستگاه USB مدل XR21V1410 ممکن است همچنان به عنوان یک دستگاه USB ACM شناسایی شود، اما برقراری ارتباط با آن غیرممکن است؛ لطفاً وقت خود را با cdc_acm هدر ندهید.

اگر در حال حاضر هسته لینوکس 5.12 یا جدیدتر دارید اما درایور xr_serial را مشاهده نمی‌کنید، به این معناست که درایور در هسته شما فعال نشده است. از نگه‌دارندگان توزیع لینوکس خود بخواهید گزینه CONFIG_USB_SERIAL_XR را در هسته فعال کنند.

هنگامی که امکان ارتقای هسته لینوکس وجود ندارد، یا زمانی که از سیستم‌عامل دیگری (مانند FreeBSD) استفاده می‌کنید، باید از پورت RS-232 استفاده شود.

سرویس Windows Update باید درایور مناسب را به صورت خودکار نصب کند، با این حال در صورت شکست این فرایند ممکن است نیاز به مداخله دستی باشد.

MaxLinear/Exar RX21V1410

برای مدل‌های مجهز به تراشه مبدل MaxLinear/Exar RX21V1410، ممکن است به یک درایور سخت‌افزاری اضافی نیاز باشد.

طبق راهنمای رسمی، از کاربران خواسته شده درایور خاصی موسوم به XR21x141x-XP2KVista7-DriversOnly-Vers1.7.0.0 را نصب کنند. به راهنمای توسعه پروتکل مدباس یوپی‌اس ۲۰۰۰ هواوی مراجعه کنید.

همچنین می‌توانید جدیدترین درایور را از صفحه محصول MaxLinear XR21V1410 در وب دانلود کنید. در زمان نگارش، جدیدترین درایور XR21x_Win10_V2.7.0.0.zip نام دارد.

WCH CH341

برای مدل‌های مجهز به تراشه مبدل WCH CH341، ممکن است به درایور اضافی نیاز باشد.

در زمان نگارش، جدیدترین درایور به نام CH341SER.EXE در وب‌سایت رسمی WCH در دسترس است. یک فایل فشرده به نام CH341SER.ZIP نیز برای نصب دستی از طریق Device Manager وجود دارد.

اتصال RS-232 در تمام سیستم‌های عامل پشتیبانی می‌شود، چه از طریق پورت سریال تعبیه‌شده روی مادربورد و چه با استفاده از مبدل خارجی USB به RS-232. در صورت استفاده از مبدل، مطمئن شوید سیستم‌عامل شما از آن پشتیبانی می‌کند.

پشتیبانی از RS-485 در UPS2000 با استفاده از کارت آداپتور اختیاری فراهم می‌شود. این درایور روی RS-485 آزمایش نشده است، اما به نظر می‌رسد از همان پروتکل سریال RS-232 استفاده می‌کند و باید پشتیبانی شود.

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

configure --with-serial=yes --with-modbus=yes

همچنین باید مجوزهای مناسب خواندن/نوشتن (R/W) را روی فایل دستگاه سریال محلی تنظیم کنید تا کاربر اجرای درایور NUT امکان دسترسی به آن را داشته باشد.

برای نمونه، یک مبدل یواس‌بی به سریال می‌تواند به صورت /dev/ttyACM0 یا /dev/ttyUSB0 در لینوکس یا /dev/ttyU0 در FreeBSD شناسایی شود. پورت سریال داخلی به صورت /dev/ttyS0 در لینوکس یا نام‌هایی مانند /dev/cua* در FreeBSD مشخص می‌شود.

این درایور از تنظیمات اختیاری زیر در فایل ups.conf(5) پشتیبانی می‌کند:

offdelay=value

مدت زمان انتظار پیش از خاموش کردن یوپی‌اس (به ثانیه)؛ محدوده مجاز از ۶ ثانیه (۰٫۱ دقیقه) تا ۵۹۴۰ ثانیه (۹۹ دقیقه) است. مقدار پیش‌فرض ۶۰ ثانیه می‌باشد. باید مضربی از ۶ ثانیه باشد. برای اطمینان از اینکه سیستم زمان کافی برای خاموش شدن پس از قطع برق دارد، تنظیم offdelay شدیداً توصیه می‌شود.

rebootdelay=value

مدت زمان انتظار پیش از راه‌اندازی مجدد یوپی‌اس (به ثانیه)؛ محدوده مجاز از ۶ ثانیه تا ۵۹۴۰ ثانیه است. مقدار پیش‌فرض ۶۰ ثانیه و مضربی از ۶ ثانیه است. این گزینه توسط دستور فوری shutdown.reboot.graceful استفاده می‌شود. در صورت تنظیم offdelay، باید rebootdelay را نیز متناسب با آن تنظیم کنید.

ondelay=value

مدت زمان انتظار پیش از روشن کردن مجدد خروجی یوپی‌اس (به ثانیه)؛ محدوده مجاز از ۶۰ ثانیه (۱ دقیقه) تا ۵۹۴۰ ثانیه است. مقدار پیش‌فرض ۶۰ ثانیه و باید مضربی از ۶۰ ثانیه باشد (نه ۶ ثانیه). نیازی به تغییر این مقدار نیست مگر اینکه الزام خاصی داشته باشید.

نکته

به دلیل محدودیت‌های سخت‌افزاری، در این درایور مقدار ondelay تنها زمانی اعمال می‌شود که برق شهری متصل باشد. اگر قطعی برق رخ داده باشد، یوپی‌اس و بار متصل به محض وصل مجدد برق شهر بلافاصله روشن می‌شوند.

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

shutdown.stayoff

پس از سپری شدن زمان offdelay، بار مصرفی را خاموش می‌کند. با وصل مجدد برق شهری، خروجی همچنان خاموش می‌ماند.

shutdown.return

پس از سپری شدن زمان offdelay، بار مصرفی را خاموش می‌کند. با وصل مجدد برق شهر، بار متصل روشن می‌شود (احتمالاً پس از سپری شدن ondelay).

نکته

به طور معمول بار مصرفی به محض وصل مجدد برق روشن می‌شود. اما اگر برق هرگز قطع نشود یا به صورت غیرمنتظره در حین فرایند خاموش‌سازی وصل شود، بار پس از سپری شدن ondelay روشن می‌گردد. بنابراین دستگاه UPS2000 از شرایط رقابت قطع و وصل برق آسیبی ندیده و روشن شدن بار تضمین می‌شود.

shutdown.reboot

مشابه shutdown.return، با این تفاوت که بار فوراً خاموش می‌شود (۶ ثانیه در این پیاده‌سازی).

shutdown.reboot.graceful

مشابه shutdown.return، با این تفاوت که بار پس از یک rebootdelay خاموش می‌شود، نه پس از offdelay.

beeper.enable

فعال‌سازی بوق هشدار (beeper) یوپی‌اس.

beeper.disable

غیرفعال‌سازی بوق هشدار یوپی‌اس.

beeper.toggle

تغییر وضعیت بوق هشدار یوپی‌اس (روشن/خاموش).

bypass.start

قرار دادن یوپی‌اس در حالت بای‌پس (Bypass). با احتیاط استفاده کنید؛ زیرا تجهیزات شما را مستقیماً به برق تنظیم‌نشده شهری متصل کرده و هیچ حفاظتی در برابر قطع برق فراهم نمی‌کند. در حالت بای‌پس، یوپی‌اس هر ۱۰ ثانیه یک بار بوق هشدار می‌زند.

نکته

درایور دارای سازوکار حفاظتی پایه است. اگر ورودی بای‌پس به دلیل قطعی برق غیرعادی باشد، درایور از ورود به حالت بای‌پس امتناع کرده و دستور را لغو می‌کند. با این حال پس از ورود به بای‌پس حفاظتی وجود ندارد.

bypass.stop

خارج کردن یوپی‌اس از حالت بای‌پس.

load.on

روشن کردن فوری بار مصرفی خروجی.

load.off

خاموش کردن فوری بار خروجی. با احتیاط فراوان استفاده کنید، زیرا برق تمام تجهیزات متصل بلافاصله قطع خواهد شد.

test.battery.start.quick

اجرای آزمون سریع و کوتاه‌مدت باتری.

test.battery.start.deep

اجرای آزمون عمیق و طولانی‌مدت باتری.

test.battery.stop

متوقف کردن آزمون در حال اجرای باتری.

این درایور از چندین متغیر قابل نوشتن در زمان اجرا پشتیبانی می‌کند (به upsrw(8) مراجعه کنید):

ups.beeper.status

فعال یا غیرفعال کردن بوق هشدار یوپی‌اس، مقادیر disabled یا enabled.

نکته

بوق را تنها می‌توان به طور کامل غیرفعال کرد و امکان بی‌صدا کردن موقت تا هشدار بعدی وجود ندارد، هرچند مقدار muted نیز برای راحتی به عنوان نام مستعار disabled پذیرفته می‌شود.

ups.delay.shutdown

ثانیه‌های انتظار پس از دستور خاموش‌سازی با تأخیر. معادل زمان اجرای offdelay است.

ups.delay.reboot

ثانیه‌های انتظار پیش از راه‌اندازی مجدد یوپی‌اس. معادل زمان اجرای rebootdelay است.

ups.delay.start

ثانیه‌های انتظار پیش از راه‌اندازی مجدد بار. معادل زمان اجرای ondelay است.

درایور نسخه 0.03 (در NUT 2.8.1) پشتیبانی از UPS2000G با رابط USB به سریال WCH CH341 را اضافه کرد؛ این مدل‌ها پیش از این پشتیبانی نمی‌شدند.

درایور نسخه 0.04 (در NUT 2.8.1) باگ بازیابی پس از اتمام مهلت زمانی را که منجر به خطاهای مکرر در خواندن و توقف دائمی داده‌ها می‌شد برطرف کرد.

درایور نسخه 0.12 (در NUT 2.8.5) پشتیبانی از مایکروسافت ویندوز را که پیش از این به دلیل خطای قفل فایل کار نمی‌کرد اصلاح نمود.

این خطا معمولاً بی‌خطر است و می‌توان آن را نادیده گرفت. تنها برای مقاصد اطلاع‌رسانی (LOG_INFO) ثبت می‌شود و هشدار یا خطا نیست.

در شرایط خاصی ممکن است برخی ثبات‌ها مقادیر نامعتبر برگردانده و خطای "data stale" ایجاد کنند. در صورت بروز، پیام‌های خطایی مشابه زیر در گزارش سیستم مشاهده خواهید کرد:

huawei-ups2000: register 2002 has invalid value a000,
upsd: Data for UPS [huawei] is stale - check driver
upsd: UPS [huawei] data is no longer stale

تاکنون تمامی مشکلات شناخته‌شده توسط مؤلف برطرف شده است. در صورت مواجهه با این مشکل، لطفاً گزارش باگ همراه با گزارش‌های کامل ارسال فرمایید.

پیش از عیب‌یابی، حتماً گزارش dmesg را برای رویدادهای قطع و وصل USB بررسی کنید تا از اتلاف وقت در بررسی درایور NUT در حالی که مشکل اصلی از درگاه USB است جلوگیری شود.

ارسال برخی دستورات معیوب پورت سریال (شامل USB که یک دستگاه USB به سریال است) را قفل می‌کند. در این حالت یوپی‌اس تمام ارتباطات سریال را قطع کرده و کاملاً بی‌پاسخ می‌شود.

برای بازیابی، کافی است یوپی‌اس را خاموش و روشن کنید: خروجی را از پنل جلو قطع کنید، کابل برق شهر را جدا نمایید، صبر کنید تا صفحه LCD خاموش شود و سپس برق را متصل و دستگاه را روشن کنید.

همان‌طور که گفته شد، تنها پورت RS-232 روی تمام سیستم‌ها پشتیبانی می‌شود. اکثر دستگاه‌ها دارای تراشه RX21V1410 هستند که نیازمند درایور اختصاصی xr_serial در هسته لینوکس 5.12 و جدیدتر است.

در سیستم‌های پشتیبانی‌نشده ارتباط با این تراشه ممکن نیست و باید از پورت RS-232 استفاده نمایید.

Yifeng Li <tomli@tomli.me>

nutupsdrv(8)

•پشتیبانی از مدل‌های جدیدتر UPS2000G/CH341: https://github.com/networkupstools/nut/commit/59af0780af0db7341ff81d460fc10736458722aa
•گزارش خطای ۱۸۴۶: https://github.com/networkupstools/nut/issues/1846
•کامیت رفع باگ زمان انقضا در گزارش ۱۸۴۶: https://github.com/networkupstools/nut/commit/3dae58f403f88dace52e2caac3c0690e45b8ef22
•گزارش خطای ۳۲۴۴ مربوط به ویندوز: https://github.com/networkupstools/nut/issues/3244
•کامیت فراخوانی ser_close پیش از اتصال مدباس: https://github.com/networkupstools/nut/commit/db2e148503d654726d5520d68e20e71117335813

•راهنمای توسعه پروتکل مدباس هواوی: https://support.huawei.com/enterprise/en/doc/EDOC1000110696
•صفحه محصول MaxLinear XR21V1410: https://www.maxlinear.com/product/interface/uarts/usb-uarts/xr21v1410
•درایور CH341SER.EXE: https://www.wch-ic.com/downloads/CH341SER_EXE.html
•درایور CH341SER.ZIP: https://www.wch-ic.com/downloads/CH341SER_ZIP.html

•صفحه خانگی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5
•راهنمای کاربری Huawei UPS2000-A: https://support.huawei.com/enterprise/en/doc/EDOC1000084260
•راهنمای توسعه پروتکل مدباس: https://support.huawei.com/enterprise/en/doc/EDOC1000110696
•صفحه خانگی libmodbus: http://libmodbus.org
06/21/2026 Network UPS Tools 2.8.5