Dotykowa dioda LED#

Wstęp #

Dioda dotykowa VEX IQ Touch LED to jednocześnie światło i przycisk. Może świecić w różnych kolorach, aby przekazywać informacje zwrotne, na przykład sygnalizując gotowość robota, pokazując wybrany tryb lub dopasowując kolor do innego czujnika. Może również wykrywać dotyk, umożliwiając uruchomienie lub zmianę zachowania robota jednym dotknięciem.

Ta strona używa touchled_1 jako przykładowej nazwy Touch LED. W razie potrzeby zastąp ją własną, skonfigurowaną nazwą.

Poniżej znajduje się lista wszystkich metod:

Akcje — interakcja z diodą LED dotykową.

naciśniętopressed — rejestruje funkcję, która ma zostać wywołana po naciśnięciu diody LED dotykowej.
released — Rejestruje funkcję, która ma zostać wywołana po zwolnieniu diody LED dotykowej.
on — Włącza diodę LED dotykową.
off — Wyłącza diodę LED dotykową.
toggle — Włącza lub wyłącza diodę LED dotykową.

Mutatory — zmiana kolorów, jasności i ustawień diody LED Touch.

set_color — Ustawia kolor diody LED dotykowej.
set_fade — Ustawia szybkość, z jaką kolory będą przechodzić jeden w drugi.
set_brightness — Ustawia jasność diody LED dotykowej.
set_blink — Naprzemiennie włącza i wyłącza diodę LED Touch w nieskończoność.

Getter — zwraca dane z diody LED Touch.

pressing — Zwraca informację, czy dioda LED dotykowa jest naciśnięta.
zainstalowanoinstalled — Zwraca informację, czy dioda LED Touch jest podłączona do mózgu.

Konstruktorzy — ręczna inicjalizacja i konfiguracja diody LED dotykowej.

Touchled — Utwórz diodę LED dotykową.

Akcje #

pressed #

pressed registers a function to be called when the Touch LED is pressed.

Usage:
touchled_1.pressed(callback, arg)

Parametry	Opis
`callback`	Funkcja, która została wcześniej zdefiniowana do wykonania po naciśnięciu diody LED Touch.
`arg`	Opcjonalnie. Krotka krotka zawierająca argumenty do przekazania do funkcji wywołania zwrotnego. Więcej informacji można znaleźć w Funkcjach z parametrami.

# Turn blue while the Touch LED is pressed
def light_blue():
    touchled_1.set_color(Color.BLUE)

touchled_1.pressed(light_blue)

released #

released rejestruje funkcję, która ma zostać wywołana po zwolnieniu diody LED dotykowej.

Usage:
touchled_1.released(callback, arg)

Parametry	Opis
`callback`	Funkcja, która została wcześniej zdefiniowana do wykonania po zwolnieniu diody LED Touch.
`arg`	Opcjonalnie. Krotka krotka zawierająca argumenty do przekazania do funkcji wywołania zwrotnego. Więcej informacji można znaleźć w Funkcjach z parametrami.

# Turn red when the Touch LED is released
def light_red():
    touchled_1.set_color(Color.RED)

touchled_1.released(light_red)

on #

on włącza diodę LED Touch, ustawiając jej jasność na 100%.

Usage:
touchled_1.on(value)

Parametry	Opis
`value`	Optional. Sets the LED’s color to: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (default) `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` You can also specify a custom color.

Parametry

Opis

value

Optional. Sets the LED’s color to:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (default)
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

You can also specify a custom color.

# Turn green when the robot is moving
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

off #

off wyłącza diodę LED Touch, ustawiając jej jasność na 0%.

Usage:
touchled_1.off()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

# Turn off Touch LED when movement is over
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

toggle #

Przełącznik toggle włącza lub wyłącza diodę LED Touch. Jeśli dioda LED jest aktualnie włączona, przełącznik toggle ustawia jej jasność na 0%, wyłączając ją. Jeśli dioda LED jest wyłączona, przełącznik toggle ustawia jej jasność na 100%, włączając ją.

Usage:
touchled_1.toggle()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

# Turn the Touch LED off and on
touchled_1.set_color(Color.RED)
while True:
    touchled_1.toggle()
    wait(0.5,SECONDS)

Mutatory #

set_color #

set_color ustawia kolor diody LED Touch. Jeśli dioda LED Touch nie jest jeszcze włączona podczas korzystania z tej metody, jasność zostanie ustawiona na 100%, aby włączyć diodę LED Touch.

Usage:
touchled_1.set_color(color)

Parametry	Opis
`color`	Optional. Sets the LED’s color to: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (default) `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` If unspecified, `set_color` will turn the Touch LED on with the previously set color. You can also specify a custom color.

