| iio_writedev(1) | LibIIO Utilities | iio_writedev(1) |
نام (NAME)
iio_writedev - نوشتن دادهها در دستگاههای نمونهبرداری ورودی/خروجی صنعتی (IIO)
خلاصه دستور (SYNOPSIS)
iio_writedev [ گزینهها ] [-t <محرک>] [-T <مهلت-زمانی-میلیثانیه>] [-b <اندازه-بافر>] [-s <نمونهها>] <دستگاه_iio> [<کانال> ...]
توضیحات (DESCRIPTION)
ابزار iio_writedev برای نوشتن بافرها روی دستگاههای متصل IIO به کار میرود.
گزینهها (OPTIONS)
- -h, --help
- نمایش پیام راهنما و سپس خروج.
- -V, --version
- چاپ اطلاعات نسخه این رونوشت از iio_writedev و نسخه کتابخانه libiio مورد استفاده. این گزینه برای آگاهی از بهروز بودن نسخه کتابخانه و iio_writedev روی سیستم شما و همچنین هنگام گزارش اشکالات مفید است.
- -S, --scan [پشتبندها]
- پویش برای یافتن زمینههای (context) موجود IIO؛ آرگومان اختیاری برای پشتبند(های) خاص 'ip'، 'usb' یا 'ip:usb'. گزینههای خاص برای USB شامل شناسه سازنده (Vendor ID) و شناسه محصول (Product ID) است تا پویش به دستگاههای مشخصی مانند 'usb=0456,b673' محدود شود. شناسههای vid و pid اعداد هگزادسیمال هستند (بدون نیاز به پیشوند)، و "*" (تطبیق با هر موردی، فقط برای pid). اگر آرگومانی داده نشود، تمامی موارد موجود بررسی میشوند.
- -t, --trigger
- استفاده از محرک (trigger) مشخصشده در صورت نیاز روی کانال معین.
- -b, --buffer-size
- اندازه بافر انتقال. مقدار پیشفرض ۲۵۶ است.
- -s, --samples
- تعداد نمونهها (نه بایتها) برای انتقال، مقدار 0 = نامحدود. پیشفرض 0 است.
- -T, --timeout
- مهلت زمانی بافر بر حسب میلیثانیه. مقدار 0 = بدون مهلت زمانی. پیشفرض 0 است.
- -c, --cyclic
- استفاده از حالت بافر چرخهای (cyclic).
- -u, --uri
- شناسه یکنواخت منبع (uri) برای اتصال به دستگاهها، که میتواند یکی از موارد زیر باشد:
- ip:[آدرس]
- آدرس شبکه، بهصورت عددی (192.168.0.1) یا نام میزبان شبکه.
- ip:
- خالی؛ در صورت کامپایل با پشتیبانی zeroconf، دستگاه IIO را روی شبکه پیدا میکند.
- usb:[دستگاه:پورت:نمونه]
- معمولاً از خروجی دستور iio_writedev -S به دست میآید.
- serial:[پورت],[نرخ_باد],[تنظیمات]
- که کنترل میشوند و باید با iiod (یا tinyiiod) در سمت دیگر پورت سریال مطابقت داشته باشند.
- [پورت]
- مقداری مانند '/dev/ttyUSB0' در لینوکس و 'COM4' در ویندوز است.
- [نرخ_باد]
- معمولاً یکی از مقادیر 110, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200 [پیشفرض], 128000 یا 256000 است، اما میتواند در هر سیستم متفاوت باشد.
- [تنظیمات]
- معمولاً بهصورت '8n1' پیکربندی میشود و با موارد زیر کنترل میگردد:
- data_bits:
- (5، 6، 7، 8 [پیشفرض]، یا 9)
- parity_bits:
- ('n' بدون توازن [پیشفرض]، 'o' فرد، 'e' زوج، 'm' علامت، یا 's' فاصله)
- stop_bits:
- (1 [پیشفرض] یا 2)
- flow_control:
- ('0' بدون کنترل [پیشفرض]، 'x' نرمافزاری Xon Xoff، 'r' سختافزاری RTSCTS، یا 'd' سختافزاری DTRDSR)
- local:
- بدون بخش آدرس.
مقدار بازگشتی (RETURN VALUE)
در صورتی که دستگاه مشخصشده یافت نشود، یک کد خروج غیرصفر بازگردانده میشود.
نحوه استفاده (USAGE)
شما از iio_writedev مشابه بسیاری از ابزارهای دیگر libiio استفاده میکنید. باید یک دستگاه IIO و کانال خاص را برای نوشتن مشخص کنید. از آنجا که این یک عملیات نوشتن است، کانالها باید از نوع خروجی باشند. اگر کانالی مشخص نشود، iio_writedev روی تمامی کانالهای خروجی خواهد نوشت. اگر دستگاهی مشخص نشود، iio_writedev چند مثال را چاپ میکند:
Using auto-detected IIO context at URI "usb:3.10.5"
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc voltage0
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc voltage1
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc voltage2
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc voltage3
Example : iio_writedev -u usb:3.10.5 -b 256 -s 1024 cf-ad9361-dds-core-lpc
این دستور ۱۰۲۴ نمونه از دادههای I و Q را به تراشه AD9361 متصل از طریق USB ارسال میکند. دادهها بهصورت باینری از ورودی استاندارد دریافت میشوند.
همچنین ببینید (SEE ALSO)
iio_attr(1), iio_info(1), iio_readdev(1), iio_reg(1), iio_writedev(1), libiio(3)
تارنمای libiio: https://wiki.analog.com/resources/tools-software/linux-software/libiio
کد منبع libiio: https://github.com/analogdevicesinc/libiio
مستندات Doxygen برای libiio: https://analogdevicesinc.github.io/libiio
گزارش اشکالات (BUGS)
تمامی اشکالات در نشانی زیر پیگیری میشوند: https://github.com/analogdevicesinc/libiio/issues
| 24 December 2025 | libiio-0.26 |