M2: USB-Tastatur-Handling - evdev-Integration, Scancode-Mapping, Tests, systemd-Service, Dokumentation
This commit is contained in:
+63
@@ -0,0 +1,63 @@
|
||||
# USB-Tastatur-Handling
|
||||
|
||||
## Übersicht
|
||||
Das `internal/usb` Paket liest Tastatureingaben direkt von Linux evdev-Geräten (`/dev/input/event*`).
|
||||
|
||||
## Tasten-Mapping
|
||||
|
||||
| Linux Scan Code | Taste | Aktion |
|
||||
|-----------------|-------|--------|
|
||||
| 1 | `/` | +1 Punkt Rot |
|
||||
| 55 | `*` | +1 Punkt Grün |
|
||||
| 78 | `+` | Nächste Runde |
|
||||
| 12 | `-` | Reset (alle Runden löschen) |
|
||||
|
||||
## Nutzung
|
||||
|
||||
```go
|
||||
import "git.jlserver.de/goSportpunktetafel/internal/usb"
|
||||
|
||||
// Erste verfügbare Tastatur öffnen
|
||||
kb, err := usb.OpenFirstKeyboard()
|
||||
if err != nil {
|
||||
log.Fatal(err)
|
||||
}
|
||||
defer kb.Close()
|
||||
|
||||
// Tastatureingabe lesen
|
||||
key, err := kb.ReadKey()
|
||||
if err != nil {
|
||||
log.Fatal(err)
|
||||
}
|
||||
|
||||
// Scan Code zu Aktion mappen
|
||||
action, ok := usb.ScanToAction(key.Code)
|
||||
if !ok {
|
||||
continue // Unbekannte Taste
|
||||
}
|
||||
```
|
||||
|
||||
## Gerät finden
|
||||
|
||||
```go
|
||||
devices, err := usb.ScanForDevices()
|
||||
if err != nil {
|
||||
log.Fatal(err)
|
||||
}
|
||||
for _, dev := range devices {
|
||||
fmt.Printf("Keyboard: %s (%s)\n", dev.Name, dev.Fn)
|
||||
}
|
||||
```
|
||||
|
||||
## systemd-Service
|
||||
|
||||
Der Service erwartet einen User `sportscore`:
|
||||
|
||||
```bash
|
||||
sudo useradd -r -s /usr/bin/false sportscore
|
||||
sudo cp systemd/sportscore.service /etc/systemd/system/
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable --now sportscore
|
||||
```
|
||||
|
||||
Der Binary muss unter `/usr/local/bin/sportscore` installiert sein.
|
||||
Reference in New Issue
Block a user