mxt-app - онлайн в облаке

ПРОГРАММА:

ИМЯ

mxt-app - утилита командной строки для устройств maXTouch

СИНТАКСИС

mxt-приложение [команду] [кредита] ...

ОПИСАНИЕ

mxt-app - это утилита для управления сенсорными контроллерами Atmel maXTouch и другими устройствами, которые
поддержка объектного протокола Atmel.

Если нет команду не указан, mxt-app предоставит интерфейс на основе интерактивного меню.

ОБЪЕКТ ПРОТОКОЛ

Протокол на основе объектов Atmel определяет, как устройство регистрируется (обычно доступ через I2C)
соответствуют различным функциям устройств. Этот интерфейс организует
регистрировать карту в отдельные объекты, каждому из которых присваивается номер T. mxt-приложение можно проверить
и изменять конфигурацию объекта и просматривать диагностические данные во время работы устройства.

Описание объектного протокола см. Atmel AT42QT1085 объект протокол Guide,
доступно на сайте atmel.com.

Значение байтов конфигурации в объектах можно найти в Протоколе.
Справочная документация выпускается с каждым устройством и предоставляется только компанией Atmel на условиях NDA.

ОБЩАЯ ИНФОРМАЦИЯ КОМАНДЫ

-h [--помощь]
Отобразите краткую сводку доступных опций и выйдите.

-i [--Информация]
Распечатайте идентификационную информацию и таблицу объектов.

-M [--Сообщения] [* тайм-аут *]
Печатает сообщения до тех пор, пока Тайм-аут прошло секунды. Если нет Тайм-аут предоставлен,
продолжайте, пока пользователь не нажмет Ctrl-C. Нулевой тайм-аут считывается один раз. Предоставлять
-F [--msg-filter] опция для фильтрации по определенному объекту.

-F [--msg-фильтр] *ТИП*
Фильтрует сообщения по объектам ТИП.

--сброс настроек
Сбросить устройство.

- откалибровать
Отправить команду калибровки.

--backup [* = КОМАНДА *]
Резервное копирование конфигурации в NVRAM, где необязательный аргумент, КОМАНДА, является BACKUPNV
команда.

-g Запишите калибровку Golden Reference в NVRAM.

--self-cap-tune-config
Настройте и откалибруйте параметры собственной емкости и сохраните их в устройстве.
конфигурации.

- self-cap-tune-nvram
Настройте и откалибруйте параметры собственной емкости и сохраните их в NVRAM без
обновление контрольной суммы конфигурации.

--версия
версия для печати mxt-app.

КОНФИГУРАЦИЯ ФАЙЛОВ КОМАНДЫ

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

--спасти *ФАЙЛ*
Сохранить конфигурацию в ФАЙЛОВ в формате OBP_RAW или .xcfg.

- контрольная сумма *ФАЙЛ*
Прочтите содержание ФАЙЛОВ и пересчитайте контрольную сумму конфигурации.

РЕГИСТРАЦИЯ ЧИТАЙ ПИШИ КОМАНДЫ

-R [--читать]
Считайте данные с устройства.

-W [--записывать]
Запишите данные на устройство.

-n [--считать] *СЧИТАТЬ*
считывание / запись СЧИТАТЬ регистры

-f [--формат]
формат вывода регистра

-I [--пример] *ПРИМЕР*
выбрать объект ПРИМЕР

-r [--регистр] *РЕГИСТР*
начинать с РЕГИСТРАЦИЯ (смещение в объекте при использовании с ТИП)

-T [--тип] *ТИП*
выбрать объект ТИП

--нуль обнулить все настройки конфигурации

ПРИМЕРЫ
Читать info Блок:
$ mxt-приложение -R -n7 -r0
82 19 11 АА 18 0Е 16

Читать T7 Power Конфиг объект:
$ mxt-приложение -R -T7
32 ФФ 05 43

                          0 первый две байт of T7:
$ mxt-приложение -W -T7 0000

Читать T7 Power Конфиг объект, отформатированные вывод:
$ mxt-приложение -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 SOCKET КОМАНДЫ

mxt-приложение поддерживает соединение через TCP с использованием протокола ASCII, который позволяет mxt-app действовать как
мост, так что проприетарные инструменты Atmel, такие как объект серверу может получить доступ к устройству.

