mxt-app - آنلاین در ابر

برنامه:

نام

mxt-app - ابزار خط فرمان برای دستگاه های maXTouch

خلاصه

mxt-app [فرمان] [گزینه های] ...

شرح

mxt-app ابزاری برای مدیریت کنترلرهای لمسی Atmel maXTouch و سایر دستگاه هایی است که
از پروتکل مبتنی بر شی Atmel پشتیبانی می کند.

اگر نه فرمان داده نشده است، mxt-app یک رابط مبتنی بر منوی تعاملی ارائه می دهد.

هدف - شی پروتکل

پروتکل مبتنی بر شی Atmel نحوه ثبت دستگاه را تعریف می کند (معمولاً از طریق I2C قابل دسترسی است)
به عملکردهای مختلف درون دستگاه ها نگاشت می شوند. این رابط سازماندهی می کند
نقشه را در اشیاء جداگانه ثبت کنید که به هر کدام یک عدد T داده می شود. mxt-app می تواند بازرسی کند
و پیکربندی شی را تغییر دهید و داده های تشخیصی را در حالی که دستگاه در حال اجرا است مشاهده کنید.

برای توضیح پروتکل شی، نگاه کنید به اتمل AT42QT1085 شیء پروتکل راهنما,
در دسترس از atmel.com.

معنی بایت های پیکربندی درون اشیاء را می توان در پروتکل یافت
اسناد راهنمای منتشر شده با هر دستگاه، و تنها توسط Atmel تحت NDA ارائه شده است.

عمومی دستورات

-h [--کمک]
نمایش خلاصه ای از گزینه های موجود و خروج.

-i [--اطلاعات]
اطلاعات شناسه و جدول شی را چاپ کنید.

-M [--پیام ها] [*تایم اوت*]
پیام ها را چاپ می کند تا زمانی که فاصله ثانیه ها گذشت اگر نه فاصله ارائه شده است ،
تا زمانی که کاربر Ctrl-C را فشار دهد ادامه دهید. تایم اوت صفر یک بار خوانده می شود. فراهم کند
-F [--msg-filter] گزینه ای برای فیلتر کردن توسط یک شی خاص.

-F [--msg-filter] *نوع*
پیام ها را بر اساس شی فیلتر می کند TYPE.

-- تنظیم مجدد
دستگاه را بازنشانی کنید.

--کالیبره کردن
ارسال فرمان کالیبره

--پشتیبان گیری[*=COMMAND*]
پشتیبان گیری از پیکربندی به NVRAM که در آن آرگومان اختیاری، COMMAND، BACKUPNV است
فرمان

-g کالیبراسیون مرجع طلایی را در NVRAM بنویسید.

--self-cap-tune-config
تنظیمات خود خازن را تنظیم و کالیبره کنید و آنها را در دستگاه ذخیره کنید
پیکربندی

--خود سرپوش- کوک-نورام
تنظیمات خود خازن را تنظیم و کالیبره کنید و آنها را در NVRAM بدون ذخیره کنید
به روز رسانی Config Checksum.

- نسخه
نسخه چاپی mxt-app.

پیکربندی فایل دستورات

--بار *فایل*
آپلود تنظیمات از فایل، آن را در NVRAM بنویسید و دستگاه را ریست کنید. پیکربندی
ممکن است در قالب xcfg. یا OBP_RAW باشد.

--صرفه جویی *فایل*
ذخیره تنظیمات در فایل در قالب OBP_RAW یا xcfg.

-- چکی *فایل*
مطالب را بخوانید فایل و جمع کنترلی پیکربندی را دوباره محاسبه کنید.

ثبت نام READ/WRITE دستورات

-R [--خواندن]
داده ها را از دستگاه بخوانید.

-W [--نوشتن]
داده ها را روی دستگاه بنویسید.

-n [--شمردن] *شمردن*
بخوان / بنویس COUNT ثبت

-f [--قالب]
فرمت خروجی ثبت نام

-I [--نمونه، مثال] *نمونه، مثال*
شی را انتخاب کنید نمونه، مثال

-r [--ثبت نام] *ثبت نام*
شروع کن در ثبت نام (در شیء هنگام استفاده با TYPE)

-T [--نوع] *نوع*
شی را انتخاب کنید TYPE

-- صفر تمام تنظیمات پیکربندی را صفر کنید

مثال ها
خواندن اطلاعات مسدود کردن:
$ mxt-app -R -n7 -r0
82 19 11 AA 18 0E 16

خواندن T7 قدرت پیکربندی هدف - شی:
$ mxt-app -R -T7
32 FF 05 43

صفر اول دو بایت of T7:
mxt-app -W -T7 0000 دلار

خواندن T7 قدرت پیکربندی هدف - شی، قالب بندی شده خروجی:
$ mxt-app -R -T7 --فرمت
GEN_POWERCONFIG_T7

