Esperto Wiimote

[!IMPORTANT] Diese Software benötigt einen aktualisierten/gefixten Wiimote-Kernel-Treiber, der hier zu finden ist.

Führen Sie nach der Installation sudo sed -i '/ATTR{inhibited}="1"/s/^/#/' /etc/udev/rules.d/99-wiimote.rules aus, um IR- und Beschleunigungsmesser-Ereignisse zu entsperren.

Basiert auf dem Eingabesystem esperto, ist esperto-wiimote ein fortschrittlicher Wiimote-Mapper. Es bietet präzise Beschleunigungsmesser-Kalibrierung, gutes IR-Tracking und leistungsstarke Neubelegungsoptionen mit Kombo-Unterstützung. Es fügt praktisch keine Latenz hinzu, die größtenteils von der evdev/uinput-API des Kernels selbst dominiert wird.

Dieses Programm enthält einen Port++ von Hector Martins 2-Punkt-IR-Tracking-Algorithmus, beigelegt als Referenz.

Verfügbar auf crates.io.

Konfigurationsoptionen

Die Konfigurationsdatei wird mit --config <FILE> angegeben. Wenn nicht angegeben, lädt das Programm eine eingebaute Media-Remote-Standardkonfiguration, verfügbar unter src/default.yaml.

Hier ist ein Konfigurationsbeispiel mit Beschreibungen:

# Whether to grab the devices, so other software won't use them 
grab: false
# Command to run when the first Wiimote connects, as list of arguments
# Useful for automation like powering on the sensor bar
on_connect: [ "echo", "hello", "world" ]
# Command to run when thelast Wiimote disconnected, as list of arguments
# Useful for automation like powering off the sensor bar
on_disconnect: [ "echo", "goodbye", "world" ]
# Options for the output device slot. For each Wiimote there are four available slots, from `slot1` to `slot4`.
# Slots are useful to isolate mouse/keyboard/joysticks inputs
slots:
  slot1:
    # Name of the wirtual device
    name: "Esperto Wiimote mouse"
  slot2:
    name: "Esperto Wiimote keyboard"
    # Whether the device should autorepeat held keys, this might get overruled by the compositor
    repeating: true
# Accelerometer calibration data generated with the `esperto-wiimote calibration` command
accelerometer_calibration: [
  1.0014056, -0.011690015, 0.009826779,
  -0.02909683, 1.013545, 0.005751312,
  -0.010004735, -0.012316463, 0.99458194,
  28.481918, 33.827446, 30.468597 ]
# Margins of the mapped area. True margins are 0-4095 (regardless of screen resolution), but you will 
# want to exceed those to account for the aspect ratio, and the IR sensor not reaching all the way to the margins.
# The same scaling will be applied to all axes
screen_limits:
  north: -2000
  south: 6569
  west: -300
  east: 4395
# Center an axis when it gets enabled 
centering:
  # Axes can be specified by name...
  !Axis ABS_X: 2048
  # Or by their real integer id
  !CustomAxis 1: 2048
# Park an axis when it gets disabled
parking:
  !CustomAxis 0: 4095
  !Axis ABS_Y: 4095
# The physical dimensions of your sensorbar
sensor_bar:
  width: 19.5
  cluster_width: 4.5
  cluster_height: 1.0
  pixel_width: 256.0
# The smoothing parameters can be tuned
smoothing:
  radius: 30.0
  speed: 0.15
  deadzone: 8.0
# esperto combos configuration, check https://github.com/KayJay7/esperto for more information
esperto:
  modifiers:
    - name: pointer
      keys: [ B ]
  actions:
    - key: A
      action:
        # Actions must specify their output slot
        slot: Slot2
        # Keys can be specified by name...
        code: !Key KEY_SPACE
      modified:
        - modifier: pointer
          action:
            slot: Slot1
            # Or by their integer id
            code: !CustomKey 0x110

Die vollständige Liste der verfügbaren Wiimote-Tasten ist:

• A
• B
• Up
• Down
• Left
• Right
• Plus
• Minus
• Home
• Btn1
• Btn2

Und Achsen:

• IRAbsX
• IRAbsY

Die vollständige Liste der verfügbaren Ausgabecodes finden Sie hier. Falls ein Scancode-Name nicht erkannt wird, funktioniert die numerische ID trotzdem.

Kalibrierung

Ein Kalibrierungsassistent für den Beschleunigungsmesser kann durch Ausführen von esperto-wiimote calibration gestartet werden.

Sie müssen die Wiimote wie aufgefordert auf ihre 6 Seiten legen und warten, bis das Werkzeug genügend Messwerte gesammelt hat. Die Ausgabe wird zur Konfigurationsdatei hinzugefügt (falls angegeben), andernfalls auf dem Bildschirm ausgegeben. Einige erweiterte Überschreibungen können bei Bedarf als Argumente angegeben werden.

Wir empfehlen dringend, Ihre Wiimote vor der Verwendung dieses Programms zu kalibrieren, da der Beschleunigungsmesser sonst ziemlich unzuverlässig sein kann. Es ist besser, zu kalibrieren, nachdem die Fernbedienung ihre normale Betriebstemperatur erreicht hat. Denken Sie daran, dass die Sensorwerte mit der Zeit und bei Temperaturänderungen leicht driften, aber eine erneute Kalibrierung wird wahrscheinlich nicht erforderlich sein, da die Software den Drift berücksichtigt.

Roadmap

• Vollständige Pointer- und Tastenunterstützung
• Beschleunigungsmesser-Kalibrierung
• Vollständige Kombo-Unterstützung
• Multi-Geräte-Unterstützung
• KeyCombos als Ausgabeereignisse
• Wiimote-Erweiterungen (Nunchuck usw.)