Files
goSportpunktetafel/docs/usb.md
T

64 lines
1.3 KiB
Markdown

# 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.