mxt-app: en línea en la nube

PROGRAMA:

NOMBRE

mxt-app - utilidad de línea de comandos para dispositivos maXTouch

SINOPSIS

aplicación mxt [comando] [opciones] ...

DESCRIPCIÓN

mxt-app es una utilidad para administrar controladores táctiles Atmel maXTouch y otros dispositivos que
admite el protocolo basado en objetos Atmel.

Si no es correcto comando no se proporciona, mxt-app proporcionará una interfaz basada en un menú interactivo.

OBJETO PROTOCOLO

El protocolo basado en objetos de Atmel define cómo se registra el dispositivo (normalmente se accede a través de I2C)
se asignan a diferentes funciones dentro de los dispositivos. Esta interfaz organiza la
registrar el mapa en objetos separados, a cada uno de los cuales se le asigna un número T. mxt-aplicación puede inspeccionar
y alterar la configuración del objeto y ver los datos de diagnóstico, mientras el dispositivo está funcionando.

Para obtener una descripción del protocolo de objeto, consulte Atmel AT42QT1085 Objeto Protocolo Guía,
disponible en atmel.com.

El significado de los bytes de configuración dentro de los objetos se puede encontrar en el Protocolo
La documentación de la guía se publica con cada dispositivo y solo la proporciona Atmel bajo NDA.

GENERAL COMANDOS

-h [--ayuda]
Muestre un breve resumen de las opciones disponibles y salga.

-i [--información]
Imprima la información de identificación y la tabla de objetos.

-M [--mensajes] [*se acabó el tiempo*]
Imprime los mensajes hasta tiempo de espera Han pasado los segundos. Si no tiempo de espera está provisto,
continúe hasta que el usuario presione Ctrl-C. El tiempo de espera cero se lee una vez. Proveer
-F [--msg-filter] opción para filtrar por un objeto específico.

-F [--msg-filtro] *ESCRIBE*
Filtra mensajes por objeto TIPO.

--Reiniciar
Reiniciar el dispositivo.

--calibrar
Enviar comando calibrar.

- copia de seguridad [* = COMANDO *]
Configuración de copia de seguridad en NVRAM donde el argumento opcional, COMANDO, es el BACKUPNV
mando.

-g Escriba la calibración de Golden Reference en la NVRAM.

--auto-cap-tune-config
Sintonice y calibre los ajustes de auto capacitancia y guárdelos en el dispositivo
configuración.

--auto-cap-tune-nvram
Sintonice y calibre los ajustes de auto capacitancia y guárdelos en NVRAM sin
actualizar la suma de comprobación de configuración.

--versión
versión impresa de mxt-app.

CONFIGURACIÓN ARCHIVO COMANDOS

--carga *EXPEDIENTE*
Subir configuración desde ARCHIVO, escríbalo en la NVRAM y reinicie el dispositivo. La configuración
puede estar en formato .xcfg u OBP_RAW.

--salvar *EXPEDIENTE*
Guardar configuración en ARCHIVO en formato OBP_RAW o .xcfg.

- suma de comprobación *EXPEDIENTE*
Leer el contenido de ARCHIVO y recalcular la suma de comprobación de la configuración.

REGISTRO LEER ESCRIBIR COMANDOS

-R [--leer]
Leer datos del dispositivo.

-W [--escribir]
Escribe datos en el dispositivo.

-n [--contar] *CONTAR*
lectura / escritura COUNT registros

-f [--formato]
formato de salida de registro

-I [--ejemplo] *EJEMPLO*
seleccionar objeto EJEMPLO

-r [--Registrarse] *REGISTRARSE*
Empieza en REGISTRO (desplazamiento en objeto cuando se usa con TIPO)

-T [--escribe] *ESCRIBE*
seleccionar objeto TIPO

--cero poner a cero todos los ajustes de configuración

EJEMPLOS
Leer info bloque:
$ mxt-aplicación -R -n7 -r0
82 19 11 AA 18 0E 16

Leer T7 Potencia Config :
$ mxt-aplicación -R -T7
32FF 05 43

