WCIMCI Get a Quote
Home/Support/OS compatibility

One USB cable, no driver disc

The controller enumerates as a standard USB HID digitizer. Windows, Android, Linux and ChromeOS already know what that is, so a stock-size frame is a plug-and-play part: screw it on, plug in, touch. The exceptions matter, and they are listed here rather than buried in a datasheet footnote.

The matrix

Which systems run without a driver

Tested on the versions listed. “None” in the driver column means the operating system provides it; nothing is installed from our side.

Operating systemVersions testedDriverMulti-touchPointsNotes
Windows 10 / 111909 – 24H2NoneYes20Enumerates as HID-compliant touch screen. Calibration is in Control Panel → Tablet PC Settings
Windows 7 SP1 / 8.1x86 / x64NoneYes10Needs the touch components present in the image; a stripped embedded build may not have them
Windows IoT / EmbeddedWES7, Win10 IoTNone, but the image must include TouchYes20Add the Touch and Tablet PC packages to the image, or the HID device is ignored
Ubuntu / Debian18.04 – 24.04, Debian 10 – 12hid_multitouch (in kernel)Yes20Works on X11 and Wayland. If only the pointer moves, the module is not loaded
Yocto / Buildrootkernel ≥ 3.8Enable CONFIG_HID_MULTITOUCHYes20Most custom kiosk images ship without it — one config line
Raspberry Pi OSBullseye / Bookwormhid_multitouchYes10–20Bookworm on Wayland is fine; some minimal images report single touch until the module loads
Android7 – 14, incl. RK3568 / RK3588 / AmlogicNoneYes20 typicalVendor kernels vary; an .idc file fixes a build that maps touch to a mouse
ChromeOS100+NoneYes10Works as a touchscreen, including in kiosk mode
macOS10.13 – 15None existsNo1Reports as a mouse. There is no HID multitouch path for third-party panels and we do not ship a driver
iPadOS / iOS——No—Not a HID host for external touchscreens; a pointer at best
Point count

Capped by the OS, not by the frame

The single most common misunderstanding on a 32 or 40-point frame: the hardware reports 40 contacts, and the host accepts whatever its HID descriptor allows. On Windows 10 / 11 and current Android boards that is 20 — so a 40-point frame presents as a 20-point device, and nothing is broken. The 10-finger ceiling people quote comes from the old Windows 7 touch stack. This table is what actually reaches your application.

Operating systemMax simultaneousDetail
Windows 10 / 1120The HID descriptor declares the contact count and Windows 8 and later accept up to 20. A 32 or 40-point frame ships flashed to a 20-contact descriptor on Windows builds, so 20 fingers is the working figure
Windows 710The older digitizer path stops at ten; for a Win7 fleet we flash a 10-contact descriptor so behaviour matches the datasheet
Android20 typicalFramework and vendor kernels carry 20 on RK3568 / RK3588 boards; a few vendor images map touch to a mouse until an .idc file is added
Linux20 via libinputThe kernel and libinput carry 20; your application decides how many it reads
ChromeOS10Same stack as Android underneath, capped lower on current builds
macOS1Single pointer, no multitouch
Test it in sixty seconds

One command per system

Before you suspect the hardware, confirm what the host sees. These are the checks we ask for on a support call, and they settle the question faster than any photo.

SystemWhat to run or look at
WindowsDevice Manager → Human Interface Devices. Look for “HID-compliant touch screen”. If it says mouse, the descriptor is wrong — send us the label photo.
Linuxlsusb for the device, dmesg | grep -i hid for the driver, libinput list-devices for what the stack sees, evtest for live coordinates.
Androidgetevent -l on adb shell. A working digitizer streams ABS_MT_POSITION_X; a mis-mapped one streams REL_X like a mouse.
ChromeOSchrome://system → input devices. Touch appears as a touchscreen device, not a pointer.
macOSSystem Information → USB. The controller appears; no touchscreen device is created. That is the expected behaviour, not a fault.
Where it goes wrong

