Signāla tornis#
Ievads#
Signāla tornis ir ierīce, kas izmanto krāsainas gaismas, lai parādītu robota statusu. Tam ir arī iebūvēts bufera slēdzis, kas spēj noteikt, kad tas tiek nospiests.
Tālāk sniegtajos piemēros konfigurētais signāla tornis tiks nosaukts par signal_tower_1 un tiks izmantots visos turpmākajos piemēros šajā API dokumentācijā, atsaucoties uz SignalTower klases metodēm.
Zemāk ir visu pieejamo metožu saraksts:
Iestatītāji — konfigurējiet signāltorņa gaismas krāsas un rakstus.
set_color– Iestata viena vai visu signāla torņa gaismas diožu rakstu.set_colors– Iestata katras signāla torņa gaismas diodes stāvokli.
Getteri – Nolasa signāltorņa bufera stāvokli.
pressing– Atgriež, vai signāla torņa buferis pašlaik ir nospiests.
Atzvanīšanas funkcijas — palaidiet kodu, kad mainās signāla torņa bufera stāvoklis.
pressed– Reģistrē funkciju, kas tiks izsaukta, nospiežot signāla torņa buferi.released– Reģistrē funkciju, kas tiks izsaukta, atlaižot signāla torņa buferi.
Konstruktori — manuāli inicializējiet un konfigurējiet signāla torni.
SignalTower– Izveidojiet signāla torni.
Seteri#
set_color#
set_color iestata viena vai visu signāla torņa gaismas diožu gaismas modeli. Šīs gaismas var izmantot, lai izsekotu robota atrašanās vietu projektā vai lai parādītu, kad ir izpildīti noteikti nosacījumi.
Usage:
signal_tower_1.set_color(value, state)
Parametrs |
Apraksts |
|---|---|
vērtība |
Krāsu gaisma, kas jāvada:
|
štats |
Pielietojamais gaismas modelis:
|
# Set the Signal Tower to start blinking the blue LED
signal_tower_1.set_color(SignalTower.BLUE, signal_tower.BLINK)
set_colors#
set_colors iestata katras signāla torņa gaismas diodes stāvokli. Šīs gaismas var izmantot, lai izsekotu robota atrašanās vietu projektā vai lai parādītu, kad ir izpildīti noteikti nosacījumi.
Usage:
signal_tower_1.set_colors(r, y, g, b, w)
Parametrs |
Apraksts |
|---|---|
r |
Sarkanās gaismas stāvoklis:
|
y |
Dzeltenās gaismas stāvoklis:
|
g |
Zaļās gaismas stāvoklis:
|
b |
Zilās gaismas stāvoklis:
|
w |
Baltās gaismas stāvoklis:
|
# Turn on all LEDs
signal_tower_1.set_colors(SignalTower.ON, SignalTower.ON, SignalTower.ON, SignalTower.ON, SignalTower.ON)
# Turn on just the red LED
signal_tower_1.set_colors(SignalTower.ON, SignalTower.OFF, SignalTower.OFF, SignalTower.OFF, SignalTower.OFF)
Getteri#
pressing#
Nospiežot pressing tiek atgriezta Būla vērtība, kas norāda, vai pašlaik tiek nospiests signāltorņa buferis. To var izmantot kā avārijas apturēšanu.
True— Signalizācijas torņa buferis pašlaik tiek nospiests.False— Signalizācijas torņa bamperis netiek nospiests.
Usage:
signal_tower_1.pressing()
Atzvanīšanas#
pressed#
Nospiests pressed reģistrē funkciju, kas tiks izsaukta, nospiežot Signal Tower buferi.
Šī metode atgriež Event klases instanci.
Usage:
signal_tower_1.pressed(callback, arg)
Parametri |
Apraksts |
|---|---|
|
Iepriekš definēta funkcija, kas tiek izpildīta, kad tiek nospiests signāltorņa buferis. |
|
Neobligāti. tuple, kas satur argumentus, kas jānodod atzvanīšanas funkcijai. Plašāku informāciju skatiet sadaļā Funkcijas ar parametriem. |
# Define a function tower_button_pressed()
def tower_button_pressed():
# Print that the Signal Tower's button was pressed
# to the Brain's screen.
brain.screen.print("button pressed")
# Run tower_button_pressed when the Signal Tower's
# button is pressed.
signal_tower_1.pressed(tower_button_pressed)
released#
released reģistrē funkciju, kas tiks izsaukta, kad tiek atbrīvots Signal Tower buferis.
Šī metode atgriež Event klases instanci.
Usage:
signal_tower_1.released(callback, arg)
Parametri |
Apraksts |
|---|---|
|
Iepriekš definēta funkcija, kas tiek izpildīta, kad tiek atbrīvots signāltorņa bamperis. |
|
Neobligāti. tuple, kas satur argumentus, kas jānodod atzvanīšanas funkcijai. Plašāku informāciju skatiet sadaļā Funkcijas ar parametriem. |
# Define a function tower_button_released()
def tower_button_released():
# Print that the Signal Tower's button was released
# to the Brain's screen.
brain.screen.print("button released")
# Run tower_button_released when the Signal Tower's
# button is released.
signal_tower_1.released(tower_button_released)
Konstruktori#
SignalTower#
SignalTower izveido signāla torni.
SignalTower(smartport)
Parametrs |
Apraksts |
|---|---|
|
Viedā pieslēgvieta, kurai ir pievienots signāla tornis, kas pierakstīta kā |
# Construct a Signal Tower "signal_tower_1" with the
# SignalTower class
signal_tower_1 = SignalTower(Ports.PORT1)