LED TÁCTIL#

Introducción #

El LED VEX IQ Touch es tanto una luz como un botón. Puede brillar en diferentes colores para dar retroalimentación, como indicar que el robot está listo, mostrar qué modo está seleccionado o hacer coincidir un color detectado por otro sensor, y puede detectar cuándo se está tocando, lo que le permite iniciar o cambiar el comportamiento de un robot con un toque.

Esta página utiliza touchled_1 como ejemplo de nombre de LED táctil. Reemplácelo con su propio nombre configurado según sea necesario.

A continuación se muestra una lista de todos los métodos:

Acciones: interactúa con el LED táctil.

pressed — Registra una función que se llamará cuando se presione el LED táctil.
released — Registra una función que se llamará cuando se libere el LED táctil.
on: enciende el LED táctil.
off — Apaga el LED táctil.
toggle: enciende o apaga el LED táctil.

Mutadores: cambie los colores, el brillo y la configuración del LED táctil.

set_color — Establece el color del LED táctil.
set_fade — Establece la rapidez con la que los colores se desvanecen entre sí.
set_brightness — Establece el brillo del LED táctil.
set_blink — Alterna el LED táctil entre encendido y apagado indefinidamente.

Getters — Devuelve datos desde el LED táctil.

pressing — Devuelve si se está presionando el LED táctil.
installed — Devuelve si el LED táctil está conectado al cerebro.

Constructores: inicializa y configura manualmente el LED táctil.

Touchled — Crear un LED táctil.

Acciones #

pressed #

pressed registra una función que se llamará cuando se pulse el LED táctil.

Usage:
touchled_1.pressed(callback, arg)

Parámetros	Descripción
`callback`	Una función que se define previamente para ejecutarse cuando se presiona el LED táctil.
`arg`	Opcional. Una tupla que contiene argumentos para pasar a la función de devolución de llamada. Consulte Funciones con parámetros para obtener más información.

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

touchled_1.pressed(light_blue)

released #

released registra una función que se llamará cuando se libere el LED táctil.

Usage:
touchled_1.released(callback, arg)

Parámetros	Descripción
`callback`	Una función que se ha definido previamente para ejecutarse cuando se suelta el LED táctil.
`arg`	Opcional. Una tupla que contiene argumentos para pasar a la función de devolución de llamada. Consulte Funciones con parámetros para obtener más información.

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

touchled_1.released(light_red)

on #

on enciende el LED táctil ajustando su brillo al 100%.

Usage:
touchled_1.on(value)

Parámetros	Descripción
`value`	Opcional. Establece el color del LED en: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (predeterminado) `Color.YELLOW` `Color.RED_ORANGE` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` Color.RED_ORANGE También puede especificar un color personalizado.

Parámetros

Descripción

value

Opcional. Establece el color del LED en:

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

Color.RED_ORANGE También puede especificar un color personalizado.

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

off #

off apaga el LED táctil ajustando su brillo al 0%.

Usage:
touchled_1.off()

Parámetros	Descripción
	Este método no tiene parámetros.

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

toggle #

toggle enciende o apaga el LED táctil. Si el LED está encendido actualmente, toggle cambie su brillo a 0%, apagándolo. Si el LED está apagado, la toggle ajusta su brillo al 100%, encendiéndolo.

Usage:
touchled_1.toggle()

Parámetros	Descripción
	Este método no tiene parámetros.

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

Mutadores #

set_color #

set_color establece el color del LED táctil. Si el LED táctil aún no está encendido cuando se utiliza este método, ajustará el brillo al 100% para encender el LED táctil.

Usage:
touchled_1.set_color(color)

Parámetros	Descripción
`color`	Opcional. Establece el color del LED en: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (predeterminado) `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` Si no se especifica, `set_color` activará el LED táctil con el color establecido anteriormente. También puedes especificar un color personalizado.

Parámetros

Descripción

color

Opcional. Establece el color del LED en:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (predeterminado)
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

Si no se especifica, set_color activará el LED táctil con el color establecido anteriormente.
También puedes especificar un color personalizado.

# 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 cambia la forma en que el LED táctil cambia a nuevos colores.

Usage:
touchled_1.set_fade(type)

Parámetros	Descripción
`type`	Qué tan rápido se desvanecerá un color de uno a otro: `FadeType.FAST` — Los colores cambiarán rápidamente. `FadeType.OFF` : los colores cambiarán instantáneamente. `FadeType.SLOW` : los colores cambiarán lentamente.

Parámetros

Descripción

type

Qué tan rápido se desvanecerá un color de uno a otro:

FadeType.FAST — Los colores cambiarán rápidamente.
FadeType.OFF : los colores cambiarán instantáneamente.
FadeType.SLOW : los colores cambiarán lentamente.

# 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 establece el brillo del LED táctil.

Usage:
touchled_1.set_brightness(brightness)

Parámetros	Descripción
`brightness`	El brillo del LED táctil se ajusta como un número entero del 0% al 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 repetidamente el LED táctil en un patrón de encendido y apagado.

Nota: Llamar a off no detendrá el comportamiento de parpadeo. Para detener el comportamiento de parpadeo, establezca el brillo del LED en 0 con set_brightness.

Usage:
set_blink(color, ontime, offtime)

Parámetros	Descripción
`color`	Establece el color del LED táctil en: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_ORANGE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` Color.RED_ORANGE También puede especificar un color personalizado.
`ontime`	Cuánto tiempo permanece encendido el LED durante cada parpadeo, en segundos. El valor predeterminado es 0,25 segundos.
`offtime`	Cuánto tiempo permanece apagado el LED durante cada parpadeo, en segundos. El valor predeterminado es 0,25 segundos.

Parámetros

Descripción

color

Establece el color del LED táctil en:

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

Color.RED_ORANGE También puede especificar un color personalizado.

ontime

Cuánto tiempo permanece encendido el LED durante cada parpadeo, en segundos. El valor predeterminado es 0,25 segundos.

offtime

Cuánto tiempo permanece apagado el LED durante cada parpadeo, en segundos. El valor predeterminado es 0,25 segundos.

# 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 #

Al pulsar pressing se devuelve un número entero que indica si el LED táctil está siendo pulsado en ese momento.

1 — Se está presionando el TouchLED.
0 — No se está presionando el TouchLED.

Usage:
touchled_1.pressing()

Parámetros	Descripción
	Este método no tiene parámetros.

# 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 devuelve un booleano que indica si el LED táctil está conectado al cerebro.

True : el LED táctil está conectado al cerebro.
False — El LED táctil no está conectado al cerebro.

Usage:
touchled_1.installed()

Parámetros	Descripción
	Este método no tiene parámetros.

Constructores #

Los constructores se utilizan para crear Touchled objetos táctiles, que son necesarios para configurar un LED táctil fuera de VEXcode.

Touchled #

Touchled crea un LED táctil.

Usage:
touchled_1 = Touchled(smartport)

Parámetro	Descripción
`smartport`	El puerto inteligente al que está conectado el LED táctil, escrito como PORTx, donde x es el número del puerto.

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