mxt-app - 클라우드의 온라인

프로그램:

이름

mxt-app - maXTouch 장치용 명령줄 유틸리티

개요

mxt 앱 [명령] [옵션] ...

기술

mxt-app은 Atmel maXTouch 터치 컨트롤러 및 기타 장치를 관리하기 위한 유틸리티입니다.
Atmel 개체 기반 프로토콜을 지원합니다.

없는 경우 명령 지정되지 않은 경우 mxt-app은 대화형 메뉴 기반 인터페이스를 제공합니다.

목적 실험 계획안

Atmel 개체 기반 프로토콜은 장치 등록 방법을 정의합니다(일반적으로 I2C를 통해 액세스).
장치 내의 다른 기능에 매핑됩니다. 이 인터페이스는
맵을 각각 T 번호가 지정된 별도의 객체에 등록합니다. mxt 앱 검사할 수 있다
장치가 실행되는 동안 개체 구성을 변경하고 진단 데이터를 볼 수 있습니다.

개체 프로토콜에 대한 설명은 다음을 참조하십시오. 아트멜 AT42QT1085 목적 프로토콜 안내서,
atmel.com에서 사용할 수 있습니다.

개체 내 구성 바이트의 의미는 프로토콜에서 찾을 수 있습니다.
각 장치와 함께 릴리스된 가이드 문서는 NDA에 따라 Atmel에서만 제공됩니다.

일반 명령

-h [--돕다]
사용 가능한 옵션에 대한 간략한 요약을 표시하고 종료합니다.

-i [--정보]
ID 정보 및 개체 테이블을 인쇄합니다.

-M [--메시지] [*시간 초과*]
까지 메시지를 인쇄합니다. 시간 제한 초가 지났습니다. 그렇지 않은 경우 시간 제한 제공됩니다
사용자가 Ctrl-C를 누를 때까지 계속합니다. 제로 타임아웃은 한 번 읽습니다. 제공하다
-F [--msg-filter] 옵션은 특정 개체로 필터링합니다.

-F [--msg-필터] *유형*
개체별로 메시지 필터링 TYPE.

--초기화
장치를 재설정합니다.

--교정
보정 명령을 보냅니다.

--backup[*=명령*]
선택적 인수인 NVRAM에 구성을 백업합니다. COMMAND은 BACKUPNV입니다.
명령.

-g NVRAM에 골든 레퍼런스 캘리브레이션을 씁니다.

--자체 캡 조정 구성
자체 정전 용량 설정을 조정 및 보정하고 장치에 저장
구성.

--자체 조정-nvram
자체 정전 용량 설정을 조정 및 보정하고 NVRAM에 저장합니다.
구성 체크섬 업데이트.

--번역
mxt-app의 인쇄 버전.

구성 FILE 명령

--짐 *파일*
다음에서 구성 업로드 FILE, NVRAM에 쓰고 장치를 재설정합니다. 구성
.xcfg 또는 OBP_RAW 형식일 수 있습니다.

--저장 *파일*
구성 저장 FILE OBP_RAW 또는 .xcfg 형식입니다.

--체크섬 *파일*
의 내용을 읽으십시오 FILE 구성 체크섬을 다시 계산합니다.

바이낸스(BINANCE) 가입하기 읽기 / 쓰기 명령

-R [--읽다]
장치에서 데이터를 읽습니다.

-W [--쓰다]
장치에 데이터를 씁니다.

-n [--세다] *세다*
읽기 / 쓰기 COUNT 레지스터들

-f [--체재]
형식 레지스터 출력

-I [--사례] *사례*
개체 선택 사례

-r [--등록하다] *등록하다*
~에서 시작하다 바이낸스(BINANCE) 가입하기 (와 함께 사용할 때 객체의 오프셋 TYPE)

-T [--유형] *유형*
개체 선택 TYPE

--영 모든 구성 설정 XNUMX

