/*----------------------------------------------------------------------------*/ /* 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 "AnalogInput.h" //#include "NetworkCommunication/UsageReporting.h" #include "Resource.h" #include "Timer.h" #include "WPIErrors.h" #include "LiveWindow/LiveWindow.h" static Resource *inputs = NULL; const uint8_t AnalogInput::kAccumulatorModuleNumber; const uint32_t AnalogInput::kAccumulatorNumChannels; const uint32_t AnalogInput::kAccumulatorChannels[] = {0, 1}; /** * Common initialization. */ void AnalogInput::InitAnalogInput(uint32_t channel) { m_table = NULL; char buf[64]; Resource::CreateResourceObject(&inputs, kAnalogInputs); if (!checkAnalogInputChannel(channel)) { snprintf(buf, 64, "analog input %d", channel); wpi_setWPIErrorWithContext(ChannelIndexOutOfRange, buf); return; } snprintf(buf, 64, "Analog Input %d", channel); if (inputs->Allocate(channel, buf) == ~0ul) { CloneError(inputs); return; } m_channel = channel; void* port = getPort(channel); int32_t status = 0; m_port = initializeAnalogInputPort(port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); LiveWindow::GetInstance()->AddSensor("AnalogInput", channel, this); HALReport(HALUsageReporting::kResourceType_AnalogChannel, channel); } /** * Construct an analog input. * * @param channel The channel number to represent. */ AnalogInput::AnalogInput(uint32_t channel) { InitAnalogInput(channel); } /** * Channel destructor. */ AnalogInput::~AnalogInput() { inputs->Free(m_channel); } /** * Get a sample straight from this channel. * The sample is a 12-bit value representing the 0V to 5V range of the A/D converter in the module. * The units are in A/D converter codes. Use GetVoltage() to get the analog value in calibrated units. * @return A sample straight from this channel. */ int16_t AnalogInput::GetValue() { if (StatusIsFatal()) return 0; int32_t status = 0; int16_t value = getAnalogValue(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return value; } /** * Get a sample from the output of the oversample and average engine for this channel. * The sample is 12-bit + the value configured in SetOversampleBits(). * The value configured in SetAverageBits() will cause this value to be averaged 2**bits number of samples. * This is not a sliding window. The sample will not change until 2**(OversamplBits + AverageBits) samples * have been acquired from the module on this channel. * Use GetAverageVoltage() to get the analog value in calibrated units. * @return A sample from the oversample and average engine for this channel. */ int32_t AnalogInput::GetAverageValue() { if (StatusIsFatal()) return 0; int32_t status = 0; int32_t value = getAnalogAverageValue(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return value; } /** * Get a scaled sample straight from this channel. * The value is scaled to units of Volts using the calibrated scaling data from GetLSBWeight() and GetOffset(). * @return A scaled sample straight from this channel. */ float AnalogInput::GetVoltage() { if (StatusIsFatal()) return 0.0f; int32_t status = 0; float voltage = getAnalogVoltage(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return voltage; } /** * Get a scaled sample from the output of the oversample and average engine for this channel. * The value is scaled to units of Volts using the calibrated scaling data from GetLSBWeight() and GetOffset(). * Using oversampling will cause this value to be higher resolution, but it will update more slowly. * Using averaging will cause this value to be more stable, but it will update more slowly. * @return A scaled sample from the output of the oversample and average engine for this channel. */ float AnalogInput::GetAverageVoltage() { if (StatusIsFatal()) return 0.0f; int32_t status = 0; float voltage = getAnalogAverageVoltage(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return voltage; } /** * Get the factory scaling least significant bit weight constant. * * Volts = ((LSB_Weight * 1e-9) * raw) - (Offset * 1e-9) * * @return Least significant bit weight. */ uint32_t AnalogInput::GetLSBWeight() { if (StatusIsFatal()) return 0; int32_t status = 0; int32_t lsbWeight = getAnalogLSBWeight(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return lsbWeight; } /** * Get the factory scaling offset constant. * * Volts = ((LSB_Weight * 1e-9) * raw) - (Offset * 1e-9) * * @return Offset constant. */ int32_t AnalogInput::GetOffset() { if (StatusIsFatal()) return 0; int32_t status = 0; int32_t offset = getAnalogOffset(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return offset; } /** * Get the channel number. * @return The channel number. */ uint32_t AnalogInput::GetChannel() { if (StatusIsFatal()) return 0; return m_channel; } /** * Set the number of averaging bits. * This sets the number of averaging bits. The actual number of averaged samples is 2**bits. * Use averaging to improve the stability of your measurement at the expense of sampling rate. * The averaging is done automatically in the FPGA. * * @param bits Number of bits of averaging. */ void AnalogInput::SetAverageBits(uint32_t bits) { if (StatusIsFatal()) return; int32_t status = 0; setAnalogAverageBits(m_port, bits, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); } /** * Get the number of averaging bits previously configured. * This gets the number of averaging bits from the FPGA. The actual number of averaged samples is 2**bits. * The averaging is done automatically in the FPGA. * * @return Number of bits of averaging previously configured. */ uint32_t AnalogInput::GetAverageBits() { int32_t status = 0; int32_t averageBits = getAnalogAverageBits(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return averageBits; } /** * Set the number of oversample bits. * This sets the number of oversample bits. The actual number of oversampled values is 2**bits. * Use oversampling to improve the resolution of your measurements at the expense of sampling rate. * The oversampling is done automatically in the FPGA. * * @param bits Number of bits of oversampling. */ void AnalogInput::SetOversampleBits(uint32_t bits) { if (StatusIsFatal()) return; int32_t status = 0; setAnalogOversampleBits(m_port, bits, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); } /** * Get the number of oversample bits previously configured. * This gets the number of oversample bits from the FPGA. The actual number of oversampled values is * 2**bits. The oversampling is done automatically in the FPGA. * * @return Number of bits of oversampling previously configured. */ uint32_t AnalogInput::GetOversampleBits() { if (StatusIsFatal()) return 0; int32_t status = 0; int32_t oversampleBits = getAnalogOversampleBits(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return oversampleBits; } /** * Is the channel attached to an accumulator. * * @return The analog input is attached to an accumulator. */ bool AnalogInput::IsAccumulatorChannel() { if (StatusIsFatal()) return false; int32_t status = 0; bool isAccum = isAccumulatorChannel(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return isAccum; } /** * Initialize the accumulator. */ void AnalogInput::InitAccumulator() { if (StatusIsFatal()) return; m_accumulatorOffset = 0; int32_t status = 0; initAccumulator(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); } /** * Set an inital value for the accumulator. * * This will be added to all values returned to the user. * @param initialValue The value that the accumulator should start from when reset. */ void AnalogInput::SetAccumulatorInitialValue(int64_t initialValue) { if (StatusIsFatal()) return; m_accumulatorOffset = initialValue; } /** * Resets the accumulator to the initial value. */ void AnalogInput::ResetAccumulator() { if (StatusIsFatal()) return; int32_t status = 0; resetAccumulator(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); if(!StatusIsFatal()) { // Wait until the next sample, so the next call to GetAccumulator*() // won't have old values. const float sampleTime = 1.0f / GetSampleRate(); const float overSamples = 1 << GetOversampleBits(); const float averageSamples = 1 << GetAverageBits(); Wait(sampleTime * overSamples * averageSamples); } } /** * Set the center value of the accumulator. * * The center value is subtracted from each A/D value before it is added to the accumulator. This * is used for the center value of devices like gyros and accelerometers to make integration work * and to take the device offset into account when integrating. * * This center value is based on the output of the oversampled and averaged source from channel 1. * Because of this, any non-zero oversample bits will affect the size of the value for this field. */ void AnalogInput::SetAccumulatorCenter(int32_t center) { if (StatusIsFatal()) return; int32_t status = 0; setAccumulatorCenter(m_port, center, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); } /** * Set the accumulator's deadband. */ void AnalogInput::SetAccumulatorDeadband(int32_t deadband) { if (StatusIsFatal()) return; int32_t status = 0; setAccumulatorDeadband(m_port, deadband, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); } /** * Read the accumulated value. * * Read the value that has been accumulating on channel 1. * The accumulator is attached after the oversample and average engine. * * @return The 64-bit value accumulated since the last Reset(). */ int64_t AnalogInput::GetAccumulatorValue() { if (StatusIsFatal()) return 0; int32_t status = 0; int64_t value = getAccumulatorValue(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return value + m_accumulatorOffset; } /** * Read the number of accumulated values. * * Read the count of the accumulated values since the accumulator was last Reset(). * * @return The number of times samples from the channel were accumulated. */ uint32_t AnalogInput::GetAccumulatorCount() { if (StatusIsFatal()) return 0; int32_t status = 0; uint32_t count = getAccumulatorCount(m_port, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); return count; } /** * Read the accumulated value and the number of accumulated values atomically. * * This function reads the value and count from the FPGA atomically. * This can be used for averaging. * * @param value Pointer to the 64-bit accumulated output. * @param count Pointer to the number of accumulation cycles. */ void AnalogInput::GetAccumulatorOutput(int64_t *value, uint32_t *count) { if (StatusIsFatal()) return; int32_t status = 0; getAccumulatorOutput(m_port, value, count, &status); wpi_setErrorWithContext(status, getHALErrorMessage(status)); *value += m_accumulatorOffset; } /** * Set the sample rate for all analog channels. * * @param samplesPerSecond The number of samples per second. */ void AnalogInput::SetSampleRate(float samplesPerSecond) { int32_t status = 0; setAnalogSampleRate(samplesPerSecond, &status); } /** * Get the current sample rate for all channels * * @return Sample rate. */ float AnalogInput::GetSampleRate() { int32_t status = 0; float sampleRate = getAnalogSampleRate(&status); return sampleRate; } /** * Get the Average value for the PID Source base object. * * @return The average voltage. */ double AnalogInput::PIDGet() { if (StatusIsFatal()) return 0.0; return GetAverageVoltage(); } void AnalogInput::UpdateTable() { if (m_table != NULL) { m_table->PutNumber("Value", GetAverageVoltage()); } } void AnalogInput::StartLiveWindowMode() { } void AnalogInput::StopLiveWindowMode() { } std::string AnalogInput::GetSmartDashboardType() { return "Analog Input"; } void AnalogInput::InitTable(ITable *subTable) { m_table = subTable; UpdateTable(); } ITable * AnalogInput::GetTable() { return m_table; }