mxt-app - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

mxt-app - tiện ích dòng lệnh cho thiết bị maXTouch

SYNOPSIS

ứng dụng mxt [lệnh] [lựa chọn] ...

MÔ TẢ

mxt-app là một tiện ích để quản lý bộ điều khiển cảm ứng Atmel maXTouch và các thiết bị khác
hỗ trợ Giao thức dựa trên đối tượng Atmel.

Nếu không lệnh không được cung cấp, mxt-app sẽ cung cấp giao diện dựa trên menu tương tác.

VẬT BẢO VỆ

Giao thức dựa trên đối tượng Atmel xác định cách thiết bị đăng ký (thường được truy cập thông qua I2C)
được ánh xạ tới các chức năng khác nhau trong thiết bị. Giao diện này tổ chức
đăng ký bản đồ thành các đối tượng riêng biệt, mỗi đối tượng được cấp một số T. ứng dụng mxt có thể kiểm tra
và thay đổi cấu hình đối tượng và xem dữ liệu chẩn đoán trong khi thiết bị đang chạy.

Để biết mô tả về giao thức đối tượng, hãy xem Atmel AT42QT1085 Đối tượng Nghị định thư Hướng dẫn,
có sẵn từ atmel.com.

Ý nghĩa của các byte cấu hình trong các đối tượng có thể được tìm thấy trong Giao thức
Tài liệu hướng dẫn được phát hành với từng thiết bị và chỉ được Atmel cung cấp theo NDA.

CÁC VẤN ĐỀ CHUNG HÀNG

-h [--Cứu giúp]
Hiển thị một bản tóm tắt ngắn gọn về các tùy chọn có sẵn và thoát.

-i [--thông tin]
In thông tin ID và bảng đối tượng.

-M [- tin nhắn] [*hết giờ*]
In tin nhắn cho đến khi thời gian chờ giây đã trôi qua. Nếu không thời gian chờ được cung cấp,
tiếp tục cho đến khi người dùng nhấn Ctrl-C. Thời gian chờ không đọc một lần. Cung cấp
Tùy chọn -F [--msg-filter] để lọc theo một đối tượng cụ thể.

-F [--msg-filter] *KIỂU*
Lọc tin nhắn theo đối tượng LOẠI.

--cài lại
Đặt lại thiết bị.

- hiệu chỉnh
Gửi lệnh hiệu chỉnh.

- sao lưu [* = COMMAND *]
Sao lưu cấu hình vào NVRAM nơi đối số tùy chọn, COMMAND, là BACKUPNV
chỉ huy.

-g Ghi hiệu chuẩn Tham chiếu Vàng vào NVRAM.

--self-cap-tune-config
Điều chỉnh và hiệu chỉnh các cài đặt tự điện dung và lưu trữ chúng vào thiết bị
cấu hình.

--self-cap-tune-nvram
Điều chỉnh và hiệu chỉnh các cài đặt tự điện dung và lưu trữ chúng vào NVRAM mà không cần
cập nhật Kiểm tra cấu hình.

--phiên bản
phiên bản in của mxt-app.

CẤU HÌNH FILE HÀNG

--trọng tải *TẬP TIN*
Tải lên cấu hình từ FILE, ghi nó vào NVRAM và đặt lại thiết bị. Cấu hình
có thể ở định dạng .xcfg hoặc OBP_RAW.

--cứu *TẬP TIN*
Lưu cấu hình vào FILE ở định dạng OBP_RAW hoặc .xcfg.

--tổng kiểm tra *TẬP TIN*
Đọc nội dung của FILE và tính toán lại tổng kiểm tra cấu hình.

ĐĂNG KÝ ĐỌC VIẾT HÀNG

-R [--đọc]
Đọc dữ liệu từ thiết bị.

-W [--viết]
Ghi dữ liệu vào thiết bị.

-n [--đếm] *ĐẾM*
đọc / ghi ĐẾM đăng ký

