mxt-app - Online w chmurze

PROGRAM:

IMIĘ

mxt-app - narzędzie wiersza poleceń dla urządzeń maXTouch

STRESZCZENIE

aplikacja mxt [komenda] [Opcje] ...

OPIS

mxt-app to narzędzie do zarządzania kontrolerami dotykowymi Atmel maXTouch i innymi urządzeniami
obsługuje protokół obiektowy Atmel.

Jeśli nie komenda nie jest podany, mxt-app zapewni interaktywny interfejs oparty na menu.

OBIEKT PROTOKÓŁ

Protokół obiektowy Atmel definiuje sposób rejestrowania urządzeń (zwykle dostępny przez I2C)
są przypisane do różnych funkcji w urządzeniach. Ten interfejs organizuje
zarejestruj mapę na osobne obiekty, z których każdy otrzymuje numer T. aplikacja mxt mogę sprawdzić
i zmieniać konfigurację obiektu oraz przeglądać dane diagnostyczne podczas pracy urządzenia.

Aby zapoznać się z opisem protokołu obiektowego, zobacz Atmel AT42QT1085 przedmiot Protokół Guide ,
dostępne na atmel.com.

Znaczenie bajtów konfiguracyjnych w obiektach można znaleźć w Protokole
Dokumentacja przewodnika wydawana z każdym urządzeniem i dostarczana wyłącznie przez firmę Atmel w ramach umowy NDA.

GENERAŁ POLECENIA

-h [--Wsparcie]
Wyświetl krótkie podsumowanie dostępnych opcji i wyjdź.

-i [--informacje]
Wydrukuj informacje identyfikacyjne i tabelę obiektów.

-M [--wiadomości] [*koniec czasu*]
Drukuje wiadomości do Timeout minęły sekundy. Jeśli nie Timeout jest zapewniony,
kontynuuj, dopóki użytkownik nie naciśnie Ctrl-C. Zerowy limit czasu odczytuje raz. Dostarczać
-F [--msg-filter] opcja filtrowania według określonego obiektu.

-F [--filtr-msg] *TYP*
Filtruje wiadomości według obiektu TYP.

--Resetowanie
Zresetować urządzenie.

--kalibrować
Wyślij polecenie kalibracji.

--backup[*=POLECENIE*]
Utwórz kopię zapasową konfiguracji w pamięci NVRAM, gdzie opcjonalny argument COMMAND, to BACKUPNV
dowództwo.

-g Zapisz kalibrację Golden Reference do NVRAM.

--self-cap-tune-config
Dostrój i skalibruj ustawienia pojemności własnej i zapisz je w urządzeniu
konfiguracja.

--self-cap-tune-nvram
Dostrój i skalibruj ustawienia własnej pojemności i zapisz je w pamięci NVRAM bez
aktualizowanie sumy kontrolnej konfiguracji.

--wersja
drukowana wersja mxt-app.

KONFIGURACJA FILE POLECENIA

--Załaduj *PLIK*
Prześlij konfigurację z FILE, zapisz go w pamięci NVRAM i zresetuj urządzenie. Konfiguracja
może być w formacie .xcfg lub OBP_RAW.

--zapisać *PLIK*
Zapisz konfigurację w FILE w formacie OBP_RAW lub .xcfg.

--suma kontrolna *PLIK*
Zapoznaj się z treścią FILE i ponownie oblicz sumę kontrolną konfiguracji.

Zarejestruj się ODCZYT/ZAPIS POLECENIA

-R [--Czytać]
Odczytaj dane z urządzenia.

-W [--pisać]
Zapisz dane na urządzeniu.

-n [--liczyć] *LICZYĆ*
odczyt / zapis COUNT rejestry

-f [--format]
formatowanie wyjścia rejestru

-I [--instancja] *INSTANCJA*
wybierz obiekt INSTANCJA

-r [--rejestr] *REJESTR*
zacznij o Zarejestruj się (przesunięcie w obiekcie, gdy jest używane z TYP)

-T [--typ] *TYP*
wybierz obiekt TYP

--zero wyzeruj wszystkie ustawienia konfiguracyjne

PRZYKŁADY
Czytaj Informacje blok:
$ mxt-app -R -n7 -r0
82 19 11 AA 18 0E 16

Czytaj T7 Prąd Config obiekt:
$ mxt-aplikacja -R -T7
32FF 05 43

Zero drugim drugiej bajtów of T7:
$ mxt-app -W -T7 0000

