.\" 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_genxml 1 "24 December 2025" "libiio-0.26" "LibIIO Utilities"
.IX iio_genxml
.SH "نام (NAME)"
iio_genxml \- تولید کانتکست XML برای دستگاه‌های IIO در لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
.B iio_genxml
[
.I گزینه‌ها
]

.SH "توضیحات (DESCRIPTION)"
دستور
.B iio_genxml
ابزاری برای تولید نمایش XML از یک کانتکست Libiio است.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
نمایش پیام راهنما و سپس خروج.
.TP
.B \-V, \-\-version
چاپ اطلاعات نسخه این نسخه از
.I iio_genxml
و نسخه کتابخانه libiio مورد استفاده آن. این گزینه برای بررسی به‌روز بودن نسخه کتابخانه و
.I iio_genxml
روی سیستم و همچنین هنگام گزارش اشکالات مفید است.
.TP
.B \-S, \-\-scan [پشت‌بندها]
پایش کانتکست‌های موجود 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:[آدرس]
آدرس شبکه، به صورت عددی (192.168.0.1) یا نام میزبان شبکه.
.IP ip:
خالی؛ در صورت کامپایل با پشتیبانی از zeroconf، دستگاه IIO را روی شبکه پیدا می‌کند.
.IP usb:[دستگاه:درگاه:نمونه]
معمولاً از خروجی
.B iio_genxml -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 "همچنین ببینید (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