WPILibC++  unspecified
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Pages
AnalogTriggerOutput Class Reference

Class to represent a specific output from an analog trigger. More...

#include <AnalogTriggerOutput.h>

Inheritance diagram for AnalogTriggerOutput:
DigitalSource InterruptableSensorBase SensorBase ErrorBase

Public Member Functions

bool Get () const
 Get the state of the analog trigger output. More...
 
virtual uint32_t GetChannelForRouting () const override
 
virtual uint32_t GetModuleForRouting () const override
 
virtual bool GetAnalogTriggerForRouting () const override
 
- Public Member Functions inherited from InterruptableSensorBase
virtual void RequestInterrupts (InterruptHandlerFunction handler, void *param)
 Asynchronus handler version. More...
 
virtual void RequestInterrupts ()
 Synchronus Wait version. More...
 
virtual void CancelInterrupts ()
 Free up the underlying chipobject functions. More...
 
virtual WaitResult WaitForInterrupt (float timeout, bool ignorePrevious=true)
 Synchronus version. More...
 
virtual void EnableInterrupts ()
 Enable interrupts - after finishing setup. More...
 
virtual void DisableInterrupts ()
 Disable, but don't deallocate. More...
 
virtual double ReadRisingTimestamp ()
 Return the timestamp for the rising interrupt that occurred. More...
 
virtual double ReadFallingTimestamp ()
 Return the timestamp for the falling interrupt that occurred. More...
 
virtual void SetUpSourceEdge (bool risingEdge, bool fallingEdge)
 Set which edge to trigger interrupts on. More...
 
- Public Member Functions inherited from SensorBase
 SensorBase ()
 Creates an instance of the sensor base and gets an FPGA handle.
 
 SensorBase (const SensorBase &)=delete
 
SensorBaseoperator= (const SensorBase &)=delete
 
- Public Member Functions inherited from ErrorBase
 ErrorBase (const ErrorBase &)=delete
 
ErrorBaseoperator= (const ErrorBase &)=delete
 
virtual ErrorGetError ()
 Retrieve the current error. More...
 
virtual const ErrorGetError () const
 
virtual void SetErrnoError (llvm::StringRef contextMessage, llvm::StringRef filename, llvm::StringRef function, uint32_t lineNumber) const
 Set error information associated with a C library call that set an error to the "errno" global variable. More...
 
virtual void SetImaqError (int success, llvm::StringRef contextMessage, llvm::StringRef filename, llvm::StringRef function, uint32_t lineNumber) const
 Set the current error information associated from the nivision Imaq API. More...
 
virtual void SetError (Error::Code code, llvm::StringRef contextMessage, llvm::StringRef filename, llvm::StringRef function, uint32_t lineNumber) const
 Set the current error information associated with this sensor. More...
 
virtual void SetWPIError (llvm::StringRef errorMessage, Error::Code code, llvm::StringRef contextMessage, llvm::StringRef filename, llvm::StringRef function, uint32_t lineNumber) const
 Set the current error information associated with this sensor. More...
 
virtual void CloneError (const ErrorBase &rhs) const
 
virtual void ClearError () const
 Clear the current error information associated with this sensor.
 
virtual bool StatusIsFatal () const
 Check if the current error code represents a fatal error. More...
 

Protected Member Functions

 AnalogTriggerOutput (const AnalogTrigger &trigger, AnalogTriggerType outputType)
 Create an object that represents one of the four outputs from an analog trigger. More...
 
- Protected Member Functions inherited from InterruptableSensorBase
void AllocateInterrupts (bool watcher)
 
- Protected Member Functions inherited from SensorBase
void AddToSingletonList ()
 Add sensor to the singleton list. More...
 

Friends

class AnalogTrigger
 

Additional Inherited Members

- Public Types inherited from InterruptableSensorBase
enum  WaitResult { kTimeout = 0x0, kRisingEdge = 0x1, kFallingEdge = 0x100, kBoth = 0x101 }
 
- Static Public Member Functions inherited from SensorBase
static void DeleteSingletons ()
 Delete all the singleton classes on the list. More...
 
static uint32_t GetDefaultSolenoidModule ()
 
static bool CheckSolenoidModule (uint8_t moduleNumber)
 Check that the solenoid module number is valid. More...
 
static bool CheckDigitalChannel (uint32_t channel)
 Check that the digital channel number is valid. More...
 
static bool CheckRelayChannel (uint32_t channel)
 Check that the digital channel number is valid. More...
 
static bool CheckPWMChannel (uint32_t channel)
 Check that the digital channel number is valid. More...
 
static bool CheckAnalogInput (uint32_t channel)
 Check that the analog input number is value. More...
 