00: 0x00 0 0000 0000
01: 0x00 0 0000 0000
02: 0x05 5 0000 0101
03: 0x43 67 0100 0011

TCP سوکت دستورات

mxt-app از اتصال از طریق TCP با استفاده از پروتکل ASCII پشتیبانی می کند که به برنامه mxt اجازه می دهد تا به عنوان عمل کند
یک پل به طوری که اتمل ابزارهای اختصاصی مانند شیء سرور می تواند به دستگاه دسترسی داشته باشد.

-C [--bridge-client] *میزبان*
از طریق TCP به HOST

-S [--bridge-server]
سرور سوکت TCP را راه اندازی کنید

-p [--بندر] PORT
پورت TCP (پیش‌فرض 4000)

بوت لودر دستورات

--bootloader-version
شناسه و نسخه بوت لودر را پرس و جو کنید و چاپ کنید.

--فلاش *سیستم عامل*
فلاش سیستم عامل به دستگاه. فایل سیستم عامل باید با فرمت .enc باشد.

-- reset-bootloader
دستگاه را در حالت بوت لودر بازنشانی کنید. در حالت بوت لودر دستگاه به حالت عادی متوقف می شود
عملیات تا زمانی که یک سیستم عامل ارسال شود. آدرس I2C یا PID USB تغییر خواهد کرد. در
تنها دستور معتبر در این حالت --flash است. یک چرخه قدرت سخت، آن را برمی گرداند
دستگاه به حالت عادی Object Protocol، مگر اینکه تصویر سیستم عامل خراب باشد.
این دستور فقط برای اهداف اشکال زدایی ارائه می شود: در بیشتر موارد --flash will
تغییر به/از حالت بوت لودر قبل/بعد از فلش را مدیریت کنید.

---نسخه سیستم عامل *نسخه*
فرمت فایل .enc نسخه سفت‌افزار را به شکلی که در دسترس است ارائه نمی‌کند
mxt-app. اگر از طریق این سوئیچ ارائه شود، mxt-app می تواند سیستم عامل را بررسی کند نسخه
قبل و بعد از فلاش اگر نسخه سفت‌افزار باشد، فرآیند فلش را رد می‌کند
قبلا درست شده همچنین پس از اتمام، فلاش موفقیت آمیز را بررسی می کند. در
نسخه باید با فرمت 1.0.AA ارائه شود. # T25 گزینه های خود تست

شی Self Test T25 روال های خودآزمایی را در دستگاه اجرا می کند تا عیوب را در این معنا پیدا کند.
خطوط و الکترودها شی Self Test T25 یک سری توالی تست را اجرا می کند.

-t [--تست]
تمام تست های خود را اجرا کنید.

-t*XX* [--test=*XXX*]
اجرای خودآزمایی فردی مشخص شده توسط CMD مقدار هگز

-t01 تست قدرت آنالوگ را اجرا کنید.

-t11 تست خطای پین را اجرا کنید.

-t12 تست خطای پین 2 اجرا شود.

-t13 تست AND gate را اجرا کنید.

-t17 تست محدودیت سیگنال را اجرا کنید.

-t20 تست افزایش را اجرا کنید

-t21 اجرای تست خطای جبران.

T37 تشخیص داده ها OPTIONS

فریم هایی از داده های تشخیصی را ضبط کنید. حالت پیش فرض برای گرفتن دلتاهای لمسی است. خود
اندازه گیری ظرفیت فقط در برخی از دستگاه ها در دسترس است.

--debug-dump *فایل*
شی T37 Diagnostic Data دسترسی خام به مرجع/دلتای لمسی را فراهم می کند
اندازه گیری از صفحه نمایش لمسی داده های تشخیصی در آن نوشته می شود فایل در CSV
قالب این فرمت با ابزار Atmel Hawkeye سازگار است.

--قاب ها *ن*
گرفتن N فریم های داده

--منابع
داده های مراجع را ضبط کنید

-- سیگنال های خود کلاهک
سیگنال های خود کلاهک را ضبط کنید.

--دلتاهای خود کلاهدار
از دلتاهای خود کلاهک بگیرید.

-- خود سرپوشی داور
منابع خود کلاهک را ضبط کنید.

T68 سریال داده ها دستورات

--t68-فایل *فایل*
بارگذاری فایل از طریق شی T68 Serial Data به دستگاه.

--t68-datatype *نوع داده*
تنظیم نوع داده از فایل این به طور خودکار از خود فایل شناسایی می شود
در بیشتر موارد.

یافته و مشخص کردن دستگاه

به طور پیش فرض mxt-app دستگاه های موجود را اسکن می کند و به اولین دستگاهی که پیدا می کند متصل می شود.

-q [--پرس و جو]
دستگاه ها را اسکن کنید و یک لیست را خروجی بگیرید.

