mxt-app - عبر الإنترنت في السحابة

برنامج:

اسم

mxt-app - أداة مساعدة لسطر الأوامر لأجهزة maXTouch

موجز

تطبيق mxt [أمر] [الخيارات] ...

الوصف

mxt-app هو أداة مساعدة لإدارة وحدات تحكم Atmel maXTouch التي تعمل باللمس والأجهزة الأخرى التي تعمل باللمس
دعم بروتوكول Atmel القائم على الكائنات.

إذا كانت الإجابة بلا أمر لم يتم توفيره، سيوفر mxt-app واجهة قائمة تفاعلية.

موضوع بروتوكول

يحدد بروتوكول Atmel Object Based Protocol كيفية تسجيل الجهاز (يتم الوصول إليه عادةً عبر I2C)
يتم تعيينها لوظائف مختلفة داخل الأجهزة. تنظم هذه الواجهة
قم بتسجيل الخريطة في كائنات منفصلة يُعطى كل منها رقم T. mxt-app يمكن أن يتفقد
وتغيير تكوين الكائن وعرض البيانات التشخيصية أثناء تشغيل الجهاز.

للحصول على وصف لبروتوكول الكائن، راجع اتميل AT42QT1085 هدف بروتوكول دليل,
متاح من atmel.com.

يمكن العثور على معنى بايتات التكوين داخل الكائنات في البروتوكول
تم إصدار وثائق الدليل مع كل جهاز، ويتم توفيرها فقط بواسطة Atmel بموجب اتفاقية عدم الإفشاء.

يمكنك تحويل أي لحظة سعيدة إلى ذكرى ثمينة وخالدة – احتفظ بها على شكل صورة أو مقطع فيديو باستخدام الكاميرا الخلفية المضمنة. ومن خلال اتصال Bluetooth، يمكنك مشاركة الملفات ذات المحتوى العزيز على قلبك مع أجهزة المقربين منك. أوامر

-h [--يساعد]
عرض ملخص مختصر للخيارات المتاحة والخروج.

-i [--معلومات]
طباعة معلومات المعرف وجدول الكائنات.

-M [--رسائل] [*نفذ الوقت*]
طباعة الرسائل حتى مهلة لقد مرت ثواني. إذا لا مهلة متوفر،
استمر حتى يضغط المستخدم على Ctrl-C. يقرأ مهلة صفر مرة واحدة. يمد
-F خيار [--msg-filter] للتصفية حسب كائن معين.

-F [--مرشح الرسائل] *يكتب*
يقوم بتصفية الرسائل حسب الكائن النوع.

--إعادة تعيين
إعادة ضبط الجهاز.

- معايرة
إرسال أمر المعايرة.

--النسخ الاحتياطي[*=COMMAND*]
تكوين النسخ الاحتياطي إلى NVRAM حيث الوسيطة الاختيارية، COMMAND، هو BACKUPNV
أمر.

-g اكتب المعايرة المرجعية الذهبية لـ NVRAM.

--self-cap-tune-config
ضبط ومعايرة إعدادات السعة الذاتية وتخزينها على الجهاز
ترتيب.

--self-cap-tune-nvram
قم بضبط ومعايرة إعدادات السعة الذاتية وتخزينها على NVRAM بدونها
تحديث المجموع الاختباري للتكوين.

--الإصدار
نسخة مطبوعة من تطبيق mxt.

CONFIGURATION FILE أوامر

--حمل *ملف*
تحميل التكوين من FILE، واكتبه على NVRAM، وأعد ضبط الجهاز. التكوين
قد يكون بتنسيق .xcfg أو OBP_RAW.

--حفظ *ملف*
احفظ التكوين في FILE بتنسيق OBP_RAW أو .xcfg.

- المجموع *ملف*
اقرأ محتويات FILE وإعادة حساب المجموع الاختباري للتكوين.

سجل قراءة و كتابة أوامر

-R [--يقرأ]
قراءة البيانات من الجهاز.

-W [--يكتب]
كتابة البيانات على الجهاز.

-n [--عدد] *عدد*
قراءة / كتابة بالإحصاء سجلات

-f [--شكل]
تنسيق تسجيل الإخراج

-I [--مثال] *مثال*
حدد الكائن حتة

-r [--يسجل] *يسجل*
تبدأ في سجل (الإزاحة في الكائن عند استخدامه مع النوع)

-T [--يكتب] *يكتب*
حدد الكائن النوع

--صفر صفر كافة إعدادات التكوين

أمثلة
عرض info كتلة:
$ mxt-app -R -n7 -r0
82 19 11 أأ 18 0 إي 16

عرض T7 الطاقة التكوين موضوع:
$mxt-app -R -T7
32 فف 05 43

