Files
touchkio/HARDWARE.md
T
2025-09-10 16:43:24 +02:00

7.3 KiB

Supported Hardware

This document contains an incomplete list of device and display hardware combinations that have already been tested.

The release page has builds exclusively for arm64 and x64, but custom builds for other architectures can be made (see development), allowing the application to operate on any hardware. At least the minimal features, such as displaying a kiosk window (which doesn't necessarily need to be Home Assistant) will work.

Hardware

If you are running Linux with a graphical user interface (Wayland or X11), you should be well equipped to use the application. Additionally, any single board computer (SBC) clones of the Raspberry Pi that operate on Raspberry Pi OS (64-bit) are likely to function as well.

Status Notes
🟩 Fully operational Working display power, brightness and keyboard control via MQTT.
🟨 Partially operational Display brightness control is not available via MQTT.
🟧 Partially operational Display brightness and keyboard control is not available via MQTT.
🟥 Partially operational Display power, brightness and keyboard control is not available via MQTT.
⬜ Somehow operational Issues can occur and the overall performance is very slow.
⬛ Not operational The house is on fire.

DSI

Device System Display Status
Raspberry Pi 3 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Official 7" Touch Display 1 (800x480) ⬜
Raspberry Pi 3 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Official 7" Touch Display 2 (720x1280) ⬜
Raspberry Pi 4 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Official 7" Touch Display 1 (800x480) 🟩
Raspberry Pi 4 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Official 7" Touch Display 2 (720x1280) 🟩
Raspberry Pi 5 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Official 7" Touch Display 1 (800x480) 🟩
Raspberry Pi 5 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Official 7" Touch Display 2 (720x1280) 🟩

HDMI

Device System Display Status
Raspberry Pi 4 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 LAFVIN 5" Touch Display (800x480) 🟨
Raspberry Pi 4 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Waveshare 8" CAPLCD (768x1024) 🟨
Raspberry Pi 4 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Waveshare 7" 7EP-CAPLCD (1280x800) 🟨
Raspberry Pi 4 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Hannspree HT225 21.5" (1920x1080) 🟨
Raspberry Pi 400 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 UPerfect Vertical Touch 15.6" (1920x1080) 🟨
Raspberry Pi CM 4 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Lenovo ThinkCentre 23.8" (1920x1080) 🟨
Raspberry Pi 5 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 GeeekPi 10.1" Capacitive Touch (1280x800) 🟨
Raspberry Pi 5 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Prechen Portable Touch 18.5" FHD (1920x1080) 🟨
Raspberry Pi 5 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Akntzcs Portable Touch 16" HD (1920x1200) 🟨
Raspberry Pi 5 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 ELECROW Portable Monitor 10.1" (1280x800) 🟨
Raspberry Pi 5 (arm64) Raspberry Pi OS (64-bit), Wayland, X11 Generic Non-Touch 🟨
Generic PC (x64) Debian KDE (64-bit), Wayland, X11 Generic Non-Touch 🟧
Generic PC (x64) Ubuntu XFCE (64-bit), X11 Generic Non-Touch 🟧
Generic PC (x64) Ubuntu GNOME (64-bit), X11 Generic Non-Touch 🟧
Generic PC (x64) Ubuntu GNOME (64-bit), Wayland Generic Non-Touch 🟥

Contributions

In case your hardware is not listed above don't worry, give it a try. Running touchkio --web-url=https://demo.home-assistant.io will most likely just work. The only problems that may arise are when controlling the display or keyboard via the Home Assistant integration.

  • If you encounter any problems, please create a new issue.
  • If you encounter any problems and are able to fix it yourself, feel free to create a pull request.
  • If everything works as expected and your hardware is not yet listed, you are welcome to report it or create a pull request.