Jelzőtorony#

Bevezetés#

A Jelzőtorony egy olyan eszköz, amely színes fényekkel jelzi a robot állapotát. Beépített lökhárító kapcsolóval is rendelkezik, amely érzékeli a megnyomását.

Az alábbi példákban a konfigurált Jelzőtorony neve signal_tower_1 lesz, és ezt fogjuk használni az API dokumentáció összes további példájában, amikor SignalTower osztálymetódusokra hivatkozunk.

Az alábbiakban felsoroljuk az összes elérhető módszert:

Beállítók – Konfigurálják a jelzőtorony fényszíneit és mintázatait.

  • set_color – Beállítja egy vagy az összes jelzőtorony LED-jének mintázatát.

  • set_colors – Beállítja az egyes jelzőtorony LED-jeinek állapotát.

Getters – Olvassa le a jelzőtorony lökhárítójának állapotát.

  • pressing – Visszaadja, hogy a Jelzőtorony lökhárítója jelenleg le van-e nyomva.

Visszahívások – Kód futtatása, amikor a jelzőtorony lökhárítójának állapota megváltozik.

  • pressed – Regisztrál egy függvényt, amely a jelzőtorony lökhárítójának megnyomásakor hívódik meg.

  • released – Regisztrál egy függvényt, amely akkor hívódik meg, amikor a jelzőtorony lökhárítóját elengedik.

Konstruktorok – A jelzőtorony manuális inicializálása és konfigurálása.

szetterek#

set_color#

set_color Beállítja a jelzőtorony egy vagy összes LED-jének világítási mintázatát. Ezek a lámpák használhatók a robot projektben elfoglalt helyzetének nyomon követésére, vagy bizonyos feltételek teljesülésének jelzésére.

Usage:
signal_tower_1.set_color(value, state)

Paraméter

Leírás

érték

A vezérelendő színes fény:

  • SignalTower.RED
  • SignalTower.GREEN
  • SignalTower.BLUE
  • SignalTower.YELLOW
  • SignalTower.WHITE
  • SignalTower.ALL — A műveletet minden színre alkalmazza.

állami

Az alkalmazandó fényminta:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — A lámpák villognak.

 
# Set the Signal Tower to start blinking the blue LED
signal_tower_1.set_color(SignalTower.BLUE, signal_tower.BLINK)

set_colors#

set_colors Beállítja az egyes jelzőtorony LED-jeinek állapotát. Ezek a lámpák használhatók annak nyomon követésére, hogy a robot hol tartózkodik egy projektben, vagy bizonyos feltételek teljesülésének jelzésére.

Usage:
signal_tower_1.set_colors(r, y, g, b, w)

Paraméter

Leírás

r

A piros lámpa állapota:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — A lámpák villognak.

y

A sárga lámpa állapota:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — A lámpák villognak.

g

A zöld lámpa állapota:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — A lámpák villognak.

b

A kék fény állapota:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — A lámpák villognak.

w

A fehér fény állapota:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK — A lámpák villognak.

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

Getterek#

pressing#

pressing megnyomása egy logikai értéket ad vissza, amely jelzi, hogy a jelzőtorony lökhárítója jelenleg le van-e nyomva. Ez vészleállítóként használható.

  • True — A jelzőtorony lökhárítóját jelenleg lenyomják.

  • False — A jelzőtorony lökhárítóját nem nyomják meg.

Usage:
signal_tower_1.pressing()

Visszahívások#

pressed#

pressed Egy függvényt regisztrál, amely akkor hívódik meg, amikor a jelzőtorony lökhárítóját megnyomják.

Ez a metódus a Event osztály egy példányát adja vissza.

Usage:
signal_tower_1.pressed(callback, arg)

Paraméterek

Leírás

callback

Egy korábban definiált függvény, amely akkor hajtódik végre, amikor a jelzőtorony lökhárítóját megnyomják.

arg

Opcionális. Egy tuple, amely argumentumokat tartalmaz a visszahívó függvénynek átadandó. További információkért lásd a Függvények paraméterekkel részt.

 
# 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 egy függvényt regisztrál, amely akkor hívódik meg, amikor a jelzőtorony lökhárítóját elengedik.

Ez a metódus a Event osztály egy példányát adja vissza.

Usage:
signal_tower_1.released(callback, arg)

Paraméterek

Leírás

callback

Egy korábban definiált függvény, amely akkor hajtódik végre, amikor a jelzőtorony lökhárítóját elengedik.

arg

Opcionális. Egy tuple, amely argumentumokat tartalmaz a visszahívó függvénynek átadandó. További információkért lásd a Függvények paraméterekkel részt.

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

Konstruktorok#

SignalTower#

SignalTower létrehoz egy jelzőtornyot.

SignalTower(smartport)

Paraméter

Leírás

smartport

Az az intelligens port, amelyhez a jelzőtorony csatlakozik, Ports.PORTx formában írva, ahol x a port száma.

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