.TH ISADUMP 8 "آوریل ۲۰۱۱" "lm_sensors" "راهنمای مدیر سیستم"
.SH "نام (NAME)"
isadump \- بررسی و استخراج ثبات‌های ISA

.SH "خلاصه دستور (SYNOPSIS)"
.B isadump
.RB [ -y ]
.RB [ -W | -L ]
.RB [ "-k V1,V2..." ]
.I addrreg
.I datareg
.RI [ "bank " [ bankreg ]]
#برای دسترسی شبه-I2C
.br
.B isadump
.B -f
.RB [ -y ]
.RB [ -W | -L ]
.I address
.RI [ "range " [ "bank " [ bankreg ]]]
#برای فضای آدرس تخت (flat)

.SH "توضیحات (DESCRIPTION)"
دستور
.B isadump
یک برنامه کمکی کوچک برای بررسی ثبات‌های قابل مشاهده از طریق گذرگاه ISA است. این ابزار برای پویش و بررسی هر تراشه‌ای که روی گذرگاه ISA قرار دارد و با یک ثبات آدرس و یک ثبات داده (دسترسی شبه-I2C) یا با یک بازه آدرس تخت (تا حداکثر ۲۵۶ بایت) کار می‌کند، در نظر گرفته شده است.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B -f
فعال‌سازی حالت فضای آدرس تخت (flat address space).
.TP
.B -y
غیرفعال کردن حالت تعاملی. به‌طور پیش‌فرض،
.B isadump
پیش از دستکاری گذرگاه ISA منتظر تایید کاربر می‌ماند. هنگامی که از این فلگ استفاده شود، عملیات را مستقیماً انجام می‌دهد. این گزینه عمدتاً برای استفاده در اسکریپت‌ها در نظر گرفته شده است.
.TP
.B -k V1,V2...
مشخص کردن یک فهرست جدا شده با کاما از بایت‌ها برای ارسال به عنوان توالی کلید جهت ورود به حالت پیکربندی تراشه. بیشتر تراشه‌های Super-I/O به این گزینه نیاز دارند.
توالی‌های کلید شناخته‌شده عبارتند از: 0x87,0x01,0x55,0x55 برای ITE، مقدار 0x55 برای SMSC، مقدار 0x87,0x87 برای Winbond و VIA؛ و برای National Semiconductor نیازی به هیچ توالی نیست.
.TP
.B -W
انجام خواندن‌های ۱۶ بیتی.
.TP
.B -L
انجام خواندن‌های ۳۲ بیتی.

.SH "گزینه‌ها (حالت دسترسی شبه-I2C) (OPTIONS (I2C-like access mode))"
حداقل دو گزینه باید به
.B isadump
داده شود.
\fIaddrreg\fR
شامل آدرس ISA ثبات آدرس برای تراشه مورد بررسی است؛
\fIdatareg\fR
شامل آدرس ثبات داده است. هر دو آدرس اعدادی صحیح بین 0x0000 و 0x3FFF هستند. معمولاً اگر آدرس پایه تراشه 0x0nn0 باشد، ثبات آدرس در 0x0nn5 و ثبات داده در 0x0nn6 قرار دارد. رایج‌ترین آدرس پایه برای تراشه‌های پایش سخت‌افزار 0x0290 است.
.PP
برای تراشه‌های Super-I/O، ثبات آدرس معمولاً در 0x2E و ثبات داده در 0x2F قرار دارد.
.PP
پارامترهای
\fIbank\fR
و
\fIbankreg\fR
روی تراشه‌های Winbond و همچنین تراشه‌های Super-I/O کاربرد دارند.
\fIbank\fR
یک عدد صحیح بین 0 و 31 است، و
\fIbankreg\fR
یک عدد صحیح بین 0x00 و 0xFF است (مقدار پیش‌فرض: 0x4E برای تراشه‌های Winbond، مقدار 0x07 برای تراشه‌های Super-I/O). برگه اطلاعات W83781D اطلاعات بیشتری درباره انتخاب بانک دارد.

.SH "گزینه‌ها (حالت فضای آدرس تخت) (OPTIONS (flat address space mode))"
در حالت تخت (flat)، تنها یک پارامتر الزامی است.
\fIaddress\fR
شامل آدرس ISA تراشه مورد بررسی است؛ این مقدار یک عدد صحیح بین 0x0000 و 0xFFFF است.
در صورت مشخص شدن،
\fIrange\fR
تعیین می‌کند که چند بایت باید خوانده شود (باید مضربی از ۱۶ باشد). اگر بازه ارائه نشود، مقدار پیش‌فرض ۲۵۶ بایت است و آدرس به اجبار روی یک مرز ۲۵۶ بایتی تراز (align) می‌شود.
.PP
پارامترهای
\fIbank\fR
و
\fIbankreg\fR
روی تراشه‌های Super-I/O مدل PC87365 و PC87366 ساخت National Semiconductor کاربرد دارند.
\fIbank\fR
یک عدد صحیح بین 0 و 31 است و
\fIbankreg\fR
یک عدد صحیح بین 0x00 و 0xFF است (مقدار پیش‌فرض: 0x09؛ باید در بازه مشخص‌شده قرار گیرد). برای اطلاعات بیشتر در مورد انتخاب بانک به برگه اطلاعات PC87365 مراجعه کنید.

.SH "نکات (NOTES)"
اگر بانکی تعیین نشود، هیچ عملیات تغییر بانکی انجام نخواهد شد.
.PP
اگر بانکی مشخص شود، مقدار اولیه پیش از خروج
.B isadump
بازیابی می‌شود.
.PP
استخراج داده‌های (Dumping) تراشه‌های Super-I/O معمولاً یک فرایند دو مرحله‌ای است. ابتدا باید با دستوری مانند زیر به آدرس اصلی Super-I/O دسترسی پیدا کنید:
.PP
isadump 0x2e 0x2f 0x09
.PP
این دستور دستگاه منطقی شماره ۹ را انتخاب می‌کند (مقدار صحیح به تراشه بستگی دارد). در 0x60 کلمه آدرس دستگاه منطقی را پیدا خواهید کرد، برای مثال "ec c0". سپس می‌توانید از دستوری مانند زیر استفاده کنید:
.PP
isadump -f 0xecc0 16
.PP
این دستور ثبات‌های دستگاه منطقی را استخراج می‌کند. بازه صحیح به تراشه بستگی دارد.

.SH "هشدار (WARNING)"
دستکاری و سرک کشیدن در فضای داده ISA به‌شدت خطرناک است. اجرای
.B isadump
با پارامترهای تصادفی می‌تواند موجب خرابی‌های سیستمی، از دست رفتن داده‌ها و حتی موارد بدتر شود! هنگام استفاده از این برنامه بی‌نهایت محتاط باشید.

.SH "همچنین ببینید (SEE ALSO)"
.BR i2cdump (8),
.BR isaset (8)

.SH "نویسندگان (AUTHORS)"
Frodo Looijaard،
Mark D. Studebaker
و گروه lm_sensors
.RI ( https://hwmon.wiki.kernel.org/lm_sensors )
.PP
این صفحه راهنما در ابتدا توسط David Z Maze <dmaze@debian.org> برای سیستم Debian GNU/Linux نوشته شده است. سپس توسط تیم lm_sensors بازبینی و تکمیل شد و اکنون بخشی از توزیع مبدأ lm_sensors است.