-d [--دستگاه] *دستگاه*
اتصال به یک دستگاه خاص مشخص شده توسط DEVICESTING که در همان آورده شده است
فرمت به عنوان خروجی توسط --query.

سه روش اتصال برای دسترسی سخت افزاری پشتیبانی می شود:

sysfs
این در ارتباط با درایور هسته لینوکس استفاده می شود. به ویژگی های sysfs دسترسی دارد
زیر دایرکتوری

/sys/bus/i2c/drivers/ddddddd/b-00xx/

جایی که

d نام درایور - atmel_mxt_ts، Atmel MXTXXX، و غیره

b آداپتور i2c

xx آدرس i2c

یک دستگاه USB خاص را می توان با دادن گزینه دستگاه -d sysfs:PATH همانطور که توسط داده شده است مشخص کرد
-q/--گزینه پرس و جو

صفات sysfs مورد استفاده در این فهرست هستند

mem_access
دسترسی به فضای آدرس خام I2C.

debug_enable
پیام های خروجی از دستگاه به dmesg به صورت هگزادسیمال ثبت می شود.

debug_v2_enable، debug_msg، debug_notify
رابط باینری بهبود یافته اختیاری برای بازیابی پیام ها

آنها هنگام استفاده از درایور هسته Atmel از github ارائه می شوند و ممکن است توسط آنها پشتیبانی شوند
سایر وسایل.

یو اس بی
بسیاری از دستگاه‌های maXTouch از حالت USB پشتیبانی می‌کنند که لمس را از طریق USB HID گزارش می‌کند. علاوه بر این،
تابلوهای ارزیابی ممکن است از یک "تراشه پل" استفاده کنند که I2C را به همان پروتکل متصل می کند.

هنگامی که libusb در دسترس باشد، حالت USB توسط ابزارهای خودکار ساخته می شود.

یک دستگاه USB خاص را می توان با دادن گزینه دستگاه -d usb:001-003 که مشخص کرد
مربوط به اتوبوس و شماره دستگاه داده شده توسط گزینه -q/--query و lsusb است.

I2C اشکال زدایی کردن رابط
دسترسی مستقیم به دستگاه ها از طریق i2c-dev رابط اشکال زدایی I2C با دادن آداپتور و
آدرس در خط فرمان

رابط i2c-dev در منبع هسته لینوکس، در مستند شده است
Documentation/i2c/dev-interface

پشتیبانی از رابط اشکال زدایی I2C باید با استفاده از هسته CONFIG_I2C_CHARDEV فعال شود
گزینه پیکربندی در صورتی که فایل های /dev/i2c-* موجود باشد، در سیستم فعال می شود.

برای استفاده از i2c-dev، یک رشته دستگاه مانند -d i2c-dev:1-004a ارائه دهید.

پیام‌های دستگاه‌های maXTouch با نظرسنجی خوانده می‌شوند. اگر درایور کرنل نیز باشد
موجود در سیستم، خواندن پیام ها در وقفه، سپس هیچ پیامی دریافت نخواهد شد
ابزار. یک راه حل این است که T18.COMMAND (بایت 1) را روی 2 اینچ تنظیم کنید تا خط CHG بالا باشد.
(غیر فعال)" بنابراین درایور هسته وقفه ای دریافت نمی کند.

پشتیبانی از اسکن وجود ندارد. این به این دلیل است که خواندن از هر maXTouch ممکن است
آدرس در هر گذرگاه I2C ممکن است بر برخی از سخت افزارهای نامرتبط تأثیر منفی بگذارد
درک پروتکل شی شما باید به صورت دستی آداپتور و آدرس صحیح را شناسایی کنید
به راهنمای پروتکل یا راه اندازی پلت فرم مراجعه کنید.

استفاده از دستور --flash با دستگاهی که از قبل در حالت بوت لودر است، توسط
مشخص کردن آدرس بوت لودر

HIDRAW
پشتیبان hidraw از دستگاه های maXTouch پشتیبانی می کند که با استفاده از USB یا HID از طریق I2C متصل می شوند.

رابط hidraw در منبع هسته لینوکس، در مستند شده است
Documentation/hid/hidraw.txt

دستگاه باید دارای /dev/hidraw پشتیبانی دستگاه خام HID باشد که با استفاده از CONFIG_HIDRAW فعال باشد
گزینه پیکربندی هسته

برای استفاده از hidraw، یک رشته دستگاه مانند -d hidraw:/dev/hidraw0 ارائه کنید.

پشتیبانی از اسکن وجود ندارد.

بوت بارگذاری در این حالت پشتیبانی نمی شود.

اشکال زدایی OPTIONS

