NUTDRV_SIEMENS-SITO(8) راهنمای NUT NUTDRV_SIEMENS-SITO(8)

nutdrv_siemens-sitop - درایور برای یوپی‌اس‌های سری زیمنس SITOP UPS500

nutdrv_siemens-sitop -h

nutdrv_siemens-sitop -a UPS_NAME [OPTIONS]


نکته

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

درایور nutdrv_siemens-sitop از مدل‌های یوپی‌اس زیمنس از سری SITOP UPS500 پشتیبانی می‌کند. برخی مدل‌ها دارای یک درگاه سریال هستند، در حالی که برخی دیگر درگاه USB دارند. مدل‌های دارای درگاه USB در واقع حاوی یک تراشه سریال روی USB (serial-over-USB) هستند، بنابراین تا جایی که به این درایور مربوط می‌شود، تمام مدل‌ها مدل‌های سریال محسوب می‌شوند. این درایور باید با تمامی مدل‌های سری SITOP UPS500 کار کند، مادامی که هسته شما از دستگاه درگاه سریال پشتیبانی کند (بخش درایور USB در زیر را ببینید).


نکته

این درایور تنها با مدل SITOP UPS500S-2.5 دارای درگاه USB (شماره محصول زیمنس 6EP1933-2EC41) آزمایش شده است.

این یوپی‌اس از طریق دیپ‌سوئیچ‌ها (DIP-switches) پیکربندی می‌شود. برای عملکرد صحیح در ترکیب با NUT، دیپ‌سوئیچ‌ها را روی مقادیر زیر تنظیم کنید:

سوئیچ‌های ۱-۴ (switch 1-4)

هر آنچه متناسب با شرایط شماست انتخاب کنید. هر ترکیبی با NUT کار خواهد کرد.

سوئیچ ۵ (switch 5) (⇒ / t)

روی OFF (t) تنظیم شود. این کار تضمین می‌کند که یوپی‌اس جریان برق را قطع نخواهد کرد مگر آنکه NUT چنین فرمانی بدهد (یا باتری‌ها خالی شده باشند).

سوئیچ‌های ۶-۱۰ (switch 6-10) (تأخیر - delay)

روی OFF (حداقل تأخیر) تنظیم شود. تنظیم تأخیر بیشتر نیز در عمل کار خواهد کرد، اما اجرای هر فرمانی از سوی NUT توسط یوپی‌اس نیز با تأخیر مواجه خواهد شد. با حداقل تنظیمات، اجرای فرمانی از طرف NUT از قبل ۵ ثانیه به طول می‌انجامد.

سوئیچ ۱۱ (switch 11) (INTERR.)

روی ON (قطع خروجی پس از پایان تایمر) تنظیم شود. این کار تضمین می‌کند که یوپی‌اس در پاسخ به دستور shutdown.return برای لحظاتی برق خروجی را قطع می‌کند. بخش دستورات آنی در زیر را ببینید.

سوئیچ ۱۲ (switch 12) (ON/OFF)

روی ON (فعال‌سازی عملکرد یوپی‌اس) تنظیم شود. بدون این گزینه، یوپی‌اس هرگز از باتری‌های خود برق تأمین نخواهد کرد.

نسخه‌های USB این یوپی‌اس حاوی یک تراشه مبدل USB به سریال FTDI هستند. این تراشه با یک شناسه محصول (Product ID) غیراستاندارد (برای نمونه 0403:e0e3) برنامه‌ریزی شده است، اما با این وجود همچنان می‌توان از آن با درایور عادی ftdi_sio استفاده کرد.


نکته

نکات زیر ممکن است مختص به گنو/لینوکس (GNU/Linux) باشد.

از دستور lsusb برای یافتن شناسه محصول (Product ID) به‌کاررفته در مدل خود استفاده کنید، و در مثال‌های زیر تمام موارد e0e3 را با شناسه محصول واقعی جایگزین نمایید.

modprobe ftdi_sio
echo 0403 e0e3 > /sys/bus/usb-serial/drivers/ftdi_sio/new_id

اگر سیستم شما از udev استفاده می‌کند، این فرآیند را می‌توان از طریق یک قاعده udev خودکار کرد:

ACTION=="add", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="e0e3", \
  RUN+="/sbin/modprobe ftdi_sio", \
  RUN+="/bin/sh -c 'echo 0403 e0e3 > /sys/bus/usb-serial/drivers/ftdi_sio/new_id'"

می‌توانید از قاعده udev زیر برای دستیابی به یک نام دستگاه قابل پیش‌بینی، به عنوان مثال /dev/ttyUPS استفاده کنید:

