mxt-app - מקוון בענן

תָכְנִית:

שֵׁם

mxt-app - שירות שורת פקודה עבור מכשירי maXTouch

תַקצִיר

mxt-app [הפקודה] [אפשרויות] ...

תיאור

mxt-app הוא כלי עזר לניהול בקרי מגע של Atmel maXTouch והתקנים אחרים
תמיכה בפרוטוקול מבוסס אובייקטים של Atmel.

אם לא הפקודה לא נתון, mxt-app תספק ממשק מבוסס תפריט אינטראקטיבי.

מטרה נוהל

הפרוטוקול מבוסס האובייקטים של Atmel מגדיר כיצד מכשיר נרשם (לרוב הגישה אליו מתבצעת באמצעות I2C)
ממופים לפונקציות שונות בתוך המכשירים. ממשק זה מארגן את
מפה לרשום לאובייקטים נפרדים שלכל אחד מהם ניתן מספר T. mxt-app יכול לבדוק
ושנה את תצורת האובייקט, והצג נתוני אבחון, בזמן שהמכשיר פועל.

לתיאור של פרוטוקול אובייקט, ראה Atmel AT42QT1085 חפץ פרוטוקול להדריך,
זמין מ-atmel.com.

ניתן למצוא את המשמעות של בתי התצורה בתוך האובייקטים בפרוטוקול
תיעוד מדריך שפורסם עם כל מכשיר, והוא מסופק רק על ידי Atmel במסגרת NDA.

כללי פקודות

-h [--עֶזרָה]
הצג סיכום קצר של האפשרויות הזמינות וצא.

-i [--מידע]
הדפס את פרטי הזיהוי וטבלת האובייקטים.

-M [--הודעות] [*פסק זמן*]
מדפיס את ההודעות עד פסק זמן שניות חלפו. אם לא פסק זמן מסופק,
המשך עד שהמשתמש ילחץ על Ctrl-C. אפס פסק זמן קריאה פעם אחת. לְסַפֵּק
-F [--msg-filter] אפשרות לסינון לפי אובייקט ספציפי.

-F [--מסנן-מסנן] *סוּג*
מסנן הודעות לפי אובייקט סוג.

--אִתחוּל
אפס את המכשיר.

--לְדַרֵג
שלח פקודת כיול.

--גיבוי[*=פקודה*]
גיבוי תצורת ל-NVRAM כאשר הארגומנט האופציונלי, פקודה, הוא ה-BACKUPNV
פקודה.

-g כתוב כיול Golden Reference ל-NVRAM.

--self-cap-tune-config
כוונן וכייל את הגדרות הקיבול העצמי ואחסן אותן במכשיר
תצורה.

--self-cap-tune-nvram
כוונן וכייל את הגדרות הקיבול העצמי ואחסן אותן ב-NVRAM ללא
עדכון ה-Config Checksum.

--גִרְסָה
גרסת הדפסה של mxt-app.

תְצוּרָה קובץ פקודות

--לִטעוֹן *קוֹבֶץ*
העלה תצורה מ קובץ, כתוב אותו ל-NVRAM, ואפס את ההתקן. התצורה
עשוי להיות בפורמט .xcfg או OBP_RAW.

--לשמור *קוֹבֶץ*
שמור את התצורה ב קובץ בפורמט OBP_RAW או .xcfg.

--בדיקת סכום *קוֹבֶץ*
קרא את התוכן של קובץ וחשב מחדש את סכום הבדיקה של התצורה.

להירשם קרוא וכתוב פקודות

-R [--לקרוא]
קרא נתונים מהמכשיר.

-W [--לִכתוֹב]
כתוב נתונים למכשיר.

-n [--לספור] *לספור*
קריאה / כתיבה COUNT רושמים

-f [--פוּרמָט]
פורמט פלט אוגר

-I [--למשל] *למשל*
בחר אובייקט למשל

-r [--הירשם] *הירשם*
מתחיל ב להירשם (היסט באובייקט בשימוש עם סוג)

-T [--סוּג] *סוּג*
בחר אובייקט סוג

