Package edu.wpi.first.wpilibj.counter
Class Tachometer
java.lang.Object
edu.wpi.first.wpilibj.counter.Tachometer
- All Implemented Interfaces:
Sendable
,AutoCloseable
public class Tachometer extends Object implements Sendable, AutoCloseable
Tachometer.
The Tachometer class measures the time between digital pulses to determine the rotation speed of a mechanism. Examples of devices that could be used with the tachometer class are a hall effect sensor, break beam sensor, or optical sensor detecting tape on a shooter wheel. Unlike encoders, this class only needs a single digital input.
-
Constructor Summary
Constructors Constructor Description Tachometer(DigitalSource source)
Constructs a new tachometer. -
Method Summary
Modifier and Type Method Description void
close()
int
getEdgesPerRevolution()
Gets the number of edges per revolution.double
getFrequency()
Gets the tachometer frequency.double
getPeriod()
Gets the tachometer period.double
getRevolutionsPerMinute()
Gets the current tachometer revolutions per minute.double
getRevolutionsPerSecond()
Gets the current tachometer revolutions per second.int
getSamplesToAverage()
Gets the number of samples to average.boolean
getStopped()
Gets if the tachometer is stopped.void
initSendable(SendableBuilder builder)
Initializes thisSendable
object.void
setEdgesPerRevolution(int edgesPerRevolution)
Sets the number of edges per revolution.void
setMaxPeriod(double maxPeriod)
Sets the maximum period before the tachometer is considered stopped.void
setSamplesToAverage(int samplesToAverage)
Sets the number of samples to average.void
setUpdateWhenEmpty(boolean updateWhenEmpty)
Sets if to update when empty.
-
Constructor Details
-
Tachometer
Constructs a new tachometer.- Parameters:
source
- The DigitalSource (e.g. DigitalInput) of the Tachometer.
-
-
Method Details
-
close
- Specified by:
close
in interfaceAutoCloseable
-
getPeriod
Gets the tachometer period.- Returns:
- Current period (in seconds).
-
getFrequency
Gets the tachometer frequency.- Returns:
- Current frequency (in hertz).
-
getEdgesPerRevolution
Gets the number of edges per revolution.- Returns:
- Edges per revolution.
-
setEdgesPerRevolution
Sets the number of edges per revolution.- Parameters:
edgesPerRevolution
- Edges per revolution.
-
getRevolutionsPerSecond
Gets the current tachometer revolutions per second.setEdgesPerRevolution must be set with a non 0 value for this to return valid values.
- Returns:
- Current RPS.
-
getRevolutionsPerMinute
Gets the current tachometer revolutions per minute.setEdgesPerRevolution must be set with a non 0 value for this to return valid values.
- Returns:
- Current RPM.
-
getStopped
Gets if the tachometer is stopped.- Returns:
- True if the tachometer is stopped.
-
getSamplesToAverage
Gets the number of samples to average.- Returns:
- Samples to average.
-
setSamplesToAverage
Sets the number of samples to average.- Parameters:
samplesToAverage
- Samples to average.
-
setMaxPeriod
Sets the maximum period before the tachometer is considered stopped.- Parameters:
maxPeriod
- The max period (in seconds).
-
setUpdateWhenEmpty
Sets if to update when empty.- Parameters:
updateWhenEmpty
- Update when empty if true.
-
initSendable
Description copied from interface:Sendable
Initializes thisSendable
object.- Specified by:
initSendable
in interfaceSendable
- Parameters:
builder
- sendable builder
-