mxt-app - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

mxt-app - утиліта командного рядка для пристроїв maXTouch

СИНТАКСИС

mxt-app [команда] [опції]...

ОПИС

mxt-app — це утиліта для керування сенсорними контролерами Atmel maXTouch та іншими пристроями, які
підтримка протоколу на основі об'єктів Atmel.

Якщо ні команда не надано, mxt-app забезпечить інтерактивний інтерфейс на основі меню.

ОБ'ЄКТ ПРОТОКОЛ

Протокол Atmel Object Based Protocol визначає, як пристрій реєструється (як правило, доступ до нього здійснюється через I2C)
зіставлені з різними функціями в пристроях. Цей інтерфейс організовує
реєструвати карту на окремі об'єкти, кожному з яких присвоюється номер T. mxt-додаток може оглянути
змінювати конфігурацію об’єкта та переглядати діагностичні дані, коли пристрій працює.

Опис об’єктного протоколу див Atmel AT42QT1085 Об'єкт протокол керівництво,
доступний на сайті atmel.com.

Значення байтів конфігурації в об'єктах можна знайти в протоколі
Довідкова документація, що випускається разом із кожним пристроєм, надається лише компанією Atmel відповідно до NDA.

Загальні відомості КОМАНДИ

-h [--довідка]
Відобразити короткий список доступних опцій та вийти.

-i [--інформація]
Роздрукуйте ідентифікаційну інформацію та таблицю об’єктів.

-M [--повідомлення] [*час вийшов*]
Друкує повідомлення доки Тайм-аут пройшли секунди. Якщо ні Тайм-аут надається,
продовжуйте, доки користувач не натисне Ctrl-C. Нульовий тайм-аут читається один раз. Забезпечити
-F [--msg-filter] параметр для фільтрації за певним об'єктом.

-F [--msg-filter] *ТИП*
Фільтрує повідомлення за об’єктами TYPE.

--скидання
Скидання пристрою.

--калібрувати
Надіслати команду калібрування.

--backup[*=КОМАНДА*]
Резервне копіювання конфігурації в NVRAM, де необов'язковий аргумент, КОМАНДА, є BACKUPNV
команда

-g Запишіть калібрування Golden Reference в NVRAM.

--self-cap-tune-config
Налаштуйте та відкалібруйте налаштування власної ємності та збережіть їх у пристрої
configuration.

--self-cap-tune-nvram
Налаштуйте та відкалібруйте налаштування власної ємності та збережіть їх у NVRAM без
оновлення контрольної суми конфігурації.

-- версія
друкована версія mxt-app.

КОНФІГУРАЦІЯ Фото КОМАНДИ

-- навантаження *ФАЙЛ*
Завантажте конфігурацію з Фото, запишіть його в NVRAM і скиньте пристрій. Конфігурація
може бути у форматі .xcfg або OBP_RAW.

--зберегти *ФАЙЛ*
Збережіть конфігурацію до Фото у форматі OBP_RAW або .xcfg.

-- контрольна сума *ФАЙЛ*
Прочитайте зміст Фото і перерахувати контрольну суму конфігурації.

REGISTER ЧИТАТИ ПИСАТИ КОМАНДИ

-R [--читати]
Читання даних з пристрою.

-W [--писати]
Запишіть дані на пристрій.

-n [--рахувати] *РАХУВАТИ*
читання / запис COUNT регістри

-f [--формат]
форматувати вихідний регістр

-I [--екземпляр] * ПРИКЛАД*
виберіть об'єкт ІНСТАНЦІЯ

