एमएक्सटी-ऐप - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

एमएक्सटी-ऐप - मैक्सटच उपकरणों के लिए कमांड लाइन उपयोगिता

SYNOPSIS

mxt-ऐप [आदेश] [विकल्पों] ...

वर्णन

एमएक्सटी-ऐप एटमेल मैक्सटच टच कंट्रोलर और अन्य उपकरणों के प्रबंधन के लिए एक उपयोगिता है
एटमेल ऑब्जेक्ट आधारित प्रोटोकॉल का समर्थन करें।

यदि नही आदेश नहीं दिया गया है, mxt-app एक इंटरैक्टिव मेनू आधारित इंटरफ़ेस प्रदान करेगा।

वस्तु मसविदा बनाना

एटमेल ऑब्जेक्ट आधारित प्रोटोकॉल परिभाषित करता है कि डिवाइस कैसे पंजीकृत होता है (सामान्यतः I2C के माध्यम से एक्सेस किया जाता है)
उपकरणों के भीतर विभिन्न कार्यों के लिए मैप किया जाता है। यह इंटरफ़ेस व्यवस्थित करता है
मानचित्र को अलग-अलग वस्तुओं में पंजीकृत करें जिनमें से प्रत्येक को एक टी नंबर दिया गया है। mxt-ऐप निरीक्षण कर सकते हैं
और डिवाइस के चलने के दौरान ऑब्जेक्ट कॉन्फ़िगरेशन को बदलें और डायग्नोस्टिक डेटा देखें।

ऑब्जेक्ट प्रोटोकॉल के विवरण के लिए देखें Atmel एटी42क्यूटी1085 वस्तु प्रोटोकॉल मार्गदर्शिका,
atmel.com से उपलब्ध है।

ऑब्जेक्ट के भीतर कॉन्फ़िगरेशन बाइट्स का अर्थ प्रोटोकॉल में पाया जा सकता है
प्रत्येक डिवाइस के साथ गाइड दस्तावेज़ीकरण जारी किया जाता है, और यह केवल एनडीए के तहत एटमेल द्वारा प्रदान किया जाता है।

सामान्य कमानों

-h [--मदद]
उपलब्ध विकल्पों का संक्षिप्त सारांश प्रदर्शित करें और बाहर निकलें।

-i [--जानकारी]
आईडी जानकारी और ऑब्जेक्ट तालिका प्रिंट करें।

-M [--संदेश] [*समय समाप्त*]
तक संदेशों को प्रिंट करता है मध्यांतर सेकंड बीत गए. अगर कोई नहीं मध्यांतर उपलब्ध है,
तब तक जारी रखें जब तक उपयोगकर्ता Ctrl-C नहीं दबाता। शून्य टाइमआउट एक बार पढ़ता है। उपलब्ध करवाना
-F [--msg-filter] किसी विशिष्ट ऑब्जेक्ट द्वारा फ़िल्टर करने का विकल्प।

-F [--संदेश-फ़िल्टर] *प्रकार*
ऑब्जेक्ट के आधार पर संदेशों को फ़िल्टर करता है TYPE.

--रीसेट
यंत्र को पुनः तैयार करो।

--अंशांकन
कैलिब्रेट आदेश भेजें.

--बैकअप[*=कमांड*]
एनवीआरएएम में बैकअप कॉन्फ़िगरेशन जहां वैकल्पिक तर्क, कमान, बैकअपएनवी है
आदेश।

-g एनवीआरएएम में गोल्डन रेफरेंस कैलिब्रेशन लिखें।

--स्वयं-कैप-ट्यून-विन्यास
सेल्फ कैपेसिटेंस सेटिंग्स को ट्यून और कैलिब्रेट करें और उन्हें डिवाइस में स्टोर करें
विन्यास।

--सेल्फ-कैप-ट्यून-एनवीआरएएम
सेल्फ कैपेसिटेंस सेटिंग्स को ट्यून और कैलिब्रेट करें और उन्हें बिना एनवीआरएएम में स्टोर करें
कॉन्फ़िग चेकसम को अद्यतन करना।

--संस्करण
एमएक्सटी-ऐप का प्रिंट संस्करण।

