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.

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:

  • SignalTower.RED
  • SignalTower.GREEN
  • SignalTower.BLUE
  • SignalTower.YELLOW
  • SignalTower.WHITE
  • SignalTower.ALL — Pielieto darbību visām krāsām.

štats

Pielietojamais gaismas modelis:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Gaismas mirgo ieslēdzas un izslēdzas.

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

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Gaismas mirgo ieslēdzas un izslēdzas.

y

Dzeltenās gaismas stāvoklis:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Gaismas mirgo ieslēdzas un izslēdzas.

g

Zaļās gaismas stāvoklis:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Gaismas mirgo ieslēdzas un izslēdzas.

b

Zilās gaismas stāvoklis:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Gaismas mirgo ieslēdzas un izslēdzas.

w

Baltās gaismas stāvoklis:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — Gaismas mirgo ieslēdzas un izslēdzas.

# 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

callback

Iepriekš definēta funkcija, kas tiek izpildīta, kad tiek nospiests signāltorņa buferis.

arg

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

callback

Iepriekš definēta funkcija, kas tiek izpildīta, kad tiek atbrīvots signāltorņa bamperis.

arg

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

smartport

Viedā pieslēgvieta, kurai ir pievienots signāla tornis, kas pierakstīta kā Ports.PORTx , kur x ir pieslēgvietas numurs.

# Construct a Signal Tower "signal_tower_1" with the
# SignalTower class
signal_tower_1 = SignalTower(Ports.PORT1)