نام (NAME)

evdev-joystick - برنامه کالیبراسیون جوی‌استیک

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

evdev-joystick --help
evdev-joystick --listdevs
evdev-joystick --showcal <device‐path>
evdev-joystick --evdev device‐path> [--axis <axis>] [--minimum <value>] [--maximum <value>] [--deadzone <value>] [--fuzz <value>]

توضیحات (DESCRIPTION)

برنامه evdev-joystick جوی‌استیک‌ها را کالیبره می‌کند. کالیبراسیون یک جوی‌استیک تضمین می‌کند که موقعیت‌ها روی محورهای گوناگون به درستی تفسیر شوند.

گزینه‌ها (OPTIONS)

--h, --help: چاپ خلاصه‌ای از گزینه‌های موجود.
--l, --listdevs: فهرست کردن تمام دستگاه‌های جوی‌استیک یافت‌شده.
--s, --showcal <device‐path>: نمایش کالیبراسیون فعلی برای device مشخص‌شده.
--e, --evdev <device‐path>: مشخص کردن device جوی‌استیک برای تغییر.
--a, --axis <axis>: مشخص کردن محور (axis) مورد نظر برای تغییر (به‌طور پیش‌فرض، همه محورها کالیبره می‌شوند).
--m, --minimum <value>: تغییر مقدار کمینه (minimum) برای جوی‌استیک فعلی.
--M, --maximum <value>: تغییر مقدار بیشینه (maximum) برای جوی‌استیک فعلی.
--d, --deadzone <value>: تغییر ناحیه مرده (deadzone) برای جوی‌استیک فعلی.
--f, --fuzz <value>: تغییر مقدار نویزگیری (fuzz) برای جوی‌استیک فعلی.

کالیبراسیون (CALIBRATION)

در سیستم ورودی لینوکس، انتظار می‌رود جوی‌استیک‌ها برای محورها مقادیری بین -32767 و 32767 تولید کنند، به‌طوری که 0 به معنای قرار داشتن جوی‌استیک در مرکز است. بنابراین، منتهی‌الیه چپ باید مقدار -32767 را روی محور X، منتهی‌الیه راست مقدار 32767 را روی محور X، منتهی‌الیه جلو مقدار -32767 را روی محور Y و به همین ترتیب تولید کند.

بسیاری از جوی‌استیک‌ها و گیم‌پدها (به‌ویژه مدل‌های قدیمی‌تر) اندکی عدم تنظیم دارند؛ در نتیجه ممکن است از تمام بازه مقادیر (برای نقاط انتهایی محورها) استفاده نکنند، یا حتی آزاردهنده‌تر اینکه در حالت مرکز، مقدار 0 ندهند. کالیبره‌سازی جوی‌استیک، اطلاعاتی درباره رفتار واقعی آن در اختیار هسته قرار می‌دهد؛ این امر به هسته اجازه می‌دهد تا نقایص گوناگون جوی‌استیک‌ها را اصلاح کرده و تا جایی که به نرم‌افزارهای استفاده‌کننده از جوی‌استیک مربوط می‌شود، خروجی‌های یکدستی تولید کند.

ابزار jstest(1) برای تعیین اینکه آیا یک جوی‌استیک کالیبره شده است یا خیر مفید است: هنگام اجرا، وقتی جوی‌استیک در حالت سکون است باید تمام مقادیر 0 باشند، و هر محور باید بتواند مقادیر -32767 و 32767 را تولید کند. جوی‌استیک‌های آنالوگ باید مقادیری بین 0 و نقاط انتهایی نیز تولید کنند، اما این امر ضروری نیست؛ پدهای جهت‌نمای دیجیتال تنها با همین سه مقدار به خوبی کار می‌کنند.

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

ffset(1), jstest(1).

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

برنامه evdev-joystick توسط Stephen Anthony و بر پایه ابزار G25manage از پروژه VDrift نوشته شده است.

این صفحه راهنما توسط Stephen Kitt <steve@sk2.org> نوشته شده است.