mxt-app - En ligne dans le Cloud

PROGRAMME:

Nom

mxt-app - utilitaire de ligne de commande pour les appareils maXTouch

SYNOPSIS

mxt-app [commander] [Options] ...

DESCRIPTION

mxt-app est un utilitaire de gestion des contrôleurs tactiles Atmel maXTouch et d'autres appareils qui
prend en charge le protocole basé sur les objets Atmel.

Sinon commander n'est pas fourni, mxt-app fournira une interface interactive basée sur un menu.

OBJET PROTOCOLE

Le protocole basé sur les objets Atmel définit la manière dont l'appareil s'enregistre (normalement accessible via I2C)
sont mappés à différentes fonctions au sein des appareils. Cette interface organise le
la carte des registres en objets séparés auxquels chacun est attribué un numéro T. application mxt peut inspecter
et modifier la configuration de l'objet et afficher les données de diagnostic pendant que l'appareil est en cours d'exécution.

Pour une description du protocole objet, voir Atmel AT42QT1085 Objet Passerelle Guide,
disponible sur atmel.com.

La signification des octets de configuration dans les objets peut être trouvée dans le protocole
La documentation du guide est publiée avec chaque appareil et est uniquement fournie par Atmel sous NDA.

GÉNÉRAL COMMANDES

-h [--aider]
Affichez un bref résumé des options disponibles et quittez.

-i [--Info]
Imprimez les informations d'identification et le tableau des objets.

-M [--messages] [*temps libre*]
Imprime les messages jusqu'à temps mort les secondes se sont écoulées. Sinon temps mort est fourni,
continuer jusqu'à ce que l'utilisateur appuie sur Ctrl-C. Le délai d'attente zéro n'est lu qu'une seule fois. Apporter
-F [--msg-filter] option pour filtrer par un objet spécifique.

-F [--filtre-msg] *TAPER*
Filtre les messages par objet TYPE.

--réinitialiser
Réinitialiser l'appareil.

--étalonner
Envoyer la commande d'étalonnage.

--backup[*=COMMANDE*]
Configuration de sauvegarde sur NVRAM où l'argument facultatif, COMMAND, est le BACKUPNV
commander.

-g Écrire le calibrage Golden Reference dans la NVRAM.

--self-cap-tune-config
Réglez et calibrez les paramètres de capacité propre et stockez-les sur l'appareil
configuration.

--self-cap-tune-nvram
Réglez et calibrez les paramètres d'autocapacité et stockez-les dans la NVRAM sans
mise à jour de la somme de contrôle de configuration.

--version
version imprimée de mxt-app.

CONFIGURATION DOSSIER COMMANDES

--charge *DÉPOSER*
Télécharger la configuration depuis DOSSIER, écrivez-le dans la NVRAM et réinitialisez le périphérique. La config
peut être au format .xcfg ou OBP_RAW.

--enregistrer *DÉPOSER*
Enregistrer la configuration dans DOSSIER au format OBP_RAW ou .xcfg.

--somme de contrôle *DÉPOSER*
Lire le contenu de DOSSIER et recalculer la somme de contrôle de configuration.

S'INSCRIRE LIRE ÉCRIRE COMMANDES

-R [--lire]
Lire les données de l'appareil.

-W [--écrivez]
Écrire des données sur l'appareil.

-n [--compter] *COMPTER*
lecture / écriture COUNT registres

-f [--format]
formater la sortie du registre

-I [--exemple] *EXEMPLE*
sélectionner l'objet INSTANCE