بدون الحاجة لأى معرفة بتصميم و برمجة المواقع الإلكترونية أول اثنان بايت of T7:
$mxt-app -W -T7 0000

عرض T7 الطاقة التكوين موضوع، تنسيق انتاج:
$ mxt-app -R -T7 --format
GEN_POWERCONFIG_T7

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

TCP SOCKET أوامر

mxt-app يدعم الاتصال عبر TCP باستخدام بروتوكول ASCII الذي يسمح لتطبيق mxt بالعمل
جسر بحيث اتميل أدوات الملكية مثل هدف المخدم يمكن الوصول إلى الجهاز.

-C [--جسر العميل] *يستضيف*
الاتصال عبر TCP ل HOST

-S [--خادم الجسر]
بدء تشغيل خادم مأخذ توصيل TCP

-p [--ميناء] PORT
منفذ TCP (الافتراضي 4000)

BOOTLOADER أوامر

--إصدار محمل الإقلاع
معرف الاستعلام والطباعة وإصدار أداة تحميل التشغيل.

--فلاش *البرامج الثابتة*
Flash البرامج الثابتة ل الجهاز. يجب أن يكون ملف البرنامج الثابت بتنسيق ‎.enc.

--إعادة تعيين محمل الإقلاع
إعادة ضبط الجهاز في وضع أداة تحميل التشغيل. في وضع أداة تحميل التشغيل، سيتوقف الجهاز عن العمل بشكل طبيعي
العملية حتى يتم إرسال البرامج الثابتة. سوف يتغير عنوان I2C أو USB PID. ال
الأمر الوحيد الصالح في هذا الوضع هو --flash. ستعيد دورة الطاقة الصلبة
الجهاز إلى وضع بروتوكول الكائنات العادي، ما لم تكن صورة البرنامج الثابت تالفة.
يتم توفير هذا الأمر فقط لأغراض تصحيح الأخطاء: في معظم الحالات، سوف يقوم --flash بذلك
إدارة التغيير من/إلى وضع أداة تحميل التشغيل قبل/بعد الفلاش.

--نسخة برنامج ثابت *إصدار*
لا يوفر تنسيق الملف .enc إصدار البرنامج الثابت في نموذج متاح
mxt-app. إذا تم توفيره عبر هذا المفتاح، فيمكن لتطبيق mxt التحقق من البرامج الثابتة VERSION
قبل وبعد الفلاش. سيتم تخطي عملية الفلاش إذا كان إصدار البرنامج الثابت
صحيح بالفعل. وسوف يتحقق أيضًا من وجود وميض ناجح عند الانتهاء. ال
يجب توفير الإصدار بالتنسيق 1.0.AA. # خيارات الاختبار الذاتي T25

يقوم كائن الاختبار الذاتي T25 بتشغيل إجراءات الاختبار الذاتي في الجهاز للعثور على الأخطاء في المعنى
الخطوط والأقطاب الكهربائية. يقوم كائن الاختبار الذاتي T25 بتشغيل سلسلة من تسلسلات الاختبار.

-t [--امتحان]
قم بإجراء جميع الاختبارات الذاتية.

-ر*XX* [--اختبار=*XX*]
قم بتشغيل الاختبار الذاتي الفردي المحدد بواسطة CMD قيمة سداسية.

-t01 تشغيل اختبار الطاقة التناظرية.

-t11 تشغيل اختبار خطأ الدبوس.

-t12 تشغيل اختبار خطأ الدبوس 2.

-t13 اختبار التشغيل والبوابة.

-t17 تشغيل اختبار حد الإشارة.

-t20 تشغيل اختبار الكسب.

-t21 تشغيل اختبار خطأ الإزاحة.

T37 التشخيص بيانات OPTIONS

التقاط إطارات البيانات التشخيصية. الوضع الافتراضي هو التقاط دلتا اللمس. الذات
قياسات السعة متاحة فقط على بعض الأجهزة.

- تفريغ الشوائب *ملف*
يوفر كائن البيانات التشخيصية T37 وصولاً أوليًا إلى مرجع اللمس/دلتا
القياسات من شاشة اللمس. تتم كتابة البيانات التشخيصية إلى FILE في CSV
شكل. التنسيق متوافق مع الأداة المساعدة Atmel Hawkeye.

- إطارات *ن*
إنها تقوم بالتسجيل N إطارات البيانات.

--مراجع
التقاط بيانات المراجع.

- إشارات الغطاء الذاتي
التقاط إشارات الغطاء الذاتي.

- دلتا الغطاء الذاتي
التقاط دلتا الغطاء الذاتي.

--المراجع ذات الحد الأقصى
التقاط مراجع الحد الأقصى الذاتي.

T68 مسلسل بيانات أوامر

