mxt-app - 云端在线

程序：

您的姓名

mxt-app - maXTouch 设备的命令行实用程序

概要

MXT 应用程序 [命令[选项] ...

商品描述

mxt-app 是用于管理 Atmel maXTouch 触摸控制器和其他设备的实用程序
支持 Atmel 基于对象的协议。

如果不 命令 未给出，mxt-app 将提供基于交互式菜单的界面。

宾语 外交协定

Atmel 基于对象的协议定义了设备注册的方式（通常通过 I2C 访问）
映射到设备内的不同功能。 该界面组织
注册映射到单独的对象，每个对象都被赋予一个 T 编号。 MXT应用 可以检查
并在设备运行时更改对象配置并查看诊断数据。

有关对象协议的说明，请参阅 爱特梅尔 AT42QT1085 摆件 协议 产品指南,
可从 atmel.com 获得。

对象中配置字节的含义可以在协议中找到
随每个设备发布的指南文档，仅由 Atmel 根据 NDA 提供。

一般 指令

-h [ - 帮助]
显示可用选项的简短摘要并退出。

-i [ - 信息]
打印 ID 信息和对象表。

-M [--消息] [*暂停*]
打印消息直到 超时 秒过去了。 如果不 超时 提供，
继续直到用户按下 Ctrl-C。 零超时读取一次。 提供
-F [--msg-filter] 按特定对象过滤的选项。

-F [--msg-过滤器] *类型*
按对象过滤消息 型.

- 重启
重置设备。

- 校准
发送校准命令。

--备份[*=命令*]
将配置备份到 NVRAM，其中可选参数， 指挥, 是 BACKUPNV
命令。

-g 将黄金参考校准写入 NVRAM。

--self-cap-tune-配置
调整和校准自电容设置并将它们存储到设备中
组态。

--self-cap-tune-nvram
调整和校准自电容设置并将它们存储到 NVRAM 中，无需
更新配置校验和。

- 版
mxt-app 的打印版本。

配置 文件 指令

- 加载 *文件*
从上传配置 文件，将其写入 NVRAM，并重置设备。 配置
可能是 .xcfg 或 OBP_RAW 格式。

- 节省 *文件*
将配置保存到 文件 OBP_RAW 或 .xcfg 格式。

--校验和 *文件*
阅读内容 文件 并重新计算配置校验和。

报名注册 读/写 指令

-R [ - 读]
从设备读取数据。

-W [ - 写]
将数据写入设备。

-n [ - 数数] *数数*
读/写 COUNT个 寄存器

-f [ - 格式]
格式寄存器输出

-I [ - 实例] *实例*
选择对象 实例

-r [ - 登记] *登记*
从...开始 报名注册 （与对象一起使用时的偏移量 型)

-T [ - 类型] *类型*
选择对象 型

- 零 将所有配置设置归零

示例
阅读 info 块：
$ mxt-app -R -n7 -r0
82 19 11 机管局 18 0E 16

阅读 T7 电力 配置 宾语：
$ mxt-app -R -T7
32 法郎 05 43

零 第一 二 字节 of T7：
$ mxt-app -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应用 支持使用 ASCII 协议通过 TCP 连接，该协议允许 mxt-app 作为
一个桥梁，以便 Atmel 专有工具，例如 摆件 服务器 可以访问设备。

-C [--桥接客户端] *主持人*
通过 TCP 连接到 主办方

-S [--桥接服务器]
启动 TCP 套接字服务器

-p [ - 港口] PORT
TCP 端口（默认 4000）

BOOTLOADER 指令

--bootloader-版本
查询和打印引导加载程序的 ID 和版本。

- 闪光 *固件*
Flash 固件 到设备。 固件文件应为 .enc 格式。

--重置引导加载程序
在引导加载程序模式下重置设备。 在引导加载程序模式下，设备将停止正常
操作，直到发送固件。 I2C 地址或 USB PID 会改变。 这
此模式下唯一有效的命令是 --flash。 硬电源循环将返回
设备到正常对象协议模式，除非固件映像已损坏。
此命令仅用于调试目的：在大多数情况下 --flash 将
在闪存之前/之后管理到/从引导加载程序模式的更改。

- 固件版本 *版本*
.enc 文件格式不以可用的形式提供固件版本
mxt 应用程序。 如果通过这个开关提供，mxt-app 可以检查固件 VERSION
闪光前后。 如果固件版本是，它将跳过闪存过程
已经正确。 它还将在完成时检查是否成功闪烁。 这
版本必须以 1.0.AA 格式提供。 # T25 自测选项

Self Test T25 对象在设备中运行自检例程，以查找意义上的故障
线和电极。 自检 T25 对象运行一系列测试序列。

-t [ - 测试]
运行所有自检。

-t*XX* [--测试=*XX*]
运行指定的单独自检 CMD 十六进制值。

-t01 运行模拟电源测试。

-t11 运行引脚故障测试。

-t12 运行引脚故障 2 测试。

-t13 运行与门测试。

-t17 运行信号限制测试。

-t20 运行增益测试。

-t21 运行偏移故障测试。

T37 诊断 数据 配置

捕获诊断数据帧。 默认模式是捕获触摸增量。 自己
电容测量仅适用于某些设备。

--调试转储 *文件*
T37 诊断数据对象提供对触摸参考/增量的原始访问
通过触摸屏进行测量。 诊断数据写入 文件 CSV格式
格式。 该格式与 Atmel Hawkeye 实用程序兼容。

--帧 * N *
捕获 N 数据帧。