विन्यास फ़ाइल कमानों

--भार *फ़ाइल*
से कॉन्फ़िगरेशन अपलोड करें फ़ाइल, इसे NVRAM पर लिखें, और डिवाइस को रीसेट करें। विन्यास
.xcfg या OBP_RAW प्रारूप में हो सकता है।

--बचा ले *फ़ाइल*
कॉन्फ़िगरेशन को इसमें सहेजें फ़ाइल या तो OBP_RAW या .xcfg प्रारूप में।

--चेकसम *फ़ाइल*
की सामग्री पढ़ें फ़ाइल और कॉन्फ़िगरेशन चेकसम की पुनर्गणना करें।

पंजीकृत पढ़ना लिखना कमानों

-R [--पढ़ना]
डिवाइस से डेटा पढ़ें.

-W [--लिखना]
डिवाइस पर डेटा लिखें.

-n [--गिनती करना] *गिनती करना*
पढ़ने / लिखने COUNT रजिस्टरों

-f [--प्रारूप]
प्रारूप रजिस्टर आउटपुट

-I [--उदाहरण] *उदाहरण*
वस्तु का चयन करें उदाहरण

-r [--पंजीकरण करवाना] *पंजीकरण करवाना*
शुरू करे पंजीकृत (जब उपयोग किया जाता है तो ऑब्जेक्ट में ऑफसेट होता है TYPE)

-T [--प्रकार] *प्रकार*
वस्तु का चयन करें TYPE

--शून्य सभी कॉन्फ़िगरेशन सेटिंग्स शून्य करें

उदाहरण
पढ़ना पता खंड मैथा:
$ mxt-ऐप -R -n7 -r0
82 19 11 एए 18 0ई 16

पढ़ना T7 Power कॉन्फिग वस्तु:
$ एमएक्सटी-ऐप -आर -टी7
32 एफएफ 05 43

शून्य प्रथम दो बाइट्स of टी -7:
$ mxt-ऐप -W -T7 0000

पढ़ना T7 Power कॉन्फिग वस्तु, स्वरूपित उत्पादन:
$ एमएक्सटी-ऐप -आर -टी7--प्रारूप
GEN_POWERCONFIG_T7

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

टीसीपी सॉकेट कमानों

mxt-ऐप ASCII प्रोटोकॉल का उपयोग करके टीसीपी पर कनेक्शन का समर्थन करता है जो एमएक्सटी-ऐप को कार्य करने की अनुमति देता है
एक पुल ताकि Atmel मालिकाना उपकरण जैसे वस्तु सर्वर डिवाइस तक पहुंच सकते हैं.

-C [--ब्रिज-क्लाइंट] *मेज़बान*
टीसीपी से कनेक्ट करें होस्ट

-S [--ब्रिज-सर्वर]
टीसीपी सॉकेट सर्वर प्रारंभ करें

-p [--पत्तन] पोर्ट
टीसीपी पोर्ट (डिफ़ॉल्ट 4000)

बूटलोडर कमानों

--बूटलोडर-संस्करण
क्वेरी और प्रिंट आईडी और बूटलोडर का संस्करण।

--Chamak *फर्मवेयर*
फ़्लैश फर्मवेयर यंत्र को। फ़र्मवेयर फ़ाइल .enc प्रारूप में होनी चाहिए।

--रीसेट-बूटलोडर
डिवाइस को बूटलोडर मोड में रीसेट करें। बूटलोडर मोड में डिवाइस सामान्य रूप से बंद हो जाएगा
फ़र्मवेयर भेजे जाने तक संचालन। I2C पता या USB PID बदल जाएगा.
इस मोड में एकमात्र वैध कमांड --फ्लैश है। एक कठिन शक्ति चक्र वापस आ जाएगा
डिवाइस को सामान्य ऑब्जेक्ट प्रोटोकॉल मोड में रखें, जब तक कि फ़र्मवेयर छवि दूषित न हो।
यह कमांड केवल डिबगिंग उद्देश्यों के लिए प्रदान किया गया है: ज्यादातर मामलों में - फ़्लैश होगा
फ्लैश से पहले/बाद में बूटलोडर मोड में परिवर्तन को प्रबंधित करें।

