pwm.pca9685
Platypush documentation
pwm.pca9685
- class platypush.plugins.pwm.pca9685.PwmPca9685Plugin(frequency: float, min_duty_cycle: int = 0, max_duty_cycle: int = 65535, channels: Iterable[int] = (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15), **kwargs)[source]
Bases:
Plugin
This plugin interacts with an Adafruit PCA9685 circuit, a 16-channel PWM servo driver. You can leverage this plugin to control servos and motors through Platypush.
Note that the driver for PCA9685 has been written for CircuitPython, and in order to use it on a Raspberry Pi or similar devices you need to follow these steps:
# pip3 install --upgrade adafruit-python-shell $ wget https://raw.githubusercontent.com/adafruit/Raspberry-Pi-Installer-Scripts/master/raspi-blinka.py # python3 raspi-blinka.py
Then reboot and check that the following virtual devices are available:
- /dev/i2c-1 - /dev/spidev0.0 - /dev/spidev0.1
Finally, install the PCA9685 drivers:
# pip3 install --upgrade adafruit-circuitpython-pca9685
This plugin works with a PCA9685 circuit connected to the Platypush host over I2C interface.
Requires:
adafruit-circuitpython-pca9685 (
pip install adafruit-circuitpython-pca9685
)
- __init__(frequency: float, min_duty_cycle: int = 0, max_duty_cycle: int = 65535, channels: Iterable[int] = (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15), **kwargs)[source]
- Parameters:
frequency – Default PWM frequency to use for the driver, in Hz.
min_duty_cycle – Minimum PWM duty cycle (you can often find it in the documentation of your device). Default: 0.
max_duty_cycle – Maximum PWM duty cycle (you can often find it in the documentation of your device). Default: 0xffff.
(default (Indices of the default channels to be controlled) – all channels, i.e.
[0-15]
).
- get_channels() Dict[int, float] [source]
Get the current duty cycle value of the channels.
- Returns:
A map in the format
channel_index -> value
, wherevalue
is the duty cycle of the associated channel, as a percentage value between 0 and 1.
- write(value: Optional[int] = None, channels: Optional[Dict[int, float]] = None, frequency: Optional[float] = None, step: Optional[int] = None, step_duration: Optional[float] = None)[source]
Send PWM values to the channels.
- Parameters:
value – Send the value to all the channels (or to all the configured default channels).
value
andchannels
are mutually exclusive.channels – Map of the values to be written, as a
channel_index -> value
, where value is a real number.value
andchannels
are mutually exclusive.frequency – Override default frequency.
step – If set, then the PWM duty cycle will be increased/decreased by this much per cycle (i.e. 1/frequency). This is useful when dealing with PWM devices that require smooth transitions, arming sequences or ramping signals. If None (default) then the new PWM values will be directly written with no ramping logic.
step_duration – If step is configured, this parameter identifies how long each step should last (default:
1/frequency
).