'\" t
.\"     Title: socomec_jbus
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/21/2026
.\"    Manual: NUT Manual
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: English
.\"
.TH "SOCOMEC_JBUS" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * 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)"
socomec_jbus \- درایور دستگاه‌های یوپی‌اس مبتنی بر پروتکل Jbus برند Socomec در NUT
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBsocomec_jbus\fR \-h
.sp
\fBsocomec_jbus\fR \-a \fIDEVICE_NAME\fR [\fIگزینه‌ها\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
این صفحه راهنما صرفاً ویژگی‌های وابسته به سخت‌افزار درایور socomec_jbus را شرح می‌دهد\&. برای کسب اطلاعات درباره هسته اصلی درایور، به \fBnutupsdrv\fR(8) مراجعه کنید\&.
.sp .5v
.RE
.SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)"
.sp
این درایور از یوپی‌اس‌های آنلاین (تبدیل دوگانه) سری Socomec JBUS با مشخصات زیر پشتیبانی می‌کند\&.
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
یوپی‌اس‌های تک‌فاز و سه‌فاز
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
اتصال: RS\-232
.RE
.sp
این دستگاه‌ها معمولاً همراه با یک کارت مدیریتی تحت وب/SNMP یا جعبه خارجی Netvision عرضه می‌شوند که برای آن‌ها استفاده از درایور \fBsnmp-ups\fR(8) مناسب‌تر خواهد بود\&. در صورتی که netvision در دسترس نباشد، می‌توانید یوپی‌اس را مستقیماً از طریق درگاه سریال متصل کرده و از این درایور استفاده کنید\&.
.sp
در حال حاضر، این درایور فقط روی مدل زیر آزمایش شده است\&:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
DIGYS 3/3 15kVA
.RE
.sp
از نظر تئوری، هر مدل Socomec JBUS باید کار کند\&. این دستگاه باید به عنوان \(lqUnknown Socomec JBUS\(rq همراه با یک شناسه عددی شناسایی شود که برای افزودن آن به فهرست یوپی‌اس‌های پشتیبانی‌شده به آن نیاز خواهد بود\&.
.sp
متأسفانه، اسناد Socomec فقط به مدل‌های DELPHYS MX و DELPHYS MX elite اشاره کرده‌اند و من فقط شناسه DIGYS خود را در اختیار دارم؛ بنابراین به احتمال زیاد مدل شما شناسایی نخواهد شد اما احتمالاً بیشتر بخش‌های آن به درستی کار خواهد کرد\&. لطفاً نتایج موفقیت‌آمیز یا ناموفق خود را به سیستم ثبت اشکال یا فهرست پستی گزارش دهید\&. اطمینان حاصل کنید که شماره مدل کامل یوپی‌اس خود را به صورت دستی در گزارش قید نمایید\&.
.sp
درایور socomec_jbus برای پیاده‌سازی پروتکل Modbus از پروژه libmodbus استفاده می‌کند\&.
.SH "کابل‌کشی (CABLING)"
.sp
دستگاه یوپی‌اس دارای یک درگاه RS\-232 است که باید با یک کابل نال‌مودم (NULL\-modem) به درگاه سریال رایانه متصل شود\&. یوپی‌اس آزمایش‌شده دارای کانکتور مادگی DB9 است، بنابراین اگر کابل را خودتان می‌سازید، به نوع کانکتور توجه کنید تا از استفاده از تبدیل‌های نری/مادگی اجتناب شود\&.
.sp
پروتکل RS\-232 در تمامی سیستم‌عامل‌ها، چه از طریق درگاه سریال داخلی رایانه و چه با استفاده از مبدل خارجی USB به RS\-232 پشتیبانی می‌شود\&. اگر قصد استفاده از مبدل USB به RS\-232 را دارید، بررسی کنید که توسط سیستم‌عامل شما پشتیبانی شود\&.
.SH "نصب (INSTALLATION)"
.sp
این درایور در صورت در دسترس بودن libmodbus و هدرهای توسعه، باید به‌طور پیش‌فرض ساخته شود\&. می‌توانید با آرگومان‌های زیر، اسکریپت پیکربندی (configure) را وادار به ساخت آن کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
:; \&./configure \-\-with\-serial=yes \-\-with\-modbus=yes
.fi
.if n \{\
.RE
.\}
.sp
همچنین باید مجوزهای مناسب (خواندن/نوشتن) را روی فایل دستگاه سریال محلی تنظیم کنید تا کاربر زمان اجرای درایور NUT اجازه دسترسی به آن را داشته باشد\&. این کار ممکن است نیازمند تنظیمات بیشتر در اسکریپت‌های راه‌اندازی، قواعد udev یا upower باشد تا مجوزها در هر بار بالا آمدن سیستم اعمال شوند \(em به‌ویژه اگر گره‌های دستگاه شما توسط یک فایل‌سیستم مجازی مدیریت می‌شوند\&.
.sp
برای نمونه، یک مبدل USB به سریال در لینوکس می‌تواند به عنوان /dev/ttyACM0 یا /dev/ttyUSB0، یا در FreeBSD به عنوان /dev/ttyU0 شناخته شود (به حرف بزرگ "U" دقت کنید)\&. یک درگاه سریال داخلی می‌تواند به عنوان /dev/ttyS0 در لینوکس یا یکی از نام‌های /dev/cua* در FreeBSD شناسایی شود\&.
.SH "دستورات فوری (INSTANT COMMANDS)"
.sp
این درایور (هنوز؟) از ارسال دستورات به یوپی‌اس پشتیبانی نمی‌کند\&.
.SH "متغیرها (VARIABLES)"
.sp
این درایور به همان دلایل، از متغیرهای زمان اجرای قابل‌نوشتن پشتیبانی نمی‌کند (به \fBupsrw\fR(8) مراجعه کنید)\&. پیاده‌سازی هر دو باید ساده باشد، اما از آنجا که قبلاً یک یا دو ناسازگاری در مستندات مشاهده کرده‌ام، فعلاً از آزمایش آن‌ها خودداری می‌کنم\&.
.SH "مشکلات و اشکالات شناخته‌شده (KNOWN ISSUES AND BUGS)"
.sp
خب، این در بهترین حالت یک نسخه آلفا است، اما تاکنون به نظر می‌رسد وضعیت یوپی‌اس را به شکلی قابل‌اطمینان گزارش می‌دهد\&. این برنامه عمدتاً بر اساس کار Yifeng Li <tomli@tomli\&.me> روی \fBhuawei-ups2000\fR(8) در همان درخت منبع نوشته شده است\&.
.SS "خطای خواندن در برخی آدرس‌های JBUS"
.sp
این درایور تمام آدرس‌های مستندشده JBUS را استعلام می‌کند و کاملاً ممکن است مدل یوپی‌اس شما از یکی از آن‌ها پشتیبانی نکند (برای مثال Digys از آدرس \fI0x1020\fR که باید وضعیت فعلی یوپی‌اس را ارائه دهد پشتیبانی نمی‌کند)\&. این مورد باید همراه با آدرسی که خطا ایجاد کرده، با LOG_ERR توسط \fBmodbus_read_input_registers\fR() ثبت شود\&.
.SS "داده‌های کهنه (Data stale)"
.sp
تحت شرایط خاصی، برخی رجیسترها می‌توانند مقادیر نامعتبر برگردانند و موجب بروز خطای «data stale» شوند\&. پس از وقوع خطای کهنگی داده، باید پیام‌های خطایی مشابه با مثال زیر در لاگ سیستم مشاهده کنید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
socomec_jbus: modbus_read_input_registers(addr:XXXX, count:Z):
    Illegal data address
upsd: Data for UPS [socomec] is stale \- check driver
upsd: UPS [socomec] data is no longer stale
.fi
.if n \{\
.RE
.\}
.sp
تاکنون تمام مشکلات شناخته‌شده توسط نویسنده برطرف شده‌اند، اما وجود یک مشکل ناشناخته غیرممکن نیست\&. اگر در کاربردهای عادی با مشکلات «data stale» مواجه شدید، لطفاً یک گزارش با پیوست کامل لاگ‌ها ارسال کنید\&.
.sp
پیش از عیب‌یابی یا گزارش مشکل، بسیار مهم است که گزارش‌های \fBdmesg\fR خود را برای رویدادهای اتصال و قطع اتصال USB بررسی کنید تا از اتلاف وقت روی درایور NUT در شرایطی که مشکل واقعی از USB است جلوگیری شود\&. به عنوان مثال، اگر کسی کابل را از درگاه USB بکشد، یا اگر دستگاه USB جدیدی به میزبان/هاب USB متصل شود که در تأمین برق پورت‌هایش با مشکل مواجه است (اتفاقی رایج در رایانه‌های تک‌بوردی مثل رزبری پای)، یا اگر کابل‌کشی نامناسب یا نویز EMI داشته باشید، مبدل سریال ممکن است حتی برای لحظه‌ای از USB قطع شود\&. این مسئله یک خطای کهنگی دائمی داده ایجاد می‌کند و درایور باید دوباره راه‌اندازی شود (وصل کردن مجدد کابل USB مشکل را حل نمی‌کند، زیرا درایور همچنان در حال استفاده از دستگاه سریال ناموجود است)\&. این مشکلات USB معمولاً ربطی به NUT ندارند\&. در صورت بروز چنین مشکلی، باید مسئله اصلی USB را حل کنید \(em کابل را بررسی کنید، مبدل را چک کنید، از یک هاب USB دارای منبع تغذیه مستقل استفاده کنید، یک ایزولاتور USB سرعت‌کامل را به کار ببرید و موارد مشابه\&.
.SH "نویسنده (AUTHOR)"
.sp
Thanos Chatziathanassiou <tchatzi@arx\&.net>
.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
.\}
راهنمای مرجع Socomec JBUS/Modbus:
https://www\&.socomec\&.com/files/live/sites/systemsite/files/GB\-JBUS\-MODBUS\-for\-Delphys\-MP\-and\-Delphys\-MX\-operating\-manual\&.pdf
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفحه اصلی libmodbus:
http://libmodbus\&.org
.RE