2020-12-26 14:12:05 -08:00
|
|
|
// Copyright (c) FIRST and other WPILib contributors.
|
|
|
|
|
// Open Source Software; you can modify and/or share it under the terms of
|
|
|
|
|
// the WPILib BSD license file in the root directory of this project.
|
2020-12-08 01:32:42 -05:00
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
2022-10-15 16:33:14 -07:00
|
|
|
#include <numbers>
|
|
|
|
|
|
2025-11-08 16:58:51 -08:00
|
|
|
#include "wpi/hardware/imu/OnboardIMU.hpp"
|
|
|
|
|
#include "wpi/hardware/motor/PWMSparkMax.hpp"
|
|
|
|
|
#include "wpi/hardware/rotation/Encoder.hpp"
|
|
|
|
|
#include "wpi/math/controller/PIDController.hpp"
|
|
|
|
|
#include "wpi/math/controller/SimpleMotorFeedforward.hpp"
|
|
|
|
|
#include "wpi/math/kinematics/DifferentialDriveKinematics.hpp"
|
|
|
|
|
#include "wpi/math/kinematics/DifferentialDriveOdometry.hpp"
|
2026-01-12 19:09:35 -08:00
|
|
|
#include "wpi/math/system/Models.hpp"
|
2025-11-08 16:58:51 -08:00
|
|
|
#include "wpi/simulation/DifferentialDrivetrainSim.hpp"
|
|
|
|
|
#include "wpi/simulation/EncoderSim.hpp"
|
|
|
|
|
#include "wpi/smartdashboard/Field2d.hpp"
|
|
|
|
|
#include "wpi/smartdashboard/SmartDashboard.hpp"
|
|
|
|
|
#include "wpi/units/angular_velocity.hpp"
|
|
|
|
|
#include "wpi/units/length.hpp"
|
|
|
|
|
#include "wpi/units/velocity.hpp"
|
2020-12-08 01:32:42 -05:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Represents a differential drive style drivetrain.
|
|
|
|
|
*/
|
|
|
|
|
class Drivetrain {
|
|
|
|
|
public:
|
|
|
|
|
Drivetrain() {
|
2025-10-10 15:44:39 -04:00
|
|
|
m_imu.ResetYaw();
|
2021-06-13 18:43:16 -04:00
|
|
|
|
2024-01-01 13:37:51 -08:00
|
|
|
m_leftLeader.AddFollower(m_leftFollower);
|
|
|
|
|
m_rightLeader.AddFollower(m_rightFollower);
|
|
|
|
|
|
2021-06-13 18:43:16 -04:00
|
|
|
// We need to invert one side of the drivetrain so that positive voltages
|
|
|
|
|
// result in both sides moving forward. Depending on how your robot's
|
|
|
|
|
// gearbox is constructed, you might have to invert the left side instead.
|
2024-01-01 13:37:51 -08:00
|
|
|
m_rightLeader.SetInverted(true);
|
2021-06-13 18:43:16 -04:00
|
|
|
|
2020-12-08 01:32:42 -05:00
|
|
|
// Set the distance per pulse for the drive encoders. We can simply use the
|
|
|
|
|
// distance traveled for one rotation of the wheel divided by the encoder
|
|
|
|
|
// resolution.
|
2022-10-15 16:33:14 -07:00
|
|
|
m_leftEncoder.SetDistancePerPulse(2 * std::numbers::pi * kWheelRadius /
|
2020-12-08 01:32:42 -05:00
|
|
|
kEncoderResolution);
|
2022-10-15 16:33:14 -07:00
|
|
|
m_rightEncoder.SetDistancePerPulse(2 * std::numbers::pi * kWheelRadius /
|
2020-12-08 01:32:42 -05:00
|
|
|
kEncoderResolution);
|
|
|
|
|
|
|
|
|
|
m_leftEncoder.Reset();
|
|
|
|
|
m_rightEncoder.Reset();
|
|
|
|
|
|
2024-01-01 13:37:51 -08:00
|
|
|
m_rightLeader.SetInverted(true);
|
2020-12-08 01:32:42 -05:00
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::SmartDashboard::PutData("Field", &m_fieldSim);
|
2020-12-08 01:32:42 -05:00
|
|
|
}
|
|
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
static constexpr wpi::units::meters_per_second_t kMaxSpeed =
|
2020-12-08 01:32:42 -05:00
|
|
|
3.0_mps; // 3 meters per second
|
2025-11-07 20:00:05 -05:00
|
|
|
static constexpr wpi::units::radians_per_second_t kMaxAngularSpeed{
|
2022-10-15 16:33:14 -07:00
|
|
|
std::numbers::pi}; // 1/2 rotation per second
|
2020-12-08 01:32:42 -05:00
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
void SetSpeeds(const wpi::math::DifferentialDriveWheelSpeeds& speeds);
|
|
|
|
|
void Drive(wpi::units::meters_per_second_t xSpeed,
|
|
|
|
|
wpi::units::radians_per_second_t rot);
|
2020-12-08 01:32:42 -05:00
|
|
|
void UpdateOdometry();
|
2025-11-07 20:00:05 -05:00
|
|
|
void ResetOdometry(const wpi::math::Pose2d& pose);
|
2020-12-08 01:32:42 -05:00
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::math::Pose2d GetPose() const { return m_odometry.GetPose(); }
|
2020-12-08 01:32:42 -05:00
|
|
|
|
|
|
|
|
void SimulationPeriodic();
|
2020-12-10 23:36:20 -05:00
|
|
|
void Periodic();
|
2020-12-08 01:32:42 -05:00
|
|
|
|
|
|
|
|
private:
|
2025-11-07 20:00:05 -05:00
|
|
|
static constexpr wpi::units::meter_t kTrackwidth = 0.381_m * 2;
|
2020-12-08 01:32:42 -05:00
|
|
|
static constexpr double kWheelRadius = 0.0508; // meters
|
|
|
|
|
static constexpr int kEncoderResolution = 4096;
|
|
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::PWMSparkMax m_leftLeader{1};
|
|
|
|
|
wpi::PWMSparkMax m_leftFollower{2};
|
|
|
|
|
wpi::PWMSparkMax m_rightLeader{3};
|
|
|
|
|
wpi::PWMSparkMax m_rightFollower{4};
|
2020-12-08 01:32:42 -05:00
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::Encoder m_leftEncoder{0, 1};
|
|
|
|
|
wpi::Encoder m_rightEncoder{2, 3};
|
2020-12-08 01:32:42 -05:00
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::math::PIDController m_leftPIDController{8.5, 0.0, 0.0};
|
|
|
|
|
wpi::math::PIDController m_rightPIDController{8.5, 0.0, 0.0};
|
2020-12-08 01:32:42 -05:00
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::OnboardIMU m_imu{wpi::OnboardIMU::kFlat};
|
2020-12-08 01:32:42 -05:00
|
|
|
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::math::DifferentialDriveKinematics m_kinematics{kTrackwidth};
|
|
|
|
|
wpi::math::DifferentialDriveOdometry m_odometry{
|
|
|
|
|
m_imu.GetRotation2d(), wpi::units::meter_t{m_leftEncoder.GetDistance()},
|
|
|
|
|
wpi::units::meter_t{m_rightEncoder.GetDistance()}};
|
2020-12-08 01:32:42 -05:00
|
|
|
|
|
|
|
|
// Gains are for example purposes only - must be determined for your own
|
|
|
|
|
// robot!
|
2025-11-07 20:01:58 -05:00
|
|
|
wpi::math::SimpleMotorFeedforward<wpi::units::meters> m_feedforward{
|
|
|
|
|
1_V, 3_V / 1_mps};
|
2020-12-08 01:32:42 -05:00
|
|
|
|
|
|
|
|
// Simulation classes help us simulate our robot
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::sim::EncoderSim m_leftEncoderSim{m_leftEncoder};
|
|
|
|
|
wpi::sim::EncoderSim m_rightEncoderSim{m_rightEncoder};
|
|
|
|
|
wpi::Field2d m_fieldSim;
|
|
|
|
|
wpi::math::LinearSystem<2, 2, 2> m_drivetrainSystem =
|
2026-01-12 19:09:35 -08:00
|
|
|
wpi::math::Models::DifferentialDriveFromSysId(
|
2021-06-05 11:22:05 -07:00
|
|
|
1.98_V / 1_mps, 0.2_V / 1_mps_sq, 1.5_V / 1_mps, 0.3_V / 1_mps_sq);
|
2025-11-07 20:00:05 -05:00
|
|
|
wpi::sim::DifferentialDrivetrainSim m_drivetrainSimulator{
|
|
|
|
|
m_drivetrainSystem, kTrackwidth, wpi::math::DCMotor::CIM(2), 8, 2_in};
|
2020-12-08 01:32:42 -05:00
|
|
|
};
|