- 参考
捕获参考数据。

--self-cap-信号
捕获自帽信号。

--自我上限增量
捕获自我上限增量。

--自我上限参考
捕获自我上限参考。

T68 SERIAL 数据 指令

--t68-文件 *文件*
上传 文件 通过 T68 串行数据对象传输到设备。

--t68-数据类型 *数据类型*
在 数据类型 的文件。 这将从文件本身自动检测到
在多数情况下。

FINDING AND 指定 支持装置

默认情况下，mxt-app 将扫描可用设备并连接到它找到的第一个设备。

-q [ - 询问]
扫描设备并输出列表。

-d [ - 设备] *设备串*
连接到指定的特定设备 设备串 这是在相同的
格式为 --query 的输出。

硬件访问支持三种连接方式：

系统文件
这与 Linux 内核驱动程序结合使用。 它访问 sysfs 属性
在目录下

/sys/总线/i2c/驱动程序/dddddddd/b-00xx/

其中

d 驱动程序名称 - atmel_mxt_ts、Atmel MXTXXXX 等

b i2c 适配器

xx i2c地址

可以通过提供设备选项 -d sysfs:PATH 来指定特定的 USB 设备
-q/--query 选项

此目录下使用的 sysfs 属性是

内存访问
访问原始 I2C 地址空间。

调试启用
将来自设备的消息以十六进制输出到 dmesg 日志。

debug_v2_enable， 调试消息， 调试通知
可选的改进的二进制接口来检索消息

它们是在使用来自 github 的 Atmel 内核驱动程序时提供的，并且可能支持
其他设备。

USB
许多 maXTouch 设备支持 USB 模式，该模式通过 USB HID 报告触摸。 此外，
评估板可以使用“桥接芯片”，它将 I2C 接口到相同的协议。

当 libusb 可用时，USB 模式将由 autotools 构建。

可以通过提供设备选项 -d usb:001-003 来指定特定的 USB 设备
对应于 -q/--query 选项和 lsusb 给出的总线和设备编号。

I2C 调试 接口
设备可以直接通过 i2c-开发 通过提供适配器和 I2C 调试接口
命令行地址。

i2c-dev 接口记录在 Linux 内核源代码中，在
文档/i2c/dev-interface

必须使用 CONFIG_I2C_CHARDEV 内核启用 I2C 调试接口支持
配置选项。 如果文件 /dev/i2c-* 存在，则在系统上启用它。

要使用 i2c-dev，请提供设备字符串，例如 -d i2c-dev:1-004a。

来自 maXTouch 设备的消息通过轮询读取。 如果内核驱动程序也是
出现在系统上，在中断时读取消息，然后不会收到任何消息
工具。 解决方法是将 T18.COMMAND（字节 1）设置为 2“强制 CHG 线为高
(inactive)”，因此内核驱动程序不会收到中断。

不支持扫描。 这是因为从每个可能的 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 仅​​在构建时可用
英寸

退出 价值观

0 成功

1 内部错误/断言

2 输入/输出错误

3 内存分配失败

4 超时

5 找不到设备或设备消失了

6 没有权限

7 此设备类型不允许操作

8 中断函数调用

9 对象在设备上不可用

10 从消息处理器收到意外的无效消息

11 自检无效测试指令

12 自检 AVdd 模拟电源不存在

13 自检引脚故障

14 自检与门故障

15 自检 信号限制故障

16 自检增益误差

17 信息块校验和错误

18 引导加载程序已解锁

19 Bootloader CRC failure（传输失败）

20 文件格式错误

21 设备固件已经需要的版本

22 无法识别引导加载程序地址

23 设备上的版本与引导加载操作后给出的版本不匹配

24 设备未重置

25 设备处于意外状态

26 给出的命令行参数或菜单输入不正确

27 桥接 TCP 协议解析错误

28 桥接错误

29 串口数据下载失败

30 无此文件或目录

31 处理 self cap 命令时出错

编译 从 源

使用 git 下载源代码：

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

有两种构建工具，分别用于 Android 和 autotools：

Android
下载 libusbdroid 子模块：

git子模块初始化
git子模块更新

使用 Android NDK 编译：

ndk 构建

要启用调试：

ndk 构建 NDK_DEBUG=1

启用 PIE 支持（适用于 Android L）：

ndk-build APP_PLATFORM=android-16

二进制文件将被放置在 libs/

Android NDK 可从 https://developer.android.com/tools/sdk/ndk/ 获得

运行 on Android
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 --启用调试

要使用 pandoc 启用手册页的生成：

./autogen.sh --enable-man

要构建 doxygen 文档（这需要安装 doxygen 和 graphviz）：

制作文档

VERSION 编号

版本号在构建过程中由 git describe 生成，并由
--version 并调试日志。

一个典型的版本可能是 1.15-29-g8321 这意味着在发布标签之后有 29 次提交
1.15，以 8321 开头的 git SHA id。

如果未使用 git 签出源代码（例如通过单击 github
“下载 ZIP”链接），那么源存档中文件 VERSION 的版本是
用过的。

如果源代码中有未提交的更改，则会附加后缀 -mod。

故障排除

登录 错误
如果您看到警告

W: klogctl error 1（不允许操作）

这表明 mxt-app 无法从 dmesg 检索消息。 各种各样的
功能将无法正常工作。 可以通过执行取消限制 dmesg

# 回声 0 > /proc/sys/内核/dmesg_restrict

MXT-APP(1)

使用 onworks.net 服务在线使用 mxt-app