.\" 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_info 1 "24 December 2025" "libiio-0.26" "LibIIO Utilities"
.IX iio_info
.SH "نام (NAME)"
iio_info \- فهرست کردن دستگاه‌های IIO و ویژگی‌های آن‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.B iio_info
[
.I options
]
-u <uri>
.SH "توضیحات (DESCRIPTION)"
ابزار
.B iio_info
برای نمایش اطلاعات مربوط به دستگاه‌های محلی یا راه دور IIO (سامانه ورودی/خروجی صنعتی لینوکس) به کار می‌رود.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
به
.I iio_info
اعلام می‌کند که راهنما را نمایش داده و سپس خارج شود.
.TP
.B \-V, \-\-version
اطلاعات نسخه این برنامه
.I iio_info
و نسخه کتابخانه libiio مورد استفاده را چاپ می‌کند. این گزینه برای اطلاع از به‌روز بودن نسخه کتابخانه و
.I iio_info
روی سیستم شما، و همچنین هنگام گزارش باگ‌ها مفید است.
.TP
.B \-S, \-\-scan [backends]
پویش برای بافت‌های (contexts) موجود IIO؛ آرگومان اختیاری شامل بک‌اند(های) خاص 'ip'، 'usb' یا 'ip:usb' است.
گزینه‌های خاص برای USB شامل Vendor ID و Product ID برای محدود کردن پویش به دستگاه‌های مشخص مانند 'usb=0456,b673' می‌باشد.
شناسه‌های 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_info -S
به دست می‌آید.
.IP serial:[port],[baud],[settings]
که کنترل‌شده هستند و باید با iiod (یا tinyiiod) در طرف دیگر درگاه سریال مطابقت داشته باشند.
.RS
.IP [port]
موردی مانند '/dev/ttyUSB0' در لینوکس و 'COM4' در ویندوز است.
.IP [baud]
معمولاً یکی از مقادیر 110، 300، 600، 1200، 2400، 4800، 9600، 14400، 19200، 38400، 57600، 115200 [پیش‌فرض]، 128000 یا 256000 است، اما می‌تواند از سیستمی به سیستم دیگر متفاوت باشد.
.IP [settings]
به طور معمول به صورت '8n1' پیکربندی می‌شود و توسط موارد زیر کنترل می‌گردد:
.RS
.IP data_bits:
(5، 6، 7، 8 [پیش‌فرض] یا 9)
.IP parity_bits:
('n' بدون بیت توازن [پیش‌فرض]، 'o' فرد، 'e' زوج، 'm' نشانه یا 's' فاصله)
.IP stop_bits:
(1 [پیش‌فرض] یا 2)
.IP flow_control:
('0' بدون کنترل جریان [پیش‌فرض]، 'x' نرم‌افزاری Xon Xoff، 'r' سخت‌افزاری RTSCTS یا 'd' سخت‌افزاری DTRDSR)
.RE
.RE
.IP local:
بدون بخش آدرس.
.RE
.TP
.B \-a, \-\-auto
پویش برای بافت‌های موجود و استفاده از آن در صورت وجود تنها یک بافت.

.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 "گزارش باگ‌ها (REPORTING BUGS)"
تمام باگ‌ها در پیوند زیر پیگیری می‌شوند:
.BR \%https://github.com/analogdevicesinc/libiio/issues