mirror of
https://github.com/wpilibsuite/allwpilib
synced 2026-06-19 00:41:43 +00:00
6d854afb0e
This is a major restructuring of the WPILib repository to simply build procedures and remove the remnants of Maven from everything except the eclipse plugins. Gradle files have been largely simplified or rewritten, taking advantage of splitting up parts of the build into separate build files for ease of reading. The eclipse plugins are now in a separate project, as is ntcore. All dependencies are resolved via Maven dependencies, with the Jenkins-maintained WPILib repo. Project structures have also been simplified: we no longer have separate subprojects inside wpilibc and wpilibj. Where possible, these changes hav been done with git renames, to make sure we still have full history for all repositories. Other unrelated subprojects have also been broken out: OutlineViewer is now a separate project. Change-Id: Ib4e2a6e1a2f66427a14f16612b0e0d69ed661878
88 lines
3.6 KiB
C++
88 lines
3.6 KiB
C++
/*----------------------------------------------------------------------------*/
|
|
/* 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. */
|
|
/*----------------------------------------------------------------------------*/
|
|
#pragma once
|
|
|
|
#include "simulation/SimEncoder.h"
|
|
#include "CounterBase.h"
|
|
#include "SensorBase.h"
|
|
#include "Counter.h"
|
|
#include "PIDSource.h"
|
|
#include "LiveWindow/LiveWindowSendable.h"
|
|
|
|
#include <memory>
|
|
|
|
/**
|
|
* Class to read quad encoders.
|
|
* Quadrature encoders are devices that count shaft rotation and can sense direction. The output of
|
|
* the QuadEncoder class is an integer that can count either up or down, and can go negative for
|
|
* reverse direction counting. When creating QuadEncoders, a direction is supplied that changes the
|
|
* sense of the output to make code more readable if the encoder is mounted such that forward movement
|
|
* generates negative values. Quadrature encoders have two digital outputs, an A Channel and a B Channel
|
|
* that are out of phase with each other to allow the FPGA to do direction sensing.
|
|
*
|
|
* All encoders will immediately start counting - Reset() them if you need them
|
|
* to be zeroed before use.
|
|
*/
|
|
class Encoder : public SensorBase, public CounterBase, public PIDSource, public LiveWindowSendable
|
|
{
|
|
public:
|
|
|
|
Encoder(uint32_t aChannel, uint32_t bChannel, bool reverseDirection = false,
|
|
EncodingType encodingType = k4X);
|
|
// TODO: [Not Supported] Encoder(DigitalSource *aSource, DigitalSource *bSource, bool reverseDirection=false, EncodingType encodingType = k4X);
|
|
// TODO: [Not Supported] Encoder(DigitalSource &aSource, DigitalSource &bSource, bool reverseDirection=false, EncodingType encodingType = k4X);
|
|
virtual ~Encoder() = default;
|
|
|
|
// CounterBase interface
|
|
int32_t Get() const override;
|
|
int32_t GetRaw() const;
|
|
int32_t GetEncodingScale() const;
|
|
void Reset() override;
|
|
double GetPeriod() const override;
|
|
void SetMaxPeriod(double maxPeriod) override;
|
|
bool GetStopped() const override;
|
|
bool GetDirection() const override;
|
|
|
|
double GetDistance() const;
|
|
double GetRate() const;
|
|
void SetMinRate(double minRate);
|
|
void SetDistancePerPulse(double distancePerPulse);
|
|
void SetReverseDirection(bool reverseDirection);
|
|
void SetSamplesToAverage(int samplesToAverage);
|
|
int GetSamplesToAverage() const;
|
|
void SetPIDSourceType(PIDSourceType pidSource);
|
|
double PIDGet() override;
|
|
|
|
void UpdateTable() override;
|
|
void StartLiveWindowMode() override;
|
|
void StopLiveWindowMode() override;
|
|
std::string GetSmartDashboardType() const override;
|
|
void InitTable(std::shared_ptr<ITable> subTable) override;
|
|
std::shared_ptr<ITable> GetTable() const override;
|
|
|
|
int32_t FPGAEncoderIndex() const
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
private:
|
|
void InitEncoder(int channelA, int channelB, bool _reverseDirection, EncodingType encodingType);
|
|
double DecodingScaleFactor() const;
|
|
|
|
// TODO: [Not Supported] DigitalSource *m_aSource; // the A phase of the quad encoder
|
|
// TODO: [Not Supported] DigitalSource *m_bSource; // the B phase of the quad encoder
|
|
// TODO: [Not Supported] bool m_allocatedASource; // was the A source allocated locally?
|
|
// TODO: [Not Supported] bool m_allocatedBSource; // was the B source allocated locally?
|
|
int channelA, channelB;
|
|
double m_distancePerPulse; // distance of travel for each encoder tick
|
|
EncodingType m_encodingType; // Encoding type
|
|
int32_t m_encodingScale; // 1x, 2x, or 4x, per the encodingType
|
|
bool m_reverseDirection;
|
|
SimEncoder* impl;
|
|
|
|
std::shared_ptr<ITable> m_table;
|
|
};
|