-r [--S'inscrire] *S'INSCRIRE*
commencer à S'INSCRIRE (décalé dans l'objet lorsqu'il est utilisé avec TYPE)

-T [--taper] *TAPER*
sélectionner l'objet TYPE

--zéro mettre à zéro tous les paramètres de configuration

EXEMPLES
Lire info bloquer:
$ application-mxt -R -n7 -r0
82 19 11 AA 18 0E 16

Lire T7 Puissance Config objet:
$ application-mxt -R -T7
32FF 05 43

Zero premier deux octets of T7:
$ mxt-app -W -T7 0000

Lire T7 Puissance Config objet, mis en forme sortie:
$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 PRISE COMMANDES

application mxt prend en charge la connexion sur TCP en utilisant un protocole ASCII qui permet à mxt-app d'agir comme
un pont pour que les outils propriétaires d'Atmel tels que Objet Server peut accéder à l'appareil.

-C [--pont-client] *HÔTE*
Connectez-vous via TCP à HÔTE

-S [--bridge-serveur]
Démarrer le serveur de socket TCP

-p [--Port] PORT
Port TCP (par défaut 4000)

BOOTLOADER COMMANDES

--bootloader-version
Interrogez et imprimez l'ID et la version du chargeur de démarrage.

--éclat *MICROLOGICIEL*
Flash FIRMWARE à l'appareil. Le fichier du firmware doit être au format .enc.

--reset-bootloader
Réinitialiser l'appareil en mode bootloader. En mode bootloader, l'appareil cessera normalement
jusqu'à ce qu'un firmware soit envoyé. L'adresse I2C ou le PID USB changera. Les
la seule commande valide dans ce mode est --flash. Un cycle d'alimentation dur renverra le
périphérique en mode Object Protocol normal, sauf si l'image du micrologiciel est corrompue.
Cette commande n'est fournie qu'à des fins de débogage : dans la plupart des cas, --flash
gérer le changement vers/depuis le mode bootloader avant/après le flash.

--version du firmware *VERSION*
Le format de fichier .enc ne fournit pas la version du micrologiciel sous une forme disponible pour
mxt-app. S'il est fourni via ce commutateur, mxt-app peut vérifier le firmware VERSION
avant et après flash. Il sautera le processus de flash si la version du firmware est
déjà correct. Il vérifiera également la réussite du flash à la fin. Les
La version doit être fournie au format 1.0.AA. # OPTIONS D'AUTO-TEST T25

L'objet Self Test T25 exécute des routines d'autotest dans l'appareil pour trouver des défauts dans le sens
lignes et électrodes. L'objet Self Test T25 exécute une série de séquences de test.

-t [--test]
Exécutez tous les autotests.

-t*XX* [--test=*XX*]
Exécutez l'autotest individuel spécifié par le CMD valeur hexadécimale.

-t01 exécuter un test d'alimentation analogique.

-t11 exécuter un test de défaut de broche.

-t12 exécuter le test de défaut de la broche 2.

-t13 exécuter le test de la porte ET.

-t17 exécuter le test de limite de signal.

-t20 exécuter un test de gain.

-t21 exécuter un test de défaut de décalage.

T37 DIAGNOSTIC DONNEES OPTIONS

Capturez des trames de données de diagnostic. Le mode par défaut consiste à capturer les deltas tactiles. Soi
les mesures de capacité ne sont disponibles que sur certains appareils.

--debug-dump *DÉPOSER*
L'objet de données de diagnostic T37 fournit un accès brut à la référence tactile/delta
mesures à partir de l'écran tactile. Les données de diagnostic sont écrites dans DOSSIER en CSV
format. Le format est compatible avec l'utilitaire Atmel Hawkeye.

--cadres *N*
Capture N trames de données.

--les références
Capturez les données de référence.

--auto-cap-signaux
Capturez les signaux d'auto-cap.

--self-cap-deltas
Capturez les deltas d'auto-plafond.

--self-cap-refs
Capturez les références de l'auto-cap.

T68 SÉRIE DONNEES COMMANDES

--t68-fichier *DÉPOSER*
Téléchargement DOSSIER à l'appareil via l'objet Données série T68.

--t68-type de données *TYPE DE DONNÉES*
Ensemble TYPE DE DONNÉES du fichier. Cela sera automatiquement détecté à partir du fichier lui-même
dans la plupart des cas.

DÉCOUVERTE ET EN PRÉCISANT DISPOSITIF

Par défaut, mxt-app analysera les appareils disponibles et se connectera au premier appareil qu'il trouvera.

-q [--mettre en doute]
Recherchez les appareils et générez une liste.

-d [--dispositif] *PÉRIPHÉRIQUE*
Connectez-vous à un appareil particulier spécifié par CHAÎNE D'APPAREILS qui est donné dans le même
format comme sortie par --query.

Il existe trois méthodes de connexion prises en charge pour l'accès au matériel :

sysfs
Ceci est utilisé en conjonction avec le pilote du noyau Linux. Il accède aux attributs sysfs
sous l'annuaire

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

Où

d nom du pilote - atmel_mxt_ts, Atmel MXTXXXX, etc.

b adaptateur i2c

xx adresse i2c

Un périphérique USB spécifique peut être spécifié en donnant une option de périphérique -d sysfs:PATH comme indiqué par
-q/--option de requête

Les attributs sysfs utilisés sous ce répertoire sont

mem_access
Accès à l'espace d'adressage I2C brut.

debug_enable
Messages de sortie de l'appareil vers le journal dmesg au format hexadécimal.

debug_v2_enable, debug_msg, débogage_notifier
Interface binaire améliorée en option pour récupérer les messages

Ils sont fournis lors de l'utilisation du pilote du noyau Atmel de github, et peuvent être pris en charge par
Autres appareils.

USB
De nombreux appareils maXTouch prennent en charge un mode USB qui signale les contacts via USB HID. En outre,
les cartes d'évaluation peuvent utiliser une "puce de pont" qui interface I2C avec le même protocole.

Le mode USB sera construit par autotools lorsque libusb sera disponible.

Un périphérique USB spécifique peut être spécifié en donnant une option de périphérique -d usb:001-003 qui
correspond aux numéros de bus et de périphériques donnés par l'option -q/--query et lsusb.

I2C déboguer interface
Les appareils sont accessibles directement via le i2c-dev Interface de débogage I2C en donnant un adaptateur et
adresse sur la ligne de commande.

L'interface i2c-dev est documentée dans les sources du noyau Linux, dans
Documentation/i2c/dev-interface

Le support de l'interface de débogage I2C doit être activé à l'aide du noyau CONFIG_I2C_CHARDEV
possibilité de configuration. Il est activé sur un système si les fichiers /dev/i2c-* sont présents.

Pour utiliser i2c-dev, fournissez une chaîne de périphérique telle que -d i2c-dev:1-004a.

Les messages des appareils maXTouch sont lus par interrogation. Si un pilote de noyau est également
présent sur le système, la lecture des messages sur interruption, alors aucun message ne sera reçu par
l'outil. Une solution de contournement consiste à définir T18.COMMAND (octet 1) sur 2 "Forcer la ligne CHG à l'état haut
(inactif)" afin que le pilote du noyau ne reçoive pas d'interruption.

Il n'y a pas de support de numérisation. C'est parce que la lecture de tous les maXTouch possibles
adresse sur chaque bus I2C peut affecter négativement certains matériels non liés qui ne
comprendre le protocole objet. Vous devez identifier manuellement l'adaptateur et l'adresse corrects en
référence au guide du protocole ou à la configuration de la plateforme.

Il est possible d'utiliser la commande --flash avec un périphérique déjà en mode bootloader, en
en spécifiant l'adresse du chargeur de démarrage.

MASQUER
Le backend hidraw prend en charge les appareils maXTouch qui se connectent via USB ou HID sur I2C.

L'interface hidraw est documentée dans les sources du noyau Linux, dans
Documentation/caché/caché.txt

Le périphérique doit avoir la prise en charge du périphérique HID brut /dev/hidraw activée à l'aide de CONFIG_HIDRAW
option de configuration du noyau.

Pour utiliser hidraw, fournissez une chaîne de périphérique telle que -d hidraw:/dev/hidraw0.

Il n'y a pas de support de numérisation.

Le bootloading n'est pas pris en charge dans ce mode.

DEBUG OPTIONS

-v [--verbeux] *NIVEAU*
définir le niveau de débogage. NIVEAU est l'un des 0 (Silencieux), 1 (Avertissements et erreurs), 2 (Info -
par défaut), 3 (Débogage), 4 (Verbose). Debug et Verbose ne sont disponibles que s'ils sont construits
dans.

