نام (NAME)

i2cdetect - ابزار پویش و شناسایی دستگاه‌های متصل به گذرگاه I2C

خلاصه دستور (SYNOPSIS)

i2cdetect [-y] [-a] [-q|-r] i2cbus [first last]
i2cdetect -F i2cbus
i2cdetect -V
i2cdetect -h
i2cdetect -l

توضیحات (DESCRIPTION)

دستور i2cdetect یک برنامه در فضای کاربری برای پویش یک گذرگاه I2C جهت یافتن دستگاه‌ها است. این دستور جدولی شامل فهرست دستگاه‌های شناسایی‌شده روی گذرگاه مشخص‌شده را در خروجی نمایش می‌دهد. پارامتر i2cbus شماره یا نام گذرگاه I2C مورد نظر برای پویش را مشخص می‌کند و باید با یکی از گذرگاه‌های فهرست‌شده توسط i2cdetect -l مطابقت داشته باشد. پارامترهای اختیاری first و last محدوده پویش را محدود می‌کنند (پیش‌فرض: از 0x08 تا 0x77).

از آنجا که هیچ دستور استاندارد تشخیص I2C وجود ندارد، i2cdetect از دستورات دلخواه SMBus (به‌ویژه SMBus quick write و SMBus receive byte) برای کاوش دستگاه‌ها استفاده می‌کند. به‌طور پیش‌فرض، دستوری به کار گرفته می‌شود که تصور می‌شود برای هر نشانی امن‌ترین گزینه است. برای تغییر این رفتار، گزینه‌های -q و -r را ببینید.

همچنین می‌توان از i2cdetect برای پرس‌وجوی قابلیت‌های یک گذرگاه I2C استفاده کرد (گزینه -F را ببینید).

هشدار (WARNING)

این برنامه می‌تواند گذرگاه I2C شما را دچار اختلال کند، موجب از دست رفتن داده‌ها شود و حتی آسیب‌های بدتری وارد کند!

تفسیر خروجی (INTERPRETING THE OUTPUT)

هر خانه در جدول خروجی شامل یکی از نمادهای زیر خواهد بود:

• "--". نشانی کاوش شد اما هیچ تراشه‌ای پاسخ نداد.
• "UU". از کاوش صرف‌نظر شد، زیرا این نشانی در حال حاضر توسط یک درایور استفاده می‌شود. این موضوع قویاً نشان می‌دهد که تراشه‌ای در این نشانی وجود دارد.
• یک شماره نشانی در مبنای شانزده (هگزادسیمال)، مانند "2d" یا "4e". تراشه‌ای در این نشانی یافت شد.

گزینه‌ها (OPTIONS)

-y

غیرفعال کردن حالت تعاملی. به‌طور پیش‌فرض، i2cdetect پیش از دستکاری گذرگاه I2C منتظر تایید کاربر می‌ماند. هنگامی که از این فلگ استفاده شود، عملیات را مستقیماً انجام می‌دهد. این گزینه اساساً برای استفاده در اسکریپت‌ها در نظر گرفته شده است.

-a

اجبار به پویش نشانی‌های غیرمعمول. توصیه نمی‌شود.

-q

استفاده از دستور «quick write» در SMBus برای کاوش. توصیه نمی‌شود. مشخص شده است که این گزینه باعث آسیب به حافظه EEPROM مدل Atmel AT24RF08 موجود در بسیاری از لپ‌تاپ‌های IBM Thinkpad می‌شود.

-r

استفاده از دستور «receive byte» در SMBus برای کاوش. توصیه نمی‌شود. مشخص شده است که این گزینه باعث قفل شدن SMBus روی تراشه‌های مختلف فقط‌نوشتنی (به‌ویژه تراشه‌های ساعت در نشانی 0x69) می‌شود.

-F

نمایش فهرست قابلیت‌های پیاده‌سازی‌شده توسط آداپتور و خروج.

-V

نمایش نسخه برنامه و خروج.

-h

نمایش راهنما و خروج.

-l

چاپ فهرستی از گذرگاه‌های نصب‌شده در سیستم.

مثال‌ها (EXAMPLES)

فهرست کردن تمام گذرگاه‌های I2C موجود:

# i2cdetect -l

پویش فوری نشانی‌های استاندارد روی گذرگاه I2C شماره ۹ (i2c-9)، با استفاده از روش پیش‌فرض برای هر نشانی (بدون تایید کاربر):

# i2cdetect -y 9

پرس‌وجوی قابلیت‌های گذرگاه I2C شماره ۱ (i2c-1):

# i2cdetect -F 1

پویش نشانی‌های 0x10 تا 0x17 روی گذرگاه I2C با نام «SMBus I801 adapter at efa0»، با استفاده از روش «receive byte»، پس از تایید کاربر:

# i2cdetect -r "SMBus I801 adapter at efa0" 0x10 0x17

اشکالات (BUGS)

برای گزارش اشکالات یا ارسال اصلاحیه‌ها، لطفاً به فهرست پستی Linux I2C به نشانی <linux-i2c@vger.kernel.org> همراه با رونوشت (Cc) به نگهدارنده فعلی پیام بفرستید: Jean Delvare <jdelvare@suse.de>.

همچنین ببینید (SEE ALSO)

i2cdump(8), i2cget(8), i2cset(8), i2ctransfer(8), sensors-detect(8)

نویسنده (AUTHOR)

Frodo Looijaard, Mark D. Studebaker and Jean Delvare

این صفحه راهنما در ابتدا توسط Aurelien Jarno <aurel32@debian.org> برای سیستم گنو/لینوکس دبیان نوشته شده است.