--אֶפֶס אפס את כל הגדרות התצורה

דוגמאות
חומר עיוני מידע בלוק:
$ mxt-app -R -n7 -r0
82 19 11 AA 18 0E 16

חומר עיוני T7 כוח Config אובייקט:
$ mxt-app -R -T7
32 FF 05 43

אפס ראשון שתיים בתים of T7:
$ mxt-app -W -T7 0000

חומר עיוני T7 כוח Config חפץ, מעוצב תְפוּקָה:
$ 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-app לפעול כמו
גשר כך שכלים קנייניים של Atmel כגון חפץ שרת יכול לגשת למכשיר.

-C [--גשר-לקוח] *מנחה*
התחבר דרך TCP ל HOST

-S [--שרת-גשר]
הפעל שרת שקע TCP

-p [--נמל] נמל
יציאת TCP (ברירת מחדל 4000)

BOOTLOAD פקודות

--גירסת Bootloader
שאילתה והדפס מזהה וגרסה של טוען האתחול.

--הֶבזֵק *קושחה*
פלאש תוכנת תוכנה למכשיר. קובץ הקושחה צריך להיות בפורמט .enc.

--reset-bootloader
אפס את המכשיר במצב טוען אתחול. במצב טוען אתחול המכשיר יפסיק לפעול
פעולה עד שליחת קושחה. כתובת I2C או USB PID ישתנו. ה
הפקודה החוקית היחידה במצב זה היא --flash. מחזור כוח קשה יחזיר את
המכשיר למצב פרוטוקול אובייקט רגיל, אלא אם תמונת הקושחה פגומה.
פקודה זו ניתנת רק למטרות ניפוי באגים: ברוב המקרים --flash יעשה זאת
נהל את השינוי אל/ממצב טוען האתחול לפני/אחרי הבזק.

--גרסת קושחה *גִרְסָה*
פורמט הקובץ .enc אינו מספק את גרסת הקושחה בצורה זמינה עבור
mxt-app. אם הוא מסופק באמצעות מתג זה, mxt-app יכול לבדוק קושחה גִרְסָה
לפני ואחרי הבזק. זה ידלג על תהליך ההבזק אם גרסת הקושחה היא
כבר נכון. זה גם יבדוק אם יש הבזק מוצלח בסיום. ה
יש לספק את הגרסה בפורמט 1.0.AA. # אפשרויות בדיקה עצמית של T25

האובייקט Self Test T25 מפעיל שגרות בדיקה עצמית במכשיר כדי למצוא תקלות במובן
קווים ואלקטרודות. האובייקט Self Test T25 מריץ סדרה של רצפי בדיקה.

-t [--מִבְחָן]
הפעל את כל הבדיקות העצמיות.

-t*XX* [--test=*XX*]
הפעל בדיקה עצמית פרטנית שצוינה על ידי CMD ערך hex.

-01 להריץ בדיקת כוח אנלוגי.

-11 הפעל בדיקת תקלות בפינים.

-12 הפעל בדיקת פין 2.

-13 הרץ ובדיקת שערים.

-17 הפעל את בדיקת מגבלת האות.

-20 להריץ בדיקת רווח.

-21 להפעיל בדיקת תקלות אופסט.

T37 אבחון נתונים אפשרויות

לכידת מסגרות של נתוני אבחון. מצב ברירת המחדל הוא לכידת דלתות מגע. עצמי
מדידות קיבול זמינות רק בחלק מהמכשירים.

--debug-dump *קוֹבֶץ*
האובייקט T37 Diagnostic Data מספק גישה גולמית להפניה למגע/דלתא
מדידות ממסך המגע. נתוני אבחון נכתבים ל קובץ ב-CSV
פוּרמָט. הפורמט תואם לכלי השירות Atmel Hawkeye.

--מסגרות *N*
ללכוד N מסגרות נתונים.

--הפניות
לכידת נתוני הפניות.

--אותות כובע עצמי
לכידת אותות מכסה עצמית.

--עצמי כובע-דלתות
לכידת דלתות מכסה עצמית.