Czytaj T7 Prąd Config obiekt, sformatowany wydajność:
$ 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 GNIAZDO ELEKTRYCZNE POLECENIA

aplikacja mxt obsługuje połączenie przez TCP przy użyciu protokołu ASCII, który pozwala mxt-app działać jako
mostek dzięki czemu autorskie narzędzia firmy Atmel takie jak przedmiot może uzyskać dostęp do urządzenia.

-C [--klient-mostowy] *GOSPODARZ*
Połącz się przez TCP z HOST

-S [--serwer-mostowy]
Uruchom serwer gniazd TCP

-p [--Port] PORT
Port TCP (domyślnie 4000)

bootloader POLECENIA

--wersja programu ładującego
Zapytanie i wydrukowanie identyfikatora oraz wersji programu ładującego.

--Lampa błyskowa *OPROGRAMOWANIE*
Migać FIRMWARE do urządzenia. Plik oprogramowania sprzętowego powinien być w formacie .enc.

--reset-bootloader
Zresetuj urządzenie w trybie bootloadera. W trybie bootloadera urządzenie przestanie działać normalnie
działać do czasu przesłania oprogramowania sprzętowego. Adres I2C lub PID USB ulegnie zmianie. The
jedyną poprawną komendą w tym trybie jest --flash. Twardy cykl zasilania przywróci
urządzenie do normalnego trybu protokołu obiektowego, chyba że obraz oprogramowania sprzętowego jest uszkodzony.
To polecenie służy tylko do celów debugowania: w większości przypadków --flash
zarządzaj zmianą do/z trybu bootloadera przed/po flashowaniu.

--Wersja oprogramowania *WERSJA*
Format pliku .enc nie udostępnia wersji oprogramowania sprzętowego w dostępnej formie
aplikacja mxt. Jeśli jest to możliwe za pośrednictwem tego przełącznika, mxt-app może sprawdzić oprogramowanie sprzętowe WERSJA
przed i po flashowaniu. Pominie proces flashowania, jeśli wersja oprogramowania sprzętowego jest taka
już poprawne. Po zakończeniu sprawdza również, czy flashowanie zakończyło się pomyślnie. The
wersję należy dostarczyć w formacie 1.0.AA. # OPCJE AUTOTESTU T25

Obiekt Self Test T25 przeprowadza w urządzeniu procedury autotestu w celu znalezienia usterek
przewody i elektrody. Obiekt Self Test T25 przeprowadza serię sekwencji testowych.

-t [--test]
Uruchom wszystkie autotesty.

-t*XX* [--test=*XX*]
Uruchom indywidualny autotest określony przez CMD wartość szesnastkowa.

-t01 uruchom test mocy analogowej.

-t11 uruchom test usterek pinów.

-t12 uruchom test błędu pinu 2.

-t13 uruchom test bramki AND.

-t17 uruchom test limitu sygnału.

-t20 przeprowadzić test wzmocnienia.

-t21 uruchom test błędu offsetu.

T37 DIAGNOSTYCZNY DATA OPCJE

Przechwytuj ramki danych diagnostycznych. Domyślnym trybem jest przechwytywanie delt dotykowych. Samego siebie
pomiary pojemności są dostępne tylko na niektórych urządzeniach.

--debug-dump *PLIK*
Obiekt danych diagnostycznych T37 zapewnia surowy dostęp do odniesienia/delty dotykowej
pomiary z ekranu dotykowego. Dane diagnostyczne są zapisywane FILE w CSV
format. Format jest zgodny z narzędziem Atmel Hawkeye.

--ramki *N*
Zdobyć N ramki danych.

--Bibliografia
Przechwytuj dane referencyjne.

--sygnały samoograniczające
Przechwytuj sygnały self-cap.

--self-cap-delty
Uchwyć delty self-cap.

--refs-samoprzylepne
Przechwytuj referencje dotyczące self-cap.

T68 SERYJNY DATA POLECENIA

--t68-plik *PLIK*
Prześlij FILE do urządzenia poprzez obiekt Serial Data T68.

--t68-typ danych *TYP DANYCH*
Zestaw TYP DANYCH pliku. Zostanie to automatycznie wykryte na podstawie samego pliku
w większości przypadków.

ODKRYCIE ROLNICZE OKREŚLANIE DEVICE

Domyślnie mxt-app skanuje dostępne urządzenia i łączy się z pierwszym znalezionym urządzeniem.

-q [--zapytanie]
Wyszukaj urządzenia i wygeneruj listę.

