Torre de señales#

Introducción#

La Torre de Señalización es un dispositivo indicador que proporciona información visual sobre el estado mediante luces de colores e incluye un interruptor de parachoques incorporado para detectar la interacción física.

For the examples below, the configured Signal Tower will be named signal_tower_1 and will be used in all subsequent examples throughout this API documentation when referring to SignalTower class methods.

A continuación se muestra una lista de todos los métodos disponibles:

Configuradores: Configure los colores y patrones de las luces de la torre de señalización.

  • set_color – Sets the pattern for a single Signal Tower color band.

  • set_colors – Sets the state of each Signal Tower light band.

Obtenedores: lean el estado del parachoques de la torre de señalización.

  • pressing – Returns whether the Signal Tower bumper is currently pressed.

Funciones de devolución de llamada: Ejecuta el código cuando cambia el estado del parachoques de la torre de señalización.

  • pressed – Calls a function when the Signal Tower bumper is pressed.

  • released – Calls a function when the Signal Tower bumper is released.

Constructores: Inicialicen y configuren manualmente la torre de señales.

Colocadores#

set_color#

set_color sets the light pattern of one or more color lights on the Signal Tower.

Usage:
signal_tower_1.set_color(value, state)

Parámetro

Descripción

valor

Optional. The color light to control:

  • SignalTower.RED
  • SignalTower.GREEN
  • SignalTower.BLUE
  • SignalTower.YELLOW
  • SignalTower.WHITE
  • SignalTower.ALL — Applies the action to all colors.

estado

Optional. The light pattern to apply:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK

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

set_colors#

set_colors sets the state of each Signal Tower light band.

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

Parámetro

Descripción

r

The state for the red LED:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK

y

The state for the yellow LED:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK

gramo

The state for the green LED:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK

b

The state for the blue LED:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK

w

The state for the white LED:

  • SignalTower.ON
  • SignalTower.OFF
  • SignalTower.BLINK

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

Getters#

pressing#

pressing returns a Boolean indicating whether the Signal Tower’s bumper is currently being pressed.

  • True — The Signal Tower’s bumper is currently being pressed.

  • False — The Signal Tower’s bumper is not being pressed.

Usage:
signal_tower_1.pressing()

Devoluciones de llamada#

pressed#

pressed registers a function to be called when the Signal Tower’s bumper is pressed.

This method returns an instance of the Event class.

Usage:
signal_tower_1.pressed(callback, arg)

Parámetros

Descripción

callback

Una función definida previamente que se ejecuta cuando se presiona el parachoques de la Torre de Señalización.

arg

Opcional. Una tupla que contiene los argumentos que se pasarán a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información.

 
# 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 registers a function to be called when the Signal Tower’s bumper is released.

This method returns an instance of the Event class.

Usage:
signal_tower_1.released(callback, arg)

Parámetros

Descripción

callback

Una función definida previamente que se ejecuta cuando se suelta el parachoques de la torre de señalización.

arg

Opcional. Una tupla que contiene los argumentos que se pasarán a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información.

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

Constructores#

SignalTower#

SignalTower creates a Signal Tower.

SignalTower(smartport)

Parámetro

Descripción

smartport

The Smart Port that the Signal Tower is connected to, written as Ports.PORTx where x is the number of the port.

 
# Construct a Signal Tower "signal_tower_1" with the
# SignalTower class
signal_tower_1 = SignalTower(Ports.PORT1)
En esta página