DE

4-inch IPS touch display · Raspberry Pi

HyperTouch 4.0

High-resolution IPS display with capacitive multi-touch for the Raspberry Pi. The picture comes over the DPI interface straight from the 40-pin header, with no HDMI cable and at 60 frames per second. It fits every Raspberry Pi with a 40-pin header, and a Pi Zero can also be soldered on directly.

InstallationDrivers on GitHub

HyperTouch 4.0 on a Raspberry Pi, showing the Raspberry Pi OS desktop with a sunset wallpaper
800 × 480
IPS, 350 cd/m², viewing angle up to 160°
DPI · 60 fps
18-bit RGB straight from the 40-pin header
Multi-touch
capacitive, GT911 compatible, via I²C
32 steps
backlight with single-wire dimming

Mounting

The display plugs onto the Raspberry Pi with the supplied 40-pin header extension. No soldering is needed. Alternatively, a Pi Zero can be soldered flat onto the adapter board to save space.

Side view: HyperTouch 4.0 above a Raspberry Pi 4, the black header extension in between, USB and Ethernet sockets on the right
On a Raspberry Pi 4 without a case
  • Spacing
    20 to 27 mmBoard to board, freely adjustable. The header extension must sit at least 3 mm deep in the display socket, but not all the way.
  • Cooling
    At least 5 mm above the USB sockets5 to 12 mm depending on insertion depth. This leaves airflow for a Pi 4 and room for a case or CPU cooler.
  • Screws
    Mirrored Pi mounting holesThe adapter board has the Raspberry Pi mounting holes. With M2.5 standoffs (e.g. Würth Elektronik 970200154) everything can be screwed together.

Plugging on

  1. Insert the header extension into the display first, not into the Raspberry Pi. It is deliberately very tight so it stays stable at large spacings, and it is hard to remove afterwards.
  2. Newer revision: before gluing. If the display is not yet glued to the adapter board, insert the header first. If it is already glued, do not press on the display near the display cable while inserting.
  3. Plug onto the Raspberry Pi and set the spacing you need.
  4. Screw down if needed through the mirrored mounting holes.
Back of the adapter board with the black 40-pin header extension inserted, the orange display flex cable on the right
Header extension in the display, seen from the Pi side
Two fingers holding the header extension between display and Raspberry Pi
To remove, hold the header, do not pull on the display

Leave the header in the display

Do not pull the extension out of the display again, or individual gold spring pins may come loose. With variable-height extensions this cannot be avoided by design. Loose pins can be carefully pushed back into the plastic part.

Remove by the header

When taking the display off the Raspberry Pi, do not apply force to the display. Hold the header extension and pull the display off together with it.

Soldering a Pi Zero (advanced)

Raspberry Pi Zero on the dark blue HyperTouch 4.0 adapter board, header extension next to it
Pi Zero on the adapter board, header extension on the right

Pi Zero models can be soldered flat onto the adapter board, with or without a pin header. Soldering is done from the back. To do this, carefully detach the display from the board; it is held by double-sided tape.

Without a pin header, align and fix the Zero through the holes first, for example with a match.

Only with this mounting are the I²C 5V pads usable, see Pinout.

Installation

Drivers and device tree overlays are on GitHub at shpi/hypertouch40. The installer builds the kernel module for backlight and display initialisation with DKMS, adds the overlays to config.txt and asks for driver mode and rotation. Run it on the Raspberry Pi, over SSH or on an HDMI monitor.

curl https://raw.githubusercontent.com/shpi/hypertouch40/main/get-hypertouch.sh | sudo bash
  1. Install Raspberry Pi OS (32 or 64 bit) and boot the Pi with a network connection.
  2. Run the command above. It installs Git, clones the repository to /usr/src/hypertouch40 and starts install.sh.
  3. Choose the driver mode: 1 KMS/DRM, recommended for current systems (still beta on the Pi 5), or 2 Legacy with framebuffer.
  4. Choose the rotation, see table.
  5. Reboot.
OptionRotationOrientation
10°Portrait, header on the right (default)
290°Landscape, header at the bottom
3180°Portrait, header on the left
4270°Landscape, header at the top

Manually

Without the one-liner: clone the repository and start the installer directly.

git clone https://github.com/shpi/hypertouch40.git
cd hypertouch40
sudo ./install.sh

32 or 64 bit, but not mixed

Raspberry Pi OS with 32 bit (armhf) and with 64 bit (arm64) are supported. A 32-bit system with a 64-bit kernel or vice versa is detected and the installer stops, because DKMS cannot build a module for it. To stay on a 32-bit system, set arm_64bit=0 in config.txt and reboot.

Updating an older installation

Simply run install.sh again. It removes obsolete entries such as dtparam=addr= and gpio=27=pu or gpio=27=pd by itself. There is no touch address to choose anymore.

