Userguide mxt-app

Introduction

This document describes the use of the Linux based userspace tool, mxt-app. The tool is a utility used for managing maXTouch touch controllers and MTCH button/wheels/sliders touch sensors that support the OBP format. This tool can be used with command line arguments or through a simple menu driven interface.

mxt-app can be used in a x86/Linux/Android based operating system and communicates with the device over an I2C, USB, or SPI interface.

An overview of how to compile and use the mxt-app is covered in detail with the various command options available. The mxt-app tool interfaces to the device through the sysfs filesystem of the Linux kernel or through i2c-dev. The mxt-app can also communicate to the device through USB using generic USB protocols or HIDRAW using standard APIs.

All testing has been done using the Ubuntu OS version 16.04 and 22.04. Any critical libraries or tools that need to be installed will be mentioned in this documentation.

The information within this wiki will reference the standard Linux kernel. Whenever possible, differences between the Linux “distributions” (for example, Android) in terms of tools, directory locations or behavior will be noted.