--प्रक्रिया यंत्र सामग्री संस्करण *संस्करण*
.enc फ़ाइल स्वरूप फ़र्मवेयर संस्करण को उपलब्ध प्रपत्र में प्रदान नहीं करता है
mxt-ऐप. यदि यह इस स्विच के माध्यम से प्रदान किया जाता है, तो एमएक्सटी-ऐप फर्मवेयर की जांच कर सकता है VERSION
फ़्लैश से पहले और बाद में. यदि फ़र्मवेयर संस्करण है तो यह फ़्लैश प्रक्रिया को छोड़ देगा
पहले से ही सही. यह पूरा होने पर सफल फ़्लैश की भी जाँच करेगा।
संस्करण 1.0.AA प्रारूप में प्रदान किया जाना चाहिए। # T25 स्वयं परीक्षण विकल्प

सेल्फ टेस्ट T25 ऑब्जेक्ट सेंस में दोष ढूंढने के लिए डिवाइस में सेल्फ-टेस्ट रूटीन चलाता है
लाइनें और इलेक्ट्रोड. सेल्फ टेस्ट T25 ऑब्जेक्ट परीक्षण अनुक्रमों की एक श्रृंखला चलाता है।

-t [--परीक्षा]
सभी स्व-परीक्षण चलाएँ.

-t*XX* [--परीक्षण=*XX*]
द्वारा निर्दिष्ट व्यक्तिगत स्व-परीक्षण चलाएँ सीएमडी हेक्स मान.

-01 एनालॉग पावर परीक्षण चलाएँ।

-11 पिन दोष परीक्षण चलाएँ.

-12 पिन फ़ॉल्ट 2 परीक्षण चलाएँ।

-13 रन और गेट परीक्षण।

-17 सिग्नल सीमा परीक्षण चलाएँ।

-20 लाभ परीक्षण चलाएँ.

-21 ऑफसेट दोष परीक्षण चलाएँ।

T37 नैदानिक आंकड़े विकल्प

डायग्नोस्टिक डेटा के फ़्रेम कैप्चर करें. डिफ़ॉल्ट मोड टच डेल्टा को कैप्चर करना है। खुद
कैपेसिटेंस माप केवल कुछ उपकरणों पर उपलब्ध हैं।

--डीबग-डंप *फ़ाइल*
T37 डायग्नोस्टिक डेटा ऑब्जेक्ट स्पर्श संदर्भ/डेल्टा तक कच्ची पहुंच प्रदान करता है
टच स्क्रीन से माप। डायग्नोस्टिक डेटा को लिखा जाता है फ़ाइल सीएसवी में
प्रारूप। प्रारूप एटमेल हॉकआई उपयोगिता के साथ संगत है।

--फ्रेम्स *एन*
कैद N डेटा के फ्रेम.

--संदर्भ
संदर्भ डेटा कैप्चर करें.

--स्वयं-कैप-संकेत
सेल्फ कैप सिग्नल कैप्चर करें.

--सेल्फ-कैप-डेल्टा
सेल्फ कैप डेल्टा कैप्चर करें.

--स्वयं-कैप-रेफ्स
सेल्फ कैप संदर्भ कैप्चर करें.

T68 धारावाहिक आंकड़े कमानों

--t68-फ़ाइल *फ़ाइल*
अपलोड फ़ाइल T68 सीरियल डेटा ऑब्जेक्ट के माध्यम से डिवाइस पर।

--t68-डेटाटाइप *डेटा प्रकार*
सेट डेटा प्रकार फ़ाइल का. इसका पता फ़ाइल से ही स्वचालित रूप से लगाया जाएगा
ज्यादातर मामलों में।

ढूँढना और निर्दिष्ट करना उपकरण

डिफ़ॉल्ट रूप से mxt-ऐप उपलब्ध डिवाइसों को स्कैन करेगा और उसे मिलने वाले पहले डिवाइस से कनेक्ट करेगा।

-q [--सवाल]
उपकरणों को स्कैन करें और एक सूची आउटपुट करें।