Cero first two bytes of T7:
$mxt-app -W -T7 0000

Leer T7 Potencia Config objeto, formateado salida:
$ mxt-app -R -T7 --formato
GEN_POWERCONFIG_T7

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

TCP TOMA COMANDOS

mxt-aplicación admite la conexión a través de TCP mediante un protocolo ASCII que permite que mxt-app actúe como
un puente para que las herramientas patentadas de Atmel como Objeto Server puede acceder al dispositivo.

-C [--puente-cliente] *ANFITRIÓN*
Conéctese a través de TCP a HOST

-S [--servidor puente]
Inicie el servidor de socket TCP

-p [--Puerto] PORT
Puerto TCP (por defecto 4000)

CARGADOR DE ARRANQUE COMANDOS

--bootloader-versión
Consultar e imprimir ID y versión del gestor de arranque.

--destello * FIRMWARE *
Flash FIRMWARE al dispositivo. El archivo de firmware debe estar en formato .enc.

--reset-cargador de arranque
Restablezca el dispositivo en modo de cargador de arranque. En el modo de cargador de arranque, el dispositivo dejará de ser normal.
funcionamiento hasta que se envíe un firmware. La dirección I2C o el PID USB cambiarán. los
El único comando válido en este modo es --flash. Un ciclo de energía fuerte devolverá el
dispositivo al modo de protocolo de objetos normal, a menos que la imagen del firmware esté dañada.
Este comando solo se proporciona con fines de depuración: en la mayoría de los casos, el flash
administrar el cambio a / desde el modo de cargador de arranque antes / después del flash.

--versión de firmware *VERSIÓN*
El formato de archivo .enc no proporciona la versión de firmware en un formulario disponible para
mxt-app. Si se proporciona a través de este interruptor, mxt-app puede verificar el firmware VERSION
antes y después del flash. Omitirá el proceso de flash si la versión del firmware es
ya correcto. También verificará que el flash se haya completado correctamente. los
La versión debe proporcionarse en el formato 1.0.AA. # T25 OPCIONES DE PRUEBA AUTOMÁTICA

El objeto Self Test T25 ejecuta rutinas de autoprueba en el dispositivo para encontrar fallas en el sentido
líneas y electrodos. El objeto Self Test T25 ejecuta una serie de secuencias de prueba.

-t [--prueba]
Ejecute todas las autopruebas.

-t * XX * [--prueba = * XX *]
Ejecute la autoprueba individual especificada por el CMD valor hexadecimal.

-t01 Ejecute la prueba de potencia analógica.

-t11 ejecutar la prueba de falla de la clavija.

-t12 Ejecute la prueba de falla 2 de la clavija.

-t13 ejecutar la prueba de la puerta AND.

-t17 ejecutar la prueba de límite de señal.

-t20 ejecutar la prueba de ganancia.

-t21 ejecutar la prueba de falla de compensación.

T37 DIAGNÓSTICO DATOS OPCIONES

Capture fotogramas de datos de diagnóstico. El modo predeterminado es capturar deltas táctiles. Uno mismo
Las mediciones de capacitancia solo están disponibles en algunos dispositivos.

--depuración-volcado *EXPEDIENTE*
El objeto de datos de diagnóstico T37 proporciona acceso sin procesar a la referencia táctil / delta
mediciones desde la pantalla táctil. Los datos de diagnóstico se escriben en ARCHIVO en CSV
formato. El formato es compatible con la utilidad Atmel Hawkeye.

- marcos *NORTE*
Capturar N marcos de datos.

--referencias
Capture datos de referencias.

- señales de auto-tapa
Capture señales de autocapitalización.

--auto-cap-deltas
Captura deltas de autocapas.

--auto-cap-refs
Capture referencias de autocapsulación.

T68 DE SERIE DATOS COMANDOS

- archivo t68 *EXPEDIENTE*
Subir ARCHIVO al dispositivo a través del objeto de datos en serie T68.

--t68-tipo de datos *TIPO DE DATOS*
Set TIPO DE DATOS del archivo. Esto se detectará automáticamente desde el propio archivo.
en la mayoría de los casos.

