allwpilib/wpilibc/wpilibC++Devices/src/VictorSP.cpp

/*----------------------------------------------------------------------------*/
/* Copyright (c) FIRST 2008. 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.  */
/*----------------------------------------------------------------------------*/

#include "VictorSP.h"

//#include "NetworkCommunication/UsageReporting.h"
#include "LiveWindow/LiveWindow.h"

/**
 * Common initialization code called by all constructors.
 *
 * Note that the VictorSP uses the following bounds for PWM values. These values should work reasonably well for
 * most controllers, but if users experience issues such as asymmetric behavior around
 * the deadband or inability to saturate the controller in either direction, calibration is recommended.
 * The calibration procedure can be found in the VictorSP User Manual available from Vex.
 *
 *   2.004ms = full "forward"
 *   1.52ms = the "high end" of the deadband range
 *   1.50ms = center of the deadband range (off)
 *   1.48ms = the "low end" of the deadband range
 *   0.997ms = full "reverse"
 */
void VictorSP::InitVictorSP() {
	SetBounds(2.004, 1.52, 1.50, 1.48, .997);
	SetPeriodMultiplier(kPeriodMultiplier_1X);
	SetRaw(m_centerPwm);
	SetZeroLatch();

	HALReport(HALUsageReporting::kResourceType_VictorSP, GetChannel());
	LiveWindow::GetInstance()->AddActuator("VictorSP", GetChannel(), this);
}

/**
 * Constructor for a VictorSP 
 * @param channel The PWM channel that the VictorSP is attached to. 0-9 are on-board, 10-19 are on the MXP port
 */
VictorSP::VictorSP(uint32_t channel) : SafePWM(channel)
{
	InitVictorSP();
}

VictorSP::~VictorSP()
{
}

/**
 * Set the PWM value.
 *
 * The PWM value is set using a range of -1.0 to 1.0, appropriately
 * scaling the value for the FPGA.
 *
 * @param speed The speed value between -1.0 and 1.0 to set.
 * @param syncGroup Unused interface.
 */
void VictorSP::Set(float speed, uint8_t syncGroup)
{
	SetSpeed(speed);
}

/**
 * Get the recently set value of the PWM.
 *
 * @return The most recently set value for the PWM between -1.0 and 1.0.
 */
float VictorSP::Get() const
{
	return GetSpeed();
}

/**
 * Common interface for disabling a motor.
 */
void VictorSP::Disable()
{
	SetRaw(kPwmDisabled);
}

/**
 * Write out the PID value as seen in the PIDOutput base object.
 *
 * @param output Write out the PWM value as was found in the PIDController
 */
void VictorSP::PIDWrite(float output)
{
	Set(output);
}