'\" t
.\"     Title: phoenixcontact_modbus
.\"    Author: [see the "AUTHORS" 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 "PHOENIXCONTACT_MODBU" "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)"
phoenixcontact_modbus \- درایور برای سخت‌افزارهای Phoenix Contact
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBphoenixcontact_modbus\fR \-h
.sp
\fBphoenixcontact_modbus\fR \-a \fIDEVICE_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
این صفحه راهنما تنها ویژگی‌های سخت‌افزاری خاص درایور phoenixcontact_modbus را مستند می‌کند\&. برای اطلاعات درباره درایور اصلی، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.sp .5v
.RE
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
این درایور باید از یوپی‌اس DC صنعتی PhoenixContact QUINT\-UPS، مدل 2320461 و تمام مدل‌های سازگار پشتیبانی کند\&. اطلاعات بیشتر درباره این یوپی‌اس را می‌توان در میان منابع اینترنتی زیر یافت\&.
.sp
درایور phoenixcontact_modbus از پروژه libmodbus برای پیاده‌سازی پروتکل Modbus استفاده می‌کند\&.
.SH "نحوه پیکربندی یوپی‌اس (HOW TO CONFIGURE THE UPS)"
.sp
نکته: این یوپی‌اس و دفترچه راهنمای آن به وضعیت باتری ضعیف (Low\-Batt) با عنوان «رویداد خاموش‌سازی» (Shutdown Event) اشاره می‌کنند\&.
.sp
شما برای برقراری ارتباط با یوپی‌اس در لینوکس به کابل «IFS\-RS232\-DATACABLE» نیاز دارید، زیرا به نظر نمی‌رسد کابل IFS\-USB پشتیبانی شود\&. جهت اطلاع، پارامترهای ارتباطی عبارتند از: 115200,E,8,1\&.
.sp
شما همچنین برای پیکربندی سیگنال‌ها و تایمرهای یوپی‌اس، به نرم‌افزار تحت ویندوز UPS\-CONF (رایگان؛ قابل دانلود از سایت آن‌ها) نیاز دارید\&.
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
اجرای نرم‌افزار UPS\-CONF
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
رفتن به مسیر Settings→Time Setting
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
انتخاب «state of charge shutdown delay»
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
انتخاب گزینه Remote starts PC\-Shutdown in Mains and Battery mode
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
در بخش PC\-Shutdown، حداکثر مقدار (۵ دقیقه) را وارد کنید
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
در بخش تأخیر PC\-Restart، مدت زمانی را که می‌خواهید یوپی‌اس پس از وصل مجدد برق شهر، پیش از راه‌اندازی مجدد برق خروجی را قطع نگه دارد (برای مثال ۶۰ ثانیه)، وارد کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  7." 4.2
.\}
روی یوپی‌اس، پیچ را روی وضعیت «PC\-MODE» بچرخانید
.RE
.sp
پیکربندی به روش فوق موارد زیر را تضمین می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگام قطع برق، یوپی‌اس به طور مداوم زمان باقی‌مانده باتری را محاسبه می‌کند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی که زمان باقی‌مانده باتری کمتر از ۵ دقیقه باشد (تنظیم PC\-Shutdown)، رویداد «Shutdown» را صادر می‌کند (در NUT به عنوان LOW\-BATT دیده می‌شود)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
از آن لحظه به بعد، حتی اگر برق ورودی وصل شود، یوپی‌اس برق خروجی به بار خود را پس از ۵ دقیقه قطع خواهد کرد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
هنگامی که برق ورودی وصل شود، یوپی‌اس برق خروجی را پس از ۶۰ ثانیه (تنظیم تأخیر PC\-RESTART) وصل خواهد کرد\&.
.RE
.sp
مفهوم تنظیمات:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
PC\-Shutdown: چه مدت قبل از قطع خروجی، یوپی‌اس سیگنال «رویداد خاموش‌سازی» را ارسال کند\&. حداکثر مقدار برای این تنظیم ۵ دقیقه است\&. بنابراین رایانه باید بتواند ظرف ۵ دقیقه خاموش شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
PC\-Restart: چه مدت پس از وصل مجدد برق، اتصال برق خروجی به تأخیر بیفتد\&. حداکثر مقدار ۶۰ ثانیه است\&.
.RE
.SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)"
.sp
این درایور از هیچ تنظیمات اختیاری پشتیبانی نمی‌کند\&.
.SH "نصب (INSTALLATION)"
.sp
این درایور ممکن است به طور پیش‌فرض کامپایل نشده باشد\&. می‌توانید با نصب libmodbus و اجرای configure \-\-with\-modbus=yes آن را بسازید\&.
.sp
همچنین باید دسترسی‌های مناسب روی فایل دستگاه سریال محلی (برای مثال /dev/ttyS0) تنظیم کنید تا کاربر NUT اجازه دسترسی به آن را داشته باشد\&.
.SH "دستورات آنی (INSTANT COMMANDS)"
.sp
این درایور از هیچ دستور آنی پشتیبانی نمی‌کند\&.
.SH "متغیرهای قابل پیکربندی (CONFIGURABLE VARIABLES)"
.sp
متغیرهای زیر را می‌توان در پیکربندی NUT به عنوان مقادیر default\&.* برای بازنویسی یا نظارت بر رفتار یوپی‌اس با استفاده از درایور phoenixcontact_modbus تنظیم کرد\&.
.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
از نسخه NUT 2\&.8\&.4، در حال حاضر هیچ پشتیبانی برای تنظیم این مقادیر در زمان اجرا (برای مثال با \fBupsrw\fR(8)) وجود ندارد\&. در حال حاضر آن‌ها فقط یک بار در طول مقداردهی اولیه درایور بررسی می‌شوند\&.
.sp .5v
.RE
.PP
\fBbattery\&.energysave\&.delay\fR=\fInum\fR
.RS 4
مدت زمان پس از ورود به حالت باتری پیش از فعال شدن سیگنال خاموش‌سازی رایانه توسط یوپی‌اس (به ثانیه)\&.
.RE
.PP
\fBups\&.timer\&.shutdown\fR=\fInum\fR
.RS 4
زمان مجاز برای خاموش شدن رایانه (به ثانیه)\&. حداکثر ۳۰۰ ثانیه است\&.
.RE
.PP
\fBups\&.timer\&.start\fR=\fInum\fR
.RS 4
مدت زمانی که برق خروجی پیش از راه‌اندازی مجدد و روشن شدن سیستم رایانه خاموش می‌ماند (به ثانیه)\&.
.RE
.PP
\fBups\&.delay\&.start\fR=\fInum\fR
.RS 4
تأخیر پیش از بازگشت به برق شهر پس از وصل مجدد برق (به ثانیه)\&. ولتاژ برق شهر برای شروع راه‌اندازی مجدد خودکار رایانه، باید در این مدت زمان در محدوده آستانه مجاز باشد\&.
.RE
.PP
\fBexperimental\&.ups\&.mode\&.selector\fR=\fInum\fR
.RS 4
حالت کارکرد یوپی‌اس\&. برای مثال،
9
مربوط به PC\-Mode (تعریف‌شده توسط سازنده) است\&.
.RE
.PP
\fBexperimental\&.battery\&.warning_soh\fR=\fInum\fR
.RS 4
آستانه هشدار باتری برای وضعیت سلامت (State of Health)، بر حسب درصد\&.
.RE
.PP
\fBinput\&.voltage\&.low\&.critical\fR=\fInum\fR
.RS 4
ولتاژ آستانه (به ولت) که پایین‌تر از آن یوپی‌اس به حالت باتری سوییچ خواهد کرد\&.
.RE
.PP
\fBinput\&.voltage\&.high\&.critical\fR=\fInum\fR
.RS 4
آستانه ولتاژ (به ولت) که بالاتر از آن یوپی‌اس برق شهر را وصل‌شده تلقی خواهد کرد (به موارد زیر نیز مراجعه کنید)\&.
.RE
.SH "نویسندگان (AUTHORS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Spiros Ioannou <sivann@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Ricardo Rodriguez <rikyrod2001@gmail\&.com>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Ulfat Hasangarayev <ulfathasangarayev@gmail\&.com>
.RE
.SH "همچنین ببینید (SEE ALSO)"
.SS "درایور اصلی:"
.sp
\fBnutupsdrv\fR(8)
.SS "منابع اینترنتی:"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحه خانگی NUT (Network UPS Tools):
https://www\&.networkupstools\&.org/historic/v2\&.8\&.5
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحه خانگی libmodbus:
http://libmodbus\&.org
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اطلاعات بیشتر درباره سری یوپی‌اس‌های صنعتی DC مدل 2320461 از PhoenixContact QUINT\-UPS را می‌توانید در اینجا بیابید:
https://www\&.phoenixcontact\&.com/online/portal/us?uri=pxc\-oc\-itemdetail:pid=2320461
.RE