- ملف t68 *ملف*
تحميل FILE إلى الجهاز عبر كائن البيانات التسلسلية T68.

--t68-نوع البيانات *نوع البيانات*
بكج نوع البيانات من الملف. سيتم اكتشاف هذا تلقائيًا من الملف نفسه
في معظم الحالات.

العثور على لأي لبس التحديد DEVICE

افتراضيًا، سيقوم تطبيق mxt بفحص الأجهزة المتاحة والاتصال بالجهاز الأول الذي يعثر عليه.

-q [--استفسار]
البحث عن الأجهزة وإخراج القائمة.

-d [--جهاز] *سلسلة الأجهزة*
الاتصال بجهاز معين يحدده سلسلة الأجهزة الذي يرد في نفسه
تنسيق كإخراج بواسطة --query.

هناك ثلاث طرق اتصال مدعومة للوصول إلى الأجهزة:

sysfs
يتم استخدام هذا بالتزامن مع برنامج تشغيل Linux kernel. يصل إلى سمات sysfs
تحت الدليل

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

في

d اسم برنامج التشغيل - atmel_mxt_ts، Atmel MXTXXXX، إلخ

b محول i2c

xx عنوان i2c

يمكن تحديد جهاز USB معين عن طريق إعطاء خيار الجهاز -d sysfs:PATH كما هو محدد بواسطة
-q/--خيار الاستعلام

سمات sysfs المستخدمة ضمن هذا الدليل هي

mem_access
الوصول إلى مساحة عنوان I2C الأولية.

debug_enable
إخراج الرسائل من الجهاز إلى سجل dmesg بالنظام الست عشري.

debug_v2_enable، debug_msg, debug_notify
واجهة ثنائية محسنة اختيارية لاسترداد الرسائل

يتم توفيرها عند استخدام برنامج تشغيل Atmel kernel من github، وقد يتم دعمها بواسطة
أجهزة أخرى.

ذراع USB‏
تدعم العديد من أجهزة maXTouch وضع USB الذي يقوم بالإبلاغ عن اللمسات عبر USB HID. فضلاً عن ذلك،
قد تستخدم لوحات التقييم "شريحة جسر" تربط I2C بالبروتوكول نفسه.

سيتم إنشاء وضع USB بواسطة الأدوات التلقائية عند توفر libusb.

يمكن تحديد جهاز USB محدد من خلال إعطاء خيار الجهاز -d usb:001-003
يتوافق مع أرقام الناقل والأجهزة المقدمة بواسطة خيار -q/--query وlsusb.

I2C تصحيح الواجهة
يمكن الوصول إلى الأجهزة مباشرة عبر i2c-dev واجهة تصحيح I2C عن طريق إعطاء محول و
العنوان على سطر الأوامر.

تم توثيق واجهة i2c-dev في مصدر Linux kernel، في
التوثيق/i2c/dev-interface

يجب تمكين دعم واجهة تصحيح I2C باستخدام نواة CONFIG_I2C_CHARDEV
خيار التكوين. يتم تمكينه على النظام في حالة وجود الملفات /dev/i2c-*.

لاستخدام i2c-dev، قم بتوفير سلسلة جهاز مثل -d i2c-dev:1-004a.

تتم قراءة الرسائل الواردة من أجهزة maXTouch عن طريق الاقتراع. إذا كان برنامج تشغيل kernel أيضًا
موجودة على النظام، وقراءة الرسائل عند المقاطعة، فلن يتم تلقي أي رسائل
الأداة. الحل البديل هو ضبط T18.COMMAND (البايت 1) على 2 "فرض ارتفاع خط CHG
(غير نشط)" لذلك لا يتلقى برنامج تشغيل kernel أي مقاطعة.

لا يوجد دعم المسح. وذلك لأن القراءة من كل maXTouch ممكن
قد يؤثر العنوان الموجود على كل ناقل I2C سلبًا على بعض الأجهزة غير ذات الصلة التي لا تؤثر
فهم بروتوكول الكائن. يجب عليك تحديد المحول والعنوان الصحيحين يدويًا بواسطة
الرجوع إلى دليل البروتوكول أو إلى إعداد النظام الأساسي.

من الممكن استخدام الأمر --flash مع جهاز موجود بالفعل في وضع أداة تحميل التشغيل
تحديد عنوان أداة تحميل التشغيل.

هيدراو
تدعم الواجهة الخلفية hidraw أجهزة maXTouch التي تتصل باستخدام USB أو HID عبر I2C.

تم توثيق واجهة hidraw في مصدر Linux kernel، في
التوثيق/hid/hidraw.txt

يجب أن يكون الجهاز مزودًا بـ /dev/hidraw دعم جهاز HID الخام ممكّنًا باستخدام ملف CONFIG_HIDRAW
خيار تكوين النواة.

