pxt-calliope/docs/reference/led/enable.md
Juri Wolf 5f7a8e5301
Updates for V4 (#197)
* update yotta defaults for 16kb devices

* refactor deprecated blocks

* updates for button events

* update button events

* update refference

* update docs

* update docs

* update button event blocks

* update docs

* update block id
2022-08-10 09:36:19 -07:00

34 lines
918 B
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Enable
Turns the LED screen on and off
```sig
led.enable(false);
```
## Parameters
* ``on`` is a [boolean](/types/boolean) that defines the on/off state of the screen
## Example: Turning off the screen
This program turns off the screen when pressing button ``B``
```blocks
input.onButtonEvent(Button.B, input.buttonEventClick(), () => {
led.enable(false)
});
```
## Pins: P3, P4, P6, P7, P9, P10
These pins are coupled to the LED matrix display, and also its associated ambient light sensing mode.
To disable the display driver feature (which will automatically disable the light sensing feature) call the DAL function ``led.enable(false)``.
To turn the display driver back on again later, call ``led.enable(true)``.
More information at http://tech.microbit.org/hardware/edgeconnector_ds/ .
## See also
[unplot](/reference/led/unplot), [point](/reference/led/point), [LED screen](/device/screen)