信号塔#

介绍#

信号塔 是一种指示装置，它使用彩色灯光提供视觉状态反馈，并包含一个内置的碰撞开关，用于检测物理交互。

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.

以下是所有可用方法的列表：

设置人员——配置信号塔灯光的颜色和模式。

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

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

Getters – 请阅读信号塔保险杠的状态说明。

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

回调函数 – 当信号塔保险杠状态改变时运行代码。

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

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

建造者 – 手动初始化和配置信号塔。

二传手#

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)

范围

描述

价值

Optional. The color light to control:

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

状态

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)

范围

描述

r

The state for the red LED:

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

是

The state for the yellow LED:

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

克

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

西

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)

获取器#

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

回调函数#

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)

参数

描述

callback

先前定义的 函数，当信号塔的保险杠被按下时执行。

arg

可选。包含要传递给回调函数的参数的元组。有关更多信息，请参阅使用带参数的函数。

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

参数

描述

callback

先前定义的 函数，当信号塔的保险杠被释放时执行。

arg

可选。包含要传递给回调函数的参数的元组。有关更多信息，请参阅使用带参数的函数。

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

构造函数#

SignalTower#

SignalTower creates a Signal Tower.

SignalTower(smartport)

范围

描述

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)
On this page