사용 예
읽기 정보 블록 :
$ mxt-앱 -R -n7 -r0
82 19 11 AA 18 0E 16

읽기 T7 출력 구성 목적:
$ mxt-앱 -R -T7
32FF 05 43

제로 먼저 두 바이트 of T7 :
$ mxt-앱 -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 앱 mxt-app이 다음과 같이 작동하도록 허용하는 ASCII 프로토콜을 사용하여 TCP를 통한 연결을 지원합니다
Atmel 독점 도구가 목적 서버 장치에 액세스할 수 있습니다.

-C [--브리지 클라이언트] *주인*
TCP를 통해 연결 HOST

-S [--브리지 서버]
TCP 소켓 서버 시작

-p [--포트] PORT
TCP 포트(기본값 4000)

부트로더 명령

--부트로더-버전
부트로더의 ID와 버전을 조회하고 인쇄합니다.

--플래시 *펌웨어*
플래시 펌웨어 장치에. 펌웨어 파일은 .enc 형식이어야 합니다.

--리셋 부트로더
부트로더 모드에서 장치를 재설정합니다. 부트로더 모드에서 장치는 정상 작동을 멈춥니다.
펌웨어가 전송될 때까지 작동합니다. I2C 주소 또는 USB PID가 변경됩니다. NS
이 모드에서 유효한 명령은 --flash뿐입니다. 하드 전원 주기는 다음을 반환합니다.
펌웨어 이미지가 손상되지 않는 한 장치를 일반 개체 프로토콜 모드로 전환합니다.
이 명령은 디버깅 목적으로만 제공됩니다. 대부분의 경우 --flash는
플래시 전/후 부트로더 모드로의 변경을 관리합니다.

--펌웨어 버전 *버전*
.enc 파일 형식은 사용 가능한 형식의 펌웨어 버전을 제공하지 않습니다.
mxt-앱. 이 스위치를 통해 제공되면 mxt-app에서 펌웨어를 확인할 수 있습니다. 버전
플래시 전후. 펌웨어 버전이 다음과 같으면 플래시 프로세스를 건너뜁니다.
이미 맞습니다. 또한 완료 시 성공적인 플래시를 확인합니다. NS
버전은 1.0.AA 형식으로 제공되어야 합니다. # T25 자체 테스트 옵션

자체 테스트 T25 개체는 장치에서 자체 테스트 루틴을 실행하여 의미에서 오류를 찾습니다.
라인과 전극. 자체 테스트 T25 개체는 일련의 테스트 시퀀스를 실행합니다.

-t [--시험]
모든 자체 테스트를 실행합니다.

-t*XX* [--테스트=**XX*]
에서 지정한 개별 자체 테스트를 실행합니다. CMD XNUMX진수 값.

-t01 아날로그 전력 테스트를 실행합니다.

-t11 핀 오류 테스트를 실행합니다.

-t12 핀 오류 2 테스트를 실행합니다.

-t13 AND 게이트 테스트를 실행합니다.

-t17 신호 제한 테스트를 실행합니다.

-t20 게인 테스트를 실행합니다.

-t21 오프셋 오류 테스트를 실행합니다.

T37 진단 데이터 옵션

진단 데이터의 프레임을 캡처합니다. 기본 모드는 터치 델타를 캡처하는 것입니다. 본인
커패시턴스 측정은 일부 장치에서만 사용할 수 있습니다.

--디버그 덤프 *파일*
T37 진단 데이터 개체는 터치 참조/델타에 대한 원시 액세스를 제공합니다.
터치 스크린에서 측정. 진단 데이터가 기록됩니다. FILE CSV로
체재. 형식은 Atmel Hawkeye 유틸리티와 호환됩니다.

--프레임 *N*
포착 N 데이터 프레임.

--참조
참조 데이터를 캡처합니다.

--셀프 캡 신호
자체 캡 신호를 캡처합니다.

