.TH I2CDETECT 8 "May 2022" .SH "نام (NAME)" i2cdetect \- ابزار پویش و شناسایی دستگاه‌های متصل به گذرگاه I2C .SH "خلاصه دستور (SYNOPSIS)" .B i2cdetect .RI [ -y ] .RI [ -a ] .RI [ -q | -r ] .I i2cbus .RI [ "first last" ] .br .B i2cdetect .I -F .I i2cbus .br .B i2cdetect .I -V .br .B i2cdetect .I -h .br .B i2cdetect .I -l .SH "توضیحات (DESCRIPTION)" دستور .B i2cdetect یک برنامه در فضای کاربری برای پویش یک گذرگاه I2C جهت یافتن دستگاه‌ها است. این دستور جدولی شامل فهرست دستگاه‌های شناسایی‌شده روی گذرگاه مشخص‌شده را در خروجی نمایش می‌دهد. پارامتر \fIi2cbus\fR شماره یا نام گذرگاه I2C مورد نظر برای پویش را مشخص می‌کند و باید با یکی از گذرگاه‌های فهرست‌شده توسط .B i2cdetect \-l مطابقت داشته باشد. پارامترهای اختیاری \fIfirst\fR و \fIlast\fR محدوده پویش را محدود می‌کنند (پیش‌فرض: از 0x08 تا 0x77). .PP از آنجا که هیچ دستور استاندارد تشخیص I2C وجود ندارد، .B i2cdetect از دستورات دلخواه SMBus (به‌ویژه SMBus quick write و SMBus receive byte) برای کاوش دستگاه‌ها استفاده می‌کند. به‌طور پیش‌فرض، دستوری به کار گرفته می‌شود که تصور می‌شود برای هر نشانی امن‌ترین گزینه است. برای تغییر این رفتار، گزینه‌های \fI\-q\fR و \fI\-r\fR را ببینید. .PP همچنین می‌توان از .B i2cdetect برای پرس‌وجوی قابلیت‌های یک گذرگاه I2C استفاده کرد (گزینه .B \-F را ببینید). .SH "هشدار (WARNING)" این برنامه می‌تواند گذرگاه I2C شما را دچار اختلال کند، موجب از دست رفتن داده‌ها شود و حتی آسیب‌های بدتری وارد کند! .SH "تفسیر خروجی (INTERPRETING THE OUTPUT)" هر خانه در جدول خروجی شامل یکی از نمادهای زیر خواهد بود: .IP \(bu "\w'\(bu'u+1n" "--". نشانی کاوش شد اما هیچ تراشه‌ای پاسخ نداد. .IP \(bu "UU". از کاوش صرف‌نظر شد، زیرا این نشانی در حال حاضر توسط یک درایور استفاده می‌شود. این موضوع قویاً نشان می‌دهد که تراشه‌ای در این نشانی وجود دارد. .IP \(bu یک شماره نشانی در مبنای شانزده (هگزادسیمال)، مانند "2d" یا "4e". تراشه‌ای در این نشانی یافت شد. .SH "گزینه‌ها (OPTIONS)" .TP .B "\-y" غیرفعال کردن حالت تعاملی. به‌طور پیش‌فرض، i2cdetect پیش از دستکاری گذرگاه I2C منتظر تایید کاربر می‌ماند. هنگامی که از این فلگ استفاده شود، عملیات را مستقیماً انجام می‌دهد. این گزینه اساساً برای استفاده در اسکریپت‌ها در نظر گرفته شده است. .TP .B "\-a" اجبار به پویش نشانی‌های غیرمعمول. توصیه نمی‌شود. .TP .B "\-q" استفاده از دستور «quick write» در SMBus برای کاوش. توصیه نمی‌شود. مشخص شده است که این گزینه باعث آسیب به حافظه EEPROM مدل Atmel AT24RF08 موجود در بسیاری از لپ‌تاپ‌های IBM Thinkpad می‌شود. .TP .B "\-r" استفاده از دستور «receive byte» در SMBus برای کاوش. توصیه نمی‌شود. مشخص شده است که این گزینه باعث قفل شدن SMBus روی تراشه‌های مختلف فقط‌نوشتنی (به‌ویژه تراشه‌های ساعت در نشانی 0x69) می‌شود. .TP .B "\-F" نمایش فهرست قابلیت‌های پیاده‌سازی‌شده توسط آداپتور و خروج. .TP .B "\-V" نمایش نسخه برنامه و خروج. .TP .B "\-h" نمایش راهنما و خروج. .TP .B "\-l" چاپ فهرستی از گذرگاه‌های نصب‌شده در سیستم. .SH "مثال‌ها (EXAMPLES)" .PP فهرست کردن تمام گذرگاه‌های I2C موجود: .nf .RS # i2cdetect -l .RE .fi .PP پویش فوری نشانی‌های استاندارد روی گذرگاه I2C شماره ۹ (i2c-9)، با استفاده از روش پیش‌فرض برای هر نشانی (بدون تایید کاربر): .nf .RS # i2cdetect -y 9 .RE .fi .PP پرس‌وجوی قابلیت‌های گذرگاه I2C شماره ۱ (i2c-1): .nf .RS # i2cdetect -F 1 .RE .fi .PP پویش نشانی‌های 0x10 تا 0x17 روی گذرگاه I2C با نام «SMBus I801 adapter at efa0»، با استفاده از روش «receive byte»، پس از تایید کاربر: .nf .RS # i2cdetect -r "SMBus I801 adapter at efa0" 0x10 0x17 .RE .fi .SH "اشکالات (BUGS)" برای گزارش اشکالات یا ارسال اصلاحیه‌ها، لطفاً به فهرست پستی Linux I2C به نشانی همراه با رونوشت (Cc) به نگهدارنده فعلی پیام بفرستید: Jean Delvare . .SH "همچنین ببینید (SEE ALSO)" i2cdump(8), i2cget(8), i2cset(8), i2ctransfer(8), sensors-detect(8) .SH "نویسنده (AUTHOR)" Frodo Looijaard, Mark D. Studebaker and Jean Delvare .PP این صفحه راهنما در ابتدا توسط Aurelien Jarno برای سیستم گنو/لینوکس دبیان نوشته شده است.