---self-cap-refs
לכיד הפניות כובע עצמי.

T68 סידורי נתונים פקודות

--t68-קובץ *קוֹבֶץ*
העלה קובץ למכשיר דרך אובייקט T68 Serial Data.

--t68-datatype *סוג מידע*
לקבוע סוג מידע של הקובץ. זה יזוהה אוטומטית מהקובץ עצמו
ברוב המקרים.

סיכום ו מפרט מכשיר

כברירת מחדל, mxt-app יסרוק מכשירים זמינים ותתחבר למכשיר הראשון שהיא תמצא.

-q [--שאילתא]
סרוק לאיתור מכשירים ופלט רשימה.

-d [--התקן] *DEVICESTRING*
התחבר למכשיר מסוים שצוין על ידי DEVICESTRING אשר ניתן באותו
פורמט כפלט על ידי --query.

ישנן שלוש שיטות חיבור נתמכות עבור גישה לחומרה:

sysfs
זה משמש בשילוב עם מנהל ההתקן של ליבת לינוקס. זה ניגש לתכונות sysfs
תחת הספריה

/sys/bus/i2c/drivers/dddddddd/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 מ-github, ועשויים להיות נתמכים על ידי
מכשירים אחרים.

USB
התקני maXTouch רבים תומכים במצב USB המדווח על נגיעות באמצעות USB HID. בנוסף,
לוחות הערכה עשויים להשתמש ב"שבב גשר" המממשק את I2C לאותו פרוטוקול.

מצב USB ייבנה על ידי כלי אוטומטי כאשר libusb זמין.

ניתן לציין התקן USB ספציפי על ידי מתן אפשרות התקן -d usb:001-003 אשר
מתאים למספרי האוטובוס וההתקנים שניתנו על ידי אפשרות השאילתה -q/--ו-lsusb.

I2C באגים ממשק
ניתן לגשת למכשירים ישירות דרך i2c-dev ממשק ניפוי באגים I2C על ידי מתן מתאם ו
כתובת בשורת הפקודה.

ממשק i2c-dev מתועד במקור ליבת לינוקס, ב
תיעוד/i2c/ממשק פיתוח

יש להפעיל את תמיכת ממשק ניפוי באגים של I2C באמצעות ליבת CONFIG_I2C_CHARDEV
אפשרות תצורה. זה מופעל במערכת אם קיימים קבצים /dev/i2c-*.

כדי להשתמש ב-i2c-dev, ספק מחרוזת התקן כגון -d i2c-dev:1-004a.

הודעות ממכשירי maXTouch נקראות באמצעות סקר. אם גם מנהל התקן ליבה
קיים במערכת, קריאת הודעות בפסיקה, אז לא יתקבלו הודעות על ידי
הכלי. דרך לעקיפת הבעיה היא להגדיר את T18.COMMAND (בייט 1) ל-2 "אלץ את קו ה-CHG גבוה
(לא פעיל)" כך שמנהל ההתקן של הליבה לא יקבל הפרעה.

אין תמיכה בסריקה. הסיבה לכך היא קריאה מכל maXTouch אפשרי
כתובת בכל אוטובוס I2C עלולה להשפיע לרעה על חומרה שאינה קשורה
להבין פרוטוקול אובייקט. עליך לזהות ידנית את המתאם והכתובת הנכונים לפי
התייחסות למדריך הפרוטוקול או להגדרת הפלטפורמה.

אפשר להשתמש בפקודה --flash עם התקן שכבר נמצא במצב טוען אתחול, על ידי
ציון הכתובת של טוען האתחול.

HIDRAW
ה-hidraw backend תומך בהתקני maXTouch המתחברים באמצעות USB או HID על I2C.

ממשק ה-hidraw מתועד במקור ליבת לינוקס, ב
Documentation/hid/hidraw.txt

על המכשיר להיות מופעל תמיכה במכשיר /dev/hidraw raw HID באמצעות CONFIG_HIDRAW
אפשרות תצורת ליבה.

כדי להשתמש ב-hidraw, ספק מחרוזת מכשיר כגון -d hidraw:/dev/hidraw0.

