'\" t
.\"     Title: nutdrv_siemens-sitop
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/21/2026
.\"    Manual: راهنمای NUT
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: Persian
.\"
.TH "NUTDRV_SIEMENS\-SITO" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "راهنمای NUT"
.\" -----------------------------------------------------------------
.\" * 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)"
nutdrv_siemens-sitop \- درایور برای یوپی‌اس‌های سری زیمنس SITOP UPS500
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnutdrv_siemens\-sitop\fR \-h
.sp
\fBnutdrv_siemens\-sitop\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
این صفحه راهنما فقط ویژگی‌های خاص سخت‌افزاری درایور \fBnutdrv_siemens\-sitop\fR را مستند می‌کند\&. برای اطلاعات درباره درایور اصلی، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.sp .5v
.RE
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
درایور \fBnutdrv_siemens\-sitop\fR از مدل‌های یوپی‌اس زیمنس از سری SITOP UPS500 پشتیبانی می‌کند\&. برخی مدل‌ها دارای یک درگاه سریال هستند، در حالی که برخی دیگر درگاه USB دارند\&. مدل‌های دارای درگاه USB در واقع حاوی یک تراشه سریال روی USB (serial\-over\-USB) هستند، بنابراین تا جایی که به این درایور مربوط می‌شود، تمام مدل‌ها مدل‌های سریال محسوب می‌شوند\&. این درایور باید با تمامی مدل‌های سری SITOP UPS500 کار کند، مادامی که هسته شما از دستگاه درگاه سریال پشتیبانی کند (بخش \fBدرایور USB\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
این درایور تنها با مدل SITOP UPS500S\-2\&.5 دارای درگاه USB (شماره محصول زیمنس 6EP1933\-2EC41) آزمایش شده است\&.
.sp .5v
.RE
.SH "تنظیمات دستگاه (DEVICE SETTINGS)"
.sp
این یوپی‌اس از طریق دیپ‌سوئیچ‌ها (DIP\-switches) پیکربندی می‌شود\&. برای عملکرد صحیح در ترکیب با NUT، دیپ‌سوئیچ‌ها را روی مقادیر زیر تنظیم کنید:
.PP
\fBسوئیچ‌های ۱\-۴ (switch 1\-4)\fR
.RS 4
هر آنچه متناسب با شرایط شماست انتخاب کنید\&. هر ترکیبی با NUT کار خواهد کرد\&.
.RE
.PP
\fBسوئیچ ۵ (switch 5)\fR (⇒ / t)
.RS 4
روی OFF (t) تنظیم شود\&. این کار تضمین می‌کند که یوپی‌اس جریان برق را قطع نخواهد کرد مگر آنکه NUT چنین فرمانی بدهد (یا باتری‌ها خالی شده باشند)\&.
.RE
.PP
\fBسوئیچ‌های ۶\-۱۰ (switch 6\-10)\fR (تأخیر - delay)
.RS 4
روی OFF (حداقل تأخیر) تنظیم شود\&. تنظیم تأخیر بیشتر نیز در عمل کار خواهد کرد، اما اجرای هر فرمانی از سوی NUT توسط یوپی‌اس نیز با تأخیر مواجه خواهد شد\&. با حداقل تنظیمات، اجرای فرمانی از طرف NUT از قبل ۵ ثانیه به طول می‌انجامد\&.
.RE
.PP
\fBسوئیچ ۱۱ (switch 11)\fR (INTERR\&.)
.RS 4
روی ON (قطع خروجی پس از پایان تایمر) تنظیم شود\&. این کار تضمین می‌کند که یوپی‌اس در پاسخ به دستور shutdown\&.return برای لحظاتی برق خروجی را قطع می‌کند\&. بخش
\fBدستورات آنی\fR
در زیر را ببینید\&.
.RE
.PP
\fBسوئیچ ۱۲ (switch 12)\fR (ON/OFF)
.RS 4
روی ON (فعال‌سازی عملکرد یوپی‌اس) تنظیم شود\&. بدون این گزینه، یوپی‌اس هرگز از باتری‌های خود برق تأمین نخواهد کرد\&.
.RE
.SH "درایور USB (USB DRIVER)"
.sp
نسخه‌های USB این یوپی‌اس حاوی یک تراشه مبدل USB به سریال FTDI هستند\&. این تراشه با یک شناسه محصول (Product ID) غیراستاندارد (برای نمونه \fI0403:e0e3\fR) برنامه‌ریزی شده است، اما با این وجود همچنان می‌توان از آن با درایور عادی ftdi_sio استفاده کرد\&.
.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
نکات زیر ممکن است مختص به گنو/لینوکس (GNU/Linux) باشد\&.
.sp .5v
.RE
.sp
از دستور \fBlsusb\fR برای یافتن شناسه محصول (Product ID) به‌کاررفته در مدل خود استفاده کنید، و در مثال‌های زیر تمام موارد \fIe0e3\fR را با شناسه محصول واقعی جایگزین نمایید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
modprobe ftdi_sio
echo 0403 e0e3 > /sys/bus/usb\-serial/drivers/ftdi_sio/new_id
.fi
.if n \{\
.RE
.\}
.sp
اگر سیستم شما از \fBudev\fR استفاده می‌کند، این فرآیند را می‌توان از طریق یک قاعده \fBudev\fR خودکار کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
ACTION=="add", ATTRS{idVendor}=="0403", ATTRS{idProduct}=="e0e3", \e
  RUN+="/sbin/modprobe ftdi_sio", \e
  RUN+="/bin/sh \-c \*(Aqecho 0403 e0e3 > /sys/bus/usb\-serial/drivers/ftdi_sio/new_id\*(Aq"
.fi
.if n \{\
.RE
.\}
.sp
می‌توانید از قاعده udev زیر برای دستیابی به یک نام دستگاه قابل پیش‌بینی، به عنوان مثال /dev/ttyUPS استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
SUBSYSTEM=="tty" ATTRS{idVendor}=="0403", ATTRS{idProduct}=="e0e3" SYMLINK+="ttyUPS"
.fi
.if n \{\
.RE
.\}
.SH "نظرسنجی دوره‌ای (POLLING)"
.sp
یوپی‌اس دستور ویژه‌ای برای \fIدریافت وضعیت (get status)\fR ندارد\&. در عوض، به طور مداوم پیام‌های به‌روزرسانی وضعیت را ارسال می‌کند (ده‌ها پیام در هر ثانیه)\&. در هر \fBpollinterval\fR، این پیام‌ها از بافر درگاه سریال خوانده می‌شوند\&.
.sp
برای واکنش سریع به تغییرات وضعیت یوپی‌اس و جلوگیری از سرریز شدن بافر سریال، \fBpollinterval\fR باید روی مقدار نسبتاً پایینی تنظیم شود\&. مقدار توصیه‌شده ۱ (ثانیه) است\&.
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از تنظیمات اختیاری زیر پشتیبانی می‌کند:
.PP
\fBmax_polls_without_data\fR=\fInum\fR
.RS 4
درگاه سریال به صورت دوره‌ای برای داده‌های جدید نظرسنجی می‌شود (بخش
\fBنظرسنجی دوره‌ای\fR
را ببینید)\&. اگر پس از
\fInum\fR
بار نظرسنجی داده جدید معتبری دریافت نشود، فرض می‌شود که ارتباط با یوپی‌اس قطع شده است\&.
.sp
مقدار پیش‌فرض برابر با
\fI2\fR است\&. مقادیر کمتر ممکن است پیام‌های کاذب
\fIData stale\fR
(داده کهنه) را به همراه داشته باشند، به ویژه هنگام راه‌اندازی\&.
.RE
.SH "دستورات آنی (INSTANT COMMANDS)"
.PP
\fBshutdown\&.return\fR
.RS 4
رفتار این دستور به وضعیت خط برق (شهری) بستگی دارد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBon line\fR: پس از ۵ ثانیه (یا بیشتر، اگر سوئیچ‌های دیپ ۶\-۱۰ روی OFF نباشند)، یوپی‌اس خروجی خود را قطع می‌کند\&. پس از ۵ ثانیه دیگر، خروجی مجدداً فعال می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBon battery\fR: پس از ۵ ثانیه (یا بیشتر، اگر سوئیچ‌های دیپ ۶\-۱۰ روی OFF نباشند)، یوپی‌اس خروجی خود را قطع می‌کند\&. خروجی تا زمان بازگشت ولتاژ خط خاموش خواهد ماند\&.
.RE
.RE
.PP
\fBshutdown\&.stayoff\fR
.RS 4
رفتار این دستور به وضعیت خط برق (شهری) بستگی دارد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBon line\fR: پس از ۵ ثانیه (یا بیشتر، اگر سوئیچ‌های دیپ ۶\-۱۰ روی OFF نباشند)، یوپی‌اس خروجی خود را قطع می‌کند\&. خروجی خاموش می‌ماند تا زمانی که ولتاژ خط حداقل به مدت ۱ ثانیه قطع شود و سپس مجدداً وصل گردد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBon battery\fR: این دستور رفتاری مشابه با
\fBshutdown\&.return\fR
دارد\&.
.RE
.RE
.SH "نصب (INSTALLATION)"
.sp
اطمینان حاصل کنید که سیستم‌عامل شما یک دستگاه سریال برای یوپی‌اس ایجاد کرده است\&. برای اطلاعات بیشتر بخش \fBدرایور USB\fR را ببینید\&.
.sp
سپس، مطمئن شوید که NUT دارای مجوزهای دسترسی به این فایل دستگاه است\&. به عنوان مثال، با ایجاد یک قاعده udev که به کاربر NUT مجوز می‌دهد، یا با افزودن کاربر NUT به گروه کاربری که می‌تواند به دستگاه‌های سریال دسترسی داشته باشد (مانند گروه \fBdialout\fR در سیستم‌های مبتنی بر دبیان)\&.
.SH "عیب‌یابی (DIAGNOSTICS)"
.sp
می‌توانید صحت عملکرد سخت‌افزار را با پایش درگاه سریال از طریق یک برنامه ترمینال، به عنوان مثال picocom بررسی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
:; picocom \-b 9600 \-d 8 \-p n /dev/ttyUPS
.fi
.if n \{\
.RE
.\}
.sp
هنگام انجام این کار نباید NUT در حال اجرا باشد\&. اکنون باید یک جریان پیوسته از متون ۵ نویسه‌ای را مشاهده کنید، برای نمونه:
.sp
.if n \{\
.RS 4
.\}
.nf
BUFRD
BA>85
DC_OK
.fi
.if n \{\
.RE
.\}
.sp
برای خروج از picocom، از کلیدهای Ctrl\-A Ctrl\-X استفاده کنید\&.
.SH "مشکلات و باگ‌های شناخته‌شده (KNOWN ISSUES AND BUGS)"
.PP
\fBمدل‌های آزمایش‌نشده\fR
.RS 4
همان‌طور که در بخش
\fBسخت‌افزارهای پشتیبانی‌شده\fR
ذکر شد، این درایور با تمامی مدل‌های سری SITOP UPS500 آزمایش نشده است\&.
.RE
.PP
\fBپیام‌های دادۀ کهنه (Data stale)\fR
.RS 4
سیستم‌عامل داخلی (سفت‌افزار) این یوپی‌اس‌ها باگ‌های زیادی دارد\&. پس از ارسال داده به یوپی‌اس، گاهی اوقات ارسال به‌روزرسانی‌های وضعیت متوقف می‌شود\&. این درایور تلاش می‌کند از این امر جلوگیری کند (مثلاً با ارسال دوبارۀ دستورات و ارسال نویسه‌های LF اضافی پس از هر دستور)\&.
.sp
هنگامی که یوپی‌اس در این وضعیت قرار گیرد، ارتباط تنها با راه‌اندازی مجدد یوپی‌اس، یا با جدا کردن و اتصال مجدد کابل USB بازیابی می‌شود\&.
.sp
در طول کارکرد عادی، هیچ دستوری به یوپی‌اس ارسال نمی‌شود (تنها هنگام خاموش‌سازی ارسال می‌شود)، بنابراین انتظار می‌رود این مشکل تأثیر اندکی بر کارایی و استفاده داشته باشد\&.
.sp
مشخص نیست که آیا مدل‌های سریال نیز تحت تأثیر این مشکل قرار دارند یا خیر\&.
.RE
.SH "نویسنده (AUTHOR)"
.sp
Matthijs H\&. ten Berge
.SH "همچنین ببینید (SEE ALSO)"
.SS "درایور اصلی (The core driver):"
.sp
\fBnutupsdrv\fR(8)
.SS "منابع اینترنتی (Internet resources):"
.sp
صفحه خانگی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5/