autr / waveshare-dtoverlays

WaveShare SpotPear 3.2" and 3.5/4.0" TFT LCD overlays for the Raspberry PI and PI 2

WaveShare SpotPear 3.2" and 3.5/4.0" LCD Device Tree Overlays for the Raspberry PI

This is Device Tree Overlays of WaveShare SpotPear 3.2" TFT LCD and WaveShare SpotPear 3.5" TFT LCD for the Raspberry PI and PI 2 using notro's FBTFT driver.

Note that the waveshare 3.5/4.0" lcd's overlay is almost same with JBTek overlay.

Installation

Update: The fbtft drivers have been absorbed into the official linux kernel tree. Step 1 can be skipped.

1.) Follow the steps on notro's wiki for installing the fbtft driver on your pi/pi2 (Your PI will not boot with the LCD attached until the right overlay is specified in /boot/config.txt)

2.) Clone my repo onto your pi

git clone https://github.com/swkim01/waveshare-dtoverlays.git

3.) According to your LCD's type, copy the overlay file waveshare32b-overlay.dtb or waveshare35b-overlay.dtb to /boot/overlays as root

In case of waveshare 3.2" LCD

sudo cp waveshare-dtoverlays/waveshare32b.dtbo /boot/overlays/

or if older than linux 4.4 kernel,

sudo cp waveshare-dtoverlays/waveshare32b.dtbo /boot/overlays/waveshare32b-overlay.dtb

In case of waveshare 3.5/4" LCD

sudo cp waveshare-dtoverlays/waveshare35a.dtbo /boot/overlays/

or if older than linux 4.4 kernel,

sudo cp waveshare-dtoverlays/waveshare35a.dtbo /boot/overlays/waveshare35a-overlay.dtb

4.) Specify this overlay file in your /boot/config.txt

dtoverlay=waveshare32b

or

dtoverlay=waveshare35a

You can configure some parameters of the lcd module like this:

dtoverlay=waveshare32b:rotate=270
dtoverlay=waveshare35a:rotate=90,swapxy=1

5.) reboot your raspberry pi

6.) In case of using X windows on raspbian buster, you have to create a fbdev conf file. Create /usr/share/X11/xorg.conf.d/99-fbdev.conf.

Section "Device"
        Identifier "touchscreen"
        Driver "fbdev"
        Option "fbdev" "/dev/fb1"
EndSection

After then, you need to calibrate touch position.

Touch Calibration

Since now x server uses libinput to handle input devices instead of evdev, there are two method to calibrate/coordinate touch screen.

1.) One is to use coordination transformation matrix. You can confirm the transformation matrix property of the input device by following commands.

$ xinput list
$ xinput list-props "ADS7846 Touchscreen"

This is coordinate transformation matrix that transform from input coordinate(x, y, z) to output coordinate(X, Y, Z).

⎡ 1 0 0 ⎤
⎜ 0 1 0 ⎥
⎣ 0 0 1 ⎦

Thus to convert coordinates, you have to add the following code within the section of touchscreen in /usr/share/X11/xorg.conf.d/99-callibration.conf or 40-libinput.conf.

• in case of rotating left (counterclockwise 90 degree),

    ⎡ 0 -1 1 ⎤ 
    ⎜ 1  0 0 ⎥ 
    ⎣ 0  0 1 ⎦ 
  

   Option "TransformationMatrix" "0 -1 1 1 0 0 0 0 1"
  

  or execute the following code.

   xinput set-prop 'ADS7846 Touchscreen' 'Coordinate Transformation Matrix' 0 -1 1 1 0 0 0 0 1
  

• in case of rotating right (clockwise 90 degree),

    ⎡ 0 1 0 ⎤ 
    ⎜-1 0 1 ⎥ 
    ⎣ 0 0 1 ⎦ 
  

   Option "TransformationMatrix" "0 1 0 -1 0 1 0 0 1"
  

  or execute the following code.

   xinput set-prop 'ADS7846 Touchscreen' 'Coordinate Transformation Matrix' 0 1 0 -1 0 1 0 0 1
  

