diff options
Diffstat (limited to 'marsond.8')
| -rw-r--r-- | marsond.8 | 39 |
1 files changed, 32 insertions, 7 deletions
@@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "MARSOND" 8 "2025-05-09" "0.3.0" "Urchlay's Stuff" +.TH "MARSOND" 8 "2025-05-10" "0.3.0" "Urchlay's Stuff" .SH NAME marsond \- Fix Enter key timing on Marson/USBLink/MT606-1 PS/2-USB adaptors .SH SYNOPSIS @@ -126,6 +126,7 @@ the primary group of the user it\(aqs running as. Normally you won\(aqt have to set this. .UNINDENT .SH NOTES +.SS Hardware .sp The problem happens with any SDL application (SDL1 or SDL2), as well as other graphics libraries. It happens regardless of what PS/2 @@ -144,9 +145,28 @@ the back, the model number is "MT606\-1". It looks like: .UNINDENT .UNINDENT .sp -I\(aqm not sure if any other USB keyboard adaptors are affected. If you -have the problem on some other adaptor, and \fBmarsond\fP fixes it, -please contact me so I can add support for it in the future. +Confusingly enough, in \fBlsusb\fP(8) output, it shows up as: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +$ lsusb | grep 04b4:0101 +Bus 003 Device 006: ID 04b4:0101 Cypress Semiconductor Corp. Keyboard/Hub +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +The Bus and Device numbers may be different for you, it\(aqs the ID and +name that are important. +.sp +I\(aqm not sure if any other USB keyboard adaptors are affected. If +you have the problem on some other adaptor, try it with \fBmarsond\fP\&. +Use the \fB\-k\fP option to set the \fI/dev/input/by\-id\fP name of the device, +and run the daemon manually. If this fixes it please contact me so I +can add support for your adaptor in the future. +.SS Implementation .sp \fBmarsond\fP uses the Linux kernel\(aqs \fBuinput\fP layer to "grab" the keyboard, create a new virtual keyboard device, and pass events from @@ -156,8 +176,10 @@ before delivering it. .sp This should work with everything that uses the keyboard. It definitely does, with SDL 1 and 2 running under X (and SDL 1 on the console, -too). I don\(aqt use Wayland, so I haven\(aqt tested it there. If you do, -please contact me and let me know if it works for you. +too). It should also work with Wayland, though I don\(aqt use Wayland, +so I haven\(aqt tested it there. If you do, please contact me and let me +know whether or not it works for you. +.SS Startup .sp \fBmarsond\fP must be run as root. At startup, it does these things as root: @@ -176,9 +198,12 @@ avoid slow response on a loaded system. After doing the above, root access is no longer needed, so it will drop privileges and run as the \fInobody\fP user by default (but see \fBENVIRONMENT\fP if you need a different user). +.SS Misc .sp While \fBmarsond\fP is running, "xinput \-\-list" will show an input -device called "marson virtual keyboard". +device called "marson virtual keyboard". Confusingly enough, it will +show up as both a pointer and a keyboard. This doesn\(aqt seem to hurt +anything, but it looks weird, doesn\(aqt it? .SH LIMITATIONS .sp Only one MT\-606\-1 device is supported, out of the box. This shouldn\(aqt |