-v [--مختلف] *مرحله*
سطح اشکال زدایی را تنظیم کنید سطح یکی از 0 (بی صدا)، 1 (هشدارها و خطاها)، 2 (اطلاعات -
پیش‌فرض)، 3 (اشکال‌زدایی)، 4 (Verbose). Debug و Verbose فقط در صورت ساخته شدن در دسترس هستند
وارد

خروج ارزش

0 موفقیت

1 خطای داخلی/اظهار

2 خطای ورودی/خروجی

3 عدم تخصیص حافظه

4 وقفه

5 دستگاهی پیدا نشد یا دستگاه از بین رفت

6 اجازه رد شد

7 عملکرد برای این نوع دستگاه مجاز نیست

8 قطع تماس تابع

9 شی در دستگاه موجود نیست

10 پیام نامعتبر غیرمنتظره ای از پردازشگر پیام دریافت شد

11 دستور تست خودآزمایی نامعتبر است

12 خودآزمایی برق AVdd آنالوگ وجود ندارد

13 خطای پین خود تست

14 خودآزمایی و خطای دروازه

15 خطای حد سیگنال خودآزمایی

16 خطای خودآزمایی Gain

17 خطای جمع کنترل بلوک اطلاعات

18 بوت لودر قبلا آنلاک شده است

19 خرابی بوت لودر CRC (شکست انتقال)

20 خطای فرمت فایل

21 نسخه سیستم عامل دستگاه قبلاً مورد نیاز است

22 آدرس بوت لودر شناسایی نشد

23 نسخه موجود در دستگاه با نسخه ارائه شده پس از عملیات بوت لود مطابقت نداشت

24 دستگاه ریست نشد

25 دستگاه در حالت غیرمنتظره

26 پارامترهای خط فرمان یا ورودی منو اشتباه داده شده است

27 خطای تجزیه پروتکل TCP Bridge

28 خطای اتصال پل

29 دانلود داده های سریال ناموفق بود

30 چنین فایل یا دایرکتوری وجود ندارد

31 خطا در پردازش فرمان self cap

تدوین از SOURCE

برای دانلود سورس کد با استفاده از git:

کلون git https://github.com/atmel-maxtouch/mxt-app.git

دو دسته ساز برای اندروید و ابزارهای خودکار وجود دارد:

آندروید
برای دانلود زیر ماژول libusbdroid:

زیر ماژول git init
به روز رسانی زیر ماژول git

برای کامپایل با استفاده از Android NDK:

ndk-build

برای فعال کردن اشکال زدایی:

ndk-build NDK_DEBUG=1

برای فعال کردن پشتیبانی PIE (برای Android L):

ndk-build APP_PLATFORM=android-16

باینری ها در libs/ قرار خواهند گرفت

Android NDK از https://developer.android.com/tools/sdk/ndk/ در دسترس است

محل دویدن و پیاده روی on آندروید
adb push libs/armeabi/mxt-app /data/local/tmp/
پوسته adb /data/local/tmp/mxt-app [فرمان]

اگر مجوزهای اجرایی تنظیم نشده اند، اجرا کنید:

adb shell chmod 777 /data/local/tmp/mxt-app

ابزارهای خودکار
برای کامپایل با استفاده از ابزارهای خودکار:

./autogen.sh && make

برای کامپایل متقابل:

./autogen.sh --host=arm-linux-gnueabi && make

برای فعال کردن اشکال زدایی:

./autogen.sh --enable-debug

برای فعال کردن تولید صفحه مرد با استفاده از pandoc:

./autogen.sh --enable-man

برای ساختن مستندات داکسیژن (این به نصب داکسیژن و گرافویز نیاز دارد):

ساختن doc

نسخه شماره گذاری

یک شماره نسخه توسط git describe در طول فرآیند ساخت تولید می شود و توسط آن گزارش می شود
--نسخه و اشکال زدایی سیاهههای مربوط.

یک نسخه معمولی ممکن است 1.15-29-g8321 باشد که به این معنی است که 29 پس از برچسب انتشار انجام می شود.
1.15، با شناسه git SHA که با 8321 شروع می شود.

اگر منبع با استفاده از git بررسی نشده باشد (به عنوان مثال با کلیک بر روی github
لینک "دانلود ZIP")، سپس نسخه از فایل VERSION در آرشیو منبع است
استفاده شده.

اگر تغییرات غیرمتعهد در کد منبع وجود داشته باشد، پسوند -mod اضافه می شود.

عیب یابی

klogctl خطا
اگر اخطار را می بینید

W: خطای klogctl 1 (عملیات مجاز نیست)

این نشان می دهد که mxt-app قادر به بازیابی پیام ها از dmesg نیست. مختلف
ویژگی ها به درستی کار نخواهند کرد. ممکن است با انجام این کار، dmesg را غیرمحدود کنید

# اکو 0 > /proc/sys/kernel/dmesg_restrict

MXT-APP(1)

با استفاده از خدمات onworks.net از mxt-app آنلاین استفاده کنید