-f [--định dạng]
định dạng đầu ra thanh ghi

-I [--ví dụ] *VÍ DỤ*
chọn đối tượng VÍ DỤ

-r [--Đăng ký] *ĐĂNG KÝ*
bắt đầu lúc ĐĂNG KÝ (bù đắp trong đối tượng khi được sử dụng với LOẠI)

-T [--kiểu] *KIỂU*
chọn đối tượng LOẠI

--số không không có tất cả các cài đặt cấu hình

VÍ DỤ
Đọc Thông tin khối:
$ mxt-ứng dụng -R -n7 -r0
82 19 11 AA 18 0E 16

Đọc T7 Power Config vật:
$ mxt-ứng dụng -R -T7
32 FF 05 43

  nhận được gì Thành phố điện khí hóa phía tây dãy núi Rocky đầu tiên hai byte of Q7:
$ mxt-ứng dụng -W -T7 0000

Đọc T7 Power Config vật, được định dạng đầu ra:
$ mxt-app -R -T7 - định dạng
GEN_POWERCONFIG_T7

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

TCP Ổ CẮM HÀNG

ứng dụng mxt hỗ trợ kết nối qua TCP sử dụng giao thức ASCII cho phép ứng dụng mxt hoạt động như
một cầu nối để các công cụ độc quyền của Atmel như Đối tượng của chúng tôi có thể truy cập thiết bị.

-C [--bridge-client] *TỔ CHỨC*
Kết nối qua TCP với HOST

-S [--máy chủ cầu]
Khởi động máy chủ ổ cắm TCP

-p [--Hải cảng] PORT
Cổng TCP (mặc định 4000)

KHỞI ĐỘNG HÀNG

--bootloader-phiên bản
Truy vấn và in ID và phiên bản của bộ nạp khởi động.

--tốc biến * PHẦN MỀM *
Đèn flash PHẦN MỀM tới thiết bị. Tệp phần sụn phải ở định dạng .enc.

- bộ nạp khởi động
Đặt lại thiết bị ở chế độ bộ nạp khởi động. Ở chế độ bộ nạp khởi động, thiết bị sẽ ngừng hoạt động bình thường
hoạt động cho đến khi một phần sụn được gửi đi. Địa chỉ I2C hoặc USB PID sẽ thay đổi. Các
chỉ lệnh hợp lệ trong chế độ này là --flash. Một chu kỳ năng lượng cứng sẽ trả về
thiết bị sang chế độ Giao thức Đối tượng bình thường, trừ khi hình ảnh phần sụn bị hỏng.
Lệnh này chỉ được cung cấp cho mục đích gỡ lỗi: trong hầu hết các trường hợp --flash sẽ
quản lý sự thay đổi đến / từ chế độ bộ nạp khởi động trước / sau khi flash.

--phiên bản phần mềm *PHIÊN BẢN*
Định dạng tệp .enc không cung cấp phiên bản chương trình cơ sở ở dạng có sẵn cho
mxt-app. Nếu nó được cung cấp thông qua công tắc này, mxt-app có thể kiểm tra chương trình cơ sở PHIÊN BẢN
trước và sau khi flash. Nó sẽ bỏ qua quá trình flash nếu phiên bản phần sụn
đã chính xác. Nó cũng sẽ kiểm tra flash thành công khi hoàn thành. Các
phiên bản phải được cung cấp ở định dạng 1.0.AA. # T25 LỰA CHỌN TỰ KIỂM TRA

Đối tượng Tự kiểm tra T25 chạy các quy trình tự kiểm tra trong thiết bị để tìm ra lỗi theo ý nghĩa
dòng và điện cực. Đối tượng Tự kiểm tra T25 chạy một loạt các trình tự kiểm tra.

-t [--kiểm tra]
Chạy tất cả các bài kiểm tra tự.

-t * XX * [--test = * XX *]
Chạy tự kiểm tra cá nhân được chỉ định bởi CMD giá trị hex.

