نام (NAME)

intel_reg - ابزار چندمنظوره برای ثبات‌های گرافیک Intel

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

intel_reg [OPTIONS] COMMAND

توضیحات (DESCRIPTION)

ابزار چندمنظوره برای ثبات‌های پردازنده گرافیکی Intel. خواندن، نوشتن، استخراج (dump) و رمزگشایی ثبات‌های MMIO و sideband گرافیک Intel و موارد دیگر.

گزینه‌ها (OPTIONS)

برخی از گزینه‌ها عمومی هستند و برخی دیگر به دستورهای خاصی اختصاص دارند.

--verbose: افزایش جزئیات خروجی.
--quiet: کاهش جزئیات خروجی.
--count=N: خواندن N ثبات.
--binary: چاپ خروجی مقادیر در قالب باینری (دودویی).
--decode: رمزگشایی ثبات‌ها. به‌طور پیش‌فرض تنها از آفست‌های خام استفاده می‌شود، مگر اینکه دستوری بدون آن کار نکند یا گزینه دیگری فعال‌سازی آن را اجباری کرده باشد. برای جزئیات بیشتر بخش دستورها (COMMANDS) را در ادامه ببینید.
--all: رمزگشایی ثبات‌ها برای همه پلتفرم‌های شناخته‌شده. این گزینه مستلزم --decode است.
--mmio=FILE: استفاده از MMIO bar از FILE.
--devid=DEVID: تظاهر به عنوان شناسه سخت‌افزاری DEVID مربوط به PCI ID. برای تصویرهای لحظه‌ای (snapshots) مربوط به MMIO bar از سیستم‌های دیگر کاربرد دارد.

--pci-slot <domain>:<bus>:<device>[.<func>]: یافتن GPU شرکت Intel بر اساس اسلات PCI. در سخت‌افزارهای مجهز به چند پردازنده گرافیکی مفید است.

--spec=PATH: خواندن مشخصات ثبات (register spec) از دایرکتوری یا فایل مشخص‌شده توسط PATH؛ برای جزئیات به بخش تعاریف مشخصات ثبات (REGISTER SPEC DEFINITIONS) در ادامه مراجعه کنید. این گزینه مستلزم --decode است.
--help: نمایش راهنمای مختصر.

دستورها (COMMANDS)

برای چگونگی توصیف ثبات‌ها برای دستورها، به بخش مراجع ثبات (REGISTER REFERENCES) در ادامه مراجعه کنید.

read [--count=N] REGISTER [...]

استخراج هر REGISTER مشخص‌شده، یا N ثبات با شروع از هر REGISTER.

write REGISTER VALUE [REGISTER VALUE ...]

نوشتن هر VALUE در REGISTER متناظر.

dump [--mmio=FILE --devid=DEVID]

استخراج تمامی ثبات‌های مشخص‌شده در مشخصات ثبات. گزینه --decode به‌طور ضمنی فعال می‌شود.

decode REGISTER VALUE

رمزگشایی REGISTER VALUE. گزینه --decode به‌طور ضمنی فعال می‌شود.

list

فهرست کردن ثبات‌های شناخته‌شده. گزینه --decode به‌طور ضمنی فعال می‌شود.

مراجع ثبات (REGISTER REFERENCES)

ثبات‌ها به صورت [(PORTNAME|PORTNUM|ENGINE|MMIO-OFFSET):](REGNAME|REGADDR) تعریف می‌شوند.