-C [--мост-клиент] *ХОЗЯИН*
Подключиться через TCP к ВЕДУЩИЙ

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

-p [--порт] PORT
Порт TCP (по умолчанию 4000)

загрузчик КОМАНДЫ

--bootloader-версия
Запросить и распечатать ID и версию загрузчика.

--вспышка *ПРОШИВКА*
Flash МИКРОПРОГРАММЫ к устройству. Файл прошивки должен быть в формате .enc.

--reset-загрузчик
Перезагрузите устройство в режиме загрузчика. В режиме загрузчика устройство перестанет нормально работать
операции до тех пор, пока прошивка не будет отправлена. Адрес I2C или USB PID изменится. В
единственной допустимой командой в этом режиме является --flash. Жесткий цикл питания вернет
устройство в нормальный режим объектного протокола, если образ встроенного ПО не поврежден.
Эта команда предназначена только для целей отладки: в большинстве случаев --flash будет
управлять переходом в / из режима загрузчика до / после прошивки.

--версия прошивки *ВЕРСИЯ*
Формат файла .enc не предоставляет версию микропрограммы в доступной для
mxt-app. Если он предоставляется с помощью этого переключателя, mxt-app может проверять прошивку. Версия
до и после вспышки. Процесс прошивки будет пропущен, если версия прошивки
уже поправили. По завершении он также проверит успешную вспышку. В
версия должна быть предоставлена ​​в формате 1.0.AA. # T25 ВАРИАНТЫ САМОПРОВЕРКИ

Объект Self Test T25 запускает процедуры самотестирования в устройстве, чтобы найти неисправности в смысле
линии и электроды. Объект Self Test T25 выполняет серию тестовых последовательностей.

-t [--тестовое задание]
Запустите все самотестирование.

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

-т01 запустите аналоговый тест мощности.

-т11 выполнить проверку неисправности штифта.

-т12 выполнить проверку неисправности вывода 2.

-т13 запустить И тест ворот.

-т17 запустить тест предела сигнала.

-т20 запустить тест усиления.

-т21 выполнить тест неисправности смещения.

T37 ДИАГНОСТИЧЕСКАЯ ДАННЫЕ ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

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

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

--фреймы * N *
захват N кадры данных.

--использованная литература
Захват справочных данных.

- self-cap-сигналы
Захватите сигналы самоограничения.

--само-кап-дельты
Захватить дельты самокапывания.

--self-cap-refs
Захватите ссылки на собственные крышки.

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

--t68-файл *ФАЙЛ*
Загрузите ФАЙЛОВ к устройству через объект последовательных данных T68.

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

ДИАГНОСТИКИ И УКАЗАНИЕ УСТРОЙСТВО

По умолчанию mxt-app просканирует доступные устройства и подключится к первому найденному устройству.

-q [--запрос]
Просканируйте устройства и выведите список.

-d [--устройство] * УСТРОЙСТВА *
Подключиться к определенному устройству, указанному УСТРОЙСТВА который дан в том же
формат как вывод --query.

Для доступа к оборудованию поддерживаются три метода подключения:

sysfs
Он используется вместе с драйвером ядра Linux. Доступ к атрибутам sysfs
в каталоге

/ sys / bus / i2c / драйверы / dddddddd / b-00xx /

где

d имя драйвера - atmel_mxt_ts, Atmel MXTXXXX и т. д.

b i2c адаптер

xx адрес i2c

Конкретное USB-устройство можно указать, указав параметр устройства -d sysfs: PATH, как указано
-q / - опция запроса

Атрибуты sysfs, используемые в этом каталоге:

mem_access
Доступ к необработанному адресному пространству I2C.

отладка_включить
Выводить сообщения с устройства в журнал dmesg в шестнадцатеричном формате.

отладка_v2_enable, отладочная_сообщение, debug_notify
Дополнительный улучшенный двоичный интерфейс для получения сообщений

Они предоставляются при использовании драйвера ядра Atmel из github и могут поддерживаться
другие устройства.

USB
Многие устройства maXTouch поддерживают режим USB, который сообщает о касаниях через USB HID. Кроме того,
оценочные платы могут использовать «мостовую микросхему», которая связывает I2C с тем же протоколом.

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

Конкретное устройство USB можно указать, указав параметр устройства -d usb: 001-003, который
соответствует номерам шины и устройства, заданным параметром запроса -q / - и lsusb.

