pxt-calliope/docs/reference/led/brightness.md

Brightness

Set the brightness of the LED screen.

led.brightness();

Returns

• Number - returns the LCD screen brightness as a number from 0 to 255. A return value of 255 means the screen brightness is at 100% and 127 is about 50% brightness.

Example: maximum brightness

If the screen brightness is < 100%, the following code sets the brightness to 100% (255):

if (led.brightness() < 255) {
    led.setBrightness(255)
}

See also

set brightness, fade in, fade out