PORTNAME: روش دسترسی به ثبات، که اغلب MMIO و حالت پیش‌فرض است. روش‌های پشتیبانی‌شده در همه پلتفرم‌ها عبارتند از "mmio"، "portio-vga" و "mmio-vga".
در BYT و CHV، درگاه‌های جانبی (sideband) شامل "bunit"، "punit"، "nc"، "dpio"، "gpio-nc"، "cck"، "ccu"، "dpio2" و "flisdsi" نیز پشتیبانی می‌شوند.
PORTNUM: شماره درگاه برای درگاه‌های جانبی پشتیبانی‌شده در BYT و CHV. تنها اعدادی مجاز هستند که به درگاه‌های پشتیبانی‌شده نگاشت شده باشند؛ اعداد دلخواه پذیرفته نمی‌شوند.
اعداد بزرگ‌تر از 0xff به‌طور خودکار به عنوان آفست‌های MMIO تفسیر می‌شوند، نه شماره درگاه.
ENGINE: به جای MMIO مبتنی بر CPU، می‌توان از موتور (engine) مشخص‌شده برای روش دسترسی استفاده کرد. یک Batchbuffer برای خواندن/نوشتن به سمت آن موتور هدایت خواهد شد. فهرست موتورهای موجود وابسته به معماری است و با دستور "intel_reg help" قابل مشاهده می‌باشد. افزودن پیشوند '-' به نام موتور، از یک batchbuffer غیرممتاز برای دسترسی استفاده می‌کند.
MMIO-OFFSET: استفاده از MMIO، و افزودن این آفست به آدرس ثبات.
اعداد مساوی یا کمتر از 0xff به‌طور خودکار به عنوان شماره درگاه تفسیر می‌شوند، نه آفست MMIO.
REGNAME: نام ثبات همان‌طور که در مشخصات ثبات تعریف شده است.
اگر آفست MMIO مشخص نشده باشد، از مشخصات ثبات برداشته می‌شود. با این حال، درگاه‌ها این‌گونه نیستند؛ درگاه به عنوان یک فضای نام برای نام‌های ثبات عمل می‌کند.
REGADDR: آدرس ثبات. نیازی نیست نام ثبات متناظر در مشخصات ثبات تعریف شده باشد.

محیط (ENVIRONMENT)

INTEL_REG_SPEC: مسیر دایرکتوری یا فایلی که حاوی تعاریف مشخصات ثبات است.

تعاریف مشخصات ثبات (REGISTER SPEC DEFINITIONS)

مشخصات ثبات (register spec)، نام‌های ثبات را به آدرس‌ها مرتبط می‌کند. جستجو برای مشخصات به این ترتیب انجام می‌شود:

1.: دایرکتوری یا فایل مشخص‌شده توسط گزینه --spec.
2.: دایرکتوری یا فایل مشخص‌شده توسط متغیر محیطی INTEL_REG_SPEC.
3.: مشخصات ثبات توکار (Builtin). همچنین در صورتی که موارد بالا استفاده شوند اما با خطا مواجه گردند، به عنوان راه‌حل پشتیبان همراه با یک هشدار استفاده خواهد شد.

اگر دایرکتوری با استفاده از گزینه --spec یا متغیر محیطی INTEL_REG_SPEC مشخص شده باشد، دایرکتوری برای یافتن فایل مشخصات به این ترتیب پویش می‌شود:

1.: فایلی که بر اساس شناسه دستگاه PCI (device id) نام‌گذاری شده است. برای مثال، "0412".
2.: فایلی که بر اساس نام رمزی (code name) با حروف کوچک و بدون نشانه‌گذاری نام‌گذاری شده است. برای مثال، "valleyview".
3.: فایلی که بر اساس نسل (generation) نام‌گذاری شده است. برای مثال، "gen7" (توجه داشته باشید که این مورد با valleyview، ivybridge و haswell مطابقت دارد!).

قالب فایل مشخصات ثبات (Register Spec File Format)

قالب مشخصات ثبات به طور خلاصه در زیر توضیح داده شده است:

خطوط خالی و خطوطی که با "#"، ";" یا "//" شروع می‌شوند نادیده گرفته می‌شوند.
خطوطی که با "(" شروع نمی‌شوند به عنوان نام فایل‌ها (مطلق یا نسبی) برای گنجانده شدن (include) در نظر گرفته می‌شوند.
خطوطی که با "(" شروع می‌شوند به عنوان تعاریف ثبات تفسیر می‌گردند.

ثبات‌ها به صورت چندتایی‌های ('REGNAME', 'REGADDR', 'PORTNAME|PORTNUM|MMIO-OFFSET')، مشابه ارجاعات ثبات (REGISTER REFERENCES) در بالا، تعریف می‌شوند. توضیحات پورت همچنین می‌تواند یک رشته خالی برای نشان دادن MMIO باشد.

مثال‌ها:

# this is a comment, below is an include
vlv_pipe_a.txt
('GEN6_PMINTRMSK', '0x0000a168', '')
('MIPIA_PORT_CTRL', '0x61190', '0x180000')
('PLL1_DW0', '0x8000', 'DPIO')

اشکالات (BUGS)

خواندن برخی از ثبات‌ها ممکن است موجب توقف کامل (hang) پردازنده گرافیکی یا کل سیستم شود.

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها در گیت‌لب fd.o: https://gitlab.freedesktop.org/drm/igt-gpu-tools/-/issues

نویسندگان (AUTHORS)

Jani Nikula <jani.nikula@intel.com>

کپی‌رایت و تکثیر (COPYRIGHT)

2015-2025 Intel Corporation