Dokumentáció / Hibaelhárítás / Az érintőképernyő bemeneti adatainak értelmezése

Az érintőképernyő bemeneti jelentéseinek értelmezése

Bevezetés és tájékozódás

Először ellenőrizze, hogy a Linux látja-e az érintőeszközt. Ezután két helyzetben hasonlítsa össze a jelentett érintéseket: amikor senki nem ér a képernyőhöz, és amikor valaki a helyszínen szándékosan megérint egy ismert pontot. Ez megmutatja, jelez-e a vezérlő a valóságtól eltérő érintéseket; az okot vagy a javítást nem határozza meg automatikusan.

Ellenőrzések és hibaelhárítás

A távoli konzol és a Linux-eszközök segíthetnek feltárni az érintésbemenet működését – irodából vagy helyszíni látogatáskor. A diagnosztika a feltételezések tesztelését szolgálja firmware-frissítés, újrakalibrálás vagy az érintőréteg cseréje előtt, így elkerülhetők a szükségtelen beavatkozások. Nem helyettesíti a hardvervizsgálatot.

Kezdje a felügyelettel, majd fogalmazzon meg konkrét kérdést

Először az eszközfelügyeletbenellenőrizze a legutóbbi jelentés időbélyegét és a csatlakoztatott USB-eszközöket. A felismert vezérlő nem jelenti, hogy helyes érintéseket jelez. Ezt segíti ellenőrizni az alábbi vizsgálat.

1. Azonosítsa a tüneteket

  • Nincs reakció: ellenőrizze az érintőeszköz felismerését és csatlakoztatását.
  • Rossz helyen reagál: ellenőrizze az érintés tájolását és leképezését az eszközbeállításokban.
  • Szabálytalan vagy kéretlen reakciók: hasonlítsa össze a jelentett érintéseket érintés nélküli állapotban és szándékos érintés közben.
  • Késés: különböztesse meg a késő bemenetet az alkalmazás lassú reakciójától; az állapotpillanatkép önmagában nem méri a késleltetést.
Különítse el az érintésbemenetet az alkalmazás reakciójától

Ha a távoli egér működik, a fizikai érintés viszont nem, ez önmagában nem igazolja az érintőpanel hibáját. Vesse össze a Linux által jelentett bemenetet az alkalmazás reakciójával. Wayland alatt az XInput-beállítások módosítása nem feltétlenül hat a lejátszó által használt bemenetre; ugyanannak a mátrixnak az újbóli beállítása nem javítás.

2. Ellenőrizze, mit jelent az érintőeszköz

Nyissa le az alábbi parancsot, és futtassa a távoli konzolban. Egyetlen pillanatképet készít, és semmit sem módosít. Először gondoskodjon róla, hogy senki ne érjen a képernyőhöz, és mentse a kimenetet. Ezután ismételje meg úgy, hogy valaki a helyszínen egy ismert pontot érint. A parancs a két kiolvasás közötti eseményeket nem rögzíti.

Az egyszeri ellenőrzés parancsának megjelenítése
python3 - <<'PY'
#!/usr/bin/env python3
"""Read-only Linux evdev snapshot. No reset, grab, calibration or writes.

Requires Python 3, Linux generic ioctl layout (e.g. x86/ARM) and permission
to read /dev/input/event*. Type-B contacts are queried from kernel state.
Raw axes precede compositor rotation/calibration. Run again to compare.
"""
import array
import fcntl
import glob
import os

def query(fd, number, size, initial=None):
    data = bytearray(size) if initial is None else bytearray(initial)
    fcntl.ioctl(fd, (2 << 30) | (size << 16) | (ord('E') << 8) | number, data, True)
    return data

def absinfo(fd, code):
    a = array.array('i')
    a.frombytes(query(fd, 0x40 + code, 24))
    return a

def slots(fd, code, count):
    a = array.array('i', [code] + [0] * count)
    data = query(fd, 0x0a, len(a) * a.itemsize, a.tobytes())
    result = array.array('i'); result.frombytes(data)
    return result[1:]

def position(value, limits):
    lo, hi = limits[1], limits[2]
    return 'n/a' if hi <= lo else '{:.1f}%'.format(100 * (value - lo) / (hi - lo))

