PWM¶
- class wpilib.PWM(channel: int, registerSendable: bool = True)¶
Bases:
Sendable
Class implements the PWM generation in the FPGA.
The values supplied as arguments for PWM outputs range from -1.0 to 1.0. They are mapped to the hardware dependent values, in this case 0-2000 for the FPGA. Changes are immediately sent to the FPGA, and the update occurs at the next FPGA cycle (5.005ms). There is no delay.
As of revision 0.1.10 of the FPGA, the FPGA interprets the 0-2000 values as follows: - 2000 = maximum pulse width - 1999 to 1001 = linear scaling from “full forward” to “center” - 1000 = center value - 999 to 2 = linear scaling from “center” to “full reverse” - 1 = minimum pulse width (currently 0.5ms) - 0 = disabled (i.e. PWM output is held low)
Allocate a PWM given a channel number.
Checks channel value range and allocates the appropriate channel. The allocation is only done to help users ensure that they don’t double assign channels.
- Parameters:
channel – The PWM channel number. 0-9 are on-board, 10-19 are on the MXP port
registerSendable – If true, adds this instance to SendableRegistry and LiveWindow
- class PeriodMultiplier(value: int)¶
Bases:
pybind11_object
Represents the amount to multiply the minimum servo-pulse pwm period by.
Members:
kPeriodMultiplier_1X : Don’t skip pulses. PWM pulses occur every 5.005 ms
kPeriodMultiplier_2X : Skip every other pulse. PWM pulses occur every 10.010 ms
kPeriodMultiplier_4X : Skip three out of four pulses. PWM pulses occur every 20.020 ms
- kPeriodMultiplier_1X = <PeriodMultiplier.kPeriodMultiplier_1X: 1>¶
- kPeriodMultiplier_2X = <PeriodMultiplier.kPeriodMultiplier_2X: 2>¶
- kPeriodMultiplier_4X = <PeriodMultiplier.kPeriodMultiplier_4X: 4>¶
- property name¶
- property value¶
- enableDeadbandElimination(eliminateDeadband: bool) None ¶
Optionally eliminate the deadband from a motor controller.
- Parameters:
eliminateDeadband – If true, set the motor curve on the motor controller to eliminate the deadband in the middle of the range. Otherwise, keep the full range without modifying any values.
- getChannel() int ¶
- getPosition() float ¶
Get the PWM value in terms of a position.
This is intended to be used by servos.
@pre SetMaxPositivePwm() called. @pre SetMinNegativePwm() called.
- Returns:
The position the servo is set to between 0.0 and 1.0.
- getRaw() int ¶
Get the PWM value directly from the hardware.
Read a raw value from a PWM channel.
- Returns:
Raw PWM control value.
- getRawBounds() Tuple[int, int, int, int, int] ¶
Get the bounds on the PWM values.
This Gets the bounds on the PWM values for a particular each type of controller. The values determine the upper and lower speeds as well as the deadband bracket.
- Parameters:
max – The Minimum pwm value
deadbandMax – The high end of the deadband range
center – The center speed (off)
deadbandMin – The low end of the deadband range
min – The minimum pwm value
- getSpeed() float ¶
Get the PWM value in terms of speed.
This is intended to be used by motor controllers.
@pre SetMaxPositivePwm() called. @pre SetMinPositivePwm() called. @pre SetMaxNegativePwm() called. @pre SetMinNegativePwm() called.
- Returns:
The most recently set speed between -1.0 and 1.0.
- setBounds(max: float, deadbandMax: float, center: float, deadbandMin: float, min: float) None ¶
Set the bounds on the PWM pulse widths.
This sets the bounds on the PWM values for a particular type of controller. The values determine the upper and lower speeds as well as the deadband bracket.
- Parameters:
max – The max PWM pulse width in ms
deadbandMax – The high end of the deadband range pulse width in ms
center – The center (off) pulse width in ms
deadbandMin – The low end of the deadband pulse width in ms
min – The minimum pulse width in ms
- setDisabled() None ¶
Temporarily disables the PWM output. The next set call will re-enable the output.
- setPeriodMultiplier(mult: wpilib._wpilib.PWM.PeriodMultiplier) None ¶
Slow down the PWM signal for old devices.
- Parameters:
mult – The period multiplier to apply to this channel
- setPosition(pos: float) None ¶
Set the PWM value based on a position.
This is intended to be used by servos.
@pre SetMaxPositivePwm() called. @pre SetMinNegativePwm() called.
- Parameters:
pos – The position to set the servo between 0.0 and 1.0.
- setRaw(value: int) None ¶
Set the PWM value directly to the hardware.
Write a raw value to a PWM channel.
- Parameters:
value – Raw PWM value.
- setRawBounds(max: int, deadbandMax: int, center: int, deadbandMin: int, min: int) None ¶
Set the bounds on the PWM values.
This sets the bounds on the PWM values for a particular each type of controller. The values determine the upper and lower speeds as well as the deadband bracket.
- Parameters:
max – The Minimum pwm value
deadbandMax – The high end of the deadband range
center – The center speed (off)
deadbandMin – The low end of the deadband range
min – The minimum pwm value
- setSpeed(speed: float) None ¶
Set the PWM value based on a speed.
This is intended to be used by motor controllers.
@pre SetMaxPositivePwm() called. @pre SetMinPositivePwm() called. @pre SetCenterPwm() called. @pre SetMaxNegativePwm() called. @pre SetMinNegativePwm() called.
- Parameters:
speed – The speed to set the motor controller between -1.0 and 1.0.
- setZeroLatch() None ¶