-d [--उपकरण] *डिवाइसस्ट्रिंग*
द्वारा निर्दिष्ट किसी विशेष डिवाइस से कनेक्ट करें डिवाइसस्ट्रिंग जो उसी में दिया गया है
--query द्वारा आउटपुट के रूप में प्रारूपित करें।

हार्डवेयर एक्सेस के लिए तीन कनेक्शन विधियाँ समर्थित हैं:

sysfs
इसका उपयोग लिनक्स कर्नेल ड्राइवर के साथ संयोजन में किया जाता है। यह sysfs विशेषताओं तक पहुँचता है
निर्देशिका के अंतर्गत

/sys/बस/i2c/ड्राइवर/dddddddd/b-00xx/

कहा पे

d ड्राइवर का नाम - atmel_mxt_ts, Atmel MXTXXXX, आदि

b i2c एडाप्टर

xx i2c पता

एक विशिष्ट USB डिवाइस को डिवाइस विकल्प -d sysfs:PATH देकर निर्दिष्ट किया जा सकता है जैसा कि दिया गया है
-q/--क्वेरी विकल्प

इस निर्देशिका के अंतर्गत उपयोग की जाने वाली sysfs विशेषताएँ हैं

mem_access
कच्चे I2C पता स्थान तक पहुंच।

डिबग_सक्षम
डिवाइस से हेक्साडेसिमल के रूप में dmesg लॉग में आउटपुट संदेश।

डिबग_v2_सक्षम, डिबग_संदेश, डीबग_सूचित करें
संदेशों को पुनः प्राप्त करने के लिए वैकल्पिक रूप से बेहतर बाइनरी इंटरफ़ेस

वे github से Atmel कर्नेल ड्राइवर का उपयोग करते समय प्रदान किए जाते हैं, और इसके द्वारा समर्थित हो सकते हैं
अन्य उपकरण।

यु एस बी
कई मैक्सटच डिवाइस यूएसबी मोड का समर्थन करते हैं जो यूएसबी एचआईडी के माध्यम से स्पर्श की रिपोर्ट करता है। इसके अलावा,
मूल्यांकन बोर्ड एक "ब्रिज चिप" का उपयोग कर सकते हैं जो I2C को समान प्रोटोकॉल से जोड़ता है।

लिबसब उपलब्ध होने पर यूएसबी मोड ऑटोटूल्स द्वारा बनाया जाएगा।

एक विशिष्ट USB डिवाइस को एक डिवाइस विकल्प -d usb:001-003 देकर निर्दिष्ट किया जा सकता है
-q/--क्वेरी विकल्प और lsusb द्वारा दिए गए बस और डिवाइस नंबरों से मेल खाता है।

I2C डिबग इंटरफेस
डिवाइसों तक सीधे इसके माध्यम से पहुंचा जा सकता है i2c-dev एडाप्टर देकर I2C डिबग इंटरफ़ेस और
कमांड लाइन पर पता.

I2c-dev इंटरफ़ेस को Linux कर्नेल स्रोत में प्रलेखित किया गया है
दस्तावेज़ीकरण/i2c/dev-इंटरफ़ेस

I2C डिबग इंटरफ़ेस समर्थन को CONFIG_I2C_CHARDEV कर्नेल का उपयोग करके सक्षम किया जाना चाहिए
कॉन्फ़िगरेशन विकल्प. यदि /dev/i2c-* फ़ाइलें मौजूद हैं तो यह सिस्टम पर सक्षम है।

i2c-dev का उपयोग करने के लिए, -d i2c-dev:1-004a जैसी डिवाइस स्ट्रिंग प्रदान करें।

मैक्सटच उपकरणों से संदेश मतदान द्वारा पढ़े जाते हैं। यदि कोई कर्नेल ड्राइवर भी है
सिस्टम पर मौजूद, संदेशों को पढ़ने में रुकावट आती है, तो कोई भी संदेश प्राप्त नहीं होगा
साधन। एक समाधान T18.COMMAND (बाइट 1) को 2 पर सेट करना है "सीएचजी लाइन को बलपूर्वक ऊंचा करें
(निष्क्रिय)" ताकि कर्नेल ड्राइवर को कोई व्यवधान प्राप्त न हो।