• in case of inverting rotate (clockwise 180 degree),

    ⎡-1  0 1 ⎤ 
    ⎜ 0 -1 1 ⎥ 
    ⎣ 0  0 1 ⎦ 
  

   Option "TransformationMatrix" "-1 0 1 0 -1 1 0 0 1"
  

  or execute the following code.

   xinput set-prop 'ADS7846 Touchscreen' 'Coordinate Transformation Matrix' -1 0 1 0 -1 1 0 0 1
  

• in case of inverting x,

    ⎡-1 0 1 ⎤ 
    ⎜ 0 1 1 ⎥ 
    ⎣ 0 0 1 ⎦ 
  

   Option "TransformationMatrix" "-1 0 1 0 1 0 0 0 1"
  

  or execute the following code.

   xinput set-prop 'ADS7846 Touchscreen' 'Coordinate Transformation Matrix' -1 0 1 0 1 0 0 0 1
  

• in case of inverting y,

    ⎡ 1  0 0 ⎤ 
    ⎜ 0 -1 1 ⎥ 
    ⎣ 0  0 1 ⎦ 
  

   Option "TransformationMatrix" "1 0 0 0 -1 1 0 0 1"
  

  or execute the following code.

   xinput set-prop 'ADS7846 Touchscreen' 'Coordinate Transformation Matrix' 1 0 0 0 -1 1 0 0 1
  

• in case of swapping x and y,

    ⎡ 0 1 0 ⎤ 
    ⎜ 1 0 0 ⎥ 
    ⎣ 0 0 1 ⎦ 
  

   Option "TransformationMatrix" "0 1 0 1 0 0 0 0 1"
  

  or execute the following code.

   xinput set-prop 'ADS7846 Touchscreen' 'Coordinate Transformation Matrix' 0 1 0 1 0 0 0 0 1
  

• To calibrate in detail, you can build a modified source of xinput-calibrator

$ sudo apt-get install git build-essential libx11-dev libxext-dev libxi-dev x11proto-input-dev
$ git clone https://github.com/kreijack/xinput_calibrator -b libinput
$ cd xinput_calibrator
$ ./autogen.sh
$ ./configure
$ make
$ sudo make install

Configure xinput_calibrator to autostart with X windows.

$ sudo cp -a scripts/xinput_calibrator_pointercal.sh /etc/X11/Xsession.d
$ echo "sudo /bin/sh /etc/X11/Xsession.d/xinput_calibrator_pointercal.sh" | sudo tee -a /etc/xdg/lxsession/LXDE-pi/autostart

On first start of X windows a calibration window will be displayed.

startx

After calibration, the calibration file /etc/pointercal.xinput will be createdautomatically. Or instead you can create /usr/share/X11/xorg.conf.d/99-calibration.conf by executing xinput_calibrator or copy from /etc/pointercal.xinput.

Section "InputClass"
        Identifier "calibration"
        MatchProduct "ADS7846 Touchscreen"
        Option "TransformationMatrix" "0.016152 -1.137751 1.062519 1.126908 -0.005470 -0.064818 0.0 0.0 1.0"
EndSection

2.) The other method is to reuse evdev. The detailed step is as follows.

• Install evdev package.

$ sudo apt-get install xserver-xorg-input-evdev

• Make sure that /etc/X11/xorg.conf.d is empty.
• Modify /usr/share/X11/xorg.conf.d/40-libinput.conf in the last section change the driver to evdev.

Section "InputClass"
        Identifier "libinput touchscreen catchall"
        MatchIsTouchscreen "on"
        MatchDevicePath "/dev/input/event*"
        Driver "evdev"
EndSection

• Calibrate touchscreen as to FBTFT wiki and/or make /usr/share/X11/xorg.conf.d/99-calibration.conf.