-t01 chạy thử nghiệm nguồn analog.

-t11 chạy kiểm tra lỗi pin.

-t12 chạy thử pin lỗi 2.

-t13 chạy kiểm tra cổng AND.

-t17 chạy kiểm tra giới hạn tín hiệu.

-t20 chạy kiểm tra độ lợi.

-t21 chạy kiểm tra lỗi bù.

T37 CHẨN ĐOÁN DỮ LIỆU LỰA CHỌN

Chụp các khung dữ liệu chẩn đoán. Chế độ mặc định là chụp các delta cảm ứng. Bản thân
các phép đo điện dung chỉ khả dụng trên một số thiết bị.

--debug-dump *TẬP TIN*
Đối tượng Dữ liệu chẩn đoán T37 cung cấp quyền truy cập thô vào tham chiếu / delta cảm ứng
các phép đo từ màn hình cảm ứng. Dữ liệu chẩn đoán được ghi vào FILE trong CSV
định dạng. Định dạng này tương thích với tiện ích Atmel Hawkeye.

--khung *N*
Chụp N các khung dữ liệu.

--người giới thiệu
Chụp dữ liệu tài liệu tham khảo.

- tín hiệu tự giới hạn
Nắm bắt các tín hiệu tự giới hạn.

--self-cap-deltas
Chụp delta tự giới hạn.

--self-cap-refs
Chụp các tài liệu tham khảo về giới hạn bản thân.

T68 NỐI TIẾP DỮ LIỆU HÀNG

--t68-tệp *TẬP TIN*
Tải lên FILE tới thiết bị thông qua đối tượng Dữ liệu nối tiếp T68.

--t68-kiểu dữ liệu *LOẠI DỮ LIỆU*
Thiết lập LOẠI DỮ LIỆU của tệp. Điều này sẽ được tự động phát hiện từ chính tệp
trong hầu hết các trường hợp.

PHÁT HIỆN VÀ ĐẶC ĐIỂM KỸ THUẬT THIẾT BỊ

Theo mặc định, mxt-app sẽ quét các thiết bị có sẵn và kết nối với thiết bị đầu tiên mà nó tìm thấy.

-q [--truy vấn]
Quét thiết bị và xuất danh sách.

-d [--thiết bị] * THIẾT BỊ *
Kết nối với một thiết bị cụ thể được chỉ định bởi THIẾT BỊ được đưa ra trong cùng một
định dạng dưới dạng đầu ra bởi --query.

Có ba phương thức kết nối được hỗ trợ để truy cập phần cứng:

sysfs
Điều này được sử dụng cùng với trình điều khiển nhân Linux. Nó truy cập các thuộc tính sysfs
dưới thư mục

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

Ở đâu

d tên trình điều khiển - atmel_mxt_ts, Atmel MXTXXXX, v.v.

b bộ chuyển đổi i2c

xx địa chỉ i2c

Một thiết bị USB cụ thể có thể được chỉ định bằng cách cung cấp tùy chọn thiết bị -d sysfs: PATH như được cung cấp bởi
-q / - tùy chọn truy vấn

Các thuộc tính sysfs được sử dụng trong thư mục này là

mem_access
Truy cập vào không gian địa chỉ I2C thô.

debug_enable
Xuất tin nhắn từ thiết bị ra nhật ký dmesg dưới dạng hệ thập lục phân.

gỡ lỗi_v2_enable, debug_msg, debug_notify
Giao diện nhị phân cải tiến tùy chọn để truy xuất tin nhắn

Chúng được cung cấp khi sử dụng trình điều khiển nhân Atmel từ github và có thể được hỗ trợ bởi
các thiết bị khác.

USB
Nhiều thiết bị maXTouch hỗ trợ chế độ USB báo cáo các lần chạm qua USB HID. Ngoài ra,
hội đồng đánh giá có thể sử dụng "chip cầu nối" giao tiếp I2C với cùng một giao thức.