कोई स्कैनिंग समर्थन नहीं है. ऐसा इसलिए है क्योंकि हर संभव maXTouch से पढ़ना
प्रत्येक I2C बस पर पता कुछ असंबंधित हार्डवेयर पर प्रतिकूल प्रभाव डाल सकता है जो नहीं करता है
ऑब्जेक्ट प्रोटोकॉल को समझें. आपको मैन्युअल रूप से सही एडॉप्टर और पते की पहचान करनी होगी
प्रोटोकॉल गाइड या प्लेटफ़ॉर्म सेटअप का संदर्भ।

पहले से ही बूटलोडर मोड में मौजूद डिवाइस के साथ --flash कमांड का उपयोग करना संभव है
बूटलोडर पता निर्दिष्ट करना।

छिपाना
hidraw बैकएंड maXTouch डिवाइस को सपोर्ट करता है जो I2C पर USB या HID का उपयोग करके कनेक्ट होता है।

hidraw इंटरफ़ेस को Linux कर्नेल स्रोत में प्रलेखित किया गया है
दस्तावेज़ीकरण/hid/hidraw.txt

डिवाइस में CONFIG_HIDRAW का उपयोग करके /dev/hidraw रॉ HID डिवाइस समर्थन सक्षम होना चाहिए
कर्नेल कॉन्फ़िगरेशन विकल्प.

hidraw का उपयोग करने के लिए, -d hidraw:/dev/hidraw0 जैसी डिवाइस स्ट्रिंग प्रदान करें।

कोई स्कैनिंग समर्थन नहीं है.

इस मोड में बूटलोडिंग समर्थित नहीं है.

डीबग विकल्प

-v [--क्रिया] *स्तर*
डिबग स्तर सेट करें. LEVEL 0 (मौन), 1 (चेतावनी और त्रुटियाँ), 2 (जानकारी -) में से एक है
डिफ़ॉल्ट), 3 (डीबग), 4 (वर्बोज़)। डिबग और वर्बोज़ केवल निर्मित होने पर ही उपलब्ध हैं
अंदर

बाहर निकलें मान

0 सफलता

1 आंतरिक त्रुटि/दावा

2 इनपुट/आउटपुट त्रुटि

3 मेमोरी आवंटन विफलता

4 मध्यांतर

5 कोई उपकरण नहीं मिल सका या उपकरण चला गया

6 अनुमति अस्वीकृत

7 इस उपकरण प्रकार के लिए संचालन की अनुमति नहीं है

8 फ़ंक्शन कॉल को बाधित करें

9 ऑब्जेक्ट डिवाइस पर उपलब्ध नहीं है

10 संदेश संसाधक से अप्रत्याशित अमान्य संदेश प्राप्त हुआ

11 स्व-परीक्षण अमान्य परीक्षण आदेश

12 स्व-परीक्षण एवीडीडी एनालॉग पावर मौजूद नहीं है

13 स्वयं परीक्षण पिन दोष

14 स्व-परीक्षण और गेट दोष

15 स्व-परीक्षण सिग्नल सीमा दोष

16 स्वयं परीक्षण लाभ त्रुटि

17 सूचना ब्लॉक चेकसम त्रुटि

18 बूटलोडर पहले से ही अनलॉक है

19 बूटलोडर सीआरसी विफलता (ट्रांसमिशन विफलता)

20 फ़ाइल स्वरूप त्रुटि

21 डिवाइस फर्मवेयर पहले से ही आवश्यक संस्करण है

22 बूटलोडर पते की पहचान नहीं हो सकी

23 डिवाइस पर संस्करण बूटलोडिंग ऑपरेशन के बाद दिए गए संस्करण से मेल नहीं खाता

24 डिवाइस रीसेट नहीं हुआ

25 डिवाइस अप्रत्याशित स्थिति में

26 गलत कमांड लाइन पैरामीटर या मेनू इनपुट दिया गया है

27 ब्रिज टीसीपी प्रोटोकॉल पार्स त्रुटि

28 ब्रिज कनेक्शन त्रुटि

