2.7 KiB
Output Devices
These output device component interfaces have been provided for simple use of everyday components.
Components must be wired up correctly before used in code.
Note all GPIO pin numbers use BCM numbering. See the notes page for more information.
LED
An LED (Light emitting diode) component.
Wiring
...
Code
Ensure the LED class is imported at the top of the file:
from gpiozero import LED
Create an LED object by passing in the pin number the LED is connected to:
led = LED(2)
Methods
| Method | Description | Arguments |
|---|---|---|
on() |
Turn the LED on. | None |
off() |
Turn the LED off. | None |
toggle() |
Toggle the LED. If it's on, turn it off; if it's off, turn it on. | None |
blink() |
Make the LED turn on and off repeatedly. | on_time=1, off_time=1, n=1, background=True |
Properties
| Property | Description | Type |
|---|---|---|
pin |
The GPIO pin number the LED is connected to. | Integer |
is_active |
The current state of the pin (True if on; False if off). |
Boolean |
Buzzer
A digital Buzzer component.
Wiring
...
Code
Ensure the Buzzer class is imported at the top of the file:
from gpiozero import Buzzer
Create a Buzzer object by passing in the pin number the buzzer is connected to:
buzzer = Buzzer(3)
Methods
| Method | Description | Arguments |
|---|---|---|
on() |
Turn the buzzer on. | None |
off() |
Turn the buzzer off. | None |
toggle() |
Toggle the buzzer. If it's on, turn it off; if it's off, turn it on. | None |
blink() |
Make the buzzer turn on and off repeatedly. | on_time=1, off_time=1, n=1, background=True |
Properties
| Property | Description | Type |
|---|---|---|
pin |
The GPIO pin number the buzzer is connected to. | Integer |
is_active |
The current state of the pin (True if on; False if off). |
Boolean |
Motor
Generic single-direction motor.
Wiring
...
Code
Ensure the Motor class is imported at the top of the file:
from gpiozero import Motor
Create a Motor object by passing in the pin number the motor is connected to:
motor = Motor(4)
Methods
| Method | Description | Arguments |
|---|---|---|
on() |
Turn the motor on. | None |
off() |
Turn the motor off. | None |
Properties
| Property | Description | Type |
|---|---|---|
pin |
The GPIO pin number the motor is connected to. | Integer |
is_active |
The current state of the pin (True if on; False if off). |
Boolean |