kbd-tst.py adalah program pengujian keyboard sederhana. Ini menguji fungsionalitas semua kunci yang memberikan umpan balik grafis (yah, hanya semigrafik ASCII di terminal teks) kepada pengguna seperti:
Tes keyboard yang sederhana dan ramah pengguna tanpa ketergantungan eksternal ()hanya menggunakan utilitas sistem standar) ...
Ada cara untuk menguji keyboard tanpa utilitas seperti ini hanya dengan menggunakan editor teks misalnya. Dalam hal ini Anda harus mengingat kunci mana yang telah diuji dan jangan lewatkan kunci mana pun yang belum diuji. Dan semuanya menjadi lebih mudah dengan umpan balik visual yang ditampilkan langsung di layar dengan kbd-test.
Berikut ini beberapa yang umum:
Meskipun penerapannya minimalis, ada persyaratan berikut:
Catatan: Karena ketergantungan xinput, kbd-tst hanya dapat berjalan pada sistem mirip linux dengan Xorg
Seluruh implementasi kbd-tst berpusat pada 'uji xinput'. Xinput dijalankan sebagai subproses dan peristiwa keluaran diurai dan divisualisasikan sebagai tata letak keyboard di layar dengan info dan statistik tambahan. Bagian visual diimplementasikan menggunakan urutan escape ANSI untuk mengontrol posisi dan warna kursor terminal teks. Tata letak keyboard disediakan dari file tata letak ASCII eksternal (*.lay) seperti 'apple.lay' atau 'at101.lay'.
Agar kbd-tst berfungsi, kita harus menentukan yang berikut:
Untuk menampilkan bantuan penggunaan, kami dapat menyediakan parameter standar '-h' atau '--help'
= Keyboard Test Program version 2017.7.28 = (c) 2017 by Robert P =
Usage: kbd-tst.py [id] [layout] [-h|--help]
kbd-tst.py [-h|--help] [layout] [id]
-h ... shows this usage help and quits
--help ... shows this usage help and quits
id ... optional keyboard device id as shown in 'xinput list' output (default user assisted autodetection)
layout ... optional keyboard ASCII layout file [*.lay] (default the first file in kbd-tst dir)
Notes:
* parameters are optional
* not providing device id will initiate a user assisted autodetection sequence requiring physical disconneting
and reconecting the keyboard under test (KUT)
* not providing the layout file is usefull if there is only single layout file in kbd-tst directory
* all unrecognized keys from layout file are shown as errors and counted as [ missing_keycodes ]
* all parameters can be supplied in arbitrary order
* in case of multiple specification the last one wins,
for example in sequence of parameters 'id1 layout1 layout2 id2' id2/layout2 pair wins
* test ends when all successfully recognized keys from layout file are tested [ to_go = 0 ]
* to end test prematurely just type phrase 'quit' (without the quotes)
Known issues:
- keys ike apple keyb VOL+/VOL-/MUTE/EJECT do not generate xinput events and therefore cannot be tested right now
- if more than one device id is found by autodetection sequence only the first one is used, which is some cases
might be incorrect. In this case provide the correct device id as a parameter (id can be found by trial and error
from 'xinput list' and verified by 'xinput test id' to show 'key press xx' and 'key release xx' events)
[ xinput double entries related bug: https://bugs.launchpad.net/ubuntu/+source/hal/+bug/277946 ]
Prosedur pengujian hanya terdiri dari langkah-langkah:
Karena sifat dinamis dan dukungan hot-plugging dari id xinput, kita harus menemukan id perangkat KUT yang benar (keyboatd sedang diuji). Ini adalah bagian paling penting dan dalam beberapa kasus juga merupakan bagian tersulit dari prosedur pengujian.
Untungnya ada modalitas deteksi otomatis yang dibantu pengguna. Ini memerlukan penyambungan KUT (keyboaard yang sedang diuji) jika KUT belum tersambung. Jika KUT sudah tersambung, diperlukan penyambungan kembali. Fungsi autodetection mengawasi sistem saat KUT terhubung dan kemudian dapat mengidentifikasi id xinput secara otomatis. Namun, dalam beberapa kasus, dua perangkat dibuat oleh HAL, sehingga deteksi otomatis tidak dapat memilih. Kemudian yang pertama dipilih dengan deteksi otomatis. Jika ini bukan yang benar, Anda harus memberikan xinput id secara manual sebagai parameter baris perintah:
> kbd-tst.py 12
File tata letak adalah representasi visual seni ASCII sederhana dari tata letak keyboard fisik. Setiap kunci diwakili oleh tanda kurung siku dengan label kunci di dalamnya dibungkus dengan spasi, misalnya: kunci dengan nomor satu direpresentasikan sebagai [ 1 ] yang secara visual terlihat seperti keycap. File tata letak ini dimuat, diurai (kesalahan penguraian ditampilkan jika ada) dan kemudian juga digunakan untuk umpan balik visual di layar. Periksa file tata letak yang disediakan untuk detailnya (apple.lay, at101.lay)
Nama file tata letak yang diperlukan untuk dimuat harus ditentukan sebagai parameter:
> kbd-tst.py at101.lay
Jika tidak ada parameter file tata letak yang disediakan, file tata letak pertama dalam direktori akan diambil. Ini berguna jika hanya ada satu file di direktori.
Legenda tombol dalam file tata letak harus dapat diterjemahkan dengan kamus rev_xmodmap di kelas Tata Letak. Hal ini memungkinkan penggunaan label tombol yang lebih pendek untuk mendesain tata letak keyboard ASCII dengan benar. Jika label tombol dari file tata letak tidak memiliki entri di kamus rev_xmodmap, pesan kesalahan ditampilkan. Pengujian akan dilanjutkan, tetapi tidak ada cara untuk menguji semua kunci. Oleh karena itu eksekusi tersebut akan diakhiri dengan peringatan (kuning/oranye) (lihat tangkapan layar di bawah dengan peringatan tentang pemuatan tata letak dan laporan pengujian).
Jangan ragu untuk menyumbangkan file tata letak spesifik Anda ke dalam direktori tata letak ...
Di akhir pengujian, laporan satu baris dengan ringkasan dihasilkan:
File-file berikut:
Semoga membantu...
versi 2017.07.27 - rilis GitHub awal pada tahun 2017
kata kunci : keyboard, test, kbdtst, layout, kbd-tst, python, xinput, xmodmap