29 सीरियल डेटा डाउनलोड विफल रहा

30 ऐसी कोई फ़ाइल या डायरेक्टरी नहीं है

31 सेल्फ कैप कमांड को संसाधित करने में त्रुटि

संकलन से स्रोत

Git का उपयोग करके स्रोत कोड डाउनलोड करने के लिए:

गिट क्लोन https://github.com/atmel-maxtouch/mxt-app.git

एंड्रॉइड और ऑटोटूल्स के लिए दो बिल्ड हार्नेस हैं:

एंड्रॉयड
libusbdroid सबमॉड्यूल डाउनलोड करने के लिए:

गिट सबमॉड्यूल init
गिट सबमॉड्यूल अद्यतन

Android NDK का उपयोग करके संकलित करने के लिए:

NDK-निर्माण

डिबग सक्षम करने के लिए:

एनडीके-बिल्ड NDK_DEBUG=1

PIE समर्थन सक्षम करने के लिए (Android L के लिए):

ndk-बिल्ड APP_PLATFORM=android-16

बायनेरिज़ को libs/ में रखा जाएगा

Android NDK https://developer.android.com/tools/sdk/ndk/ पर उपलब्ध है

रनिंग on एंड्रॉयड
एडीबी पुश libs/armeabi/mxt-app /डेटा/स्थानीय/tmp/
एडीबी शेल /डेटा/स्थानीय/टीएमपी/एमएक्सटी-ऐप [कमांड]

यदि निष्पादन योग्य अनुमतियाँ सेट नहीं की गई हैं, तो चलाएँ:

एडीबी शेल चामोद 777 /डेटा/लोकल/टीएमपी/एमएक्सटी-ऐप

ऑटोटूल्स
ऑटोटूल्स का उपयोग करके संकलित करने के लिए:

./autogen.sh && बनाओ

क्रॉस-संकलन करने के लिए:

./autogen.sh --host=arm-linux-gnueabi && बनाओ

डिबग सक्षम करने के लिए:

./autogen.sh --enable-debug

पंडोक का उपयोग करके मैन पेज के निर्माण को सक्षम करने के लिए:

./autogen.sh --enable-man

डॉक्सीजन दस्तावेज़ बनाने के लिए (इसके लिए डॉक्सीजन और ग्राफ़विज़ को स्थापित करना आवश्यक है):

दस्तावेज़ बनाओ

VERSION नंबरिंग

बिल्ड प्रक्रिया के दौरान गिट डिस्क्रिप्शन द्वारा एक संस्करण संख्या उत्पन्न की जाती है और इसके द्वारा रिपोर्ट की जाती है
--संस्करण और लॉग डीबग करने के लिए।

एक सामान्य संस्करण 1.15-29-जी8321 हो सकता है जिसका अर्थ है, रिलीज़ टैग के बाद 29 कमिट
1.15, 8321 से शुरू होने वाली गिट एसएचए आईडी के साथ।

यदि स्रोत की जाँच git का उपयोग करके नहीं की गई है (उदाहरण के लिए github पर क्लिक करके)।
"ज़िप डाउनलोड करें" लिंक), फिर स्रोत संग्रह में फ़ाइल संस्करण से संस्करण है
उपयोग किया गया।

यदि स्रोत कोड में अप्रतिबद्ध परिवर्तन हैं तो प्रत्यय -मॉड जोड़ा जाता है।

समस्या निवारण

klogctl त्रुटि
यदि आपको चेतावनी दिखाई देती है

डब्ल्यू: klogctl त्रुटि 1 (ऑपरेशन की अनुमति नहीं है)

यह इंगित करता है कि mxt-ऐप dmesg से संदेशों को पुनर्प्राप्त करने में असमर्थ है। विभिन्न
सुविधाएं ठीक से काम नहीं करेंगी. ऐसा करने से dmesg को अप्रतिबंधित करना संभव हो सकता है

# गूंज 0 > /proc/sys/kernel/dmesg_restrict

एमएक्सटी-एपीपी(1)

onworks.net सेवाओं का उपयोग करके ऑनलाइन mxt-app का उपयोग करें