Chế độ USB sẽ được tự động xây dựng khi có libusb.

Một thiết bị USB cụ thể có thể được chỉ định bằng cách cung cấp tùy chọn thiết bị -d usb: 001-003
tương ứng với xe buýt và số thiết bị được cung cấp bởi tùy chọn truy vấn -q / - và lsusb.

I2C gỡ lỗi giao diện
Các thiết bị có thể được truy cập trực tiếp thông qua i2c-dev Giao diện gỡ lỗi I2C bằng cách đưa bộ điều hợp và
địa chỉ trên dòng lệnh.

Giao diện i2c-dev được ghi lại trong nguồn nhân Linux, trong
Documentation / i2c / dev-interface

Hỗ trợ giao diện gỡ lỗi I2C phải được bật bằng hạt nhân CONFIG_I2C_CHARDEV
tùy chọn cấu hình. Nó được bật trên hệ thống nếu có tệp / dev / i2c- *.

Để sử dụng i2c-dev, hãy cung cấp một chuỗi thiết bị chẳng hạn như -d i2c-dev: 1-004a.

Tin nhắn từ thiết bị maXTouch được đọc bằng cách bỏ phiếu. Nếu một trình điều khiển hạt nhân cũng
hiển thị trên hệ thống, đọc tin nhắn khi bị gián đoạn, sau đó không có tin nhắn nào sẽ được
công cụ. Một cách giải quyết là đặt T18.COMMAND (byte 1) thành 2 "Buộc dòng CHG lên cao
(không hoạt động) "để trình điều khiển hạt nhân không nhận được ngắt.

Không có hỗ trợ quét. Điều này là do đọc từ mọi maXTouch có thể
địa chỉ trên mỗi bus I2C có thể ảnh hưởng xấu đến một số phần cứng không liên quan không
hiểu Giao thức đối tượng. Bạn phải xác định thủ công bộ điều hợp và địa chỉ chính xác bằng cách
tham khảo hướng dẫn giao thức hoặc thiết lập nền tảng.

Có thể sử dụng lệnh --flash với thiết bị đã ở chế độ bootloader, bằng cách
xác định địa chỉ bộ nạp khởi động.

HIDRAW
Phần phụ trợ hidraw hỗ trợ các thiết bị maXTouch kết nối bằng USB hoặc HID qua I2C.

Giao diện hidraw được ghi lại trong nguồn nhân Linux, trong
Documentation / hidden / hidraw.txt

Thiết bị phải được bật / dev / hidraw hỗ trợ thiết bị HID thô bằng CONFIG_HIDRAW
tùy chọn cấu hình hạt nhân.

Để sử dụng hidraw, hãy cung cấp một chuỗi thiết bị như -d hidraw: / dev / hidraw0.

Không có hỗ trợ quét.

Chế độ này không hỗ trợ tải khởi động.

DEBUG LỰA CHỌN

-v [--tiết] *CẤP ĐỘ*
đặt mức gỡ lỗi. LEVEL là một trong 0 (Im lặng), 1 (Cảnh báo và Lỗi), 2 (Thông tin -
mặc định), 3 (Gỡ lỗi), 4 (Chi tiết). Gỡ lỗi và Chi tiết chỉ khả dụng nếu được xây dựng
.

EXIT GIÁ TRỊ

0 Sự thành công

1 Lỗi nội bộ / xác nhận

2 Lỗi đầu vào / đầu ra

3 Cấp phát bộ nhớ thất bại

4 Timeout

5 Không thể tìm thấy thiết bị hoặc thiết bị đã biến mất

6 Quyền bị từ chối

7 Thao tác không được phép đối với loại thiết bị này

8 Ngắt cuộc gọi chức năng

9 Đối tượng không khả dụng trên thiết bị

10 Đã nhận được tin nhắn không hợp lệ không mong muốn từ trình xử lý tin nhắn