--셀프 캡 델타
자체 캡 델타를 캡처합니다.

--자체 캡 참조
자체 캡 참조를 캡처합니다.

T68 연속물 데이터 명령

--t68-파일 *파일*
가이드라가 FILE T68 직렬 데이터 개체를 통해 장치에.

--t68-데이터 유형 *데이터 형식*
세트 데이터 형식 파일의. 이것은 파일 자체에서 자동으로 감지됩니다.
대부분의 경우에.

발견 및 지정 장치

기본적으로 mxt-app은 사용 가능한 장치를 검색하고 찾은 첫 번째 장치에 연결합니다.

-q [--질문]
장치를 검색하고 목록을 출력합니다.

-d [--장치] *장치스트링*
에 의해 지정된 특정 장치에 연결 디바이스스트링 동일하게 주어지는
--query에 의해 출력으로 형식화됩니다.

하드웨어 액세스에는 세 가지 연결 방법이 지원됩니다.

sysfs
이것은 Linux 커널 드라이버와 함께 사용됩니다. 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 주소 공간에 대한 액세스.

디버그_활성화
장치에서 dmesg 로그로 메시지를 XNUMX진수로 출력합니다.

debug_v2_enable, 디버그_msg, debug_notify
메시지 검색을 위한 개선된 바이너리 인터페이스(선택 사항)

github에서 Atmel 커널 드라이버를 사용할 때 제공되며 다음에서 지원될 수 있습니다.
다른 장치들.

USB
많은 maXTouch 장치는 USB HID를 통해 터치를 보고하는 USB 모드를 지원합니다. 게다가,
평가 보드는 I2C를 동일한 프로토콜에 인터페이스하는 "브리지 칩"을 사용할 수 있습니다.

USB 모드는 libusb를 사용할 수 있을 때 autotools에 의해 빌드됩니다.

장치 옵션 -d usb:001-003을 제공하여 특정 USB 장치를 지정할 수 있습니다.
-q/--query 옵션 및 lsusb에 의해 제공된 버스 및 장치 번호에 해당합니다.

I2C 디버그 인터페이스
장치는 다음을 통해 직접 액세스할 수 있습니다. i2c-dev 어댑터를 제공하여 I2C 디버그 인터페이스 및
명령줄의 주소.

i2c-dev 인터페이스는 Linux 커널 소스에 문서화되어 있습니다.
문서/i2c/dev-interface

I2C 디버그 인터페이스 지원은 CONFIG_I2C_CHARDEV 커널을 사용하여 활성화해야 합니다.
구성 옵션. /dev/i2c-* 파일이 있는 경우 시스템에서 활성화됩니다.

i2c-dev를 사용하려면 -d i2c-dev:1-004a와 같은 장치 문자열을 제공하십시오.

maXTouch 장치의 메시지는 폴링으로 읽습니다. 커널 드라이버도
시스템에 존재하고 인터럽트 시 메시지를 읽고 있으면 메시지가 수신되지 않습니다.
도구. 해결 방법은 T18.COMMAND(바이트 1)를 2로 설정하는 것입니다.
(비활성)"이므로 커널 드라이버가 인터럽트를 수신하지 않습니다.

스캔 지원이 없습니다. 가능한 모든 maXTouch에서 읽기 때문입니다.
모든 I2C 버스의 주소는 그렇지 않은 관련 없는 일부 하드웨어에 부정적인 영향을 미칠 수 있습니다.
개체 프로토콜을 이해합니다. 다음을 통해 올바른 어댑터와 주소를 수동으로 식별해야 합니다.
프로토콜 가이드 또는 플랫폼 설정을 참조하십시오.

이미 부트로더 모드에 있는 장치에서 --flash 명령을 사용할 수 있습니다.
부트로더 주소를 지정합니다.

히드로
hidraw 백엔드는 I2C를 통해 USB 또는 HID를 사용하여 연결하는 maXTouch 장치를 지원합니다.

