.\" Copyright (c) 2018-2020 Robin Getz
.\" Copyright (c) 2018-2020 Analog Devices Inc.
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, see
.\" <http://www.gnu.org/licenses>.
.\" %%%LICENSE_END
.\"
.TH iio_reg 1 "24 December 2025" "libiio-0.26" "LibIIO Utilities"
.IX iio_reg_
.SH "نام (NAME)"
iio_reg \- خواندن یا نوشتن سطح پایین در رجیستر SPI یا I2C
.SH "خلاصه دستور (SYNOPSIS)"
.B iio_reg
[
.I گزینه‌ها
]
<device> <register> [<value>]
.SH "توضیحات (DESCRIPTION)"
.B iio_reg
ابزاری برای اشکال‌زدایی دستگاه‌های IIO محلی یا راه دور است.
این ابزار نباید توسط کاربران عادی استفاده شود، و معمولاً توسط توسعه‌دهندگان
درایور در طول توسعه، یا توسط کاربران نهایی هنگام اشکال‌زدایی یک درایور، یا
ارسال یک درخواست قابلیت جدید به کار می‌رود.
این ابزار سازوکاری برای خواندن یا نوشتن در رجیسترهای SPI یا I2C برای دستگاه‌های IIO فراهم می‌کند.
این امر می‌تواند هنگام عیب‌یابی دستگاه‌های IIO و درک نحوه مدیریت دستگاه توسط
زیرسیستم IIO لینوکس مفید باشد.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
به
.I iio_reg
دستور می‌دهد تا اطلاعات راهنما را نمایش داده و سپس خارج شود.
.TP
.B \-V, \-\-version
اطلاعات نسخه این رونوشت خاص از
.I iio_reg
و نسخه کتابخانه libiio مورد استفاده آن را چاپ می‌کند. این گزینه برای آگاهی از به‌روز بودن نسخه کتابخانه و
.I iio_reg
روی سیستم شما مفید است. همچنین هنگام گزارش باگ‌ها کاربرد دارد.
.TP
.B \-S, \-\-scan [backends]
پایش زمینه‌های (contexts) موجود IIO، با آرگومان اختیاری برای پشتیبان(های) مشخص \(aqip\(aq، \(aqusb\(aq یا \(aqip:usb\(aq.
گزینه‌های اختصاصی برای USB شامل Vendor ID و Product ID جهت محدود کردن پایش به دستگاه‌های مشخص مانند \(aqusb=0456,b673\(aq است.
مقادیر vid و pid اعداد هگزادسیمال هستند (نیازی به پیشوند نیست)، و "*" (تنها برای pid، تطابق با هر مقداری).
اگر آرگومانی داده نشود، همه موارد موجود بررسی می‌شوند.
.TP
.B \-u, \-\-uri
شناسه یکنواخت منبع
.I (uri)
برای اتصال به دستگاه‌ها، که می‌تواند یکی از موارد زیر باشد:
.RS
.IP ip:[address]
نشانی شبکه، خواه عددی (192.168.0.1) یا نام میزبان شبکه.
.IP ip:
خالی؛ در صورتی که با پشتیبانی از zeroconf کامپایل شده باشد، یک دستگاه IIO را در شبکه پیدا می‌کند.
.IP usb:[device:port:instance]
معمولاً از خروجی دستور زیر بازگردانده می‌شود:
.B iio_reg -S
.IP serial:[port],[baud],[settings]
که کنترل می‌شوند و باید با iiod (یا tinyiiod) در طرف دیگر پورت سریال مطابقت داشته باشند.
.RS
.IP [port]
چیزی شبیه به \(aq/dev/ttyUSB0\(aq در لینوکس و \(aqCOM4\(aq در ویندوز است.
.IP [baud]
معمولاً یکی از مقادیر 110، 300، 600، 1200، 2400، 4800، 9600، 14400، 19200، 38400، 57600، 115200 [پیش‌فرض]، 128000 یا 256000 است، اما می‌تواند از سیستمی به سیستم دیگر تفاوت داشته باشد.
.IP [settings]
معمولاً به‌صورت \(aq8n1\(aq پیکربندی می‌شود؛ این تنظیم با موارد زیر کنترل می‌شود:
.RS
.IP data_bits:
(5، 6، 7، 8 [پیش‌فرض] یا 9)
.IP parity_bits:
(\(aqn\(aq هیچ‌کدام [پیش‌فرض]، \(aqo\(aq فرد، \(aqe\(aq زوج، \(aqm\(aq علامت یا \(aqs\(aq فاصله)
.IP stop_bits:
(1 [پیش‌فرض] یا 2)
.IP flow_control:
(\(aq0\(aq هیچ‌کدام [پیش‌فرض]، \(aqx\(aq برای Xon Xoff، \(aqr\(aq برای RTSCTS، یا \(aqd\(aq برای DTRDSR)
.RE
.RE
.IP local:
بدون بخش نشانی.
.RE
.SH "مقدار بازگشتی (RETURN VALUE)"
اگر دستگاه مشخص‌شده پیدا نشود، یک کد خروج غیرصفر بازگردانده می‌شود.

.SH "همچنین ببینید (SEE ALSO)"
.ad l
.BR iio_attr (1),
.BR iio_info (1),
.BR iio_readdev (1),
.BR iio_reg (1),
.BR iio_writedev (1),
.BR libiio (3)
.PP
صفحه اصلی libiio:
.BR \%https://wiki.analog.com/resources/tools-software/linux-software/libiio
.PP
کد منبع libiio:
.BR \%https://github.com/analogdevicesinc/libiio
.PP
مستندات Doxygen برای libiio:
.BR \%https://analogdevicesinc.github.io/libiio
.SH "گزارش باگ‌ها (BUGS)"
تمام باگ‌ها در نشانی زیر پیگیری می‌شوند:
.BR \%https://github.com/analogdevicesinc/libiio/issues