Jutiklinis šviesos diodas#

Įvadas#

„VEX IQ Touch“ LED indikatorius yra ir lemputė, ir mygtukas. Jis gali šviesti skirtingomis spalvomis, kad pateiktų grįžtamąjį ryšį, pavyzdžiui, signalizuodamas, kad robotas yra pasiruošęs, rodydamas, kuris režimas pasirinktas, arba kad spalva atitiktų kito jutiklio aptiktą spalvą, ir gali aptikti, kada yra liečiamas, leisdamas jums paleisti arba pakeisti roboto elgesį vienu bakstelėjimu.

Šiame puslapyje kaip jutiklinio šviesos diodo pavadinimo pavyzdys naudojamas touchled_1 Jei reikia, pakeiskite jį savo sukonfigūruotu pavadinimu.

Žemiau pateikiamas visų metodų sąrašas:

Veiksmai – sąveikaukite su jutikliniu LED indikatoriumi.

  • pressed — Registruoja funkciją, kuri bus iškviesta paspaudus jutiklinį šviesos diodą.

  • released — Registruoja funkciją, kuri bus iškviesta atleidus jutiklinį šviesos diodą.

  • on – Įjungia jutiklinį šviesos diodą.

  • off — Išjungia jutiklinį šviesos diodą.

  • toggle – Įjungia arba išjungia jutiklinį šviesos diodą.

Mutatoriai – keičia jutiklinio LED spalvas, ryškumą ir nustatymus.

  • set_color — Nustato jutiklinio LED spalvą.

  • set_fade — Nustato, kaip greitai spalvos išnyks viena po kitos.

  • set_brightness — Nustato jutiklinio LED ryškumą.

  • set_blink — Jutiklinis šviesos diodas pakaitomis įsijungia ir išsijungia neribotą laiką.

Getteriai – grąžina duomenis iš jutiklinio LED.

  • pressing – Grąžina, ar paspaudžiamas jutiklinis šviesos diodas.

  • installed — Grąžina, ar jutiklinis šviesos diodas prijungtas prie smegenų.

Konstruktoriai – rankiniu būdu inicijuokite ir konfigūruokite jutiklinį šviesos diodą.

  • Touchled — Sukurkite jutiklinį šviesos diodą.

Veiksmai#

pressed#

Paspaustas pressed užregistruoja funkciją, kuri bus iškviesta paspaudus jutiklinį šviesos diodą.

Usage:
touchled_1.pressed(callback, arg)

Parametrai

Aprašymas

callback

Funkcija, kuri anksčiau buvo apibrėžta vykdyti paspaudus jutiklinį šviesos diodą.

arg

Pasirinktinai. Tuple su argumentais, kuriuos reikia perduoti atgalinio iškvietimo funkcijai. Daugiau informacijos žr. Funkcijos su parametrais.

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

touchled_1.pressed(light_blue)

released#

released užregistruoja funkciją, kuri bus iškviesta atleidus jutiklinį šviesos diodą.

Usage:
touchled_1.released(callback, arg)

Parametrai

Aprašymas

callback

Funkcija, kuri anksčiau buvo apibrėžta vykdyti atleidus jutiklinį šviesos diodą.

arg

Pasirinktinai. Tuple su argumentais, kuriuos reikia perduoti atgalinio iškvietimo funkcijai. Daugiau informacijos žr. Funkcijos su parametrais.

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

touchled_1.released(light_red)

on#

on įjungia jutiklinį LED, nustatydamas jo ryškumą į 100 %.

Usage:
touchled_1.on(value)

Parametrai

Aprašymas

value

Pasirinktinai. Nustato šviesos diodo spalvą į:

  • Color.RED
  • Color.GREEN
  • Color.BLUE
  • Color.WHITE (numatytoji)
  • 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
Taip pat galite nurodyti pasirinktinę spalvą.

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

off#

off išjungia jutiklinį šviesos diodą, nustatant jo ryškumą į 0 %.

Usage:
touchled_1.off()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

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

toggle#

toggle įjungia arba išjungia jutiklinį šviesos diodą. Jei šviesos diodas šiuo metu šviečia, toggle nustato jo ryškumą į 0 %, jį išjungdamas. Jei šviesos diodas išjungtas, toggle nustato jo ryškumą į 100 %, jį įjungdamas.

Usage:
touchled_1.toggle()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

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

Mutatoriai#

set_color#

set_color nustato jutiklinio LED spalvą. Jei naudojant šį metodą jutiklinis LED dar neįsijungęs, jis bus įjungtas nustatant ryškumą į 100 %.

Usage:
touchled_1.set_color(color)

Parametrai

Aprašymas

color

Pasirinktinai. Nustato šviesos diodo spalvą į:

  • Color.RED
  • Color.GREEN
  • Color.BLUE
  • Color.WHITE (numatytoji)
  • 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
Jei nenurodyta, set_color įjungs jutiklinį LED su anksčiau nustatyta spalva.
Taip pat galite nurodyti pasirinktinę spalvą.

# 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 pakeičia, kaip jutiklinis LED pereina į naujas spalvas.

Usage:
touchled_1.set_fade(type)

Parametrai

Aprašymas

type

Kaip greitai spalva blunka iš vienos į kitą:

  • FadeType.FAST — Spalvos pereis greitai.
  • FadeType.OFF — Spalvos pereis akimirksniu.
  • FadeType.SLOW — Spalvos pereis lėtai.

# 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 nustato jutiklinio LED ryškumą.

Usage:
touchled_1.set_brightness(brightness)

Parametrai

Aprašymas

brightness

Jutiklinio LED ryškumą galima nustatyti sveikuoju skaičiumi nuo 0 % iki 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)

Getteriai#

pressing#

pressing grąžina sveikąjį skaičių, rodantį, ar šiuo metu paspaustas jutiklinis šviesos diodas.

  • 1 — Paspaudžiamas jutiklinis šviesos diodas (TouchLED).

  • 0 — Nepaspaustas jutiklinis šviesos diodas (TouchLED).

Usage:
touchled_1.pressing()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

# 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 grąžina loginę reikšmę, nurodančią, ar jutiklinis šviesos diodas yra prijungtas prie smegenų.

  • True — Jutiklinis šviesos diodas prijungtas prie smegenų.

  • False — Jutiklinis šviesos diodas neprijungtas prie smegenų.

Usage:
touchled_1.installed()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

Konstruktoriai#

Konstruktoriai naudojami rankiniu būdu sukurti Touchled objektus, kurie yra būtini norint konfigūruoti Touch LED ne VEXcode.

Touchled#

Touchled sukuria jutiklinį LED.

Usage:
touchled_1 = Touchled(smartport)

Parametras

Aprašymas

smartport

Išmanusis prievadas, prie kurio prijungtas jutiklinis šviesos diodas, rašomas kaip PORTx, kur x yra prievado numeris.

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