def main():
    found = denied = 0
    for path in sorted(glob.glob('/dev/input/event*')):
        try:
            fd = os.open(path, os.O_RDONLY | os.O_NONBLOCK)
        except PermissionError:
            denied += 1; continue
        except OSError as error:
            print(path, error); continue
        try:
            bits = query(fd, 0x20 + 3, 64)
            has = lambda code: bool(bits[code // 8] & (1 << (code % 8)))
            keys = query(fd, 0x20 + 1, 96)
            touch_supported = bool(keys[330 // 8] & (1 << (330 % 8)))
            multi = has(47) and has(57) and has(53) and has(54)
            if not multi and not (touch_supported and has(0) and has(1)):
                continue
            found += 1
            name = query(fd, 0x06, 256).split(b'\0', 1)[0].decode(errors='replace')
            print('\nDevice:', path, name)
            print('Snapshot only; coordinates are raw sensor axes, not screen pixels.')
            if multi:
                count = absinfo(fd, 47)[2] + 1
                if not 1 <= count <= 256:
                    print('Unsupported slot count:', count); continue
                tracking = slots(fd, 57, count)
                xs, ys = slots(fd, 53, count), slots(fd, 54, count)
                xr, yr = absinfo(fd, 53), absinfo(fd, 54)
                active = [i for i, value in enumerate(tracking) if value >= 0]
                print('Active contacts:', len(active))
                for i in active:
                    print('Slot', i, 'ID', tracking[i], 'X=', xs[i], position(xs[i], xr),
                          'Y=', ys[i], position(ys[i], yr))
            else:
                print('No type-B contact count; single-touch state only.')
                x, y = absinfo(fd, 0), absinfo(fd, 1)
                print('X=', x[0], position(x[0], x), 'Y=', y[0], position(y[0], y))
            if touch_supported:
                state = query(fd, 0x18, 96)
                print('BTN_TOUCH:', bool(state[330 // 8] & (1 << (330 % 8))))
        except OSError as error:
            print(path, 'Cannot read this device:', error)
        finally:
            os.close(fd)
    if not found:
        print('No supported candidate read. This does not prove hardware failure.')
    if denied:
        print('Permission denied for', denied, 'input device(s). Contact authorised support.')

if __name__ == '__main__':
    main()

PY

Ugyanez az ellenőrzés a letölthető diagnosztikai szkripttelis elvégezhető.

Műszaki megjegyzés adminisztrátoroknak

A szkripthez Linux, Python 3 és az alábbi elérési út olvasási jogosultsága szükséges: /dev/input/event*. Nem telepít semmit, nem módosít kalibrációt, nem választ le illesztőprogramot, és nem blokkolja más alkalmazások bemenetét. A listában más mutatóeszközök is szerepelhetnek; név alapján azonosítsa a megfelelő vezérlőt. Nem támogatott bemeneti típusnál az érintésszám nem feltétlenül érhető el. Ha a hozzáférés megtagadva, általános jogosultságmódosítás helyett kérjen segítséget a szolgáltatótól.

Ha a konzol csak SEND OK választ ad

Az elküldés visszaigazolása nem a parancs kimenete és nem igazolja a befejezést. Ha a konzol már nem ad eredményeket, különösen a megjelenítőalkalmazás leállítása után, a csendet ne értelmezze üres diagnosztikai eredményként. Gondoskodjon független ellenőrzésről jogosult karbantartási kapcsolaton vagy a helyszínen. Lásd még: a távoli konzol használati útmutatója.

3. Az érintések és koordináták értelmezése

Mit keressen?Mit jelent?
DeviceA bemeneti eszköz neve és azonosítója Linux alatt. Név alapján keresse meg az érintővezérlőt.
Active contactsA támogatott többérintéses vezérlő által éppen jelentett érintések száma. Érintés nélkül nulla várható.
Slot / IDEgy érintést azonosít; nem a képernyő számozott helyét jelenti.
X / YAz érzékelő által jelentett pozíció. A százalékok nem automatikusan képpontok vagy a bal és felső széltől mért távolságok.
BTN_TOUCHHa az eszköz szolgáltat ilyen adatot, a True érintést jelez, a False pedig azt, hogy nincs érintés.

Szemléltető kimenet, nem az Ön eszközének mérése:

Device: /dev/input/eventN Example touch controller
Active contacts: 1
Slot 0 ID 12 X= 600 50.0% Y= 1100 100.0%
BTN_TOUCH: True

Hogyan folytassa az eredmény alapján?

  • Érintések maradnak jelentve, miközben senki nem ér a képernyőhöz: vesse össze a pozícióikat ismert érintésekkel, és vizsgálja meg az adott területet, szélt vagy burkolatot. Ez a vizsgálat támpontja, nem szennyeződés vagy hiba igazolása.
  • Az érintések megfelelnek a valós érintéseknek, az alkalmazás mégsem reagál: ellenőrizze a tájolást és a leképezést az érintéstájolási beállításokban. A helyes bemeneti pillanatkép önmagában nem igazolja az alkalmazás helyes reakcióját.
  • Az eszköz nem szerepel a listában vagy a kiolvasás sikertelen: mentse a kimenetet, és küldje el a szolgáltatónak. Jogosultság, nem támogatott bemenet vagy kapcsolat is okozhatja; a lista önmagában nem bizonyít hibát.
Műszaki megjegyzés adminisztrátoroknak

Az X és Y az érzékelő nyers tengelyei; a százalékok az illesztőprogram által jelentett tartományon belüli pozíciót írják le. Nem automatikusan képernyőpixelek vagy a bal és felső széltől mért távolságok. Az elforgatás, kalibrálás és leképezés módosíthatja az összefüggést. A fizikai pont meghatározásához ismert érintéseket hasonlítson össze. Az értékek kiolvasása nem egyetlen atomi művelet: mozgó érintéseknél ismételje meg a parancsot.

Az érintés nélkül is tartósan jelentett kontaktus egy konkrét hely vizsgálata felé terelheti a figyelmet. Segít tesztelni a feltételezéseket a bizonyíték nélküli firmware-frissítés vagy alkatrészcsere előtt. Nem bizonyítja, hogy az ok szennyeződés, mechanikai nyomás, vezérlőállapot vagy meghibásodás. Egyetlen pillanatban jelzett nulla érintés nem zárja ki az időszakos problémákat; a fel nem ismert bemenet vagy kiolvasási hiba nem bizonyít hardverhibát.

Példa: jelentett érintések, amikor senki nem ér a képernyőhöz

Egy szervizellenőrzéskor a vezérlő ismételten négy aktív érintést jelzett az alsó szél közelében, és BTN_TOUCH: True állapotot adott, miközben senki nem ért a képernyőhöz. Szoftveres alaphelyzetbe állítás után az érintések új azonosítókkal tértek vissza. Ez a jelentett érintéseket igazolja, nem az okukat. Az új azonosítók vagy a megváltozott event-fájlnév nem bizonyítják a hiba megszűnését. További beállításmódosítás előtt hasonlítson össze friss kiolvasást, és vizsgálja meg a burkolat érintett területét.

4. Vizsgálja meg a felületet és a burkolatot

Ellenőrizze a felületet és a széleket szennyeződés, nedvesség, rögzített tárgyak vagy a burkolat nyomása szempontjából. Kövesse a gyártó tisztítási útmutatóját. Érintőfóliás ajtóknál állapítsa meg, hogy a probléma szervizelés vagy helyzetváltozás után kezdődött-e.

5. Megfelelően állítsa vissza a kiindulási állapotot

Rögzítse az állapotot minden beavatkozás előtt és után. A /dev/input/eventN azonosító újraindítás vagy újracsatlakoztatás után változhat. Név alapján azonosítsa újra a vezérlőt, ne használja ellenőrzés nélkül a korábbi bemeneti számot. A szoftveres illesztőprogram alaphelyzetbe állítása áram alatt hagyhatja a vezérlőt, és nem garantál teljes hardveres visszaállítást.

Egyes kialakítások bekapcsoláskor automatikusan hozzáigazíthatják az érintővezérlőt a környezethez. Ezeknél az ajtó vagy fólia későbbi mozgatása téves érintésekkel járhat. Ez nem általános szabály: az eljárást egyeztesse a hardverszállítóval.

Először fejezze be a szervizelést, csukja be az ajtókat, és hagyja a burkolatot normál üzemi helyzetben. Ha a gyártó teljes áramtalanítást javasol, az érintővezérlőt is áramtalanítani kell, amely USB-ről is kaphat tápellátást. A lejátszó újraindítása ezt nem feltétlenül szakítja meg. Az előírt eljárást jogosult személy végezze; visszakapcsolás után ne mozgassa a burkolatot.

A távoli USB-helyreállítás a bekötéstől függ, és más eszközöket is leválaszthat. Ezért az útmutató nem ad általános visszaállító parancsot vagy firmware-frissítési utasítást.

Kapcsolódó témák és következő lépések

6. Ellenőrizze az eredményt, és ossza meg a megállapításokat

Ismét vesse össze az érintés nélküli állapotot több, ismert helyen végzett érintéssel. Küldje el a támogatásnak a vezérlő nevét, a kimenetet, a tüneteket, a képernyő tájolását és az utolsó szervizbeavatkozást. Jelezze, segített-e a teljes áramtalanítás, és befolyásolja-e az ajtó mozgatása a problémát. Ha továbbra is fennáll, egyeztessen hardvervizsgálatot.

Nem találta meg, amit keresett?
Forduljon szoftverszolgáltatójához.