אין תמיכה בסריקה.

טעינת אתחול אינה נתמכת במצב זה.

DEBUG אפשרויות

-v [--מִלוּלִי] *רָמָה*
הגדר רמת ניפוי באגים. רמה הוא אחד מ-0 (שקט), 1 (אזהרות ושגיאות), 2 (מידע -
ברירת מחדל), 3 (ניפוי באגים), 4 (מילולית). Debug ו-verbose זמינים רק אם הם בנויים
פנימה

יְצִיאָה ערכים

0 הַצלָחָה

1 שגיאה/טענה פנימית

2 שגיאת קלט/פלט

3 כשל בהקצאת זיכרון

4 פסק זמן

5 לא ניתן למצוא מכשיר או מכשיר נעלמו

6 הרשאה נדחתה

7 פעולה לא מותרת עבור סוג מכשיר זה

8 שיחת פונקציה להפריע

9 האובייקט אינו זמין במכשיר

10 התקבלה הודעה לא חוקית בלתי צפויה ממעבד ההודעות

11 בדיקה עצמית פקודת בדיקה לא חוקית

12 בדיקה עצמית AVdd כוח אנלוגי אינו קיים

13 בדיקה עצמית תקלת פינים

14 בדיקה עצמית ותקלת שער

15 בדיקה עצמית תקלת מגבלת אות

16 בדיקה עצמית שגיאת רווח

17 שגיאת בדיקת סכום חסימת מידע

18 טוען האתחול כבר לא נעול

19 כשל CRC של טוען האתחול (כשל שידור)

20 שגיאה בפורמט הקובץ

21 כבר דרושה גרסה של קושחת ההתקן

22 לא ניתן לזהות כתובת של טוען האתחול

23 הגרסה במכשיר לא התאימה לגרסה שניתנה לאחר פעולת טעינת האתחול

24 המכשיר לא אופס

25 מכשיר במצב לא צפוי

26 נתנו פרמטרים שגויים של שורת הפקודה או קלט תפריט

27 שגיאת ניתוח פרוטוקול TCP של Bridge

28 שגיאת חיבור גשר

29 הורדת הנתונים הסידוריים נכשלה

30 אין קובץ או ספריה כאלה

31 שגיאה בעיבוד פקודת כובע עצמי

קומפילציה מן מקור

כדי להוריד את קוד המקור באמצעות git:

שיבוט git https://github.com/atmel-maxtouch/mxt-app.git

ישנן שתי רתמות בנייה, עבור אנדרואיד וכלים אוטומטיים:

אנדרואיד
להורדת תת-מודול libusbdroid:

git submodule 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 shell /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

כדי לבנות את תיעוד הדוקסגן (זה דורש התקנה של דוקסיג'ן ו-graphviz):

לעשות דוק

גִרְסָה סִפְרוּר

מספר גרסה נוצר על ידי git describe במהלך תהליך הבנייה ומדווח על ידי
--גרסה ולניפוי באגים ביומנים.

גרסה טיפוסית עשויה להיות 1.15-29-g8321 כלומר, 29 התחייבויות לאחר תג השחרור
1.15, עם מזהה SHA של git שמתחיל ב-8321.

אם המקור לא נמחק באמצעות git (למשל על ידי לחיצה על ה-github
קישור "הורד ZIP", ואז הגרסה מהקובץ VERSION בארכיון המקור היא
מְשׁוּמָשׁ.

הסיומת -mod מתווספת אם יש שינויים לא מחויבים בקוד המקור.

פתרון תקלות

klogctl שגיאה
אם אתה רואה את האזהרה

W: klogctl שגיאה 1 (פעולה לא מותרת)

זה מציין ש-mxt-app לא הצליחה לאחזר הודעות מ-dmesg. שׁוֹנִים
התכונות לא יפעלו כראוי. ייתכן שניתן לבטל הגבלת dmesg על ידי ביצוע

# echo 0 > /proc/sys/kernel/dmesg_restrict

MXT-APP(1)

השתמש ב-mxt-app באינטרנט באמצעות שירותי onworks.net