Class NiDsPS4Controller

java.lang.Object
org.wpilib.driverstation.NiDsPS4Controller
All Implemented Interfaces:
HIDDevice, TelemetryLoggable
public class NiDsPS4Controller extends Object implements HIDDevice, TelemetryLoggable
Handle input from NiDsPS4 controllers connected to the Driver Station.

This class handles NiDsPS4 input that comes from the Driver Station. Each time a value is requested the most recent value is returned. There is a single class instance for each controller and the mapping of ports to hardware buttons depends on the code in the Driver Station.

Only first party controllers from Sony are guaranteed to have the correct mapping, and only through the official NI DS. Sim is not guaranteed to have the same mapping, as well as any 3rd party controllers.

  • Constructor Details

    • NiDsPS4Controller

      public NiDsPS4Controller(int port)
      Construct an instance of a controller.
      Parameters:
      port - The port index on the Driver Station that the controller is plugged into (0-5).

    • NiDsPS4Controller

      public NiDsPS4Controller(GenericHID hid)
      Construct an instance of a controller with a GenericHID object.
      Parameters:
      hid - The GenericHID object to use for this controller.

  • Method Details

    • getHID

      public GenericHID getHID()
      Get the underlying GenericHID object.
      Specified by:
      getHID in interface HIDDevice
      Returns:
      the wrapped GenericHID object

    • getLeftX

      public double getLeftX()
      Get the X axis value of left side of the controller. Right is positive.
      Returns:
      The axis value.

    • getLeftY

      public double getLeftY()
      Get the Y axis value of left side of the controller. Back is positive.
      Returns:
      The axis value.

    • getRightX

      public double getRightX()
      Get the X axis value of right side of the controller. Right is positive.
      Returns:
      The axis value.

    • getRightY

      public double getRightY()
      Get the Y axis value of right side of the controller. Back is positive.
      Returns:
      The axis value.

    • getL2Axis

      public double getL2Axis()
      Get the left trigger 2 axis value of the controller. Note that this axis is bound to the range of [0, 1] as opposed to the usual [-1, 1].
      Returns:
      The axis value.

    • getR2Axis

      public double getR2Axis()
      Get the right trigger 2 axis value of the controller. Note that this axis is bound to the range of [0, 1] as opposed to the usual [-1, 1].
      Returns:
      The axis value.

    • getSquareButton

      public boolean getSquareButton()
      Read the value of the square button on the controller.
      Returns:
      The state of the button.

    • getSquareButtonPressed

      public boolean getSquareButtonPressed()
      Whether the square button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getSquareButtonReleased

      public boolean getSquareButtonReleased()
      Whether the square button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • square

      public BooleanEvent square(EventLoop loop)
      Constructs an event instance around the square button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the square button's digital signal attached to the given loop.

    • getCrossButton

      public boolean getCrossButton()
      Read the value of the cross button on the controller.
      Returns:
      The state of the button.

    • getCrossButtonPressed

      public boolean getCrossButtonPressed()
      Whether the cross button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getCrossButtonReleased

      public boolean getCrossButtonReleased()
      Whether the cross button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • cross

      public BooleanEvent cross(EventLoop loop)
      Constructs an event instance around the cross button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the cross button's digital signal attached to the given loop.

    • getCircleButton

      public boolean getCircleButton()
      Read the value of the circle button on the controller.
      Returns:
      The state of the button.

    • getCircleButtonPressed

      public boolean getCircleButtonPressed()
      Whether the circle button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getCircleButtonReleased

      public boolean getCircleButtonReleased()
      Whether the circle button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • circle

      public BooleanEvent circle(EventLoop loop)
      Constructs an event instance around the circle button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the circle button's digital signal attached to the given loop.

    • getTriangleButton

      public boolean getTriangleButton()
      Read the value of the triangle button on the controller.
      Returns:
      The state of the button.

    • getTriangleButtonPressed

      public boolean getTriangleButtonPressed()
      Whether the triangle button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getTriangleButtonReleased

      public boolean getTriangleButtonReleased()
      Whether the triangle button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • triangle

      public BooleanEvent triangle(EventLoop loop)
      Constructs an event instance around the triangle button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the triangle button's digital signal attached to the given loop.

    • getL1Button

      public boolean getL1Button()
      Read the value of the left trigger 1 button on the controller.
      Returns:
      The state of the button.

    • getL1ButtonPressed

      public boolean getL1ButtonPressed()
      Whether the left trigger 1 button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getL1ButtonReleased

      public boolean getL1ButtonReleased()
      Whether the left trigger 1 button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • L1

      public BooleanEvent L1(EventLoop loop)
      Constructs an event instance around the left trigger 1 button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the left trigger 1 button's digital signal attached to the given loop.

    • getR1Button

      public boolean getR1Button()
      Read the value of the right trigger 1 button on the controller.
      Returns:
      The state of the button.

    • getR1ButtonPressed

      public boolean getR1ButtonPressed()
      Whether the right trigger 1 button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getR1ButtonReleased

      public boolean getR1ButtonReleased()
      Whether the right trigger 1 button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • R1

      public BooleanEvent R1(EventLoop loop)
      Constructs an event instance around the right trigger 1 button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the right trigger 1 button's digital signal attached to the given loop.

    • getL2Button

      public boolean getL2Button()
      Read the value of the left trigger 2 button on the controller.
      Returns:
      The state of the button.

    • getL2ButtonPressed

      public boolean getL2ButtonPressed()
      Whether the left trigger 2 button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getL2ButtonReleased

      public boolean getL2ButtonReleased()
      Whether the left trigger 2 button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • L2

      public BooleanEvent L2(EventLoop loop)
      Constructs an event instance around the left trigger 2 button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the left trigger 2 button's digital signal attached to the given loop.

    • getR2Button

      public boolean getR2Button()
      Read the value of the right trigger 2 button on the controller.
      Returns:
      The state of the button.

    • getR2ButtonPressed

      public boolean getR2ButtonPressed()
      Whether the right trigger 2 button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getR2ButtonReleased

      public boolean getR2ButtonReleased()
      Whether the right trigger 2 button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • R2

      public BooleanEvent R2(EventLoop loop)
      Constructs an event instance around the right trigger 2 button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the right trigger 2 button's digital signal attached to the given loop.

    • getShareButton

      public boolean getShareButton()
      Read the value of the share button on the controller.
      Returns:
      The state of the button.

    • getShareButtonPressed

      public boolean getShareButtonPressed()
      Whether the share button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getShareButtonReleased

      public boolean getShareButtonReleased()
      Whether the share button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • share

      public BooleanEvent share(EventLoop loop)
      Constructs an event instance around the share button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the share button's digital signal attached to the given loop.

    • getOptionsButton

      public boolean getOptionsButton()
      Read the value of the options button on the controller.
      Returns:
      The state of the button.

    • getOptionsButtonPressed

      public boolean getOptionsButtonPressed()
      Whether the options button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getOptionsButtonReleased

      public boolean getOptionsButtonReleased()
      Whether the options button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • options

      public BooleanEvent options(EventLoop loop)
      Constructs an event instance around the options button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the options button's digital signal attached to the given loop.

    • getL3Button

      public boolean getL3Button()
      Read the value of the L3 (left stick) button on the controller.
      Returns:
      The state of the button.

    • getL3ButtonPressed

      public boolean getL3ButtonPressed()
      Whether the L3 (left stick) button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getL3ButtonReleased

      public boolean getL3ButtonReleased()
      Whether the L3 (left stick) button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • L3

      public BooleanEvent L3(EventLoop loop)
      Constructs an event instance around the L3 (left stick) button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the L3 (left stick) button's digital signal attached to the given loop.

    • getR3Button

      public boolean getR3Button()
      Read the value of the R3 (right stick) button on the controller.
      Returns:
      The state of the button.

    • getR3ButtonPressed

      public boolean getR3ButtonPressed()
      Whether the R3 (right stick) button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getR3ButtonReleased

      public boolean getR3ButtonReleased()
      Whether the R3 (right stick) button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • R3

      public BooleanEvent R3(EventLoop loop)
      Constructs an event instance around the R3 (right stick) button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the R3 (right stick) button's digital signal attached to the given loop.

    • getPSButton

      public boolean getPSButton()
      Read the value of the PlayStation button on the controller.
      Returns:
      The state of the button.

    • getPSButtonPressed

      public boolean getPSButtonPressed()
      Whether the PlayStation button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getPSButtonReleased

      public boolean getPSButtonReleased()
      Whether the PlayStation button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • PS

      public BooleanEvent PS(EventLoop loop)
      Constructs an event instance around the PlayStation button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the PlayStation button's digital signal attached to the given loop.

    • getTouchpadButton

      public boolean getTouchpadButton()
      Read the value of the touchpad button on the controller.
      Returns:
      The state of the button.

    • getTouchpadButtonPressed

      public boolean getTouchpadButtonPressed()
      Whether the touchpad button was pressed since the last check.
      Returns:
      Whether the button was pressed since the last check.

    • getTouchpadButtonReleased

      public boolean getTouchpadButtonReleased()
      Whether the touchpad button was released since the last check.
      Returns:
      Whether the button was released since the last check.

    • touchpad

      public BooleanEvent touchpad(EventLoop loop)
      Constructs an event instance around the touchpad button's digital signal.
      Parameters:
      loop - the event loop instance to attach the event to.
      Returns:
      an event instance representing the touchpad button's digital signal attached to the given loop.

    • isConnected

      public boolean isConnected()
      Get if the controller is connected.
      Returns:
      true if the controller is connected

    • getGamepadType

      public GenericHID.HIDType getGamepadType()
      Get the type of the controller.
      Returns:
      the type of the controller.

    • getSupportedOutputs

      public EnumSet<GenericHID.SupportedOutput> getSupportedOutputs()
      Get the supported outputs of the controller.
      Returns:
      the supported outputs of the controller.

    • getName

      public String getName()
      Get the name of the controller.
      Returns:
      the name of the controller.

    • getPort

      public int getPort()
      Get the port number of the controller.
      Returns:
      The port number of the controller.

    • setRumble

      public void setRumble(GenericHID.RumbleType type, double value)
      Set the rumble output for the HID.

      The DS currently supports 4 rumble values: left rumble, right rumble, left trigger rumble, and right trigger rumble.

      Parameters:
      type - Which rumble value to set
      value - The normalized value (0 to 1) to set the rumble to

    • getTelemetryType

      public String getTelemetryType()
      Description copied from interface: TelemetryLoggable
      Gets the telemetry table type. Default is no specified table type (null). A mismatch in type during logging results in a reported warning, so this should always return the same value.
      Specified by:
      getTelemetryType in interface TelemetryLoggable
      Returns:
      Table type

    • logTo

      public void logTo(TelemetryTable table)
      Description copied from interface: TelemetryLoggable
      Logs the object to a TelemetryTable.
      Specified by:
      logTo in interface TelemetryLoggable
      Parameters:
      table - telemetry table