mirror of
https://github.com/KevinMidboe/python-gpiozero.git
synced 2025-10-29 17:50:37 +00:00
02f7d20bc3
Add Servo and AngularServo implementation along with docs and tests. This is a deliberately minimal implementation designed to be added to as we agree on new extensions (better than making an all-singing, all-dancing version in which I get things wrong and then wind up making backward incompatible changes to get it right :)
97 lines
2.2 KiB
ReStructuredText
97 lines
2.2 KiB
ReStructuredText
==============
|
|
Output Devices
|
|
==============
|
|
|
|
.. currentmodule:: gpiozero
|
|
|
|
These output device component interfaces have been provided for simple use of
|
|
everyday components. Components must be wired up correctly before use in code.
|
|
|
|
.. note::
|
|
|
|
All GPIO pin numbers use Broadcom (BCM) numbering. See the :doc:`recipes`
|
|
page for more information.
|
|
|
|
|
|
LED
|
|
===
|
|
|
|
.. autoclass:: LED(pin, active_high=True, initial_value=False)
|
|
:members: on, off, toggle, blink, pin, is_lit
|
|
|
|
PWMLED
|
|
======
|
|
|
|
.. autoclass:: PWMLED(pin, active_high=True, initial_value=0, frequency=100)
|
|
:members: on, off, toggle, blink, pulse, pin, is_lit, value
|
|
|
|
RGBLED
|
|
======
|
|
|
|
.. autoclass:: RGBLED(red, green, blue, active_high=True, initial_value=(0, 0, 0), pwm=True)
|
|
:members: on, off, toggle, blink, pulse, red, green, blue, is_lit, color
|
|
|
|
Buzzer
|
|
======
|
|
|
|
.. autoclass:: Buzzer(pin, active_high=True, initial_value=False)
|
|
:members: on, off, toggle, beep, pin, is_active
|
|
|
|
Motor
|
|
=====
|
|
|
|
.. autoclass:: Motor(forward, backward, pwm=True)
|
|
:members: forward, backward, stop
|
|
|
|
Servo
|
|
=====
|
|
|
|
.. autoclass:: Servo(pin, initial_value=0, min_pulse_width=1/1000, max_pulse_width=2/1000, frame_width=20/1000)
|
|
:inherited-members:
|
|
:members:
|
|
|
|
AngularServo
|
|
============
|
|
|
|
.. autoclass:: AngularServo(pin, initial_angle=0, min_angle=-90, max_angle=90, min_pulse_width=1/1000, max_pulse_width=2/1000, frame_width=20/1000)
|
|
:inherited-members:
|
|
:members:
|
|
|
|
Base Classes
|
|
============
|
|
|
|
The classes in the sections above are derived from a series of base classes,
|
|
some of which are effectively abstract. The classes form the (partial)
|
|
hierarchy displayed in the graph below:
|
|
|
|
.. image:: images/output_device_hierarchy.*
|
|
|
|
The following sections document these base classes for advanced users that wish
|
|
to construct classes for their own devices.
|
|
|
|
DigitalOutputDevice
|
|
===================
|
|
|
|
.. autoclass:: DigitalOutputDevice(pin, active_high=True, initial_value=False)
|
|
:members:
|
|
|
|
PWMOutputDevice
|
|
===============
|
|
|
|
.. autoclass:: PWMOutputDevice(pin, active_high=True, initial_value=0, frequency=100)
|
|
:members:
|
|
|
|
OutputDevice
|
|
============
|
|
|
|
.. autoclass:: OutputDevice(pin, active_high=True, initial_value=False)
|
|
:members:
|
|
|
|
GPIODevice
|
|
==========
|
|
|
|
.. autoclass:: GPIODevice(pin)
|
|
:members:
|
|
:noindex:
|
|
|