SUBSYSTEM=="tty" ATTRS{idVendor}=="0403", ATTRS{idProduct}=="e0e3" SYMLINK+="ttyUPS"

یوپی‌اس دستور ویژه‌ای برای دریافت وضعیت (get status) ندارد. در عوض، به طور مداوم پیام‌های به‌روزرسانی وضعیت را ارسال می‌کند (ده‌ها پیام در هر ثانیه). در هر pollinterval، این پیام‌ها از بافر درگاه سریال خوانده می‌شوند.

برای واکنش سریع به تغییرات وضعیت یوپی‌اس و جلوگیری از سرریز شدن بافر سریال، pollinterval باید روی مقدار نسبتاً پایینی تنظیم شود. مقدار توصیه‌شده ۱ (ثانیه) است.

این درایور از تنظیمات اختیاری زیر پشتیبانی می‌کند:

max_polls_without_data=num

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

مقدار پیش‌فرض برابر با 2 است. مقادیر کمتر ممکن است پیام‌های کاذب Data stale (داده کهنه) را به همراه داشته باشند، به ویژه هنگام راه‌اندازی.

shutdown.return

رفتار این دستور به وضعیت خط برق (شهری) بستگی دارد:
•on line: پس از ۵ ثانیه (یا بیشتر، اگر سوئیچ‌های دیپ ۶-۱۰ روی OFF نباشند)، یوپی‌اس خروجی خود را قطع می‌کند. پس از ۵ ثانیه دیگر، خروجی مجدداً فعال می‌شود.
•on battery: پس از ۵ ثانیه (یا بیشتر، اگر سوئیچ‌های دیپ ۶-۱۰ روی OFF نباشند)، یوپی‌اس خروجی خود را قطع می‌کند. خروجی تا زمان بازگشت ولتاژ خط خاموش خواهد ماند.

shutdown.stayoff

رفتار این دستور به وضعیت خط برق (شهری) بستگی دارد:
•on line: پس از ۵ ثانیه (یا بیشتر، اگر سوئیچ‌های دیپ ۶-۱۰ روی OFF نباشند)، یوپی‌اس خروجی خود را قطع می‌کند. خروجی خاموش می‌ماند تا زمانی که ولتاژ خط حداقل به مدت ۱ ثانیه قطع شود و سپس مجدداً وصل گردد.
•on battery: این دستور رفتاری مشابه با shutdown.return دارد.

اطمینان حاصل کنید که سیستم‌عامل شما یک دستگاه سریال برای یوپی‌اس ایجاد کرده است. برای اطلاعات بیشتر بخش درایور USB را ببینید.

سپس، مطمئن شوید که NUT دارای مجوزهای دسترسی به این فایل دستگاه است. به عنوان مثال، با ایجاد یک قاعده udev که به کاربر NUT مجوز می‌دهد، یا با افزودن کاربر NUT به گروه کاربری که می‌تواند به دستگاه‌های سریال دسترسی داشته باشد (مانند گروه dialout در سیستم‌های مبتنی بر دبیان).

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

:; picocom -b 9600 -d 8 -p n /dev/ttyUPS

هنگام انجام این کار نباید NUT در حال اجرا باشد. اکنون باید یک جریان پیوسته از متون ۵ نویسه‌ای را مشاهده کنید، برای نمونه:

BUFRD
BA>85
DC_OK

برای خروج از picocom، از کلیدهای Ctrl-A Ctrl-X استفاده کنید.

مدل‌های آزمایش‌نشده

همان‌طور که در بخش سخت‌افزارهای پشتیبانی‌شده ذکر شد، این درایور با تمامی مدل‌های سری SITOP UPS500 آزمایش نشده است.

پیام‌های دادۀ کهنه (Data stale)

سیستم‌عامل داخلی (سفت‌افزار) این یوپی‌اس‌ها باگ‌های زیادی دارد. پس از ارسال داده به یوپی‌اس، گاهی اوقات ارسال به‌روزرسانی‌های وضعیت متوقف می‌شود. این درایور تلاش می‌کند از این امر جلوگیری کند (مثلاً با ارسال دوبارۀ دستورات و ارسال نویسه‌های LF اضافی پس از هر دستور).

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

در طول کارکرد عادی، هیچ دستوری به یوپی‌اس ارسال نمی‌شود (تنها هنگام خاموش‌سازی ارسال می‌شود)، بنابراین انتظار می‌رود این مشکل تأثیر اندکی بر کارایی و استفاده داشته باشد.

مشخص نیست که آیا مدل‌های سریال نیز تحت تأثیر این مشکل قرار دارند یا خیر.

Matthijs H. ten Berge

nutupsdrv(8)

صفحه خانگی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5/

06/21/2026 Network UPS Tools 2.8.5