StarPilot/tools/joystick/joystick_control.py

#!/usr/bin/env python3
import os
import time
import argparse
import threading
import numpy as np
import inputs
from inputs import UnpluggedError, get_gamepad

from cereal import messaging
from openpilot.common.params import Params
from openpilot.common.realtime import Ratekeeper
from openpilot.common.swaglog import cloudlog
from openpilot.system.hardware import HARDWARE
from openpilot.tools.lib.kbhit import KBHit

EXPO = 0.4

# Per-controller config keyed on a substring of the `inputs` gamepad name.
# accel = right stick vertical (up = gas). Axis codes and raw ranges (signed vs
# unsigned) differ per pad — use tools/joystick/joystick_probe.py to add one.
CONTROLLER_PROFILES = {
  'Stadia':    {'name': 'Stadia',    'steer': 'ABS_X', 'accel': 'ABS_RZ', 'lo': 0.,      'hi': 255.},
  'X-Box':     {'name': 'Xbox',      'steer': 'ABS_X', 'accel': 'ABS_RY', 'lo': -32768., 'hi': 32767.},
  'DualSense': {'name': 'DualSense', 'steer': 'ABS_X', 'accel': 'ABS_RY', 'lo': 0.,      'hi': 255.},
}
DEFAULT_PROFILE = 'X-Box'


class Keyboard:
  def __init__(self):
    self.kb = KBHit()
    self.axis_increment = 0.05  # 5% of full actuation each key press
    self.axes_map = {'w': 'gb', 's': 'gb',
                     'a': 'steer', 'd': 'steer'}
    self.axes_values = {'gb': 0., 'steer': 0.}
    self.axes_order = ['gb', 'steer']
    self.cancel = False

  def update(self):
    key = self.kb.getch().lower()
    self.cancel = False
    if key == 'r':
      self.axes_values = dict.fromkeys(self.axes_values, 0.)
    elif key == 'c':
      self.cancel = True
    elif key in self.axes_map:
      axis = self.axes_map[key]
      incr = self.axis_increment if key in ['w', 'a'] else -self.axis_increment
      self.axes_values[axis] = float(np.clip(self.axes_values[axis] + incr, -1, 1))
    else:
      return False
    return True


class Joystick:
  def __init__(self):
    self.cancel_button = 'BTN_NORTH'
    self.is_pc = HARDWARE.get_device_type() == 'pc'
    self._last_scan = 0.
    self._load_profile()

  def _load_profile(self):
    if self.is_pc:
      # DualSense over a laptop for development
      accel_axis, steer_axis = 'ABS_Z', 'ABS_RX'
      self.flip_map = {'ABS_RZ': accel_axis}
      raw_min, raw_max, self.deadzone = 0., 255., 0.03
      name, prof_name = 'pc', 'pc'
    else:
      name = inputs.devices.gamepads[0].name if inputs.devices.gamepads else ''
      prof = next((p for key, p in CONTROLLER_PROFILES.items() if key in name), CONTROLLER_PROFILES[DEFAULT_PROFILE])
      accel_axis, steer_axis = prof['accel'], prof['steer']
      self.flip_map = {}
      raw_min, raw_max, self.deadzone = prof['lo'], prof['hi'], 0.10
      prof_name = prof['name']

    cloudlog.info(f"joystick_control: gamepad='{name}' using profile '{prof_name}'")
    self.min_axis_value = {accel_axis: raw_min, steer_axis: raw_min}
    self.max_axis_value = {accel_axis: raw_max, steer_axis: raw_max}
    self.axes_values = {accel_axis: 0., steer_axis: 0.}
    self.axes_order = [accel_axis, steer_axis]
    self.cancel = False

  def _rescan(self):
    # `inputs` enumerates /dev/input once at import, so a pad that wasn't ready at boot (or was
    # hot-swapped) never gets read. Re-scan so it's picked up without a restart. Throttled to 1s.
    now = time.monotonic()
    if now - self._last_scan < 1.0:
      return
    self._last_scan = now
    inputs.devices = inputs.DeviceManager()
    if not self.is_pc and inputs.devices.gamepads:
      self._load_profile()

  def update(self):
    try:
      joystick_event = get_gamepad()[0]
    except (OSError, UnpluggedError):
      self.axes_values = dict.fromkeys(self.axes_values, 0.)
      self._rescan()
      time.sleep(0.1)  # no controller; avoid busy-spin
      return False

    event = (joystick_event.code, joystick_event.state)

    if event[0] in self.flip_map:
      event = (self.flip_map[event[0]], -event[1])

    if event[0] == self.cancel_button:
      if event[1] == 1:
        self.cancel = True
      elif event[1] == 0:   # state 0 is falling edge
        self.cancel = False
    elif event[0] in self.axes_values:
      norm = -float(np.interp(event[1], [self.min_axis_value[event[0]], self.max_axis_value[event[0]]], [-1., 1.]))
      norm = norm if abs(norm) > self.deadzone else 0.  # center can be noisy
      self.axes_values[event[0]] = EXPO * norm ** 3 + (1 - EXPO) * norm  # less action near center for fine control
    else:
      return False
    return True


def send_thread(joystick):
  pm = messaging.PubMaster(['testJoystick'])

  rk = Ratekeeper(100, print_delay_threshold=None)

  while True:
    if rk.frame % 20 == 0:
      print('\n' + ', '.join(f'{name}: {round(v, 3)}' for name, v in joystick.axes_values.items()))

    # _rescan() may swap the axis map from another thread
    values, order = joystick.axes_values, joystick.axes_order
    joystick_msg = messaging.new_message('testJoystick')
    joystick_msg.valid = True
    joystick_msg.testJoystick.axes = [values.get(ax, 0.) for ax in order]

    pm.send('testJoystick', joystick_msg)

    rk.keep_time()


def joystick_control_thread(joystick):
  Params().put_bool('JoystickDebugMode', True)
  threading.Thread(target=send_thread, args=(joystick,), daemon=True).start()
  while True:
    joystick.update()


def main():
  joystick_control_thread(Joystick())


if __name__ == '__main__':
  parser = argparse.ArgumentParser(description='Publishes events from your joystick to control your car.\n' +
                                               'openpilot must be offroad before starting joystick_control. This tool supports ' +
                                               'a PlayStation 5 DualSense controller on the comma 3X.',
                                   formatter_class=argparse.ArgumentDefaultsHelpFormatter)
  parser.add_argument('--keyboard', action='store_true', help='Use your keyboard instead of a joystick')
  args = parser.parse_args()

  if not Params().get_bool("IsOffroad") and "ZMQ" not in os.environ:
    print("The car must be off before running joystick_control.")
    exit()

  print()
  if args.keyboard:
    print('Gas/brake control: `W` and `S` keys')
    print('Steering control: `A` and `D` keys')
    print('Buttons')
    print('- `R`: Resets axes')
    print('- `C`: Cancel cruise control')
  else:
    print('Using joystick, make sure to run cereal/messaging/bridge on your device if running over the network!')
    print('If not running on a comma device, the mapping may need to be adjusted.')

  joystick = Keyboard() if args.keyboard else Joystick()
  joystick_control_thread(joystick)