Uninstall

Removes the kernel module, the overlays, all HyperTouch entries in config.txt (backup as config.txt.bak) and the rotation helpers. Reboot afterwards.

sudo /usr/src/hypertouch40/install.sh --uninstall

Brightness and rotation

Brightness

The backlight is driven by a Diodes AL3050, dimmed over a single line (GPIO 19). The driver exposes it as a Linux backlight with levels 0 to 31.

echo 31 | sudo tee /sys/class/backlight/soc:backlight/brightness

If the path soc:backlight does not exist, ls /sys/class/backlight/ shows the correct name.

Rotation

Changing the rotation

Run the installer again and choose a different rotation. Picture and touch are set up to match each other.

KMS

The touch stays in its base orientation. The installer writes a Wayfire mapping for the DPI-1 output and adds an autostart helper that uses wlr-randr or xrandr in other sessions.

Legacy

The installer sets display_lcd_rotate= and the matching touchscreen axes in config.txt.

Troubleshooting

Touch does not respond

The number of the software I²C bus can differ between systems. List the buses first, then scan the bus named i2c-ht40:

i2cdetect -l
i2cdetect -y <bus-number>

The touch controller shows up as UU (claimed by the driver) at 0x14 or 0x5d.

Two possible touch addresses

The GT911 latches its address from the level on GPIO 27 at power-on. Its reset is hardwired to 3.3 V, so software cannot restart it. The address can even change between a cold boot and a reboot. The overlays therefore declare both addresses and the kernel binds to the one that answers.

Harmless messages

For the other address, dmesg shows a short error block, for example Goodix-TS 22-005d: I2C communication failure: -6. The line Goodix-TS 22-0014: ID 911, … then confirms the touch works. Repeated vc4-drm gpu: bound … lines at boot are normal too.

“Pin already requested”

DPI needs almost all GPIOs. The installer therefore disables dtparam=i2c_arm=on (pins 2 and 3) and enable_uart=1 (pins 14 and 15). If they are switched on again, display or touch may fail.

Kernel header or DKMS errors

Usually system and running kernel do not match (mixed 32/64 bit). Use a matching image, or on a 32-bit system set arm_64bit=0, reboot and run the installer again.

Help

If nothing helps, write to lh@shpi.de, ideally with the Raspberry Pi model, the Raspberry Pi OS version and the output of dmesg.

Pinout

The display uses almost the entire 40-pin header. The picture runs in parallel over 18 data lines and four control lines (DPI), the touch over a software I²C bus on GPIO 10 and 11.

FunctionGPIOPinPinGPIOFunction
3.3 V–12–5 V
DPI V-sync234–5 V
DPI H-sync356–GND
DPI blue 247814DPI green 4
GND–91015DPI green 5
DPI green 717111218Display chip select
Touch interrupt271314–GND
DPI red 422151623DPI red 5
3.3 V–171824DPI red 6
I²C SDA (touch)101920–GND
DPI blue 79212225DPI red 7
I²C SCL (touch)1123248DPI blue 6
GND–25267DPI blue 5
DPI pixel clock027281DPI data enable
DPI blue 352930–GND
DPI blue 46313212DPI green 2
DPI green 3133334–GND
Backlight19353616DPI green 6
Display data (SPI)26373820DPI red 2
GND–394021DPI red 3

Picture data (DPI)Control, touch, backlightPowerGround

GPIO 18, 26 and 27 initialise the display controller at boot (chip select, data, clock). After that, GPIO 27 is the touch controller interrupt. That is why the installer always loads the hypertouch40 module before the Goodix touch driver.

I²C pads

Rendering of the adapter board: display connector with resistor row on the left, 40-pin socket in the middle, I²C 3.3V and I²C 5V pads at the bottom right, lettering HyperTouch+ 4.0 single wire dimming
Adapter board, Raspberry Pi side (rendering)
  • I²C 3.3V
    3.3 V · GND · SDA · SCLConnected to the software I²C bus of the touch controller (GPIO 10 and 11, pull-ups on the board). Further I²C devices can be connected here as long as their addresses are not 0x14 or 0x5d.
  • I²C 5V
    5 V · GND · SDA · SCLOnly usable with a soldered-on Pi Zero.
  • Holes
    2.54 mm pitchFor a pin header or directly soldered wires.

Schematic

The schematic has been redrawn in KiCad on two A4 pages. It is based on the 2021 Eagle schematic and the board: all connections are checked against the board and the values match the production BOM. Click a page to open it full size.

Schematic page 1: 40-pin Raspberry Pi socket U$2 and Pi Zero solder pads U$1 on the left, the 23 series resistors and the 45-pin display connector CON1 on the right
Page 1: Raspberry Pi, Pi Zero pads, series resistors, display connector
Schematic page 2: backlight with AL3050 and inductor L6, touch connector CON4 with pull-ups and RC reset, I²C pads
Page 2: backlight, touch, I²C pads