11 Tự kiểm tra lệnh kiểm tra không hợp lệ

12 Tự kiểm tra AVdd Nguồn tương tự không có

13 Tự kiểm tra lỗi Pin

14 Tự kiểm tra VÀ Lỗi cổng

15 Tự kiểm tra Lỗi giới hạn tín hiệu

16 Tự kiểm tra Lỗi đạt được

17 Lỗi tổng kiểm tra khối thông tin

18 Bootloader đã được mở khóa

19 Lỗi CRC của bộ nạp khởi động (lỗi truyền)

20 Lỗi định dạng tệp

21 Phiên bản chương trình cơ sở thiết bị đã được yêu cầu

22 Không thể xác định địa chỉ bộ nạp khởi động

23 Phiên bản trên thiết bị không khớp với phiên bản được cung cấp sau hoạt động tải khởi động

24 Thiết bị không được đặt lại

25 Thiết bị ở trạng thái không mong muốn

26 Đã cung cấp thông số dòng lệnh hoặc đầu vào menu không chính xác

27 Cầu phân tích cú pháp giao thức TCP lỗi

28 Cầu kết nối lỗi

29 Tải xuống dữ liệu nối tiếp không thành công

30 Không có tệp hoặc thư mục như vậy

31 Lỗi khi xử lý lệnh tự giới hạn

LẮP RÁP TỪ SOURCE

Để tải xuống mã nguồn bằng git:

bản sao git https://github.com/atmel-maxtouch/mxt-app.git

Có hai bộ khai thác xây dựng, dành cho Android và công cụ tự động:

Android
Để tải xuống libusbdroid submodule:

mô-đun con git init
cập nhật git submodule

Để biên dịch bằng Android NDK:

xây dựng ndk

Để bật gỡ lỗi:

ndk-build NDK_DEBUG = 1

Để bật hỗ trợ PIE (dành cho Android L):

ndk-build APP_PLATFORM = android-16

Binaries sẽ được đặt trong libs /

Android NDK có sẵn từ https://developer.android.com/tools/sdk/ndk/

Chạy on Android
adb push libs / armeabi / mxt-app / data / local / tmp /
adb shell / data / local / tmp / mxt-app [command]

Nếu quyền thực thi chưa được đặt, hãy chạy:

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

ô tô tự động
Để biên dịch bằng công cụ tự động:

./autogen.sh && make

Để biên dịch chéo:

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

Để bật gỡ lỗi:

./autogen.sh --enable-debug

Để cho phép tạo trang người dùng bằng pandoc:

./autogen.sh --enable-man

Để xây dựng tài liệu doxygen (điều này yêu cầu phải cài đặt doxygen và graphviz):

làm tài liệu

PHIÊN BẢN ĐÁNH SỐ

Số phiên bản được tạo bởi git description trong quá trình xây dựng và được báo cáo bởi
--version và để gỡ lỗi nhật ký.

Một phiên bản điển hình có thể là 1.15-29-g8321 có nghĩa là, 29 cam kết sau thẻ phát hành
1.15, với id git SHA bắt đầu bằng 8321.

Nếu nguồn không được kiểm tra bằng git (ví dụ: bằng cách nhấp vào github
"Tải xuống liên kết ZIP"), thì phiên bản từ tệp VERSION trong kho lưu trữ nguồn là
đã sử dụng.

Hậu tố -mod được thêm vào nếu có những thay đổi chưa được cam kết trong mã nguồn.

Giải đáp thắc mắc

klogctl lôi
Nếu bạn thấy cảnh báo

W: lỗi klogctl 1 (Hoạt động không được phép)

điều này cho thấy rằng mxt-app không thể truy xuất tin nhắn từ dmesg. Đa dạng
các tính năng sẽ không hoạt động bình thường. Có thể không hạn chế dmesg bằng cách

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

Ứng dụng MXT(1)

Sử dụng mxt-app trực tuyến bằng các dịch vụ onworks.net