TalonFX.hpp

Go to the documentation of this file.

/*
 * Copyright (C) Cross The Road Electronics.  All rights reserved.
 * License information can be found in CTRE_LICENSE.txt
 * For support and suggestions contact support@ctr-electronics.com or file
 * an issue tracker at https://github.com/CrossTheRoadElec/Phoenix-Releases
 */
#pragma once
 
#include "ctre/phoenix6/core/CoreTalonFX.hpp"
 
#include "frc/MotorSafety.h"
#include "frc/motorcontrol/MotorController.h"
#include "wpi/sendable/Sendable.h"
#include "wpi/sendable/SendableBuilder.h"
#include "wpi/sendable/SendableHelper.h"
#include <hal/SimDevice.h>
 
#include <string>
 
namespace ctre {
namespace phoenix6 {
namespace hardware {
 
/**
 * Class description for the Talon FX integrated motor controller that runs on
 * associated Falcon motors.
 *
 * This must be constructed after main executes. We recommend constructing inside
 * the robot class or your subsystem classes. Otherwise WPILib motor safety may
 * produce erroneous behavior.
 */
class TalonFX : public core::CoreTalonFX,
                public frc::MotorController,
                public frc::MotorSafety,
                public wpi::Sendable,
                public wpi::SendableHelper<TalonFX>
{
    /**
     * The StatusSignal getters are copies so that calls
     * to the WPI interface do not update any references
     *
     * These are also mutable so the const getter methods are
     * properly managed.
     */
    mutable StatusSignal<units::dimensionless::scalar_t> m_dutyCycle = GetDutyCycle();
 
    controls::DutyCycleOut m_setterControl{0.0};
    controls::NeutralOut m_brakeRef{};
    controls::VoltageOut m_voltageControl{0_V};
 
    std::string m_description;
 
    hal::SimDevice m_simMotor;
    hal::SimDouble m_simSupplyVoltage;
    hal::SimDouble m_simDutyCycle;
    hal::SimDouble m_simMotorVoltage;
    hal::SimDouble m_simTorqueCurrent;
    hal::SimDouble m_simSupplyCurrent;
 
    hal::SimDevice m_simForwardLimit;
    hal::SimBoolean m_simForwardLimitValue;
 
    hal::SimDevice m_simReverseLimit;
    hal::SimBoolean m_simReverseLimitValue;
 
    hal::SimDevice m_simRotor;
    hal::SimDouble m_simRotorPos;
    hal::SimDouble m_simRotorRawPos;
    hal::SimDouble m_simRotorVel;
 
    int32_t m_simPeriodicUid{-1};
    std::vector<int32_t> m_simValueChangedUids;
 
    static void OnValueChanged(const char* name, void *param, HAL_SimValueHandle handle,
                               HAL_Bool readonly, const struct HAL_Value* value);
    static void OnPeriodic(void* param);
 
public:
    /**
     * Constructs a new Talon FX motor controller object.
     *
     * This must be constructed after main executes. We recommend constructing inside
     * the robot class or your subsystem classes. Otherwise WPILib motor safety may
     * produce erroneous behavior.
     *
     * \param deviceId    ID of the device, as configured in Phoenix Tuner.
     * \param canbus      Name of the CAN bus this device is on. Possible CAN bus strings are:
     *                    - "rio" for the native roboRIO CAN bus
     *                    - CANivore name or serial number
     *                    - SocketCAN interface (non-FRC Linux only)
     *                    - "*" for any CANivore seen by the program
     *                    - empty string (default) to select the default for the system:
     *                      - "rio" on roboRIO
     *                      - "can0" on Linux
     *                      - "*" on Windows
     */
    TalonFX(int deviceId, std::string canbus = "");
    ~TalonFX();
 
    /**
     * Common interface for setting the speed of a motor controller.
     *
     * \param speed The speed to set. Value should be between -1.0 and 1.0.
     */
    void Set(double speed) override;
    /**
     * Common interface for seting the direct voltage output of a motor controller.
     *
     * \param volts The voltage to output.
     */
    void SetVoltage(units::volt_t volts) override;
    /**
     * Common interface for getting the current set speed of a motor controller.
     *
     * \returns The current set speed. Value is between -1.0 and 1.0.
     */
    double Get() const override;
    /**
     * Common interface for disabling a motor controller.
     */
    void Disable() override;
    /**
     * Common interface to stop motor movement until Set is called again.
     */
    void StopMotor() override;
    /**
     * Common interface for inverting direction of a motor controller.
     *
     * Since invert is a config, this API is blocking. We recommend that
     * users avoid calling this API periodically.
     *
     * \param isInverted The state of inversion, true is inverted.
     */
    void SetInverted(bool isInverted) override;
    /**
     * Common interface for returning the inversion state of a motor controller.
     *
     * Since invert is a config, this API is blocking. We recommend that
     * users avoid calling this API periodically.
     *
     * \returns The state of the inversion, true is inverted.
     */
    bool GetInverted() const override;
 
    /**
     * \returns Description of motor controller
     */
    std::string GetDescription() const override;
    void InitSendable(wpi::SendableBuilder &builder) override;
 
protected:
    //------------- Intercept CTRE calls for motor safety ------------//
    ctre::phoenix::StatusCode SetControlPrivate(controls::ControlRequest &request) override;
};
 
}
}
}