.\" 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_writedev 1 "24 December 2025" "libiio-0.26" "LibIIO Utilities"
.IX iio_writedev_
.SH "نام (NAME)"
iio_writedev \- نوشتن داده‌ها در دستگاه‌های نمونه‌برداری ورودی/خروجی صنعتی (IIO)
.SH "خلاصه دستور (SYNOPSIS)"
.B iio_writedev
[
.I گزینه‌ها
]
[\-t <محرک>] [\-T <مهلت-زمانی-میلی‌ثانیه>] [\-b <اندازه-بافر>] [\-s <نمونه‌ها>] <دستگاه_iio> [<کانال> ...]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B iio_writedev
برای نوشتن بافرها روی دستگاه‌های متصل IIO به کار می‌رود.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
نمایش پیام راهنما و سپس خروج.
.TP
.B \-V, \-\-version
چاپ اطلاعات نسخه این رونوشت از
.I iio_writedev
و نسخه کتابخانه libiio مورد استفاده. این گزینه برای آگاهی از به‌روز بودن نسخه کتابخانه و
.I iio_writedev
روی سیستم شما و همچنین هنگام گزارش اشکالات مفید است.
.TP
.B \-S, \-\-scan [پشت‌بندها]
پویش برای یافتن زمینه‌های (context) موجود IIO؛ آرگومان اختیاری برای پشت‌بند(های) خاص 'ip'، 'usb' یا 'ip:usb'.
گزینه‌های خاص برای USB شامل شناسه سازنده (Vendor ID) و شناسه محصول (Product ID) است تا پویش به دستگاه‌های مشخصی مانند 'usb=0456,b673' محدود شود.
شناسه‌های vid و pid اعداد هگزادسیمال هستند (بدون نیاز به پیشوند)، و "*" (تطبیق با هر موردی، فقط برای pid).
اگر آرگومانی داده نشود، تمامی موارد موجود بررسی می‌شوند.
.TP
.B \-t, \-\-trigger
استفاده از محرک (trigger) مشخص‌شده در صورت نیاز روی کانال معین.
.TP
.B \-b, \-\-buffer-size
اندازه بافر انتقال. مقدار پیش‌فرض ۲۵۶ است.
.TP
.B \-s, \-\-samples
تعداد نمونه‌ها (نه بایت‌ها) برای انتقال، مقدار 0 = نامحدود. پیش‌فرض 0 است.
.TP
.B \-T, \-\-timeout
مهلت زمانی بافر بر حسب میلی‌ثانیه. مقدار 0 = بدون مهلت زمانی. پیش‌فرض 0 است.
.TP
.B \-c, \-\-cyclic
استفاده از حالت بافر چرخه‌ای (cyclic).
.TP
.B \-u, \-\-uri
شناسه یکنواخت منبع
.I (uri)
برای اتصال به دستگاه‌ها، که می‌تواند یکی از موارد زیر باشد:
.RS
.IP ip:[آدرس]
آدرس شبکه، به‌صورت عددی (192.168.0.1) یا نام میزبان شبکه.
.IP ip:
خالی؛ در صورت کامپایل با پشتیبانی zeroconf، دستگاه IIO را روی شبکه پیدا می‌کند.
.IP usb:[دستگاه:پورت:نمونه]
معمولاً از خروجی دستور
.B iio_writedev -S
به دست می‌آید.
.IP serial:[پورت],[نرخ_باد],[تنظیمات]
که کنترل می‌شوند و باید با iiod (یا tinyiiod) در سمت دیگر پورت سریال مطابقت داشته باشند.
.RS
.IP [پورت]
مقداری مانند '/dev/ttyUSB0' در لینوکس و 'COM4' در ویندوز است.
.IP [نرخ_باد]
معمولاً یکی از مقادیر 110, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200 [پیش‌فرض], 128000 یا 256000 است، اما می‌تواند در هر سیستم متفاوت باشد.
.IP [تنظیمات]
معمولاً به‌صورت '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 "مقدار بازگشتی (RETURN VALUE)"
در صورتی که دستگاه مشخص‌شده یافت نشود، یک کد خروج غیرصفر بازگردانده می‌شود.

.SH "نحوه استفاده (USAGE)"
.PP
شما از
.B iio_writedev
مشابه بسیاری از ابزارهای دیگر libiio استفاده می‌کنید.
باید یک دستگاه IIO و کانال خاص را برای نوشتن مشخص کنید. از آنجا که این یک عملیات نوشتن است، کانال‌ها باید از نوع خروجی باشند.
اگر کانالی مشخص نشود،
.B iio_writedev
روی تمامی کانال‌های خروجی خواهد نوشت.
اگر دستگاهی مشخص نشود،
.B iio_writedev
چند مثال را چاپ می‌کند:
.RS
.B \f(CWiio_writedev -a\fP
.br
Using auto-detected IIO context at URI "usb:3.10.5"
.br
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc voltage0
.br
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc voltage1
.br
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc voltage2
.br
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc voltage3
.br
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc
.RE
.PP
این دستور ۱۰۲۴ نمونه از داده‌های I و Q را به تراشه AD9361 متصل از طریق USB ارسال می‌کند. داده‌ها به‌صورت باینری از ورودی استاندارد دریافت می‌شوند.
.RS
.B \f(CWiio_writedev \-a \-s 1024 cf-ad9361-dds-core-lpc voltage0 voltage1 < ./samples.dat\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