LED sensível ao toque#

Introdução #

O VEX IQ Touch LED funciona como luz e botão. Pode brilhar em diferentes cores para fornecer feedback, como sinalizar que o robô está pronto, mostrar qual o modo selecionado ou combinar com uma cor detetada por outro sensor. Além disso, deteta quando é tocado, permitindo iniciar ou alterar o comportamento do robô com um simples toque.

Esta página utiliza touchled_1 como exemplo do nome do LED táctil. Substitua-o pelo nome que configurou, se necessário.

Segue-se uma lista de todos os métodos:

Ações — Interaja com o LED sensível ao toque.

pressed — Regista uma função a ser chamada quando o LED de toque é premido.
released — Regista uma função a ser chamada quando o LED de toque é libertado.
on — Liga o LED táctil.
off — Desliga o LED táctil.
toggle — Liga ou desliga o LED táctil.

Modificadores — Altere as cores, o brilho e as definições do LED sensível ao toque.

set_color — Define a cor do LED de toque.
set_fade — Define a velocidade com que as cores se vão misturar.
set_brightness — Define o brilho do LED de toque.
set_blink — Alterna o LED de toque ligado e desligado indefinidamente.

Getters — Retornam os dados do LED sensível ao toque.

pressing — Retorna se o LED de toque está a ser premido.
installed — Retorna se o LED de toque está ligado ao cérebro.

Construtores — Inicialize e configure manualmente o LED sensível ao toque.

Touchled — Criar um LED sensível ao toque.

Ações #

pressed #

O comando pressed registam uma função a ser chamada quando o LED táctil é premido.

Usage:
touchled_1.pressed(callback, arg)

Parâmetros	Descrição
`callback`	Uma função que está previamente definida para ser executada quando o LED de toque é pressionado.
`arg`	Opcional. Uma tupla contendo argumentos para passar para a função de callback. Consulte Funções com Parâmetros para obter mais informações.

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

touchled_1.pressed(light_blue)

released #

released regista uma função a ser chamada quando o LED táctil for libertado.

Usage:
touchled_1.released(callback, arg)

Parâmetros	Descrição
`callback`	Uma função que está previamente definida para ser executada quando o LED de toque é libertado.
`arg`	Opcional. Uma tupla contendo argumentos para passar para a função de callback. Consulte Funções com Parâmetros para obter mais informações.

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

touchled_1.released(light_red)

on #

O comando on liga o LED sensível ao toque, definindo o seu brilho para 100%.

Usage:
touchled_1.on(value)

Parâmetros	Descrição
`value`	Opcional. Define a cor do LED para: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (padrão) `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` Também pode especificar uma cor personalizada.

Parâmetros

Descrição

value

Opcional. Define a cor do LED para:

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

Também pode especificar uma cor personalizada.

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

off #

off desliga o LED táctil, definindo o seu brilho para 0%.

Usage:
touchled_1.off()

Parâmetros	Descrição
	Este método não tem 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 liga ou desliga o LED táctil. Se o LED estiver ligado, toggle define o seu brilho para 0%, desligando-o. Se o LED estiver desligado, toggle define o seu brilho para 100%, ligando-o.

Usage:
touchled_1.toggle()

Parâmetros	Descrição
	Este método não tem parâmetros.

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

Mutantes #

set_color #

O comando set_color define a cor do LED sensível ao toque. Se o LED sensível ao toque não estiver aceso quando este método for utilizado, o brilho será definido para 100% para o acender.

Usage:
touchled_1.set_color(color)

Parâmetros	Descrição
`color`	Opcional. Define a cor do LED para: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (padrão) `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` Se não for especificado, `set_color` ligará o LED Touch com a cor previamente definida. Também pode especificar uma cor personalizada.

Parâmetros

Descrição

color

Opcional. Define a cor do LED para:

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

Se não for especificado, set_color ligará o LED Touch com a cor previamente definida.
Também pode especificar uma cor personalizada.

# 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 altera a forma como o LED sensível ao toque faz a transição para novas cores.

Usage:
touchled_1.set_fade(type)

Parâmetros	Descrição
`type`	Velocidade de transição de uma cor para outra: `FadeType.FAST` — As cores transitam rapidamente. `FadeType.OFF` — As cores transitam instantaneamente. `FadeType.SLOW` — As cores transitam lentamente.

Parâmetros

Descrição

type

Velocidade de transição de uma cor para outra:

FadeType.FAST — As cores transitam rapidamente.
FadeType.OFF — As cores transitam instantaneamente.
FadeType.SLOW — As cores transitam 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 define o brilho do LED sensível ao toque.

Usage:
touchled_1.set_brightness(brightness)

Parâmetros	Descrição
`brightness`	O brilho do LED sensível ao toque pode ser definido como um número inteiro de 0% a 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 pisca repetidamente o LED de toque num padrão de ligar/desligar.

Nota: Chamar off não irá interromper o comportamento de piscar. Para interromper o comportamento de piscar, defina o brilho do LED para 0 com set_brightness.

Usage:
set_blink(color, ontime, offtime)

Parâmetros	Descrição
`color`	Define a cor do LED táctil para: `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` Também pode especificar uma cor personalizada.
`ontime`	Tempo que o LED permanece aceso durante cada pestanejo, em segundos. O valor predefinido é 0,25 segundos.
`offtime`	Tempo que o LED permanece apagado durante cada pestanejo, em segundos. O valor predefinido é 0,25 segundos.

Parâmetros

Descrição

color

Define a cor do LED táctil para:

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

Também pode especificar uma cor personalizada.

ontime

Tempo que o LED permanece aceso durante cada pestanejo, em segundos. O valor predefinido é 0,25 segundos.

offtime

Tempo que o LED permanece apagado durante cada pestanejo, em segundos. O valor predefinido é 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 #

pressing returns an integer indicating whether the Touch LED is currently being pressed.

1 — O TouchLED está a ser pressionado.
0 — O TouchLED não está a ser premido.

Usage:
touchled_1.pressing()

Parâmetros	Descrição
	Este método não tem 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 devolve um valor booleano indicando se o LED de toque está ligado ao cérebro.

True — O LED sensível ao toque está ligado ao cérebro.
False — O LED sensível ao toque não está ligado ao cérebro.

Usage:
touchled_1.installed()

Parâmetros	Descrição
	Este método não tem parâmetros.

Construtores #

Os construtores são utilizados para criar manualmente Touchled , que são necessários para configurar um LED sensível ao toque fora do VEXcode.

Touchled #

Touchled cria um LED sensível ao toque.

Usage:
touchled_1 = Touchled(smartport)

Parâmetro	Descrição
`smartport`	A porta inteligente à qual o LED sensível ao toque está ligado é representada por PORTx, onde x é o número da porta.

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