| iio_attr(1) | LibIIO Utilities | iio_attr(1) |
نام (NAME)
iio_attr - فهرستکردن دستگاههای IIO و خواندن یا نوشتن مشخصههای دستگاه
خلاصه دستور (SYNOPSIS)
iio_attr [ options ] -d [device] [attr] [value]
iio_attr [ options ] -c [device] [channel] [attr] [value]
iio_attr [ options ] -D [device] [attr] [value]
iio_attr [ options ] -C [attr]
iio_attr -S <arg>
iio_attr -h
توضیحات (DESCRIPTION)
دستور iio_attr ابزاری برای نمایش اطلاعات درباره دستگاههای IIO محلی یا از راه دور است. با مشخصکردن یک مقدار اختیاری، iio_attr تلاش میکند تا مقدار جدید را در مشخصه موردنظر بنویسد.
دستورها (COMMANDS)
- ابزار iio_attr دارای چند گزینه اصلی است که عملکرد کلی برنامه را کنترل میکنند.
- -d, --device-attr
- خواندن و نوشتن مشخصههای دستگاه IIO
- -c --channel-attr
- خواندن و نوشتن مشخصههای کانال IIO
- -B --buffer-attr
- خواندن و نوشتن مشخصههای بافر IIO
- -C --context-attr
- خواندن و نوشتن مشخصههای کانتکست IIO
- -D --debug-attr
- خواندن و نوشتن مشخصههای اشکالزدایی IIO
- -h, --help
- به iio_attr دستور میدهد تا پیام راهنما را نمایش داده و خارج شود.
- -V, --version
- اطلاعات نسخه این نگارش از iio_attr و نسخه کتابخانه libiio مورد استفاده آن را چاپ میکند. این گزینه برای بررسی بهروز بودن نسخه کتابخانه و iio_attr روی سیستم شما، و همچنین هنگام گزارش باگها مفید است.
- -S, --scan [backends]
- پویش برای کانتکستهای IIO موجود؛ آرگومان اختیاری برای بکاند(های) مشخص مانند 'ip'، 'usb' یا 'ip:usb' است. گزینههای اختصاصی برای USB شامل شناسه فروشنده (Vendor ID) و شناسه محصول (Product ID) برای محدود کردن پویش به دستگاههای خاص مانند 'usb=0456,b673' هستند. vid و pid اعدادی در مبنای شانزده (هگزادسیمال، بدون نیاز به پیشوند) میباشند، و علامت “*” برای تطابق با هر مقداری (تنها برای pid) به کار میرود. اگر آرگومانی داده نشود، همه موارد موجود بررسی خواهند شد.
گزینهها (OPTIONS)
- -u, --uri
- شناسه یکنواخت منبع (uri) برای اتصال به دستگاهها، که میتواند یکی از موارد زیر باشد:
- ip:[address]
- آدرس شبکه، به صورت عددی (192.168.0.1) یا نام میزبان در شبکه
- ip:
- خالی؛ در صورت کامپایل شدن برنامه با پشتیبانی از zeroconf، یک دستگاه IIO را در شبکه پیدا میکند
- usb:[device:port:instance]
- معمولاً از خروجی iio_attr -S به دست میآید
- serial:[port],[baud],[settings]
- که کنترل میشوند و باید با iiod (یا tinyiiod) در طرف دیگر درگاه سریال مطابقت داشته باشند.
- [port]
- چیزی شبیه به '/dev/ttyUSB0' در لینوکس، و 'COM4' در ویندوز است.
- [baud]
- معمولاً یکی از مقادیر 110، 300، 600، 1200، 2400، 4800، 9600، 14400، 19200، 38400، 57600، 115200 [پیشفرض]، 128000 یا 256000 است، اما میتواند از سیستمی به سیستم دیگر تفاوت داشته باشد.
- [settings]
- به طور معمول به صورت '8n1' پیکربندی میشود و توسط موارد زیر کنترل میشود:
- data_bits:
- (5، 6، 7، 8 [پیشفرض]، یا 9)
- parity_bits:
- ('n' هیچکدام [پیشفرض]، 'o' فرد، 'e' زوج، 'm' علامت (mark)، یا 's' فاصله (space))
- stop_bits:
- (1 [پیشفرض]، یا 2)
- flow_control:
- ('0' هیچکدام [پیشفرض]، 'x' برای Xon Xoff، 'r' برای RTSCTS، یا 'd' برای DTRDSR)
- local:
- بدون بخش آدرس.
- -i, --input-channel
- فیلتر کردن کانالها تنها بر اساس کانالهای ورودی
- -o, --output-channel
- فیلتر کردن کانالها تنها بر اساس کانالهای خروجی
- -s, --scan-channel
- فیلتر کردن کانالها تنها بر اساس کانالهای پویش
- -I, --ignore-case
- نادیده گرفتن بزرگی و کوچکی حروف هنگام تطبیق الگوی دستگاهها، کانالها یا مشخصهها
- -g, --generate-code <arg>
- تولید قطعهکدهای کوچک C یا python که عملکرد شما در خط فرمان را شبیهسازی میکنند. آرگومان یک نام فایل مانند 'foo.c' یا 'foo.py' است.
وضعیت خروج (EXIT STATUS)
در صورتی که دستگاه مشخصشده یافت نشود، یک کد خروج غیر صفر برگردانده میشود.
همچنین ببینید (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 |