static bool CheckAnalogOutput (uint32_t channel)
 Check that the analog output number is valid. More...
 
static bool CheckSolenoidChannel (uint32_t channel)
 Verify that the solenoid channel number is within limits. More...
 
static bool CheckPDPChannel (uint32_t channel)
 Verify that the power distribution channel number is within limits. More...
 
- Static Public Member Functions inherited from ErrorBase
static void SetGlobalError (Error::Code code, llvm::StringRef contextMessage, llvm::StringRef filename, llvm::StringRef function, uint32_t lineNumber)
 
static void SetGlobalWPIError (llvm::StringRef errorMessage, llvm::StringRef contextMessage, llvm::StringRef filename, llvm::StringRef function, uint32_t lineNumber)
 
static ErrorGetGlobalError ()
 Retrieve the current global error.
 
- Static Public Attributes inherited from SensorBase
static const uint32_t kDigitalChannels = 26
 
static const uint32_t kAnalogInputs = 8
 
static const uint32_t kAnalogOutputs = 2
 
static const uint32_t kSolenoidChannels = 8
 
static const uint32_t kSolenoidModules = 2
 
static const uint32_t kPwmChannels = 20
 
static const uint32_t kRelayChannels = 8
 
static const uint32_t kPDPChannels = 16
 
static const uint32_t kChassisSlots = 8
 
- Protected Attributes inherited from InterruptableSensorBase
void * m_interrupt = nullptr
 
uint32_t m_interruptIndex = std::numeric_limits<uint32_t>::max()
 
- Protected Attributes inherited from ErrorBase
Error m_error
 
- Static Protected Attributes inherited from InterruptableSensorBase
static std::unique_ptr< Resourcem_interrupts
 
- Static Protected Attributes inherited from SensorBase
static void * m_digital_ports [kDigitalChannels]
 
static void * m_relay_ports [kRelayChannels]
 
static void * m_pwm_ports [kPwmChannels]
 
- Static Protected Attributes inherited from ErrorBase
static priority_mutex _globalErrorMutex
 
static Error _globalError
 

Detailed Description

Class to represent a specific output from an analog trigger.

This class is used to get the current output value and also as a DigitalSource to provide routing of an output to digital subsystems on the FPGA such as Counter, Encoder, and Interrupt.

The TriggerState output indicates the primary output value of the trigger. If the analog signal is less than the lower limit, the output is false. If the analog value is greater than the upper limit, then the output is true. If the analog value is in between, then the trigger output state maintains its most recent value.

The InWindow output indicates whether or not the analog signal is inside the range defined by the limits.

The RisingPulse and FallingPulse outputs detect an instantaneous transition from above the upper limit to below the lower limit, and vise versa. These pulses represent a rollover condition of a sensor and can be routed to an up / down couter or to interrupts. Because the outputs generate a pulse, they cannot be read directly. To help ensure that a rollover condition is not missed, there is an average rejection filter available that operates on the upper 8 bits of a 12 bit number and selects the nearest outlyer of 3 samples. This will reject a sample that is (due to averaging or sampling) errantly between the two limits. This filter will fail if more than one sample in a row is errantly in between the two limits. You may see this problem if attempting to use this feature with a mechanical rollover sensor, such as a 360 degree no-stop potentiometer without signal conditioning, because the rollover transition is not sharp / clean enough. Using the averaging engine may help with this, but rotational speeds of the sensor will then be limited.

Constructor & Destructor Documentation

AnalogTriggerOutput::AnalogTriggerOutput ( const AnalogTrigger trigger,
AnalogTriggerType  outputType 
)
protected

Create an object that represents one of the four outputs from an analog trigger.

Because this class derives from DigitalSource, it can be passed into routing functions for Counter, Encoder, etc.

Parameters
triggerA pointer to the trigger for which this is an output.
outputTypeAn enum that specifies the output on the trigger to represent.

Member Function Documentation

bool AnalogTriggerOutput::Get ( ) const

Get the state of the analog trigger output.

Returns
The state of the analog trigger output.
bool AnalogTriggerOutput::GetAnalogTriggerForRouting ( ) const
overridevirtual
Returns
The value to be written to the module field of a routing mux.

Implements DigitalSource.

uint32_t AnalogTriggerOutput::GetChannelForRouting ( ) const
overridevirtual
Returns
The value to be written to the channel field of a routing mux.

Implements DigitalSource.

uint32_t AnalogTriggerOutput::GetModuleForRouting ( ) const
overridevirtual
Returns
The value to be written to the module field of a routing mux.

Implements DigitalSource.


The documentation for this class was generated from the following files: