M2: USB-Tastatur-Handling - evdev-Integration, Scancode-Mapping, Tests, systemd-Service, Dokumentation
This commit is contained in:
@@ -0,0 +1,55 @@
|
||||
package usb
|
||||
|
||||
// Linux input event codes for the keys we care about.
|
||||
const (
|
||||
KEY_SLASH = 1 // '/' key
|
||||
KEY_ASTERISK = 55 // '*' key
|
||||
KEY_PLUS = 78 // '+' key
|
||||
KEY_MINUS = 12 // '-' key
|
||||
)
|
||||
|
||||
// KeyToChar maps a Linux scancode to its character/action.
|
||||
// Returns the character and whether it's a valid input key.
|
||||
func KeyToChar(code uint16, eventType string) (string, bool) {
|
||||
if eventType == "release" {
|
||||
return "", false
|
||||
}
|
||||
|
||||
switch code {
|
||||
case KEY_SLASH:
|
||||
return "/", true
|
||||
case KEY_ASTERISK:
|
||||
return "*", true
|
||||
case KEY_PLUS:
|
||||
return "+", true
|
||||
case KEY_MINUS:
|
||||
return "-", true
|
||||
}
|
||||
|
||||
return "", false
|
||||
}
|
||||
|
||||
// ScanToAction maps a Linux scancode to a logical action.
|
||||
type Action string
|
||||
|
||||
const (
|
||||
ActionScoreRed Action = "red"
|
||||
ActionScoreGreen Action = "green"
|
||||
ActionNextRound Action = "next"
|
||||
ActionReset Action = "reset"
|
||||
)
|
||||
|
||||
// ScanToAction returns the logical action for a given scancode.
|
||||
func ScanToAction(code uint16) (Action, bool) {
|
||||
switch code {
|
||||
case KEY_SLASH:
|
||||
return ActionScoreRed, true
|
||||
case KEY_ASTERISK:
|
||||
return ActionScoreGreen, true
|
||||
case KEY_PLUS:
|
||||
return ActionNextRound, true
|
||||
case KEY_MINUS:
|
||||
return ActionReset, true
|
||||
}
|
||||
return "", false
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
package usb
|
||||
|
||||
import "testing"
|
||||
|
||||
func TestKeyToChar(t *testing.T) {
|
||||
tests := []struct {
|
||||
name string
|
||||
code uint16
|
||||
eventType string
|
||||
want string
|
||||
wantOK bool
|
||||
}{
|
||||
{"slash press", KEY_SLASH, "press", "/", true},
|
||||
{"slash release", KEY_SLASH, "release", "", false},
|
||||
{"asterisk press", KEY_ASTERISK, "press", "*", true},
|
||||
{"asterisk release", KEY_ASTERISK, "release", "", false},
|
||||
{"plus press", KEY_PLUS, "press", "+", true},
|
||||
{"minus press", KEY_MINUS, "press", "-", true},
|
||||
{"unknown key", 42, "press", "", false},
|
||||
{"unknown code release", 42, "release", "", false},
|
||||
}
|
||||
|
||||
for _, tt := range tests {
|
||||
t.Run(tt.name, func(t *testing.T) {
|
||||
got, ok := KeyToChar(tt.code, tt.eventType)
|
||||
if ok != tt.wantOK {
|
||||
t.Errorf("KeyToChar() ok = %v, want %v", ok, tt.wantOK)
|
||||
}
|
||||
if got != tt.want {
|
||||
t.Errorf("KeyToChar() = %q, want %q", got, tt.want)
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
func TestScanToAction(t *testing.T) {
|
||||
tests := []struct {
|
||||
name string
|
||||
code uint16
|
||||
want Action
|
||||
wantOK bool
|
||||
}{
|
||||
{"slash -> red", KEY_SLASH, ActionScoreRed, true},
|
||||
{"asterisk -> green", KEY_ASTERISK, ActionScoreGreen, true},
|
||||
{"plus -> next", KEY_PLUS, ActionNextRound, true},
|
||||
{"minus -> reset", KEY_MINUS, ActionReset, true},
|
||||
{"unknown", 42, "", false},
|
||||
}
|
||||
|
||||
for _, tt := range tests {
|
||||
t.Run(tt.name, func(t *testing.T) {
|
||||
got, ok := ScanToAction(tt.code)
|
||||
if ok != tt.wantOK {
|
||||
t.Errorf("ScanToAction() ok = %v, want %v", ok, tt.wantOK)
|
||||
}
|
||||
if got != tt.want {
|
||||
t.Errorf("ScanToAction() = %v, want %v", got, tt.want)
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,132 @@
|
||||
// Package usb provides keyboard input handling via Linux evdev devices.
|
||||
package usb
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"os"
|
||||
|
||||
"github.com/gvalkov/golang-evdev"
|
||||
)
|
||||
|
||||
// Key represents a keyboard key event.
|
||||
type Key struct {
|
||||
Code uint16 // Linux input event code
|
||||
Type string // "press", "release"
|
||||
}
|
||||
|
||||
// Keyboard represents an input device (keyboard).
|
||||
type Keyboard struct {
|
||||
device *evdev.InputDevice
|
||||
}
|
||||
|
||||
// ScanForDevices finds all keyboard devices in /dev/input/.
|
||||
func ScanForDevices() ([]*evdev.InputDevice, error) {
|
||||
keyboards := make([]*evdev.InputDevice, 0)
|
||||
devices, err := evdev.ListInputDevices("event*")
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to list input devices: %w", err)
|
||||
}
|
||||
|
||||
for _, dev := range devices {
|
||||
// Use CapabilitiesFlat which maps int event type to []int codes
|
||||
if dev.CapabilitiesFlat == nil {
|
||||
continue
|
||||
}
|
||||
|
||||
keyCaps, ok := dev.CapabilitiesFlat[1] // EV_KEY = 1
|
||||
if !ok || len(keyCaps) == 0 {
|
||||
continue
|
||||
}
|
||||
|
||||
// Filter: only consider devices with standard keyboard keys
|
||||
hasSlash := false
|
||||
for _, code := range keyCaps {
|
||||
if code == 1 { // KEY_SLASH
|
||||
hasSlash = true
|
||||
break
|
||||
}
|
||||
}
|
||||
|
||||
if hasSlash {
|
||||
keyboards = append(keyboards, dev)
|
||||
}
|
||||
}
|
||||
|
||||
return keyboards, nil
|
||||
}
|
||||
|
||||
// OpenKeyboard opens a keyboard device at the given path.
|
||||
func OpenKeyboard(devicePath string) (*Keyboard, error) {
|
||||
dev, err := evdev.Open(devicePath)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to open %s: %w", devicePath, err)
|
||||
}
|
||||
|
||||
return &Keyboard{
|
||||
device: dev,
|
||||
}, nil
|
||||
}
|
||||
|
||||
// OpenFirstKeyboard opens the first available keyboard device.
|
||||
func OpenFirstKeyboard() (*Keyboard, error) {
|
||||
keyboards, err := ScanForDevices()
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
if len(keyboards) == 0 {
|
||||
return nil, fmt.Errorf("no keyboard devices found in /dev/input/")
|
||||
}
|
||||
|
||||
dev, err := evdev.Open(keyboards[0].Fn)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to open first keyboard %s: %w", keyboards[0].Fn, err)
|
||||
}
|
||||
|
||||
fmt.Fprintf(os.Stderr, "[usb] Using keyboard: %s (%s)\n", dev.Name, dev.Fn)
|
||||
|
||||
return &Keyboard{
|
||||
device: dev,
|
||||
}, nil
|
||||
}
|
||||
|
||||
// Close releases the keyboard device.
|
||||
func (kb *Keyboard) Close() error {
|
||||
if kb.device != nil {
|
||||
return kb.device.File.Close()
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// ReadKey reads the next key event from the keyboard.
|
||||
// Returns a Key struct or an error.
|
||||
func (kb *Keyboard) ReadKey() (*Key, error) {
|
||||
event, err := kb.device.ReadOne()
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to read event: %w", err)
|
||||
}
|
||||
|
||||
if event.Type != 1 { // EV_KEY
|
||||
// Not a key event, try to read again
|
||||
return kb.ReadKey()
|
||||
}
|
||||
|
||||
key := &Key{
|
||||
Code: event.Code,
|
||||
Type: "press",
|
||||
}
|
||||
|
||||
if event.Value == 0 {
|
||||
key.Type = "release"
|
||||
}
|
||||
|
||||
return key, nil
|
||||
}
|
||||
|
||||
// GetDeviceInfo returns information about the connected keyboard.
|
||||
func (kb *Keyboard) GetDeviceInfo() string {
|
||||
if kb.device == nil {
|
||||
return "no device"
|
||||
}
|
||||
return fmt.Sprintf("%s (%s)", kb.device.Name, kb.device.Fn)
|
||||
}
|
||||
Reference in New Issue
Block a user