.\" 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_readdev 1 "24 December 2025" "libiio-0.26" "LibIIO Utilities"
.IX iio_readdev_
.SH "نام (NAME)"
iio_readdev \- خواندن بافرها از یک دستگاه IIO
.SH "خلاصه دستور (SYNOPSIS)"
.B iio_readdev
[
.I options
]
[-n <hostname>] [-t <trigger>] [-T <timeout-ms>] [-b <buffer-size>] [-s <samples>] <iio_device> [<channel> ...]
.SH "توضیحات (DESCRIPTION)"
.B iio_reg
ابزاری برای خواندن بافرها از دستگاه‌های IIO متصل‌شده و ارسال نتایج به خروجی استاندارد است.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
به
.I iio_readdev
اعلام می‌کند که پیام راهنما را نمایش داده و سپس خارج شود.
.TP
.B \-V, \-\-version
اطلاعات نسخه این رونوشت از
.I iio_readdev
و نسخه کتابخانه libiio مورد استفاده آن را چاپ می‌کند. این گزینه برای آگاهی از به‌روز بودن نسخه کتابخانه و
.I iio_readdev
روی سیستم شما، و همچنین هنگام گزارش باگ‌ها مفید است.
.TP
.B \-S, \-\-scan [backends]
پویش برای زمینه‌های (contexts) در دسترس IIO؛ با آرگومان اختیاری برای مشخص کردن بک‌اند(های) 'ip' ،'usb' یا 'ip:usb'.
گزینه‌های اختصاصی برای USB شامل شناسه سازنده (Vendor ID) و شناسه محصول (Product ID) جهت محدود کردن پویش به دستگاه‌های مشخص 'usb=0456,b673' است.
شناسه‌های vid و pid اعدادی در مبنای شانزده هستند (بدون نیاز به پیشوند)، و "*" (تنها برای pid، جهت مطابقت با هر شناسه‌ای).
اگر آرگومانی داده نشود، تمام موارد موجود بررسی می‌شوند.
.TP
.B \-t \-\-trigger
استفاده از تریگر مشخص‌شده در صورت نیاز روی کانال تعیین‌شده.
.TP
.B \-b \-\-buffer-size
اندازه بافر ضبط داده. مقدار پیش‌فرض ۲۵۶ است.
.TP
.B \-s \-\-samples
تعداد نمونه‌ها (نه بایت‌ها) برای دریافت؛ 0 = نامحدود. مقدار پیش‌فرض 0 است.
.TP
.B \-T \-\-timeout
زمان‌انتظار بافر بر حسب میلی‌ثانیه. 0 = بدون زمان‌انتظار. مقدار پیش‌فرض 0 است.
.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_readdev -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
.SH "وضعیت خروج (EXIT STATUS)"
در صورتی که دستگاه مشخص‌شده یافت نشود، یک کد خروج غیر صفر بازگردانده می‌شود.

.SH "نحوه استفاده (USAGE)"
.PP
شما از iio_readdev به همان شیوه‌ای استفاده می‌کنید که از سایر ابزارهای کاربردی libiio بهره می‌برید.
شما باید یک دستگاه IIO و کانال مشخص برای خواندن را تعیین کنید. از آنجا که این یک عملیات خواندن است، کانال‌ها باید ورودی باشند.
اگر کانالی مشخص نشود، iio_readdev از تمام کانال‌های ورودی خواهد خواند.
اگر هیچ دستگاهی تعیین نشود، iio_readdev چند مثال را چاپ می‌کند:
.RS
.B \f(CWiio_readdev -a\fP
.br
Using auto-detected IIO context at URI "usb:3.10.5"
.br
Example : iio_readdev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-lpc voltage0
.br
Example : iio_readdev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-lpc voltage1
.br
Example : iio_readdev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-lpc voltage2
.br
Example : iio_readdev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-lpc voltage3
.br
Example : iio_readdev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-lpc
.RE
.PP
این دستور ۱۰۲۴ نمونه از داده‌های I و Q را از دستگاه AD9361 متصل به USB دریافت کرده و آن‌ها را (به صورت دودویی خام) در فایل samples.dat ذخیره می‌کند:
.RS
.B \f(CWiio_readdev \-a \-s 1024 cf-ad9361-lpc voltage0 voltage1 > samples.dat\fP
.RE
.PP
و رسم داده‌ها با gnuplot:
.RS
.B \f(WCgnuplot \-e \(dq\&set term png; set output 'sample.png'; plot 'sample.dat' binary format='%short%short' using 1 with lines, 'sample.dat' binary format='%short%short' using 2 with lines;\(dq\&\fP
.RE

.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