mirror of
https://github.com/wpilibsuite/allwpilib
synced 2026-06-25 01:41:43 +00:00
136 lines
3.5 KiB
C++
136 lines
3.5 KiB
C++
/*----------------------------------------------------------------------------*/
|
|
/* Copyright (c) 2019 FIRST. 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 the root directory of */
|
|
/* the project. */
|
|
/*----------------------------------------------------------------------------*/
|
|
|
|
#pragma once
|
|
|
|
#include <memory>
|
|
|
|
#include <hal/Types.h>
|
|
|
|
#include "frc/ErrorBase.h"
|
|
#include "frc/smartdashboard/Sendable.h"
|
|
#include "frc/smartdashboard/SendableHelper.h"
|
|
|
|
namespace frc {
|
|
class DigitalSource;
|
|
class AnalogTrigger;
|
|
class DMA;
|
|
class DMASample;
|
|
|
|
/**
|
|
* Class to read a duty cycle PWM input.
|
|
*
|
|
* <p>PWM input signals are specified with a frequency and a ratio of high to
|
|
* low in that frequency. There are 8 of these in the roboRIO, and they can be
|
|
* attached to any DigitalSource.
|
|
*
|
|
* <p>These can be combined as the input of an AnalogTrigger to a Counter in
|
|
* order to implement rollover checking.
|
|
*
|
|
*/
|
|
class DutyCycle : public ErrorBase,
|
|
public Sendable,
|
|
public SendableHelper<DutyCycle> {
|
|
friend class AnalogTrigger;
|
|
friend class DMA;
|
|
friend class DMASample;
|
|
|
|
public:
|
|
/**
|
|
* Constructs a DutyCycle input from a DigitalSource input.
|
|
*
|
|
* <p> This class does not own the inputted source.
|
|
*
|
|
* @param source The DigitalSource to use.
|
|
*/
|
|
explicit DutyCycle(DigitalSource& source);
|
|
/**
|
|
* Constructs a DutyCycle input from a DigitalSource input.
|
|
*
|
|
* <p> This class does not own the inputted source.
|
|
*
|
|
* @param source The DigitalSource to use.
|
|
*/
|
|
explicit DutyCycle(DigitalSource* source);
|
|
/**
|
|
* Constructs a DutyCycle input from a DigitalSource input.
|
|
*
|
|
* <p> This class does not own the inputted source.
|
|
*
|
|
* @param source The DigitalSource to use.
|
|
*/
|
|
explicit DutyCycle(std::shared_ptr<DigitalSource> source);
|
|
|
|
/**
|
|
* Close the DutyCycle and free all resources.
|
|
*/
|
|
~DutyCycle() override;
|
|
|
|
DutyCycle(DutyCycle&&) = default;
|
|
DutyCycle& operator=(DutyCycle&&) = default;
|
|
|
|
/**
|
|
* Get the frequency of the duty cycle signal.
|
|
*
|
|
* @return frequency in Hertz
|
|
*/
|
|
int GetFrequency() const;
|
|
|
|
/**
|
|
* Get the output ratio of the duty cycle signal.
|
|
*
|
|
* <p> 0 means always low, 1 means always high.
|
|
*
|
|
* @return output ratio between 0 and 1
|
|
*/
|
|
double GetOutput() const;
|
|
|
|
/**
|
|
* Get the raw output ratio of the duty cycle signal.
|
|
*
|
|
* <p> 0 means always low, an output equal to
|
|
* GetOutputScaleFactor() means always high.
|
|
*
|
|
* @return output ratio in raw units
|
|
*/
|
|
unsigned int GetOutputRaw() const;
|
|
|
|
/**
|
|
* Get the scale factor of the output.
|
|
*
|
|
* <p> An output equal to this value is always high, and then linearly scales
|
|
* down to 0. Divide the result of getOutputRaw by this in order to get the
|
|
* percentage between 0 and 1.
|
|
*
|
|
* @return the output scale factor
|
|
*/
|
|
unsigned int GetOutputScaleFactor() const;
|
|
|
|
/**
|
|
* Get the FPGA index for the DutyCycle.
|
|
*
|
|
* @return the FPGA index
|
|
*/
|
|
int GetFPGAIndex() const;
|
|
|
|
/**
|
|
* Get the channel of the source.
|
|
*
|
|
* @return the source channel
|
|
*/
|
|
int GetSourceChannel() const;
|
|
|
|
protected:
|
|
void InitSendable(SendableBuilder& builder) override;
|
|
|
|
private:
|
|
void InitDutyCycle();
|
|
std::shared_ptr<DigitalSource> m_source;
|
|
hal::Handle<HAL_DutyCycleHandle> m_handle;
|
|
};
|
|
} // namespace frc
|