-d [--urządzenie] *URZĄDZENIE*
Połącz się z konkretnym urządzeniem określonym przez STRONA URZĄDZEŃ co jest podane w tym samym
format jako wynik --query.

W celu uzyskania dostępu do sprzętu obsługiwane są trzy metody połączenia:

sysfs
Jest to używane w połączeniu ze sterownikiem jądra Linuksa. Uzyskuje dostęp do atrybutów sysfs
w katalogu

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

Gdzie

d nazwa sterownika - atmel_mxt_ts, Atmel MXTXXXX itp

b adapter i2c

xx adres i2c

Konkretne urządzenie USB można określić, podając opcję urządzenia -d sysfs:PATH podaną przez
-q/--opcja zapytania

Atrybuty sysfs używane w tym katalogu to

dostęp do pamięci
Dostęp do surowej przestrzeni adresowej I2C.

debug_enable
Wysyłaj komunikaty z urządzenia do dziennika dmesg w formacie szesnastkowym.

debug_v2_enable, debug_msg, debug_notify
Opcjonalny ulepszony interfejs binarny do pobierania wiadomości

Są one dostępne podczas korzystania ze sterownika jądra Atmel z githuba i mogą być obsługiwane przez
inne urządzenia.

USB
Wiele urządzeń maXTouch obsługuje tryb USB, który zgłasza dotknięcia poprzez USB HID. Ponadto,
płytki ewaluacyjne mogą wykorzystywać „układ mostkowy”, który łączy I2C z tym samym protokołem.

Tryb USB zostanie zbudowany przez autotools, gdy będzie dostępny libusb.

Konkretne urządzenie USB można określić, podając opcję urządzenia -d usb:001-003, która
odpowiada numerom magistrali i urządzeń podanym przez opcję -q/--query i lsusb.

I2C debug Interfejs
Dostęp do urządzeń można uzyskać bezpośrednio poprzez i2c-dev Interfejs debugowania I2C, dając adapter i
adres w wierszu poleceń.

Interfejs i2c-dev jest udokumentowany w źródłach jądra Linuksa, w
Dokumentacja/i2c/interfejs-dev

Obsługa interfejsu debugowania I2C musi być włączona przy użyciu jądra CONFIG_I2C_CHARDEV
opcja konfiguracji. Jest ona włączona w systemie, jeśli obecne są pliki /dev/i2c-*.

Aby użyć i2c-dev, podaj ciąg urządzenia, taki jak -d i2c-dev:1-004a.

Wiadomości z urządzeń maXTouch odczytywane są poprzez odpytywanie. Jeśli sterownik jądra również jest
obecny w systemie, czytający komunikaty po przerwaniu, wówczas żadne komunikaty nie będą odbierane
narzędzie. Rozwiązaniem jest ustawienie T18.COMMAND (bajt 1) na 2 „Wymuś wysoki stan linii CHG
(nieaktywny)”, aby sterownik jądra nie otrzymał przerwania.

Nie ma obsługi skanowania. Dzieje się tak dlatego, że czytanie z każdego możliwego maXTouch
adres na każdej magistrali I2C może niekorzystnie wpłynąć na jakiś niepowiązany sprzęt, który tego nie robi
zrozumieć protokół obiektowy. Należy ręcznie zidentyfikować właściwy adapter i adres za pomocą
odwołanie do przewodnika po protokole lub konfiguracji platformy.

Możliwe jest użycie polecenia --flash na urządzeniu już w trybie bootloadera, przez
określenie adresu bootloadera.

HIDRAW
Backend hidraw obsługuje urządzenia maXTouch, które łączą się za pomocą USB lub HID przez I2C.

Interfejs hidraw jest udokumentowany w źródle jądra Linuksa, w
Dokumentacja/hid/hidraw.txt

Urządzenie musi mieć włączoną obsługę urządzeń HID w formacie /dev/hidraw przy użyciu pliku CONFIG_HIDRAW
opcja konfiguracji jądra.

Aby użyć hidraw, podaj ciąg urządzenia, taki jak -d hidraw:/dev/hidraw0.

Nie ma obsługi skanowania.

W tym trybie ładowanie nie jest obsługiwane.

DEBUG OPCJE

-v [--gadatliwy] *POZIOM*
ustaw poziom debugowania. POZIOM jest jednym z 0 (Cichy), 1 (Ostrzeżenia i błędy), 2 (Informacje -
domyślnie), 3 (debugowanie), 4 (pełne). Debugowanie i pełne informacje są dostępne tylko wtedy, gdy są zbudowane
widok

