Signal Logging#

Note

Information on how to retrieve and convert hoot files to compatible formats can be found in Extracting Signal Logs.

Phoenix 6 comes with a real-time, high-fidelity signal logger. This can be useful for any form of post analysis, including diagnosing issues after a match or using WPILib SysID.

The Phoenix 6 signal logger provides the following advantages over alternatives:

All status signals are captured automatically with their timestamps from CAN.
Status signals are captured as they arrive at their configured update frequency.
Logging is not affected by the timing of the main robot loop or Java GC, significantly improving the sensitivity and accuracy of system identification.
Signal logging is started automatically during an FRC match by default.
Custom user signals can be logged alongside the automatically captured status signals on the same timebase.
The highly efficient hoot file format minimizes the size of the log files and the CPU usage of the logger.

The signal logging API is available through static functions in the SignalLogger (Java, C++, Python) class. Signal logging is enabled by default whenever it detects an FRC match is currently being played. Users can disable this behavior with SignalLogger.enableAutoLogging(false) (Java, C++, Python).

Setting Log Path#

The logging directory can optionally be changed using SignalLogger.setPath() (Java, C++, Python). If the specified directory does not exist, SignalLogger.setPath() will return an error code. Setting the path while logging will restart the log.

The below example sets the logging path to a ctre-logs folder on the first USB drive found.

Java

SignalLogger.setPath("/media/sda1/ctre-logs/");

C++

SignalLogger::SetPath("/media/sda1/ctre-logs/");

Python

SignalLogger.set_path("/media/sda1/ctre-logs/")

Note

Each CAN bus gets its own dedicated log file.

Start/Stop Logging#

The signal logger can be started and stopped using the Start/Stop functions.

Java

SignalLogger.start();
SignalLogger.stop();

C++

SignalLogger::Start();
SignalLogger::Stop();

Python

SignalLogger.start()
SignalLogger.stop()

Writing Custom Signals#

Users can write custom signals to the currently opened logs by utilizing the write*() functions. An example application of this is logging your swerve odometry data.

The integer and floating-point write*() functions can optionally be supplied a units string to log alongside the data. Additionally, all write*() functions support an optional latency parameter that is subtracted from the current time to get the latency-adjusted timestamp of the signal. This can be useful for logging high-latency data, such as vision measurements.

Java

// Log the odometry pose as a double array
SignalLogger.writeDoubleArray("odometry", new double[] {pose.getX(), pose.getY(), pose.getRotation().getDegrees()});
// Log the odometry period with units of "seconds"
SignalLogger.writeDouble("odom period", state.OdometryPeriod, "seconds");
// Log the camera pose with calculated latency
SignalLogger.writeDoubleArray("camera pose", new double[] {camPose.getX(), camPose.getY(), camPose.getRotation().getDegrees()},
   "", Timer.getFPGATimestamp() - camRes.getTimestampSeconds());

C++

// Log the odometry pose as a double array
SignalLogger::WriteDoubleArray("odometry", std::array<double, 3>{pose.X().value(), pose.Y().value(), pose.Rotation().Degrees().value()});
// Log the odometry period with units of "seconds"
SignalLogger::WriteDouble("odom period", state.OdometryPeriod, "seconds");
// Log the camera pose with calculated latency
SignalLogger::WriteDoubleArray("camera pose", std::array<double, 3>{camPose.X().value(), camPose.Y().value(), camPose.Rotation().Degrees().value()},
   "", frc::Timer::GetFPGATimestamp() - camRes.GetTimestamp());

Python

# Log the odometry pose as a double array
SignalLogger.write_double_array("odometry", [pose.X(), pose.Y(), pose.rotation().degrees()])
# Log the odometry period with units of "seconds"
SignalLogger.write_double("odom period", state.odometry_period, "seconds")
# Log the camera pose with calculated latency
SignalLogger.write_double_array("camera pose", [cam_pose.X(), cam_pose.Y(), cam_pose.rotation().degrees()],
   "", wpilib.Timer.getFPGATimestamp() - cam_res.getTimestamp())

Free Signals#

Any log that contains a pro-licensed device will export all signals. Otherwise, the following status signals and all custom signals can be exported for free.

Low Storage Space Behavior#

If the target drive (i.e. flash drive or roboRIO internal storage) reaches 50 MB free space, old logs will be deleted, and a warning will be printed.

If the target drive reaches 5 MB of free space, logging will be stopped, and an error will be printed. Logging cannot be resumed until more disk space is made available.

An example error that may occur if the free space limit is reached is shown below.

[phoenix] Signal Logger: Available disk space (3 MB) below 5 MB, stopping log