allwpilib/wpilibc/wpilibC++Devices/include/CANTalon.h

/*----------------------------------------------------------------------------*/
/* Copyright (c) FIRST 2014. All Rights Reserved.                             */
/* Open Source Software - may be modified and shared by FRC teams. The code   */
/* must be accompanied by the FIRST BSD license file in $(WIND_BASE)/WPILib.  */
/*----------------------------------------------------------------------------*/
#pragma once

#include "SafePWM.h"
#include "CANSpeedController.h"
#include "PIDOutput.h"
#include "MotorSafetyHelper.h"
#include "LiveWindow/LiveWindowSendable.h"
#include "tables/ITable.h"

class CanTalonSRX;

/**
 * CTRE Talon SRX Speed Controller with CAN Control
 */
class CANTalon : public MotorSafety,
                 public CANSpeedController,
                 public ErrorBase,
                 public LiveWindowSendable,
                 public ITableListener
{
public:
  enum FeedbackDevice {
    QuadEncoder=0,
    AnalogPot=2,
    AnalogEncoder=3,
    EncRising=4,
    EncFalling=5
  };
  enum StatusFrameRate {
    StatusFrameRateGeneral=0,
    StatusFrameRateFeedback=1,
    StatusFrameRateQuadEncoder=2,
    StatusFrameRateAnalogTempVbat=3,
  };
	explicit CANTalon(int deviceNumber);
	explicit CANTalon(int deviceNumber,int controlPeriodMs);
	virtual ~CANTalon();

	// PIDController interface
	virtual void PIDWrite(float output) override;

	// MotorSafety interface
	virtual void SetExpiration(float timeout) override;
	virtual float GetExpiration() override;
	virtual bool IsAlive() override;
	virtual void StopMotor() override;
	virtual void SetSafetyEnabled(bool enabled) override;
	virtual bool IsSafetyEnabled() override;
	virtual void GetDescription(char *desc) override;

	// CANSpeedController interface
	virtual float Get() override;
	virtual void Set(float value, uint8_t syncGroup=0) override;
	virtual void Disable() override;
  virtual void EnableControl();
	virtual void SetP(double p) override;
	virtual void SetI(double i) override;
	virtual void SetD(double d) override;
	void SetF(double f);
	void SetIzone(unsigned iz);
	virtual void SetPID(double p, double i, double d) override;
	void SetPID(double p, double i, double d, double f);
	virtual double GetP() override;
	virtual double GetI() override;
	virtual double GetD() override;
	double GetF();
	virtual float GetBusVoltage() override;
	virtual float GetOutputVoltage() override;
	virtual float GetOutputCurrent() override;
	virtual float GetTemperature() override;
	void SetPosition(double pos);
	virtual double GetPosition() override;
	virtual double GetSpeed() override;
  virtual int GetClosedLoopError();
  virtual int GetAnalogIn();
  virtual int GetAnalogInRaw();
  virtual int GetAnalogInVel();
  virtual int GetEncPosition();
  virtual int GetEncVel();
	int GetPinStateQuadA();
	int GetPinStateQuadB();
	int GetPinStateQuadIdx();
	int IsFwdLimitSwitchClosed();
	int IsRevLimitSwitchClosed();
	int GetNumberOfQuadIdxRises();
	void SetNumberOfQuadIdxRises(int rises);
	virtual bool GetForwardLimitOK() override;
	virtual bool GetReverseLimitOK() override;
	virtual uint16_t GetFaults() override;
	uint16_t GetStickyFaults();
	void ClearStickyFaults();
	virtual void SetVoltageRampRate(double rampRate) override;
	virtual uint32_t GetFirmwareVersion() override;
	virtual void ConfigNeutralMode(NeutralMode mode) override;
	virtual void ConfigEncoderCodesPerRev(uint16_t codesPerRev) override;
	virtual void ConfigPotentiometerTurns(uint16_t turns) override;
	virtual void ConfigSoftPositionLimits(double forwardLimitPosition, double reverseLimitPosition) override;
	virtual void DisableSoftPositionLimits() override;
	virtual void ConfigLimitMode(LimitMode mode) override;
	virtual void ConfigForwardLimit(double forwardLimitPosition) override;
	virtual void ConfigReverseLimit(double reverseLimitPosition) override;
	/**
	 * Change the fwd limit switch setting to normally open or closed.
	 * Talon will disable momentarilly if the Talon's current setting
	 * is dissimilar to the caller's requested setting.
	 *
	 * Since Talon saves setting to flash this should only affect
	 * a given Talon initially during robot install.
	 *
	 * @param normallyOpen true for normally open.  false for normally closed.
	 */
	void ConfigFwdLimitSwitchNormallyOpen(bool normallyOpen);
	/**
	 * Change the rev limit switch setting to normally open or closed.
	 * Talon will disable momentarilly if the Talon's current setting
	 * is dissimilar to the caller's requested setting.
	 *
	 * Since Talon saves setting to flash this should only affect
	 * a given Talon initially during robot install.
	 *
	 * @param normallyOpen true for normally open.  false for normally closed.
	 */
	void ConfigRevLimitSwitchNormallyOpen(bool normallyOpen);
	virtual void ConfigMaxOutputVoltage(double voltage) override;
	virtual void ConfigFaultTime(float faultTime) override;
	virtual void SetControlMode(ControlMode mode);
  void SetFeedbackDevice(FeedbackDevice device);
	void SetStatusFrameRateMs(StatusFrameRate stateFrame, int periodMs);
	virtual ControlMode GetControlMode();
	void SetSensorDirection(bool reverseSensor);
	void SetCloseLoopRampRate(double rampRate);
	void SelectProfileSlot(int slotIdx);
	int GetIzone();
	int GetIaccum();
	void ClearIaccum();
	int GetBrakeEnableDuringNeutral();

  bool IsControlEnabled();
  double GetSetpoint();

  // LiveWindow stuff.
	void ValueChanged(ITable* source, const std::string& key, EntryValue value, bool isNew);
	void UpdateTable();
	void StartLiveWindowMode();
	void StopLiveWindowMode();
	std::string GetSmartDashboardType();
	void InitTable(ITable *subTable);
	ITable * GetTable();
private:
  // Values for various modes as is sent in the CAN packets for the Talon.
  enum TalonControlMode {
		kThrottle=0,
    kFollowerMode=5,
		kVoltageMode=4,
		kPositionMode=1,
		kSpeedMode=2,
		kCurrentMode=3,
    kDisabled=15
  };

	int m_deviceNumber;
	CanTalonSRX *m_impl;
	MotorSafetyHelper *m_safetyHelper;
  int m_profile; // Profile from CANTalon to use. Set to zero until we can actually test this.

  bool m_controlEnabled;
  ControlMode m_controlMode;
  TalonControlMode m_sendMode;

  double m_setPoint;
  static const unsigned int kDelayForSolicitedSignalsUs = 4000;
  /**
   * Fixup the sendMode so Set() serializes the correct demand value.
   * Also fills the modeSelecet in the control frame to disabled.
   * @param mode Control mode to ultimately enter once user calls Set().
   * @see Set()
   */
  void ApplyControlMode(CANSpeedController::ControlMode mode);

  // LiveWindow stuff.
	ITable *m_table;
};