I2C отлаживать интерфейс
Доступ к устройствам можно получить напрямую через i2c-dev Интерфейс отладки I2C, предоставив адаптер и
адрес в командной строке.

Интерфейс i2c-dev задокументирован в исходном коде ядра Linux в
Документация / i2c / dev-интерфейс

Поддержка интерфейса отладки I2C должна быть включена с помощью ядра CONFIG_I2C_CHARDEV.
вариант конфигурации. Он включен в системе, если присутствуют файлы / dev / i2c- *.

Чтобы использовать i2c-dev, укажите строку устройства, например -d i2c-dev: 1-004a.

Сообщения с устройств maXTouch считываются методом опроса. Если драйвер ядра также
присутствуют в системе, читают сообщения при прерывании, тогда сообщения не будут получены
инструмент. Обходной путь - установить для T18.COMMAND (байт 1) значение 2 ". Принудительно установить для строки CHG высокий уровень.
(неактивно) ", чтобы драйвер ядра не получал прерывания.

Нет поддержки сканирования. Это потому, что чтение со всех возможных maXTouch
адрес на каждой шине I2C может отрицательно повлиять на некоторое несвязанное оборудование, которое не
понимать протокол объектов. Вы должны вручную определить правильный адаптер и адрес с помощью
ссылка на руководство по протоколу или настройку платформы.

Можно использовать команду --flash с устройством, уже находящимся в режиме загрузчика,
указав адрес загрузчика.

ХИДРАУ
Бэкэнд hidraw поддерживает устройства maXTouch, которые подключаются с помощью USB или HID через I2C.

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

На устройстве должна быть включена поддержка / dev / hidraw raw HID устройства с помощью CONFIG_HIDRAW
вариант конфигурации ядра.

Чтобы использовать hidraw, укажите строку устройства, например -d hidraw: / dev / hidraw0.

Нет поддержки сканирования.

Загрузочная загрузка в этом режиме не поддерживается.

ОТЛАЖИВАТЬ ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

-v [--подробный] *УРОВЕНЬ*
установить уровень отладки. УРОВЕНЬ принимает одно из следующих значений: 0 (без звука), 1 (предупреждения и ошибки), 2 (информация -
по умолчанию), 3 (Отладка), 4 (Подробно). Отладка и подробный доступ доступны только в том случае, если он собран.
дюйм

ВЫХОД ЦЕННОСТИ:

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 Ошибка синтаксического анализа протокола TCP моста

28 Ошибка подключения моста

29 Не удалось загрузить последовательные данные

30 Данный файл или каталог отсутствует

31 Ошибка при обработке команды self cap

СОСТАВЛЕНИЕ от ИСТОЧНИК

Чтобы загрузить исходный код с помощью git:

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

Существует две сборки для Android и автоинструментов:

Android
Чтобы загрузить подмодуль libusbdroid:

инициализация подмодуля git
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 библиотеки / armeabi / mxt-app / data / local / tmp /
adb shell / data / local / tmp / mxt-app [команда]

Если разрешения для исполняемого файла не установлены, запустите:

оболочка adb chmod 777 / данные / локальные / tmp / mxt-приложение

автоинструменты
Для компиляции с использованием автоинструментов:

./autogen.sh && make

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

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

Чтобы включить отладку:

./autogen.sh --enable-debug

Чтобы включить создание справочной страницы с помощью pandoc:

./autogen.sh --enable-man

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

сделать документ

Версия НУМЕРАЦИЯ

Номер версии генерируется git description в процессе сборки и сообщается
--version и для отладки логов.

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

Если источник не извлечен с помощью git (например, нажав на github
Ссылка "Скачать ZIP"), то версия из файла ВЕРСИЯ в исходном архиве будет
используемый.

Суффикс -mod добавляется, если в исходном коде есть незафиксированные изменения.

УСТРАНЕНИЕ

Клогктл ошибка
Если вы видите предупреждение

W: ошибка klogctl 1 (операция запрещена)

это указывает на то, что mxt-app не смог получить сообщения от dmesg. Различный
функции не будут работать должным образом. Можно снять ограничения dmesg, выполнив

# echo 0> / proc / sys / ядро ​​/ dmesg_restrict

MXT-ПРИЛОЖЕНИЕ(1)

Используйте mxt-app онлайн через сервисы onworks.net