.\" 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_attr 1 "24 December 2025" "libiio-0.26" "LibIIO Utilities"
.IX iio_attr
.SH "نام (NAME)"
iio_attr \- فهرست‌کردن دستگاه‌های IIO و خواندن یا نوشتن مشخصه‌های دستگاه
.SH "خلاصه دستور (SYNOPSIS)"
.B iio_attr
[
.I options
]
-d [device] [attr] [value]
.br
.B iio_attr
[
.I options
]
-c [device] [channel] [attr] [value]
.br
.B iio_attr
[
.I options
]
-D [device] [attr] [value]
.br
.B iio_attr
[
.I options
]
-C [attr]
.br
.B iio_attr
-S <arg>
.br
.B iio_attr
-h

.SH "توضیحات (DESCRIPTION)"
دستور
.B iio_attr
ابزاری برای نمایش اطلاعات درباره دستگاه‌های IIO محلی یا از راه دور است.
با مشخص‌کردن یک مقدار اختیاری،
.B iio_attr
تلاش می‌کند تا مقدار جدید را در مشخصه موردنظر بنویسد.

.SH "دستورها (COMMANDS)"
.TP
ابزار iio_attr دارای چند گزینه اصلی است که عملکرد کلی برنامه را کنترل می‌کنند.
.TP
.B \-d, \-\-device-attr
خواندن و نوشتن مشخصه‌های دستگاه IIO
.TP
.B \-c \-\-channel-attr
خواندن و نوشتن مشخصه‌های کانال IIO
.TP
.B \-B \-\-buffer-attr
خواندن و نوشتن مشخصه‌های بافر IIO
.TP
.B \-C \-\-context-attr
خواندن و نوشتن مشخصه‌های کانتکست IIO
.TP
.B \-D \-\-debug-attr
خواندن و نوشتن مشخصه‌های اشکال‌زدایی IIO
.TP
.B \-h, \-\-help
به
.I iio_attr
دستور می‌دهد تا پیام راهنما را نمایش داده و خارج شود.
.TP
.B \-V, \-\-version
اطلاعات نسخه این نگارش از
.I iio_attr
و نسخه کتابخانه libiio مورد استفاده آن را چاپ می‌کند. این گزینه برای بررسی به‌روز بودن نسخه کتابخانه و
.I iio_attr
روی سیستم شما، و همچنین هنگام گزارش باگ‌ها مفید است.
.TP
.B \-S, \-\-scan [backends]
پویش برای کانتکست‌های IIO موجود؛ آرگومان اختیاری برای بک‌اند(های) مشخص مانند \(aqip\(aq، \(aqusb\(aq یا \(aqip:usb\(aq است.
گزینه‌های اختصاصی برای USB شامل شناسه فروشنده (Vendor ID) و شناسه محصول (Product ID) برای محدود کردن پویش به دستگاه‌های خاص مانند \(aqusb=0456,b673\(aq هستند.
‏vid و pid اعدادی در مبنای شانزده (هگزادسیمال، بدون نیاز به پیشوند) می‌باشند، و علامت \(lq*\(rq برای تطابق با هر مقداری (تنها برای pid) به کار می‌رود.
اگر آرگومانی داده نشود، همه موارد موجود بررسی خواهند شد.
.SH "گزینه‌ها (OPTIONS)"
.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_attr -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 علامت (mark)، یا \(aqs\(aq فاصله (space))
.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
.TP
.B \-i, \-\-input-channel
فیلتر کردن کانال‌ها تنها بر اساس کانال‌های ورودی
.TP
.B \-o, \-\-output-channel
فیلتر کردن کانال‌ها تنها بر اساس کانال‌های خروجی
.TP
.B \-s, \-\-scan-channel
فیلتر کردن کانال‌ها تنها بر اساس کانال‌های پویش
.TP
.B \-I, \-\-ignore-case
نادیده گرفتن بزرگی و کوچکی حروف هنگام تطبیق الگوی دستگاه‌ها، کانال‌ها یا مشخصه‌ها
.TP
.B \-g, \-\-generate-code <arg>
تولید قطعه‌کدهای کوچک C یا python که عملکرد شما در خط فرمان را شبیه‌سازی می‌کنند. آرگومان یک نام فایل مانند \(aqfoo.c\(aq یا \(aqfoo.py\(aq است.
.TP
.SH "وضعیت خروج (EXIT STATUS)"
در صورتی که دستگاه مشخص‌شده یافت نشود، یک کد خروج غیر صفر برگردانده می‌شود.

.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