HALLAZGO Y ESPECIFICANDO DISPOSITIVO

De forma predeterminada, mxt-app escaneará los dispositivos disponibles y se conectará al primer dispositivo que encuentre.

-q [--consulta]
Busque dispositivos y genere una lista.

-d [--dispositivo] * DEVICESTRING *
Conéctese a un dispositivo en particular especificado por CADENA DE DISPOSITIVO que se da en el mismo
formato como salida por --query.

Hay tres métodos de conexión admitidos para el acceso al hardware:

sysfs
Se utiliza junto con el controlador del kernel de Linux. Accede a los atributos del sysfs.
bajo el directorio

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

Dónde

d nombre del controlador: atmel_mxt_ts, Atmel MXTXXXX, etc.

b adaptador i2c

xx dirección i2c

Se puede especificar un dispositivo USB específico dando una opción de dispositivo -d sysfs: PATH como lo indica
-q / - opción de consulta

Los atributos sysfs usados ​​en este directorio son

mem_acceso
Acceso al espacio de direcciones I2C sin procesar.

habilitar_depuración
Salida de mensajes desde el dispositivo al registro dmesg como hexadecimal.

debug_v2_habilitar, mensaje_depuración, depurar_notificar
Interfaz binaria mejorada opcional para recuperar mensajes

Se proporcionan cuando se usa el controlador del kernel de Atmel de github, y pueden ser compatibles con
otros dispositivos.

USB
Muchos dispositivos maXTouch admiten un modo USB que informa de los toques a través de USB HID. Además,
Las placas de evaluación pueden utilizar un "chip puente" que interconecta I2C con el mismo protocolo.

El modo USB se creará mediante autotools cuando libusb esté disponible.

Se puede especificar un dispositivo USB específico dando una opción de dispositivo -d usb: 001-003 que
corresponde a los números de bus y dispositivo dados por la opción de consulta -q / - y lsusb.

I2C depurar interfaz.
Se puede acceder a los dispositivos directamente a través del i2c-dev Interfaz de depuración I2C dando adaptador y
dirección en la línea de comando.

La interfaz i2c-dev está documentada en la fuente del kernel de Linux, en
Documentación / i2c / dev-interface

La compatibilidad con la interfaz de depuración I2C debe habilitarse mediante el kernel CONFIG_I2C_CHARDEV
opción de configuración. Está habilitado en un sistema si los archivos / dev / i2c- * están presentes.

Para usar i2c-dev, proporcione una cadena de dispositivo como -d i2c-dev: 1-004a.

Los mensajes de los dispositivos maXTouch se leen mediante sondeo. Si un controlador de kernel también
presente en el sistema, leyendo mensajes en caso de interrupción, entonces no se recibirán mensajes por
la herramienta. Una solución alternativa es establecer T18.COMMAND (byte 1) en 2 "Forzar la línea CHG alta
(inactivo) "para que el controlador del kernel no reciba una interrupción.

No hay soporte de escaneo. Esto se debe a que la lectura de todos los maXTouch posibles
La dirección en cada bus I2C podría afectar negativamente a algún hardware no relacionado que no
entender el protocolo de objetos. Debe identificar manualmente el adaptador y la dirección correctos mediante
referencia a la guía de protocolo o a la configuración de la plataforma.

Es posible usar el comando --flash con un dispositivo que ya está en modo de cargador de arranque,
especificando la dirección del cargador de arranque.

HIDRATAR
El backend hidraw admite dispositivos maXTouch que se conectan mediante USB o HID a través de I2C.

La interfaz hidraw está documentada en la fuente del kernel de Linux, en
Documentación / hid / hidraw.txt

El dispositivo debe tener la compatibilidad con el dispositivo HID sin procesar / dev / hidraw habilitada mediante CONFIG_HIDRAW
opción de configuración del kernel.

Para usar hidraw, proporcione una cadena de dispositivo como -d hidraw: / dev / hidraw0.

No hay soporte de escaneo.

La carga de arranque no se admite en este modo.