Parametry

Opis

color

Optional. Sets the LED’s color to:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (default)
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

If unspecified, set_color will turn the Touch LED on with the previously set color.
You can also specify a custom color.

# Change colors between blue and green
while True:
    touchled_1.set_color(Color.BLUE)
    wait(0.5, SECONDS)
    touchled_1.set_color(Color.GREEN)
    wait(0.5, SECONDS)

set_fade #

set_fade zmienia sposób, w jaki dioda LED dotykowa przechodzi na nowe kolory.

Usage:
touchled_1.set_fade(type)

Parametry	Opis
`type`	Szybkość, z jaką kolor będzie przechodził z jednego do drugiego: `FadeType.FAST` — Kolory będą szybko przechodzić. `FadeType.OFF` — Kolory będą przechodzić natychmiast. `FadeType.SLOW` — Kolory będą przechodzić powoli.

Parametry

Opis

type

Szybkość, z jaką kolor będzie przechodził z jednego do drugiego:

FadeType.FAST — Kolory będą szybko przechodzić.
FadeType.OFF — Kolory będą przechodzić natychmiast.
FadeType.SLOW — Kolory będą przechodzić powoli.

# No fade to red, then slow fade to purple
touchled_1.set_fade(FadeType.OFF)
touchled_1.set_color(Color.RED)
wait(2, SECONDS)
touchled_1.set_fade(FadeType.SLOW)
touchled_1.set_color(Color.PURPLE)

set_brightness #

set_brightness ustawia jasność diody LED dotykowej.

Usage:
touchled_1.set_brightness(brightness)

Parametry	Opis
`brightness`	Jasność diody LED dotykowej można ustawić jako liczbę całkowitą od 0% do 100%.

# Show green at different brightness levels
touchled_1.set_color(Color.GREEN)
wait(1, SECONDS)
touchled_1.set_brightness(10)
wait(1, SECONDS)
touchled_1.set_brightness(100)

set_blink #

set_blink powoduje wielokrotne miganie diody LED Touch w sposób powtarzający się.

Uwaga: Wywołanie funkcji off nie zatrzyma migania. Aby zatrzymać miganie, należy ustawić jasność diody LED na 0 za pomocą funkcji set_brightness.

Usage:
set_blink(color, ontime, offtime)

Parametry	Opis
`color`	Sets the Touch LED’s color to: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` You can also specify a custom color.
`ontime`	Czas świecenia diody LED podczas każdego mignięcia (w sekundach). Domyślnie 0,25 sekundy.
`offtime`	Czas, przez jaki dioda LED pozostaje wyłączona podczas każdego mignięcia (w sekundach). Domyślnie 0,25 sekundy.

Parametry

Opis

color

Sets the Touch LED’s color to:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

You can also specify a custom color.

ontime

Czas świecenia diody LED podczas każdego mignięcia (w sekundach). Domyślnie 0,25 sekundy.

offtime

Czas, przez jaki dioda LED pozostaje wyłączona podczas każdego mignięcia (w sekundach). Domyślnie 0,25 sekundy.

# Blink green for 2 seconds then stop
touchled_1.set_blink(Color.GREEN, 0.5, 0.5)
wait(2, SECONDS)
touchled_1.set_brightness(0)

Getters #

pressing #

Naciśnięcie pressing czy dioda LED Touch jest aktualnie naciśnięta.

1 — Naciśnięto przycisk TouchLED.
0 — Przycisk TouchLED nie jest wciśnięty.

Usage:
touchled_1.pressing()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

# Turn TouchLED green when touched
while True:
    if touchled_1.pressing():
        touchled_1.set_color(Color.GREEN)
    else:
        touchled_1.set_color(Color.RED)
    wait(50, MSEC)

installed #

installed zwraca wartość logiczną wskazującą, czy dioda LED Touch jest podłączona do mózgu.

True — Dioda LED dotykowa jest połączona z mózgiem.
False — Dioda LED Touch nie jest podłączona do mózgu.

Usage:
touchled_1.installed()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

Konstruktorzy #

Konstruktory służą do ręcznego tworzenia obiektów Touchled Touchled , które są niezbędne do skonfigurowania diody Touch LED poza programem VEXcode.

Touchled #

Touchled tworzy diodę LED dotykową.

Usage:
touchled_1 = Touchled(smartport)

Parametr	Opis
`smartport`	Smart Port, do którego podłączona jest dioda Touch LED, zapisany jako PORTx, gdzie x jest numerem portu.

# Create a Touchled in Port 1
touchled_1 = Touchled(Ports.PORT1)