hidraw 인터페이스는 Linux 커널 소스에 문서화되어 있습니다.
문서/hid/hidraw.txt

장치에는 CONFIG_HIDRAW를 사용하여 활성화된 /dev/hidraw 원시 HID 장치 지원이 있어야 합니다.
커널 구성 옵션.

hidraw를 사용하려면 -d hidraw:/dev/hidraw0과 같은 장치 문자열을 제공합니다.

스캔 지원이 없습니다.

이 모드에서는 부트로딩이 지원되지 않습니다.

DEBUG 옵션

-v [--말 수가 많은] *수준*
디버그 수준을 설정합니다. LEVEL 0(무음), 1(경고 및 오류), 2(정보 -
기본값), 3(디버그), 4(자세한 정보). Debug 및 Verbose는 빌드된 경우에만 사용할 수 있습니다.
인치

EXIT Values

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 프로토콜 구문 분석 오류

28 브리지 연결 오류

29 직렬 데이터 다운로드 실패

30 그러한 파일 또는 디렉토리 없음

31 자체 캡 명령을 처리하는 동안 오류가 발생했습니다.

컴파일 FROM SOURCE

git을 사용하여 소스 코드를 다운로드하려면:

자식 복제 https://github.com/atmel-maxtouch/mxt-app.git

Android 및 autotools에는 두 가지 빌드 하네스가 있습니다.

Android
libusbdroid 하위 모듈을 다운로드하려면:

자식 하위 모듈 초기화
자식 하위 모듈 업데이트

Android NDK를 사용하여 컴파일하려면:

ndk 빌드

디버그를 활성화하려면:

ndk-빌드 NDK_DEBUG=1

PIE 지원을 활성화하려면(Android L용):

ndk-build APP_PLATFORM=안드로이드-16

바이너리는 libs/

Android NDK는 https://developer.android.com/tools/sdk/ndk/에서 사용할 수 있습니다.

달리는 on Android
adb 푸시 라이브러리/armeabi/mxt-app /data/local/tmp/
adb 셸 /data/local/tmp/mxt-app [명령]

실행 권한이 설정되지 않은 경우 다음을 실행합니다.

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

자동 도구
autotools를 사용하여 컴파일하려면:

./autogen.sh && 확인

크로스 컴파일하려면:

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

디버그를 활성화하려면:

./autogen.sh --enable-debug

pandoc을 사용하여 매뉴얼 페이지 생성을 활성화하려면:

./autogen.sh --enable-man

doxygen 문서를 작성하려면(doxygen 및 graphviz가 설치되어야 함):

문서를 만들다

버전 번호 매기기

버전 번호는 빌드 프로세스 중에 git describe에 의해 생성되고 다음에서 보고됩니다.
--version 및 디버그 로그.

일반적인 버전은 1.15-29-g8321일 수 있습니다. 즉, 릴리스 태그 뒤에 29개의 커밋이 있습니다.
1.15, git SHA ID가 8321로 시작합니다.

git을 사용하여 소스를 체크아웃하지 않은 경우(예: github
"ZIP 다운로드" 링크), 소스 아카이브의 VERSION 파일 버전은 다음과 같습니다.
익숙한.

소스 코드에 커밋되지 않은 변경 사항이 있는 경우 접미사 -mod가 추가됩니다.

문제 해결

klogctl 오류
경고가 보이면

W: klogctl 오류 1(작업이 허용되지 않음)

이것은 mxt-app이 dmesg에서 메시지를 검색할 수 없음을 나타냅니다. 다양한
기능이 제대로 작동하지 않습니다. 다음을 수행하여 dmesg를 제한 해제할 수 있습니다.

# 에코 0 > /proc/sys/kernel/dmesg_restrict

MXT-앱(1)

onworks.net 서비스를 사용하여 mxt-app 온라인 사용