Light

../_images/pupdevice-light.png
Alighton
class Light(port)

LEGO® Powered Up Light.

Parameters:

port (Port) – Port to which the device is connected.

100%lightlighton
on(brightness=100)

Turns on the light at the specified brightness.

Parameters:

brightness (Number, %) – Brightness of the light.

lightlightoff
off()

Turns off the light.

Examples

Gradually change the brightness

from pybricks.pupdevices import Light
from pybricks.parameters import Port
from pybricks.tools import wait, StopWatch

from umath import pi, cos

# Initialize the light and a StopWatch.
light = Light(Port.A)
watch = StopWatch()

# Cosine pattern properties.
PERIOD = 2000
MAX = 100

# Make the brightness fade in and out.
while True:
    # Get phase of the cosine.
    phase = watch.time() / PERIOD * 2 * pi

    # Evaluate the brightness.
    brightness = (0.5 - 0.5 * cos(phase)) * MAX

    # Set light brightness and wait a bit.
    light.on(brightness)
    wait(10)