EXIT VALEURS

0 Succès

1 Erreur/assertion interne

2 Erreur d'entrée/sortie

3 Échec d'allocation de mémoire

4 Temps mort

5 Impossible de trouver un appareil ou l'appareil est parti

6 Permission refusée

7 Opération non autorisée pour ce type d'appareil

8 Appel de fonction d'interruption

9 Objet non disponible sur l'appareil

10 Message non valide inattendu reçu du processeur de messages

11 Commande de test invalide d'auto-test

12 Autotest AVdd L'alimentation analogique n'est pas présente

13 Défaut de broche d'autotest

14 Auto-test ET Défaut de porte

15 Autotest Défaut limite de signal

16 Erreur de gain d'autotest

17 Erreur de somme de contrôle du bloc d'informations

18 Bootloader déjà débloqué

19 Échec du CRC du chargeur de démarrage (échec de la transmission)

20 Erreur de format de fichier

21 Version du firmware de l'appareil déjà requise

22 Impossible d'identifier l'adresse du chargeur de démarrage

23 La version sur l'appareil ne correspond pas à la version donnée après l'opération de démarrage

24 L'appareil n'a pas été réinitialisé

25 Appareil dans un état inattendu

26 Paramètres de ligne de commande ou entrée de menu incorrects

27 Erreur d'analyse du protocole TCP du pont

