Attention: the features and instructions contained in this article are not guaranteed to be maintained by Toradex.

Introduction

The Atmel MaXTouch controllers have a configuration file saved in their internal NVRAM. On rare occasions, one may need those files for some purpose.

Attention: it is very likely that you don't need to get the configuration from the controller. Avoid messing up with it, so you avoid permanently damaging the controller.

This article focuses on specifically how to retrieve the configuration from the Capacitive Touch Display 10.1" LVDS on Torizon. It most likely works for the Capacitive Touch Display 7" Parallel, or at least very similar instructions. The configuration is retrieved using the mxt-app and you should read the README.md of the repo for further details.

This article complies to the Typographic Conventions for Torizon Documentation.

Prerequisites

• Capacitive Touch Display 10.1" LVDS
• Ixora Carrier Board
• Apalis iMX8

Build and Run a Container

Build a container named mxt-app using the Dockerfile below:

Warning: the Dockerfile provided in this article may not comply with best practices. It is intended as a quickstart only.

 Dockerfile
FROM arm64v8/ubuntu
 
RUN apt-get update && apt-get upgrade -y && apt-get install -y \
    git \
    build-essential \
    autoconf \
    libtool \
    i2c-tools
 
RUN git clone https://github.com/atmel-maxtouch/mxt-app.git && \
    cd mxt-app && \
    ./autogen.sh && \
    make && \
    cp mxt-app /usr/local/bin/
 
CMD ["/bin/bash"]

Run with:

# cd /home/torizon
# mkdir mxt
# docker run --rm -it --privileged -v /dev:/dev -v /tmp:/tmp -v /run/udev/:/run/udev/ -v /sys:/sys -v /home/torizon/mxt:/mxt mxt-app

You'll later save the config file in the bind-mount /home/torizon/mxt.

Dump the Configuration to a File

In the interactive bash session inside the container, find the i2c controller and address:

## ls /sys/bus/i2c/drivers/atmel_mxt_ts/
4-004a  bind  uevent  unbind

In this case, it is 4-004a. Now you can dump the config to a file:

Xcfg file

## cd mxt
## mxt-app -d i2c-dev:4-004a --save mxt.xcfg
Version:1.28-25-g927e026
Registered i2c-dev adapter:4 address:0x4a
REPORTALL command issued
Timeout
Read config from device
Saved config to mxt.xcfg in .xcfg format

Binary file

## cd mxt
## mxt-app -d i2c-dev:4-004a --save mxt.bin
Version:1.28-25-g927e026
Registered i2c-dev adapter:4 address:0x4a
REPORTALL command issued
Timeout
Read config from device
Saved config to mxt.bin in OBP_RAW format

Save the File to Your Computer

Exit the container and copy the file to your PC from /home/torizon/mxt/mxt.xcfg using, for instance, scp:

# scp /home/torizon/mxt/mxt.xcfg <user>@<ip>:<path to save file on your PC>