.TH I2CDUMP 8 "مه ۲۰۲۲"
.SH "نام (NAME)"
i2cdump \- بررسی و استخراج ثبات‌های I2C

.SH "خلاصه دستور (SYNOPSIS)"
.B i2cdump
.RB [ -f ]
.RB [ "-r first-last" ]
.RB [ -y ]
.RB [ -a ]
.I i2cbus
.I address
.RI [ "mode " [ "bank " [ bankreg ]]]
.br
.B i2cdump
.B -V
.br
.B i2cdump
.B -h

.SH "توضیحات (DESCRIPTION)"
دستور
.B i2cdump
یک برنامه کمکی کوچک برای بررسی ثبات‌های قابل مشاهده از طریق گذرگاه I2C است.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B -V
نمایش نسخه و خروج.
.TP
.B -h
نمایش راهنما و خروج.
.TP
.B -f
اجبار به دسترسی به دستگاه حتی در صورتی که مشغول باشد. به‌طور پیش‌فرض،
.B i2cdump
از دسترسی به دستگاهی که تحت کنترل درایور هسته است خودداری می‌کند. استفاده از این فلگ خطرناک است و می‌تواند درایور هسته مربوطه را به شدت سردرگم کند. همچنین می‌تواند باعث شود
.B i2cdump
نتایج نامعتبر بازگرداند. بنابراین با مسئولیت خود و تنها در صورتی که می‌دانید چه می‌کنید از آن استفاده نمایید.
.TP
.B -r first-last
محدود کردن بازه ثبات‌های مورد دسترسی. این گزینه در حالت
\fBs\fP
در دسترس نیست. برای حالت
\fBW\fP،
مقدار
\fBfirst\fR
باید زوج و
\fBlast\fR
باید فرد باشد.
.TP
.B -y
غیرفعال کردن حالت تعاملی. به‌طور پیش‌فرض،
.B i2cdump
قبل از دستکاری گذرگاه I2C منتظر تایید کاربر می‌ماند. با استفاده از این فلگ، عملیات را مستقیماً انجام می‌دهد. این گزینه عمدتاً برای استفاده در اسکریپت‌ها در نظر گرفته شده است.
.TP
.B -a
اجازه استفاده از آدرس‌های بین 0x00 \- 0x07 و 0x78 \- 0x7f. توصیه نمی‌شود.
.PP
حداقل دو پارامتر باید به
.B i2cdump
داده شود.
\fIi2cbus\fR
شماره یا نام گذرگاه I2C برای پویش را مشخص می‌کند. این شماره باید با یکی از گذرگاه‌های فهرست‌شده توسط
\fIi2cdetect -l\fR
مطابقت داشته باشد.
\fIaddress\fR
آدرس مورد پویش روی آن گذرگاه را مشخص می‌کند و یک عدد صحیح بین 0x08 و 0x77 است.
.PP
پارامتر
\fImode\fR
در صورت تعیین شدن، یکی از حروف
\fBb\fP،
\fBw\fP
یا
\fBi\fP
است که به ترتیب متناظر با اندازه خواندن یک تک‌بایت، یک کلمه ۱۶ بیتی، یا یک بلوک I2C هستند. حالت
\fBc\fP
کمی متفاوت است، همه بایت‌ها را به‌طور متوالی می‌خواند و برای تراشه‌هایی که دارای قابلیت افزایش خودکار آدرس هستند، مانند EEPROMها، مفید است. حالت
\fBW\fP
نیز خاص است؛ مشابه
\fBw\fP
است به جز اینکه دستور خواندن تنها برای آدرس‌های ثبات زوج صادر می‌شود؛ این حالت نیز عمدتاً برای EEPROMها مفید است.
.PP
همچنین یک
\fBp\fP
می‌تواند به انتهای پارامتر
\fImode\fR
اضافه شود (به جز برای
\fBi\fP
و
\fBW\fP)
تا PEC فعال گردد. اگر پارامتر
\fImode\fR
حذف شود، پیش‌فرض
.B i2cdump
دسترسی بایتی بدون PEC است.
.PP
پارامترهای
\fIbank\fR
و
\fIbankreg\fR
روی W83781D و تراشه‌های مشابه (در زمان نگارش، تمام تراشه‌های Winbond و Asus) مفید هستند.
\fIbank\fR
یک عدد صحیح بین 0 و 7 است و
\fIbankreg\fR
یک عدد صحیح بین 0x00 و 0xFF است (مقدار پیش‌فرض: 0x4E). برگه اطلاعات W83781D اطلاعات بیشتری درباره انتخاب بانک دارد.

.SH "هشدار (WARNING)"
دستور
.B i2cdump
در صورت استفاده نادرست می‌تواند خطرناک باشد. به‌ویژه، حالت
\fBc\fP
با نوشتن یک بایت در تراشه آغاز می‌شود. در بیشتر تراشه‌ها این مقدار در ثبات اشاره‌گر آدرس ذخیره می‌شود که مشکلی ندارد، اما برخی تراشه‌ها با یک ثبات واحد یا بدون هیچ ثبات (قابل مشاهده)، به احتمال زیاد این عمل را به عنوان یک نوشتن واقعی در نظر می‌گیرند که ممکن است منجر به رفتار نادرست یا خرابی داده شود. از
.B i2cdump
روی آدرس‌های تصادفی استفاده نکنید. به هر حال، استفاده از آن فایده چندانی ندارد مگر اینکه شناخت خوبی از تراشه‌ای که با آن کار می‌کنید داشته باشید و بدانید به دنبال چه می‌گردید.

.SH "مثال‌ها (EXAMPLES)"
.PP
استخراج کامل محتویات دستگاه I2C در آدرس ۷ بیتی 0x50 روی گذرگاه ۹
(i2c-9)،
با استفاده از روش خواندن پیش‌فرض (حالت بایتی)، پس از تایید کاربر:
.nf
.RS
# i2cdump 9 0x50
.RE
.fi
.PP
استخراج فوری کل محتویات دستگاه I2C در آدرس ۷ بیتی 0x50 روی گذرگاه ۹
(i2c-9)،
با استفاده از تراکنش‌های خواندن بلوک I2C (بدون تایید کاربر):
.nf
.RS
# i2cdump -y 9 0x50 i
.RE
.fi
اگر دستگاه یک EEPROM باشد، خروجی معمولاً مشابه خروجی مثال قبلی خواهد بود.
.PP
استخراج ثبات‌های 0x00 تا 0x3f از دستگاه I2C در آدرس ۷ بیتی 0x2d روی گذرگاه ۱
(i2c-1)،
با استفاده از روش خواندن پیش‌فرض (حالت بایتی)، پس از تایید کاربر:
.nf
.RS
# i2cdump -r 0x00-0x3f 1 0x2d
.RE
.fi

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

.SH "همچنین ببینید (SEE ALSO)"
.BR i2cdetect (8),
.BR i2cget (8),
.BR i2cset (8),
.BR i2ctransfer (8),
.BR isadump (8)

.SH "نویسندگان (AUTHORS)"
Frodo Looijaard, Mark D. Studebaker and Jean Delvare
.PP
این صفحه راهنما در ابتدا توسط David Z Maze <dmaze@debian.org> برای سیستم Debian GNU/Linux نوشته شده است.