v1.2.0

[CameronMyhre]

GitHub Release Notes: RobotCode2025 v1.2.0

We are excited to announce v1.2.0, a release that includes significant enhancements to the vision system, odometry, subsystem architecture, and overall code quality. This update also introduces new subsystems and utility features, ensuring better performance and a streamlined development process. Below is the comprehensive breakdown of changes included in this release.

Changelog

🚀 New Features

• Vision Odometry Integration
  • Added VisionOdometry class to integrate vision-based pose estimates with drivetrain odometry.
  • Enhanced PhotonVisionCamera for improved pose estimation.
  • Constants updated with a new pose strategy for PhotonPoseEstimator.
  • Modified RobotContainer to include the VisionOdometry subsystem and camera setup.
  • DriveSubsystem now includes a method to retrieve the SwerveDrivePoseEstimator.
• LED Manager and Configurations
  • Introduced the LEDManager class to manage LED patterns dynamically.
  • Added an LEDConfiguration enum for customizable LED states.
  • Organized subsystems with LEDManager for consistent architecture.
• Unified Vision and Drive Odometry
  • Combined odometry updates for vision and drivetrain for seamless pose estimation.
  • Improved thread safety with a synchronized getRobotPose() method.
• Narwhal Mechanisms
  • Added subsystems for the Narwhal Intake-Outtake and Narwhal Wrist Mechanism, including temporary constants for control positions.
  • Updated comments and documentation for clarity and maintainability.
• Improved Drive Speeds
  • Increased drive speeds and accelerations to theoretical limits, fully tested for reliability and performance.

🛠️ Enhancements

• Vision System Improvements
  • Introduced camera stream forwarding using PortForwarder, enabling live camera streams via the robot’s network.
  • Added constants for multiple camera setups, including front and side cameras, to enhance vision system flexibility.
  • Incorporated new pose estimation strategies and Transform3d imports for better positioning and fallback mechanisms.
• Field Debugging and Display
  • Integrated Field2d for visual debugging of robot positions on the SmartDashboard.
  • Improved periodic methods in DriveSubsystem and VisionOdometry for consistent pose updates.
• Restructured Utilities and Autonomous Configuration
  • Moved Alliance and AutonomousRoutine enums to a new Autonomous package for better organization.
  • Updated imports and configurations in the main container.

📝 Code Quality

• Documentation and Comments
  • Enhanced Javadoc comments across multiple classes, including DriveSubsystem, SwerveModule, and utility classes.
  • Added author tags and version information for improved traceability.
  • Reorganized subsystem documentation for clarity.
• Style Improvements
  • Removed debug print statements from the vision and drive subsystems to clean up console output.
  • Reformatted comments for better readability and consistency.
  • Improved variable naming conventions and removed unused imports.
• Thread Safety
  • Added synchronization to getRobotPose to prevent concurrency issues.

🐛 Bug Fixes

• AprilTag Field Layout
  • Updated AprilTag field layout from 2024Crescendo to 2025Reefscape for current season compatibility.
• Configuration and Constants
  • Resolved duplicate constant declarations in the configuration files.
• GitHub Actions Fixes
  • Addressed issues with Gradle builds, SpotBugs analysis, and PMD reports.

Usage Notes

For Drive Team:

• Vision and Odometry
  • The updated vision system integrates seamlessly with odometry, enhancing autonomous accuracy. Ensure the PhotonVision system is calibrated correctly on the field.
  • Use the SmartDashboard’s Field2d visualization for real-time debugging of robot positions.
• LED Configurations
  • LED patterns can now be dynamically managed. Patterns will indicate the current robot state or match phase for better situational awareness.
• Drive Performance
  • With increased drive speeds and acceleration limits, expect faster and more responsive robot movements. Test in practice matches to ensure consistency.

For Developers:

• Subsystem Enhancements
  • The new LEDManager and Narwhal subsystems offer extensibility for future updates. Review these implementations for consistency with team architecture.
• Code Maintenance
  • Javadoc comments and reorganized utilities make the codebase more maintainable. Follow the updated conventions for future contributions.
  • Utilize Field2d and SmartDashboard visualizations for debugging complex autonomous routines.

---

This discussion was created from the release v1.2.0.