Six integration traps

The OS calls it a mouse

The controller was flashed with a mouse descriptor, usually on a spare board. It still moves the cursor, which is why it gets mistaken for a working unit. One reflash fixes it and the tool ships with the order.

It works on the bench, not in the product

The product's port provides less current than the bench hub, or the cable run is longer. A 40-point frame peaks near 320 mA; a port rated 500 mA with a 5 m passive cable may not hold it.

Multi-touch dies after a kiosk image update

The new image ships without hid_multitouch, or blacklists it. Single touch still works, so it reads as a hardware downgrade.

Coordinates are mirrored or rotated

The display is rotated in software but the frame is not rotated in the controller. Set orientation in the calibration tool, then check the OS rotation matches.

Offset grows with display scaling

Windows at 125 % or 150 % scaling moves the mapping origin. Either run 100 % or recalibrate at the scaling the product ships with — not both.

Touch stops when the screen sleeps

The USB port is suspended with the display. Disable selective suspend for that port, or power the controller from a port that stays alive.

Before you commit to tooling

Test on your own board

Every one of these questions is answered by one sample on your own hardware, and that is the cheapest test in this business. We ship a single unit for evaluation, with the calibration tool, the installation sheet and a test checklist matched to your host. Run it on the board you will actually ship, at the OS version you will actually image, before you cut a housing or pay for tooling.

What to tell us: operating system and version, host board (x86 or ARM, and which SoC), how the unit is powered, and the longest cable run in your design. We will confirm whether a stock part works or whether the controller needs a different descriptor.

Order an evaluation unit →  ·  Calibration and tools

FAQ

Driver and compatibility questions

Do I need to install a driver on Windows?
No. The controller enumerates as a standard USB HID digitizer and Windows has shipped the driver since 7. There is no CD, no vendor service, no reboot. If someone tells you a driver is required, they are usually thinking of a serial or I2C controller, which is a different part.
Why does my 40-point frame only register 20 fingers?
Because the controller is flashed with a 20-contact HID descriptor, which is what Windows 10 / 11 and current Android boards accept. The frame and the sensor are the same part as the 40-point version; the descriptor is the ceiling. Tell us the host at the quote stage and we flash to match — 20 for Windows, 40 for a Linux or Android build with its own input stack. Ten fingers only happens on an old Windows 7 image, or on a controller left in the default 10-contact profile.
Does it work on a Mac?
It works as a single-point pointer, not as a touchscreen. macOS has no HID multitouch path for third-party panels, so gestures and two-finger work are not available and we do not supply a driver to work around it. If your deployment is Mac-heavy, plan for single point or choose a different route.
What about a Raspberry Pi?
It works, and it is one of the more common hosts for prototype and signage builds. Single touch usually works out of the box; multi-touch needs hid_multitouch loaded, which is automatic on Raspberry Pi OS but not on minimal images.
Can I use it with an Android media box?
Yes, on boards with a standard HID host stack — RK3568, RK3588 and Amlogic boxes are the common ones. A few vendor images map HID touch to a mouse; that is fixed with an input device configuration file, and we can send the file for the build you are using.
Is there an SDK or API?
Not for basic touch — the operating system already provides the events, and adding an SDK would only give you a second way to receive the same data. For integration into your own production test line we do supply the controller command reference, including how to write a calibration profile from your own software.

Tell us the host board.

Send the SoC, the OS version and the cable length in your design. We will tell you whether a stock controller works or which descriptor it needs.

◉WeChat wm-lcd · scan or search the ID
◷Mon–Sat 09:00–18:00 GMT+8 · English & Chinese
Thanks — your request is with our engineering desk.
You will get a reply within 12 working hours, usually much sooner. If it is urgent, message WhatsApp +86 153 2343 9001 and quote your company name.

Or email us directly at info@wcimci.com. Drawings in DWG, STEP, PDF or DXF are all fine.

WhatsApp us