EXIT WARTOŚCI

0 sukces

1 Błąd wewnętrzny/twierdzenie

2 Błąd wejścia/wyjścia

3 Błąd alokacji pamięci

4 Timeout

5 Nie można znaleźć urządzenia lub urządzenie zniknęło

6 Odmowa uprawnień

7 Obsługa nie jest dozwolona dla tego typu urządzenia

8 Przerwij wywołanie funkcji

9 Obiekt niedostępny na urządzeniu

10 Otrzymano nieoczekiwany nieprawidłowy komunikat z procesora komunikatów

11 Autotest nieprawidłowe polecenie testowe

12 Autotest AVdd Brak zasilania analogowego

13 Autotest Błąd pinu

14 Autotest ORAZ błąd bramki

15 Autotest Błąd ograniczenia sygnału

16 Autotest Błąd wzmocnienia

17 Błąd sumy kontrolnej bloku informacyjnego

18 Bootloader już odblokowany

19 Błąd CRC programu ładującego (awaria transmisji)

20 Błąd formatu pliku

21 Oprogramowanie sprzętowe urządzenia jest już wymaganą wersją

22 Nie można zidentyfikować adresu programu ładującego

23 Wersja na urządzeniu nie zgadza się z wersją podaną po operacji ładowania

24 Urządzenie nie zostało zresetowane

25 Urządzenie w nieoczekiwanym stanie

26 Podano nieprawidłowe parametry wiersza poleceń lub dane wprowadzone w menu

27 Błąd analizy protokołu Bridge TCP

28 Błąd połączenia mostkowego

29 Pobieranie danych szeregowych nie powiodło się

30 Brak takiego pliku lub katalogu

31 Błąd podczas przetwarzania polecenia self-cap

KOMPILOWANIE OD ŹRÓDŁO

Aby pobrać kod źródłowy za pomocą gita:

klon git https://github.com/atmel-maxtouch/mxt-app.git

Istnieją dwie wiązki kompilacji dla systemu Android i narzędzi automatycznych:

Android
Aby pobrać podmoduł libusbdroid:

init podmodułu git
aktualizacja podmodułu git

Aby skompilować przy użyciu Androida NDK:

ndk-build

Aby włączyć debugowanie:

ndk-build NDK_DEBUG=1

Aby włączyć obsługę PIE (dla Androida L):

ndk-build APP_PLATFORM=android-16

Pliki binarne zostaną umieszczone w libs/

Zestaw Android NDK jest dostępny pod adresem https://developer.android.com/tools/sdk/ndk/

Bieganie on Android
adb push libs/armeabi/mxt-app /data/local/tmp/
powłoka adb /data/local/tmp/mxt-app [polecenie]

Jeśli nie ustawiono uprawnień do wykonywania, uruchom:

powłoka adb chmod 777 /data/local/tmp/mxt-app

autonarzędzia
Aby skompilować za pomocą narzędzi automatycznych:

./autogen.sh && make

Aby dokonać kompilacji krzyżowej:

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

Aby włączyć debugowanie:

./autogen.sh --enable-debug

Aby włączyć generowanie strony podręcznika za pomocą pandoc:

./autogen.sh --enable-man

Aby zbudować dokumentację doxygen (wymaga to zainstalowania doxygen i graphviz):

zrób dokument

WERSJA NUMERACJA

Numer wersji jest generowany przez git require podczas procesu kompilacji i raportowany przez
--version i do debugowania dzienników.

Typową wersją może być 1.15-29-g8321, co oznacza 29 zatwierdzeń po tagu wydania
1.15, z identyfikatorem git SHA zaczynającym się od 8321.

Jeśli źródło nie zostało sprawdzone przy użyciu gita (na przykład poprzez kliknięcie pliku github
„Pobierz ZIP”), to wersja z pliku VERSION w archiwum źródłowym to
używany.

Jeśli w kodzie źródłowym występują niezatwierdzone zmiany, dodawany jest przyrostek -mod.

ROZWIĄZYWANIE PROBLEMÓW

klogctl błąd
Jeśli zobaczysz ostrzeżenie

W: błąd klogctl 1 (operacja niedozwolona)

oznacza to, że mxt-app nie był w stanie pobrać wiadomości z dmesg. Różny
funkcje nie będą działać prawidłowo. Można w ten sposób odblokować dmesg

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

APLIKACJA MXT(1)

Korzystaj z mxt-app online, korzystając z usług onworks.net