DEBUG OPCIONES

-v [--verboso] *NIVEL*
establecer el nivel de depuración. NIVEL es uno de 0 (silencioso), 1 (advertencias y errores), 2 (información -
predeterminado), 3 (Depurar), 4 (Detallado). Debug y Verbose solo están disponibles si se compilan
en.

SALIR VALORES

0 éxito

1 Error interno / afirmación

2 Error de entrada / salida

3 Fallo de asignación de memoria

4 Tiempo de espera

5 No se pudo encontrar un dispositivo o el dispositivo desapareció

6 Permiso denegado

7 Operación no permitida para este tipo de dispositivo

8 Interrumpir llamada a función

9 Objeto no disponible en el dispositivo

10 Se recibió un mensaje inesperado no válido del procesador de mensajes

11 Comando de prueba no válido de autoprueba

12 Autoprueba AVdd No hay alimentación analógica

13 Fallo de pin de autoprueba

14 Autoprueba Y falla de la puerta

15 Fallo de límite de señal de autodiagnóstico

16 Error de ganancia de autoprueba

17 Error de suma de comprobación del bloque de información

18 El cargador de arranque ya está desbloqueado

19 Fallo de CRC del cargador de arranque (fallo de transmisión)

20 Error de formato de archivo

21 El firmware del dispositivo ya requiere la versión

22 No se pudo identificar la dirección del cargador de arranque

23 La versión en el dispositivo no coincide con la versión proporcionada después de la operación de carga de arranque

24 El dispositivo no se reinició

25 Dispositivo en estado inesperado

26 Parámetros de línea de comando incorrectos o entrada de menú proporcionada

27 Error de análisis del protocolo TCP del puente

28 Error de conexión del puente

29 Falló la descarga de datos en serie

30 El fichero o directorio no existe

31 Error al procesar el comando de límite automático

COMPILACIÓN DESDE FUENTE

Para descargar el código fuente usando git:

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

Hay dos arneses de compilación, para Android y autotools:

Android
Para descargar el submódulo libusbdroid:

inicio del submódulo git
actualización del submódulo git

Para compilar usando Android NDK:

ndk-construir

Para habilitar la depuración:

ndk-build NDK_DEBUG = 1

Para habilitar la compatibilidad con PIE (para Android L):

ndk-build APP_PLATFORM = android-16

Los binarios se colocarán en libs /

El NDK de Android está disponible en https://developer.android.com/tools/sdk/ndk/

Correr on Android
adb push libs / armeabi / mxt-app / data / local / tmp /
adb shell / data / local / tmp / mxt-app [comando]

Si no se han establecido los permisos ejecutables, ejecute:

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

autoherramientas
Para compilar usando autotools:

./autogen.sh && hacer

Para realizar una compilación cruzada:

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

Para habilitar la depuración:

./autogen.sh --enable-debug

Para habilitar la generación de la página de manual usando pandoc:

./autogen.sh --enable-man

Para construir la documentación de doxygen (esto requiere que doxygen y graphviz estén instalados):

hacer doc

VERSION NUMERACIÓN

Git describe genera un número de versión durante el proceso de compilación y lo informa
--version y depurar registros.

Una versión típica podría ser 1.15-29-g8321, lo que significa 29 confirmaciones después de la etiqueta de lanzamiento.
1.15, con un ID SHA de git que comienza con 8321.

Si la fuente no está verificada usando git (por ejemplo, haciendo clic en github
Enlace "Descargar ZIP"), la versión del archivo VERSION en el archivo de origen es
usado.

El sufijo -mod se agrega si hay cambios no confirmados en el código fuente.

SOLUCIÓN DE PROBLEMAS

klogctl error
Si ves la advertencia

W: klogctl error 1 (operación no permitida)

esto indica que mxt-app no ​​ha podido recuperar mensajes de dmesg. Varios
las funciones no funcionarán correctamente. Es posible eliminar las restricciones de dmesg haciendo

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

APLICACIÓN MXT(1)

Use mxt-app en línea usando los servicios de onworks.net