Package com.ctre.phoenix6

Class HootReplay

java.lang.Object
com.ctre.phoenix6.HootReplay
public class HootReplay extends Object
Static class for controlling Phoenix 6 hoot log replay.

This replays all signals in the given hoot log in simulation. Hoot logs can be created by a robot program using SignalLogger. Only one hoot log, corresponding to one CAN bus, may be replayed at a time.

During replay, all transmits from the robot program are ignored. This includes features such as control requests, configs, and setting signal update frequency. Additionally, Tuner X is not functional during log replay.

To use Hoot Replay, call loadFile(String) before any devices are constructed to load a hoot file and start replay. Alternatively, the CANBus(String, String) constructor can be used when constructing devices.

After devices are constructed, Hoot Replay can be controlled using play(), pause(), stop(), and restart(). Additionally, Hoot Replay supports stepTiming(double) while paused. The current file can be closed using closeFile(), after which a new file may be loaded.

  • Constructor Details

  • Method Details

    • loadFile

      public static StatusCode loadFile(String filepath)
      Loads the given file and starts signal log replay. Only one hoot log, corresponding to one CAN bus, may be replayed at a time.

      This must be called before constructing any devices or checking CAN bus status. The CANBus(String, String) constructor can be used when constructing devices to guarantee that this API is called first.

      When using relative paths, the file path is typically relative to the top-level folder of the robot project.

      This API is blocking on the file read.

      Parameters:
      filepath - Path and name of the hoot file to load
      Returns:
      Status of opening and reading the file for replay
      Throws:
      IllegalArgumentException - The file is invalid, unlicensed, or targets a different version of Phoenix 6

    • closeFile

      public static void closeFile()
      Ends the hoot log replay. This stops the replay if it is running, closes the hoot log, and clears all signals read from the file.

    • isFileLoaded

      public static boolean isFileLoaded()
      Gets whether a valid hoot log file is currently loaded.
      Returns:
      true if a valid hoot log file is loaded

    • play

      public static StatusCode play()
      Starts or resumes the hoot log replay.
      Returns:
      Status of starting or resuming replay

    • pause

      public static StatusCode pause()
      Pauses the hoot log replay. This maintains the current position in the log replay so it can be resumed later.
      Returns:
      Status of pausing replay

    • stop

      public static StatusCode stop()
      Stops the hoot log replay. This resets the current position in the log replay to the start.
      Returns:
      Status of stopping replay

    • restart

      public static StatusCode restart()
      Restarts the hoot log replay from the start of the log. This is equivalent to calling stop() followed by play().
      Returns:
      Status of restarting replay

    • isPlaying

      public static boolean isPlaying()
      Gets whether hoot log replay is actively playing.

      This API will return true in programs that do not support replay, making it safe to call without first checking if the program supports replay.

      Returns:
      true if replay is playing back signals

    • waitForPlaying

      public static boolean waitForPlaying(double timeoutSeconds)
      Waits until hoot log replay is actively playing.

      This API will immediately return true in programs that do not support replay, making it safe to call without first checking if the program supports replay.

      Since this can block the calling thread, this should not be called with a non-zero timeout on the main thread.

      This can also be used with a timeout of 0 to perform a non-blocking check, which is equivalent to isPlaying().

      Parameters:
      timeoutSeconds - Max time to wait for replay to start playing
      Returns:
      true if replay is playing back signals

    • setSpeed

      public static void setSpeed(double speed)
      Sets the speed of the hoot log replay. A speed of 1.0 corresponds to replaying the file in real time, and larger values increase the speed.
      • Minimum Value: 0.01
      • Maximum Value: 100.0
      • Default Value: 1.0
      Parameters:
      speed - Speed of the hoot log replay

    • stepTiming

      public static StatusCode stepTiming(double stepTimeSeconds)
      Advances the hoot log replay time by the given value. Replay must be paused or stopped before advancing its time.
      Parameters:
      stepTimeSeconds - The amount of time to advance
      Returns:
      Status of advancing the replay time

    • getRaw

      public static HootReplay.SignalData<byte[]> getRaw(String name)
      Gets a raw-bytes user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getBoolean

      public static HootReplay.SignalData<Boolean> getBoolean(String name)
      Gets a boolean user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getInteger

      public static HootReplay.SignalData<Long> getInteger(String name)
      Gets an integer user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getFloat

      public static HootReplay.SignalData<Float> getFloat(String name)
      Gets a float user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getDouble

      public static HootReplay.SignalData<Double> getDouble(String name)
      Gets a double user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getString

      public static HootReplay.SignalData<String> getString(String name)
      Gets a string user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getBooleanArray

      public static HootReplay.SignalData<boolean[]> getBooleanArray(String name)
      Gets a boolean user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getIntegerArray

      public static HootReplay.SignalData<long[]> getIntegerArray(String name)
      Gets a boolean array user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getFloatArray

      public static HootReplay.SignalData<float[]> getFloatArray(String name)
      Gets a float array user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal

    • getDoubleArray

      public static HootReplay.SignalData<double[]> getDoubleArray(String name)
      Gets a double array user signal.
      Parameters:
      name - Name of the signal
      Returns:
      Structure with all information about the signal