28 Erreur de connexion au pont

29 Échec du téléchargement des données série

30 Aucun fichier ou répertoire de ce nom

31 Erreur lors du traitement de la commande self cap

COMPILATION De SOURCE

Pour télécharger le code source à l'aide de git :

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

Il existe deux harnais de construction, pour Android et autotools :

Android
Pour télécharger le sous-module libusbdroid :

git sous-module init
mise à jour du sous-module git

Pour compiler à l'aide d'Android NDK :

ndk-build

Pour activer le débogage :

ndk-build NDK_DEBUG=1

Pour activer la prise en charge de PIE (pour Android L) :

ndk-build APP_PLATFORM=android-16

Les binaires seront placés dans libs/

Le NDK Android est disponible sur https://developer.android.com/tools/sdk/ndk/

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

Si les autorisations exécutables n'ont pas été définies, exécutez :

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

outils automatiques
Pour compiler à l'aide d'autotools :

./autogen.sh && make

Pour effectuer une compilation croisée :

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

Pour activer le débogage :

./autogen.sh --enable-debug

Pour activer la génération de la page de manuel à l'aide de pandoc :

./autogen.sh --enable-man

Pour construire la documentation doxygen (cela nécessite l'installation de doxygen et graphviz) :

faire un doc

VERSION NUMÉROTAGE

Un numéro de version est généré par git describe pendant le processus de construction et est signalé par
--version et pour déboguer les journaux.

Une version typique peut être 1.15-29-g8321, ce qui signifie 29 commits après la balise release
1.15, avec un identifiant git SHA commençant par 8321.

Si la source n'est pas extraite à l'aide de git (par exemple en cliquant sur le github
lien "Télécharger ZIP"), la version du fichier VERSION dans l'archive source est
utilisé.

Le suffixe -mod est ajouté s'il y a des modifications non validées dans le code source.

DÉPANNAGE

klogctl erreur
Si vous voyez l'avertissement

W : erreur klogctl 1 (Opération non autorisée)

cela indique que mxt-app n'a pas pu récupérer les messages de dmesg. Divers
fonctionnalités ne fonctionneront pas correctement. Il peut être possible de libérer dmesg en faisant

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

MXT-APP(1)

Utilisez mxt-app en ligne en utilisant les services onworks.net