لاستخدام hidraw، قم بتوفير سلسلة جهاز مثل -d hidraw:/dev/hidraw0.

لا يوجد دعم المسح.

تحميل التمهيد غير مدعوم في هذا الوضع.

DEBUG OPTIONS

-v [- الإسراف] *مستوى*
تعيين مستوى التصحيح. الدور هو واحد من 0 (صامت)، 1 (التحذيرات والأخطاء)، 2 (معلومات -)
الافتراضي)، 3 (تصحيح)، 4 (مطول). لا يتوفر Debug وVerbose إلا إذا تم إنشاؤهما
في.

EXIT القيم

0 للنجاح

1 خطأ داخلي/تأكيد

2 خطأ في الإدخال/الإخراج

3 فشل في تخصيص الذاكرة

4 مهلة

5 تعذر العثور على جهاز أو اختفى الجهاز

6 طلب الاذن مرفوض

7 العملية غير مسموح بها لهذا النوع من الأجهزة

8 مقاطعة استدعاء الوظيفة

9 الكائن غير متوفر على الجهاز

10 تم تلقي رسالة غير صالحة غير متوقعة من معالج الرسائل

11 أمر اختبار ذاتي غير صالح

12 الاختبار الذاتي AVdd الطاقة التناظرية غير موجودة

13 خطأ دبوس الاختبار الذاتي

14 الاختبار الذاتي وخطأ البوابة

15 الاختبار الذاتي خطأ في حد الإشارة

16 الاختبار الذاتي كسب خطأ

17 خطأ في المجموع الاختباري لكتلة المعلومات

18 تم إلغاء قفل أداة تحميل التشغيل بالفعل

19 فشل Bootloader CRC (فشل الإرسال)

20 خطأ في تنسيق الملف

21 الإصدار الثابت للجهاز مطلوب بالفعل

22 لا يمكن تحديد عنوان أداة تحميل التشغيل

23 الإصدار الموجود على الجهاز لا يتطابق مع الإصدار المقدم بعد عملية تحميل التشغيل

24 لم تتم إعادة ضبط الجهاز

25 الجهاز في حالة غير متوقعة

26 تم تقديم معلمات سطر الأوامر أو إدخال القائمة بشكل غير صحيح

27 خطأ في تحليل بروتوكول Bridge TCP

28 خطأ في اتصال الجسر

29 فشل تنزيل البيانات التسلسلية

30 لا يوجد ملف او مجلد

31 حدث خطأ أثناء معالجة أمر الغطاء الذاتي

تجميع من عند مصدر

لتنزيل الكود المصدري باستخدام git:

استنساخ بوابة https://github.com/atmel-maxtouch/mxt-app.git

هناك نوعان من أدوات البناء لنظامي التشغيل Android والأدوات التلقائية:

أندرويد
لتنزيل الوحدة الفرعية 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 أندرويد
بنك التنمية الآسيوي دفع libs/armeabi/mxt-app /data/local/tmp/
بنك التنمية الآسيوي شل /data/local/tmp/mxt-app [الأمر]

إذا لم يتم تعيين الأذونات القابلة للتنفيذ، فقم بتشغيل:

بنك التنمية الآسيوي شل 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

لإنشاء وثائق Doxygen (يتطلب ذلك تثبيت Doxygen وgraphviz):

جعل وثيقة

VERSION ترقيم

يتم إنشاء رقم الإصدار بواسطة git description أثناء عملية الإنشاء ويتم الإبلاغ عنه بواسطة
--version ولتصحيح الأخطاء.

قد يكون الإصدار النموذجي 1.15-29-g8321 مما يعني 29 التزامًا بعد علامة الإصدار
1.15، بمعرف git SHA يبدأ بـ 8321.

إذا لم يتم سحب المصدر باستخدام git (على سبيل المثال، عن طريق النقر على github
رابط "تنزيل ZIP")، فإن الإصدار من الملف VERSION الموجود في الأرشيف المصدر هو
مستخدم.

يتم إلحاق اللاحقة -mod إذا كانت هناك تغييرات متاحة في كود المصدر.

TROUBLESHOOTING

klogctl خطأ
إذا رأيت التحذير

W: خطأ klogctl 1 (العملية غير مسموح بها)

يشير هذا إلى أن mxt-app لم يتمكن من استرداد الرسائل من dmesg. متنوع
لن تعمل الميزات بشكل صحيح. قد يكون من الممكن إلغاء تقييد dmesg عن طريق القيام بذلك

# صدى 0> /proc/sys/kernel/dmesg_restrict

تطبيق MXT(1)

استخدم تطبيق mxt عبر الإنترنت باستخدام خدمات onworks.net