// 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. #include "frc/simulation/SingleJointedArmSim.h" #include #include #include #include "frc/system/NumericalIntegration.h" #include "frc/system/plant/LinearSystemId.h" using namespace frc; using namespace frc::sim; SingleJointedArmSim::SingleJointedArmSim( const LinearSystem<2, 1, 1>& system, const DCMotor& gearbox, double gearing, units::meter_t armLength, units::radian_t minAngle, units::radian_t maxAngle, bool simulateGravity, const std::array& measurementStdDevs) : LinearSystemSim<2, 1, 1>(system, measurementStdDevs), m_armLen(armLength), m_minAngle(minAngle), m_maxAngle(maxAngle), m_gearbox(gearbox), m_gearing(gearing), m_simulateGravity(simulateGravity) {} SingleJointedArmSim::SingleJointedArmSim( const DCMotor& gearbox, double gearing, units::kilogram_square_meter_t moi, units::meter_t armLength, units::radian_t minAngle, units::radian_t maxAngle, bool simulateGravity, const std::array& measurementStdDevs) : SingleJointedArmSim( LinearSystemId::SingleJointedArmSystem(gearbox, moi, gearing), gearbox, gearing, armLength, minAngle, maxAngle, simulateGravity, measurementStdDevs) {} bool SingleJointedArmSim::WouldHitLowerLimit(units::radian_t armAngle) const { return armAngle <= m_minAngle; } bool SingleJointedArmSim::WouldHitUpperLimit(units::radian_t armAngle) const { return armAngle >= m_maxAngle; } bool SingleJointedArmSim::HasHitLowerLimit() const { return WouldHitLowerLimit(units::radian_t{m_y(0)}); } bool SingleJointedArmSim::HasHitUpperLimit() const { return WouldHitUpperLimit(units::radian_t{m_y(0)}); } units::radian_t SingleJointedArmSim::GetAngle() const { return units::radian_t{m_y(0)}; } units::radians_per_second_t SingleJointedArmSim::GetVelocity() const { return units::radians_per_second_t{m_x(1)}; } units::ampere_t SingleJointedArmSim::GetCurrentDraw() const { // Reductions are greater than 1, so a reduction of 10:1 would mean the motor // is spinning 10x faster than the output units::radians_per_second_t motorVelocity{m_x(1) * m_gearing}; return m_gearbox.Current(motorVelocity, units::volt_t{m_u(0)}) * wpi::sgn(m_u(0)); } void SingleJointedArmSim::SetInputVoltage(units::volt_t voltage) { SetInput(Vectord<1>{voltage.value()}); } Vectord<2> SingleJointedArmSim::UpdateX(const Vectord<2>& currentXhat, const Vectord<1>& u, units::second_t dt) { // The torque on the arm is given by τ = F⋅r, where F is the force applied by // gravity and r the distance from pivot to center of mass. Recall from // dynamics that the sum of torques for a rigid body is τ = J⋅α, were τ is // torque on the arm, J is the mass-moment of inertia about the pivot axis, // and α is the angular acceleration in rad/s². Rearranging yields: α = F⋅r/J // // We substitute in F = m⋅g⋅cos(θ), where θ is the angle from horizontal: // // α = (m⋅g⋅cos(θ))⋅r/J // // Multiply RHS by cos(θ) to account for the arm angle. Further, we know the // arm mass-moment of inertia J of our arm is given by J=1/3 mL², modeled as a // rod rotating about it's end, where L is the overall rod length. The mass // distribution is assumed to be uniform. Substitute r=L/2 to find: // // α = (m⋅g⋅cos(θ))⋅r/(1/3 mL²) // α = (m⋅g⋅cos(θ))⋅(L/2)/(1/3 mL²) // α = 3/2⋅g⋅cos(θ)/L // // This acceleration is next added to the linear system dynamics ẋ=Ax+Bu // // f(x, u) = Ax + Bu + [0 α]ᵀ // f(x, u) = Ax + Bu + [0 3/2⋅g⋅cos(θ)/L]ᵀ Vectord<2> updatedXhat = RKDP( [&](const auto& x, const auto& u) -> Vectord<2> { Vectord<2> xdot = m_plant.A() * x + m_plant.B() * u; if (m_simulateGravity) { xdot += Vectord<2>{ 0.0, (3.0 / 2.0 * -9.8 / m_armLen * std::cos(x(0))).value()}; } return xdot; }, currentXhat, u, dt); // Check for collisions. if (WouldHitLowerLimit(units::radian_t{updatedXhat(0)})) { return Vectord<2>{m_minAngle.value(), 0.0}; } else if (WouldHitUpperLimit(units::radian_t{updatedXhat(0)})) { return Vectord<2>{m_maxAngle.value(), 0.0}; } return updatedXhat; }