-r [--реєстрація] *ЗАРЕЄСТРУВАТИСЯ*
початок о REGISTER (зміщення в об'єкті при використанні з TYPE)

-T [--тип] *ТИП*
виберіть об'єкт TYPE

--нуль обнулити всі налаштування конфігурації

ПРИКЛАДИ
Читати info блок:
$ mxt-app -R -n7 -r0
82 19 11 AA 18 0E 16

Читати T7 Power конфиг об’єкт:
$ mxt-app -R -T7
32 FF 05 43

Нульовий перший два bytes of T7:
$ mxt-app -W -T7 0000

Читати T7 Power конфиг об'єкт, відформатовано вихід:
$ 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 SOCKET КОМАНДИ

mxt-додаток підтримує підключення через TCP за допомогою протоколу ASCII, що дозволяє mxt-app діяти як
міст, щоб Atmel власні інструменти, такі як Об'єкт сервер може отримати доступ до пристрою.

-C [--bridge-client] *ГОСПОДАР*
Підключитися через TCP до HOST

-S [--мост-сервер]
Запустіть сервер сокетів TCP

-p [--порт] PORT
TCP-порт (за замовчуванням 4000)

ЗАВАНТАЖНИК КОМАНДИ

--версія завантажувача
Запит і роздрукування ідентифікатора та версії завантажувача.

--спалах *Прошивка*
спалах ФІРМА до пристрою. Файл мікропрограми має бути у форматі .enc.

--reset-bootloader
Скидання пристрою в режимі завантажувача. У режимі завантажувача пристрій припинить роботу
працювати, поки не буде надіслано прошивку. Зміниться адреса I2C або USB PID. The
єдина дійсна команда в цьому режимі --flash. Жорсткий цикл живлення поверне
пристрій у звичайний режим Object Protocol, якщо образ мікропрограми не пошкоджено.
Ця команда надається лише для налагодження: у більшості випадків --flash буде
керувати переходом у/з режиму завантажувача до/після Flash.

--версія прошивки *ВЕРСІЯ*
Формат файлу .enc не надає версію мікропрограми у доступній формі
mxt-додаток. Якщо це надано через цей перемикач, mxt-app може перевірити прошивку Версія
до і після спалаху. Якщо версія мікропрограми є, процес флеш-пам’яті буде пропущено
вже правильно. Він також перевірить успішне спалах після завершення. The
версія має бути надана у форматі 1.0.AA. № T25 ВАРИАНТИ САМОТЕСТІВКИ

Об’єкт Self Test T25 запускає процедури самотестування в пристрої, щоб знайти несправності в сенсі
лінії та електроди. Об’єкт Self Test T25 запускає серію тестових послідовностей.

-t [--тест]
Виконайте всі самотестування.

-t*XX* [--test=*XX*]
Виконайте індивідуальне самотестування, зазначене в CMD шістнадцяткове значення.

-t01 запустити аналоговий тест потужності.

-t11 запустити перевірку несправності контактів.

-t12 запустити перевірку pin fault 2.

-t13 запустити І перевірку воріт.

-t17 запустити тест обмеження сигналу.

-t20 запустити тест посилення.

-t21 запустити перевірку зміщення несправності.

T37 ДІАГНОСТИКА ДАНІ ВАРІАНТИ

Захоплення кадрів діагностичних даних. Режим за замовчуванням — зйомка дельта дотику. Самостійне
вимірювання ємності доступні лише на деяких пристроях.

--debug-dump *ФАЙЛ*
Об’єкт діагностичних даних T37 надає необроблений доступ до сенсорного посилання/дельта
вимірювання з сенсорного екрану. До нього записуються діагностичні дані Фото у форматі CSV
формат. Формат сумісний із утилітою Atmel Hawkeye.

--рамки *Н*
захоплення N кадри даних.

--посилання
Захоплення довідкових даних.

--сигнали самообмежування
Знімайте сигнали самообмежування.

--self-cap-deltas
Зніміть дельти власного кепки.

--self-cap-refs
Знімайте посилання на власні обмеження.

T68 СЕРІЙНИЙ ДАНІ КОМАНДИ

--t68-файл *ФАЙЛ*
Завантажувати Фото на пристрій через об’єкт послідовних даних T68.

--t68-тип даних *ТИП ДАНИХ*
Установка ТИП ДАНИХ файлу. Це буде автоматично виявлено з самого файлу
в більшості випадків.

ВИЗНАЧЕННЯ І УКАЗАННЯ ПРИСТРІЙ

За замовчуванням mxt-app скануватиме доступні пристрої та підключається до першого знайденого пристрою.

-q [--запит]
Скануйте пристрої та виведіть список.

-d [--пристрій] *DEVICESTRING*
Підключитися до певного пристрою, зазначеного в DEVICESTRING яка наведена в ж
відформатувати як вихід за допомогою --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.

debug_enable
Виводити повідомлення з пристрою в журнал dmesg у шістнадцятковому вигляді.

debug_v2_enable, debug_msg, debug_notify
Додатково покращений двійковий інтерфейс для отримання повідомлень

Вони надаються під час використання драйвера ядра Atmel з github і можуть підтримуватися
інші пристрої.

USB
Багато пристроїв maXTouch підтримують режим USB, який повідомляє про дотики через USB HID. В додаток,
Оціночні плати можуть використовувати "містовий чіп", який підключає I2C до того самого протоколу.

Режим USB буде створено за допомогою autotools, коли буде доступний libusb.

Конкретний USB-пристрій можна вказати, вказавши параметр пристрою -d usb:001-003 котрий
відповідає номерам шини та пристроїв, заданим параметром -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 "Примусове примусове переміщення лінії CHG
(неактивний)", тож драйвер ядра не отримує переривання.

Немає підтримки сканування. Це тому, що читання з усіх можливих maXTouch
адреса на кожній шині I2C може негативно вплинути на деяке непов’язане обладнання, яке не пов’язане
розуміти об'єктний протокол. Ви повинні вручну визначити правильний адаптер і адресу
посилання на посібник із протоколу або налаштування платформи.

Можна використовувати команду --flash з пристроєм, який уже перебуває в режимі завантажувача
вказавши адресу завантажувача.

HIDRAW
Бекенд hidraw підтримує пристрої maXTouch, які підключаються за допомогою USB або HID через I2C.

Інтерфейс hidraw задокументований у вихідному коді ядра Linux, в
Документація/hid/hidraw.txt

На пристрої має бути увімкнено підтримку /dev/hidraw raw HID за допомогою CONFIG_HIDRAW
параметр конфігурації ядра.

Щоб використовувати hidraw, надайте рядок пристрою, наприклад -d hidraw:/dev/hidraw0.

Немає підтримки сканування.

Завантаження в цьому режимі не підтримується.

DEBUG ВАРІАНТИ

-v [--дослівно] *РІВЕНЬ*
встановити рівень налагодження. РІВЕНЬ є одним із 0 (Без звуку), 1 (Попередження та помилки), 2 (Інформація -
за замовчуванням), 3 (налагодження), 4 (докладний). Debug і Verbose доступні лише у разі створення
дюйм

EXIT ЗНАЧЕННЯ

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 Помилка аналізу протоколу Bridge TCP

28 Помилка підключення через міст

29 Не вдалося завантажити послідовні дані

30 Немає такого файлу або каталогу

31 Помилка обробки команди self cap

КОМПІЛЯЦІЯ З ДЖЕРЕЛО

Щоб завантажити вихідний код за допомогою git:

клон git https://github.com/atmel-maxtouch/mxt-app.git

Існує два джгути збірки, для Android і autotools:

Android
Щоб завантажити субмодуль libusbdroid:

git підмодуль init
оновлення підмодулю git

Щоб зібрати за допомогою Android NDK:

ndk-збірка

Щоб увімкнути налагодження:

ndk-build 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 /data/local/tmp/mxt-app [команда]

Якщо дозволи на виконання не встановлено, запустіть:

оболонка adb chmod 777 /data/local/tmp/mxt-app

автоінструменти
Щоб зібрати за допомогою autotools:

./autogen.sh && make

Для крос-компіляції:

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

Щоб увімкнути налагодження:

./autogen.sh --enable-debug

Щоб увімкнути створення сторінки man за допомогою pandoc:

./autogen.sh --enable-man

Щоб створити документацію doxygen (для цього потрібно встановити doxygen і graphviz):

зробити док

Версія НОМЕРАЦІЯ

Номер версії генерується git describe під час процесу збірки та повідомляється
--версії та журналів налагодження.

Типовою версією може бути 1.15-29-g8321, що означає 29 комітів після тегу випуску
1.15, з ідентифікатором git SHA, що починається з 8321.

Якщо джерело не перевірено за допомогою git (наприклад, клацнувши на github
посилання «Завантажити ZIP»), то версія з файлу VERSION у вихідному архіві є
використаний

Суфікс -mod додається, якщо у вихідному коді є незафіксовані зміни.

ВИРІШЕННЯ ПРОБЛЕМ

klogctl помилка
Якщо ви бачите попередження

W: помилка klogctl 1 (операція не дозволена)

це вказує на те, що mxt-app не зміг отримати повідомлення з dmesg. Різні
функції не працюватимуть належним чином. Можливо, можна зняти обмеження dmesg, зробивши

# відлуння 0 > /proc/sys/kernel/dmesg_restrict

MXT-APP(1)

Використовуйте mxt-app онлайн за допомогою служб onworks.net