# validated: 2016-12-25 JW 69422dc0636c athena/java/edu/wpi/first/wpilibj/Compressor.java
import hal
from .sensorbase import SensorBase
__all__ = ["Compressor"]
[docs]class Compressor(SensorBase):
"""Class for operating a compressor connected to a PCM (Pneumatic Control Module).
The PCM will automatically run in closed loop mode by default whenever a
Solenoid object is created. For most cases the Compressor object does not
need to be instantiated or used in a robot program. This class is only required
in cases where the robot program needs a more detailed status of the compressor or to
enable/disable closed loop control.
Note: you cannot operate the compressor directly from this class as doing
so would circumvent the safety provided by using the pressure switch and closed loop control.
You can only turn off closed loop control, thereby stopping the compressor from operating.
"""
def __init__(self, module=None):
"""Makes a new instance of the compressor using the provided CAN device ID.
:param module: The PCM CAN device ID. (0 - 62 inclusive)
"""
self.table = None
if module is None:
module = SensorBase.getDefaultSolenoidModule()
self.compressorHandle = hal.initializeCompressor(module)
self.module = module
[docs] def start(self):
"""Start the compressor running in closed loop control mode.
Use the method in cases where you would like to manually stop and
start the compressor for applications such as conserving battery
or making sure that the compressor motor doesn't start during
critical operations.
"""
self.setClosedLoopControl(True)
[docs] def stop(self):
"""Stop the compressor from running in closed loop control mode.
Use the method in cases where you would like to manually stop and
start the compressor for applications such as conserving battery
or making sure that the compressor motor doesn't start during
critical operations.
"""
self.setClosedLoopControl(False)
[docs] def enabled(self):
"""Get the enabled status of the compressor.
:returns: True if the compressor is on
:rtype: bool
"""
return hal.getCompressor(self.compressorHandle)
[docs] def getPressureSwitchValue(self):
""" Get the pressure switch value.
:returns: True if the pressure is low
:rtype: bool
"""
return hal.getCompressorPressureSwitch(self.compressorHandle)
[docs] def getCompressorCurrent(self):
"""Get the current being used by the compressor.
:returns: Current consumed by the compressor in amps
:rtype: float
"""
return hal.getCompressorCurrent(self.compressorHandle)
[docs] def setClosedLoopControl(self, on):
"""Set the PCM in closed loop control mode.
:param on: If True sets the compressor to be in closed loop control
mode (default)
:type on: bool
"""
hal.setCompressorClosedLoopControl(self.compressorHandle, True if on else False)
[docs] def getClosedLoopControl(self):
"""Gets the current operating mode of the PCM.
:returns: True if compressor is operating on closed-loop mode
:rtype: bool
"""
return hal.getCompressorClosedLoopControl(self.compressorHandle)
[docs] def getCompressorCurrentTooHighFault(self):
"""
:returns: True if PCM is in fault state : Compressor Drive is
disabled due to compressor current being too high
"""
return hal.getCompressorCurrentTooHighFault(self.compressorHandle)
[docs] def getCompressorCurrentTooHighStickyFault(self):
"""
:returns: True if PCM sticky fault is set : Compressor is
disabled due to compressor current being too high
"""
return hal.getCompressorCurrentTooHighStickyFault(self.compressorHandle)
[docs] def getCompressorShortedFault(self):
"""
:returns: True if PCM is in fault state : Compressor output
appears to be shorted
"""
return hal.getCompressorShortedFault(self.compressorHandle)
[docs] def getCompressorShortedStickyFault(self):
"""
:returns: True if PCM sticky fault is set : Compressor output
appears to be shorted
"""
return hal.getCompressorShortedStickyFault(self.compressorHandle)
[docs] def getCompressorNotConnectedFault(self):
"""
:returns: True if PCM is in fault state : Compressor does not appear
to be wired, i.e. compressor is not drawing enough current.
"""
return hal.getCompressorNotConnectedFault(self.compressorHandle)
[docs] def getCompressorNotConnectedStickyFault(self):
"""
:returns: True if PCM sticky fault is set : Compressor does not appear
to be wired, i.e. compressor is not drawing enough current.
"""
return hal.getCompressorNotConnectedStickyFault(self.compressorHandle)
[docs] def clearAllPCMStickyFaults(self):
"""Clear ALL sticky faults inside PCM that Compressor is wired to.
If a sticky fault is set, then it will be persistently cleared. The compressor might
momentarily disable while the flags are being cleared. Doo not call this method too
frequently, otherwise normal compressor functionality may be prevented.
If no sticky faults are set then this call will have no effect.
"""
hal.clearAllPCMStickyFaults(self.module)
def getSmartDashboardType(self):
return "Compressor"
def initTable(self, subtable):
self.table = subtable
self.updateTable()
def getTable(self):
return self.table
def updateTable(self):
table = self.getTable()
if table is not None:
table.putBoolean("Enabled", self.enabled())
table.putBoolean("Pressure Switch", self.getPressureSwitchValue())