PDF, 2 pages A4Page 1 (SVG)Page 2 (SVG)

Video signals

18 colour lines (R2–R7, G2–G7, B2–B7), pixel clock, data enable, H-sync and V-sync run from the Pi header through one 33 Ω series resistor each to the 45-pin display connector CON1 (Hirose FH12-45S-0.5SH, 0.5 mm pitch). The resistors damp reflections on the fast lines.

Display connector

The CON1 pin names follow the panel datasheet (TXW397017S4-AS). The Pi's 6 bits per colour go to panel pins R5–R0, G5–G0 and B5–B0; bits 7 and 6 of each colour are tied to GND.

Display initialisation

The ILI9806E display controller is configured over SPI at boot: chip select on GPIO 18 (CS_DISPLAY), data on GPIO 26 (MOSI), clock on GPIO 27. Display and touch controller share their reset via the RC network R5/C1 (4.7 kΩ, 4.7 µF) to 3.3 V.

Backlight

U14 (Diodes AL3050) is a boost converter for the display's LED string. It runs from 5 V with inductor L6 (22 µH) and supplies VLED+ to CON1-2. The LED current flows through VLED− (CON1-1) and R3 (8 Ω) to ground; R3 sets it via the FB input. GPIO 19 dims it through R72 (33 Ω) on the CTRL input.

Touch

The touch controller connects to the 8-pin connector CON4 (Omron XF2L-0835-1). SDA and SCL (GPIO 10 and 11) have 4.7 kΩ pull-ups (R1, R2), the interrupt on GPIO 27 a 1 MΩ pull-up (R4). It is powered from 3.3 V, buffered by C5.

Pi Zero and R43

The Pi Zero solder pads U$1 are connected in parallel to the socket U$2. Only pin 13 goes through R43 to the touch interrupt there; the socket connects directly. The old Eagle schematic still listed 604 Ω for the series resistors and 30 Ω for R72; 33 Ω are fitted.

Bill of materials

Parts as assembled, according to the 2021 production BOM.

RefQtyValuePurposePartLCSC
U141–LED driver, boost converterDiodes AL3050FDC-7, U-DFN2020-6–
L6122 µH, 300 mAInductor for U14GCNR4018-220MC (NR4018)–
R14, R15, R23–R432333 ΩSeries resistors for video signals and touch interrupt0402C25105
R72133 ΩDimming input CTRL0402C25105
R318.06 Ω, 1 %LED currentYageo RC0402FR-078R06L–
R1, R2, R534.7 kΩPull-ups SDA, SCL, reset0402C25900
R411 MΩPull-up touch interrupt0402WGJ0105TCE–
C1, C2, C4, C544.7 µFReset delay, 5 V, 3.3 V0402C23733
C311 µF, 25 VLED voltage VLED+0402C52923
CON1145-pin, 0.5 mmDisplay connectorHirose FH12-45S-0.5SHC376072
CON418-pinTouch connectorOmron XF2L-0835-1C376058
U$212 × 20, 2.54 mmSocket to the Raspberry PiFemale header, 8.5 mm high–

Specifications

Display
Type4-inch IPS TFT, 800 × 480 pixels, capacitive touchscreen
Active area86.4 × 51.84 mm
Brightness350 cd/m²
Viewing anglemax. 160°
Display ICIlitek ILI9806E
Interfaces
VideoDPI, 18-bit RGB, 60 fps
Touchmulti-touch, Goodix GT911 compatible, I²C on GPIO 10/11, address 0x14 or 0x5d
BacklightDiodes AL3050, single-wire dimming on GPIO 19, 32 steps
Electrical
Supplyvia the Raspberry Pi: 5 V for the backlight, 3.3 V logic
Insulationnone
Mechanical
Dimensions98 × 59 × 15 mm
Weightmax. 80 g
MaterialFR4 circuit board, IPS display
Mountingheader extension, spacing 20–27 mm · mirrored Pi mounting holes for M2.5 · Pi Zero can be soldered on
Environment
Operation0 … +40 °C
Storage−25 … +70 °C
Relative humidity5 … 93 %, non-condensing
Climate resistanceEN 50090-2-2
Conformity
CEEMC Directive 2014/30/EU, RoHS Directive 2011/65/EU
StandardsEN 55032:2012 Class B · EN 55024:2010 · EN 61000-3-2:2014 · EN 61000-3-3:2013 · EN 63000:2018 · EN 62368-1:2018
Scope of delivery
Includeddisplay with touchscreen and adapter board · 40-pin header extension for plug-on mounting

Downloads

The driver notes in the 2022 PDFs (changing the touch address in hypertouch40.dts, display_rotate) are outdated. Follow the installation on this page.