LED tactile

Introduction

Le VEX IQ Touch LED fait à la fois office de voyant et de bouton. Il peut s’illuminer de différentes couleurs pour fournir des informations, par exemple pour signaler que le robot est prêt, indiquer le mode sélectionné ou correspondre à une couleur détectée par un autre capteur. Il détecte également le contact, ce qui permet de démarrer ou de modifier le comportement du robot d’une simple pression.

Cette page utilise touchled_1 comme nom d’exemple pour la LED tactile. Remplacez-le par le nom que vous avez configuré.

Vous trouverez ci-dessous la liste de toutes les méthodes :

Actions — Interagissez avec la LED tactile.

• pressed — Enregistre une fonction à appeler lorsque la LED tactile est pressée.

• released — Enregistre une fonction à appeler lorsque la LED tactile est relâchée.

• on — Allume la LED tactile.

• off — Éteint la LED tactile.

• toggle — Active ou désactive la LED tactile.

Modificateurs — Modifiez les couleurs, la luminosité et les paramètres de la LED tactile.

• set_color — Définit la couleur de la LED tactile.

• set_fade — Définit la vitesse à laquelle les couleurs se fondent les unes dans les autres.

• set_brightness — Définit la luminosité de la LED tactile.

• set_blink — Faire clignoter et éteindre la LED tactile de manière alternée indéfiniment.

Récupérateurs — Renvoient les données de la LED tactile.

• pressing — Renvoie si la LED tactile est enfoncée.

• installed — Renvoie si la LED tactile est connectée au cerveau.

Constructeurs — Initialisez et configurez manuellement la LED tactile.

• Touchled — Créer une LED tactile.

Actes

pressed

Appuyer sur pressed enregistre une fonction à appeler lorsque la LED tactile est enfoncée.

Usage:
touchled_1.pressed(callback, arg)

Paramètres	Description
callback	Une fonction qui a été préalablement définie pour s’exécuter lorsque la LED tactile est enfoncée.
arg	Facultatif. Un tuple contenant les arguments à transmettre à la fonction de rappel. Voir Fonctions avec paramètres pour plus d’informations.

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

touchled_1.pressed(light_blue)

released

released enregistre une fonction à appeler lorsque la LED tactile est relâchée.

Usage:
touchled_1.released(callback, arg)

Paramètres	Description
callback	Une fonction qui a été préalablement définie pour s’exécuter lorsque la LED tactile est relâchée.
arg	Facultatif. Un tuple contenant les arguments à transmettre à la fonction de rappel. Voir Fonctions avec paramètres pour plus d’informations.

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

touchled_1.released(light_red)

on

on active la LED tactile en réglant sa luminosité à 100 %.

Usage:
touchled_1.on(value)

Paramètres	Description
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 éteint la LED tactile en réglant sa luminosité à 0 %.

Usage:
touchled_1.off()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

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

toggle

Le bouton toggle active ou désactive la LED tactile. Si la LED est allumée, le bouton toggle la désactive en réglant sa luminosité à 0 %. Si la LED est éteinte, le bouton toggle la réactive en réglant sa luminosité à 100 %.

Usage:
touchled_1.toggle()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

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

Mutateurs

set_color

La commande `set_color ) définit la couleur de la LED tactile. Si la LED tactile n’est pas déjà allumée lors de l’utilisation de cette méthode, sa luminosité sera réglée à 100 % pour l’allumer.

Usage:
touchled_1.set_color(color)

Paramètres	Description
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 modifie la façon dont la LED tactile passe aux nouvelles couleurs.

Usage:
touchled_1.set_fade(type)

Paramètres	Description
type	Vitesse de transition des couleurs : FadeType.FAST — Transition rapide. FadeType.OFF — Transition instantanée. FadeType.SLOW — Transition lente.

# 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 définit la luminosité de la LED tactile.

Usage:
touchled_1.set_brightness(brightness)

Paramètres	Description
brightness	La luminosité de la LED tactile se règle sur un nombre entier compris entre 0 % et 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 fait clignoter la LED tactile de manière répétée selon un motif marche/arrêt.

Remarque : L’appel à off n’arrêtera pas le clignotement. Pour arrêter le clignotement, réglez la luminosité de la LED sur 0 avec set_brightness.

Usage:
set_blink(color, ontime, offtime)

Paramètres	Description
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	Durée d’allumage de la LED lors de chaque clignotement, en secondes. Par défaut : 0,25 seconde.
offtime	Durée d’extinction de la LED lors de chaque clignotement, en secondes. Par défaut : 0,25 seconde.

# 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

Appuyer sur pressing renvoie un entier indiquant si la LED tactile est actuellement enfoncée.

• 1 — La TouchLED est enfoncée.

• 0 — La LED tactile n’est pas enfoncée.

Usage:
touchled_1.pressing()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

# 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 renvoie une valeur booléenne indiquant si la LED tactile est connectée au cerveau.

• True — La LED tactile est connectée au cerveau.

• False — La LED tactile n’est pas connectée au cerveau.

Usage:
touchled_1.installed()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

Constructeurs

Les constructeurs sont utilisés pour créer manuellement Touchled , qui sont nécessaires pour configurer une LED tactile en dehors de VEXcode.

Touchled

Touchled crée une LED tactile.

Usage:
touchled_1 = Touchled(smartport)

Paramètre	Description
smartport	Le port intelligent auquel la LED tactile est connectée est noté PORTx, où x est le numéro du port.

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