No description, website, or topics provided.
Python Shell
Switch branches/tags
Nothing to show
Clone or download
Latest commit 3cfcec5 Mar 24, 2017

Update about new device

I heared that waveshare developed a new version of the touchscreen which uses standard HID protocol. By using this new version, we don't need driver any more. The HID protocol can be used in linux, windows 10 IoT and even desktop (I didn't try)

If you want to upgrade your device, please send it back and let them upgrade for you.

I will stop develop this driver and keep the functionality the same.

Support this driver

Support me by registering a DigitalOcean account, you will get a $10 credict for free.

WaveShare 7-inch user space driver

I brought a WaveShare 7-inch HDMI LCD and it provides a USB touchscreen. But the company only provide binary driver and images, which is quite bad. Installing binary driver will break self compiled kernel, and you can't get updated kernels. I asked the company to provide the source code but they refused. They said they won't provide any source code because other companies can copy very fast so that their products can't sell out at good price.

OK. If they company won't want to provide anything, that's fine. I finally find out we can still drive the touchscreen by writing a user space driver.

Tested using official image: 2015-05-05-raspbian-wheezy.img

NOTE: I do not guarantee this driver will work on other system/other displays. If you have trouble, or make it work on other system/displays, please make a pull request, I'll help to merge it into master branch.

If any help needed, do not send an email to me directly, please raise an issue so that your question can be solved quicker.

This is what my hack does.

  • Make 7-inch display working.
  • Make touch panel working.

Install (Thanks Kaz Fukuoka to fix this guide)

ssh into your raspiberry

git clone
cd waveshare-7inch-touchscreen-driver
chmod +x
sudo apt-get update
sudo ./
sudo restart

How do I hack it

By looking at the dmesg information, we can see it is installed as a hid-generic driver, the vendor is 0x0eef(eGalaxy) and product is 0x0005. 0x0005 can't be found anywhere, I think the company wrote their own driver to support this.

dmesg infomation

[    3.518144] usb 1-1.5: new full-speed USB device number 4 using dwc_otg
[    3.606036] udevd[174]: starting version 175
[    3.631476] usb 1-1.5: New USB device found, idVendor=0eef, idProduct=0005
[    3.641195] usb 1-1.5: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[    3.653540] usb 1-1.5: Product: By ZH851
[    3.659956] usb 1-1.5: Manufacturer: RPI_TOUCH
[    3.659967] usb 1-1.5: SerialNumber: \xffffffc2\xffffff84\xffffff84\xffffffc2\xffffffa0\xffffffa0B54711U335
[    3.678577] hid-generic 0003:0EEF:0005.0001: hiddev0,hidraw0: USB HID v1.10 Device [RPI_TOUCH By ZH851] on usb-bcm2708_usb-1.5/input0

kernel config provide us more clue:


It is really a eGalaxy based device. Google this config but found nothing. I don't have a eGalxy to compare, maybe waveshare's touchscreen is only modifed the product id.

Then I look at the response of hidraw driver:

hidraw driver analysis

pi@raspberrypi ~/python $ sudo xxd -c 25 /dev/hidraw0
0000000: aa00 0000 0000 bb00 0000 0000 0000 0000 0000 0000 0000 0000 00  .........................
0000019: aa01 00c5 0134 bb01 0000 0000 0000 0000 0000 0000 0000 0000 cc  .....4...................

You can try by your self, by moving the figure on the screen you will notice the value changes. Take one for example:

0000271: aa01 00e4 0139 bb01 01e0 0320 01e0 0320 01e0 0320 01e0 0320 cc  .....9..... ... ... ... .

"aa" is start of the command, "01" means clicked while "00" means unclicked. "00e4" and "0139" is the X,Y position (HEX). "bb" is start of multi-touch, and the following bytes are the position of each point.

Write the driver

I use python to read from hidraw driver and then use uinput to emulate the mouse. It is quite easy to do. Please look at the source code.

Other systems

I think this driver can work in any linux system with hidraw and uinput driver support.

Other displays

I received an email from Adam, this driver may work with another type of screen:

Hi there. Wanted to say thank you for writing and sharing the user space driver for 7" USB touchscreen, you have saved me!

Mine is branded Eleduino (see here for details: and I had exactly the same issue - closed source binary driver which simply replaced kernel modules.

Your solution worked out of the box, and didn't even need calibration.

You're a hero!

Another option

I found another guy wrote a C++ driver for this. Please refer to

Pro version features (STOP DEVELOPMENT)

Please try this driver and if you need to support more, please contact me to get the paid pro version.

1 More options:

  • Set right click duration

2 Calibration:

  • On screen calibration

3 Multitouch:

  • Two fingures touch to simulate right click
  • Three fingures to scrool