Torre de señales#

Introducción #

The signaltower class is used to change lights and detect interactions with the CTE Signal Tower.

Constructores de clases #

signaltower( 
  int32_t  index );

Instructor de clase #

Destroys the signaltower object and releases associated resources.

virtual ~signaltower();

Parámetros #

Parámetro	Tipo	Descripción
`index`	`int32_t`	The Smart Port that the Signal Tower is connected to, written as `PORTx`, where `x` is the port number (for example, `PORT1`).

Ejemplos #

// Create a signal tower instance in Port 1
signaltower SignalTower = signaltower(PORT1);

Funciones de los miembros #

The signaltower class provides the following member functions:

setColor - Controla los colores y estados de los LED en la torre de señalización utilizando varios métodos de entrada.
setColors - Establece el estado de todos los LED de la torre de señalización individualmente.
setBlink - Establece el estado de parpadeo de un LED en la torre de señalización mediante la ID del LED.
setBlinkTime - Establece el tiempo entre parpadeos de los LED en la torre de señalización.
enableBlink - Habilita el parpadeo de varios LED en la torre de señalización mediante sus identificadores.
disableBlink - Deshabilita el parpadeo de varios LED en la torre de señalización por sus identificadores.
presionando - Devuelve si el parachoques de la torre de señales está siendo presionado actualmente.
presionado - Registra una función que se llamará cuando se presione el parachoques de la torre de señalización.
released - Registra una función que se llamará cuando se suelte el parachoques de la torre de señalización.

Controla los colores y estados de los LED en la torre de señalización mediante diversos métodos de entrada. Estas luces se pueden usar para rastrear la posición del robot en un proyecto o para indicar cuándo se cumplen ciertas condiciones.

Available Functions

1 — Establece el color de la torre de señales usando vex::color.
void setColor( 
  vex::color         color, 
  signaltower::state state = signaltower::state::on );

2 — Establece los colores de los LED utilizando valores RGB y YW de 32 bits.
void setColor( 
  uint32_t rgb, 
  uint32_t yw );

3 — Establece el brillo de cada LED individual mediante su ID.
void setColor( 
  ledId id, 
  uint32_t value );

4 — Establece los niveles de brillo para todos los LED individualmente.
void setColor( 
  uint8_t r, 
  uint8_t y, 
  uint8_t g, 
  uint8_t b, 
  uint8_t w );

Parameters

Parámetro	Tipo	Descripción
`color`	`vex::color`	The color to use: `red` `yellow` `green` `blue` `white` `all`
`state`	`signaltower::state`	The state for the LED: `on` (Default) – Turns the LED on. `off` – Turns the LED off. `blink` – Makes the LED blink.
`rgb`	`uint32_t`	The brightness of red, green and blue LED using a 32-bit value (e.g., red on = `0xFF0000`, green on = `0x00FF00`, and blue on = `0x0000FF`).
`yw`	`uint32_t`	The brightness of yellow and white LED using a 32-bit value (e.g., yellow on = `0xFF00` and white on = `0x00FF`).
`id`	`ledId`	The index of the LED to control: `0` – red `1` – green `2` – blue `3` – white `4` – yellow
`value`	`uint32_t`	El brillo del LED varía de 0 a 255, donde 0 significa apagado y 255 es el brillo máximo.
`r`	`uint8_t`	El brillo del LED rojo varía de 0 a 255, donde 0 significa apagado y 255 es el brillo máximo.
`y`	`uint8_t`	El brillo del LED amarillo varía de 0 a 255, donde 0 significa apagado y 255 es el brillo máximo.
`g`	`uint8_t`	El brillo del LED verde varía de 0 a 255, donde 0 significa apagado y 255 es el brillo máximo.
`b`	`uint8_t`	El brillo del LED azul varía de 0 a 255, donde 0 significa apagado y 255 es el brillo máximo.
`w`	`uint8_t`	El brillo del LED blanco varía de 0 a 255, donde 0 significa apagado y 255 es el brillo máximo.

Return Values

Esta función no devuelve ningún valor.

Examples

// Set the Signal Tower to start blinking blue
SignalTower.setColor(vex::color::blue, signaltower::blink);

// Set the red, blue and white LEDs using hex values
SignalTower.setColor(0xFF00FF, 0x00FF);

// Set the green LED to full brightness by ID
SignalTower.setColor(1, 255);

// Set all LEDs to full brightness
SignalTower.setColor(255, 255, 255, 255, 255);

setColors #

Configura individualmente el estado de todos los LED de la torre de señalización. Estas luces se pueden usar para rastrear la posición del robot en un proyecto o para indicar cuándo se cumplen ciertas condiciones.

Available Functions

void setColors( 
  signaltower::state rs, 
  signaltower::state ys, 
  signaltower::state gs, 
  signaltower::state bs, 
  signaltower::state ws );

Parameters

Parámetro	Tipo	Descripción
`rs`	`signaltower::state`	The state of the red LED: `on` – Turns the LED on. `off` – Turns the LED off. `blink` – Makes the LED blink.
`ys`	`signaltower::state`	The state of the yellow LED: `on` – Turns the LED on. `off` – Turns the LED off. `blink` – Makes the LED blink.
`gs`	`signaltower::state`	The state of the green LED: `on` – Turns the LED on. `off` – Turns the LED off. `blink` – Makes the LED blink.
`bs`	`signaltower::state`	The state of the blue LED: `on` – Turns the LED on. `off` – Turns the LED off. `blink` – Makes the LED blink.
`ws`	`signaltower::state`	The state of the white LED: `on` – Turns the LED on. `off` – Turns the LED off. `blink` – Makes the LED blink.

Return Values

Esta función no devuelve ningún valor.

Examples

// Turn on all LEDs
SignalTower.setColors(signaltower::on, signaltower::on, signaltower::on, signaltower::on, signaltower::on);

setBlink #

Establece el estado de parpadeo de un LED en la torre de señalización mediante su ID. Estas luces intermitentes se pueden usar para indicar cuándo se cumplen ciertas condiciones, como cuando el robot está esperando o cuando se requiere atención.

Available Functions

void setBlink( 
  ledId id, 
  bool  enable );

Parameters

Parámetro	Tipo	Descripción
`id`	`ledId`	The LED ID: `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`enable`	`bool`	`true` – Enables blinking. `false` – Disables blinking.

Parámetro

Tipo

Descripción

id

ledId

The LED ID:

0 – red
1 – green
2 – blue
3 – white
4 – yellow
99 – none

enable

bool

true – Enables blinking.
false – Disables blinking.

Return Values

Esta función no devuelve ningún valor.

setBlinkTime #

Configura el tiempo entre parpadeos de los LED en la torre de señalización.

Available Functions

void setBlinkTime( 
  uint32_t onTime, 
  uint32_t offTime = 0 );

Parameters

Parámetro	Tipo	Descripción
`onTime`	`uint32_t`	El tiempo en milisegundos que el LED debe permanecer encendido al parpadear. El máximo es de 2500 ms. Un valor de 0 establece por defecto un tiempo de 500 ms.
`offTime`	`uint32_t`	Tiempo en milisegundos que el LED debe permanecer apagado al parpadear. El máximo es 2500 ms. Un valor de 0 utiliza el valor de onTime. El valor predeterminado es 0.

Return Values

Esta función no devuelve ningún valor.

enableBlink #

Permite que varios LED de la torre de señalización parpadeen según sus identificadores.

Available Functions

void enableBlink( 
  ledId id0, 
  ledId id1 = ledId::none, 
  ledId id2 = ledId::none, 
  ledId id3 = ledId::none, 
  ledId id4 = ledId::none );

Parameters

Parámetro	Tipo	Descripción
`id0`	`ledId`	The LED ID: `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`id1`	`ledId`	The index of the second LED (optional). Default is `ledId::none`. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`id2`	`ledId`	The index of the third LED (optional). Default is `ledId::none`. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`id3`	`ledId`	The index of the fourth LED (optional). Default is `ledId::none`. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`id4`	`ledId`	The index of the fifth LED (optional). Default is `ledId::none`. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none

Return Values

Esta función no devuelve ningún valor.

disableBlink #

Desactiva el parpadeo de varios LED en la torre de señalización mediante sus identificadores.

Available Functions

void disableBlink( 
  ledId id0, 
  ledId id1 = ledId::none, 
  ledId id2 = ledId::none, 
  ledId id3 = ledId::none, 
  ledId id4 = ledId::none );

Parameters

Parámetro	Tipo	Descripción
`id0`	`ledId`	The index of the first LED. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`id1`	`ledId`	The index of the second LED (optional). Default is `ledId::none`. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`id2`	`ledId`	The index of the third LED (optional). Default is `ledId::none`. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`id3`	`ledId`	The index of the fourth LED (optional). Default is `ledId::none`. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none
`id4`	`ledId`	The index of the fifth LED (optional). Default is `ledId::none`. `0` – red `1` – green `2` – blue `3` – white `4` – yellow `99` – none

Return Values

Esta función no devuelve ningún valor.

pressing #

Indica si se está presionando el parachoques de la torre de señalización. Esto puede utilizarse como parada de emergencia.

Available Functions

bool pressing();

Parameters

Esta función no tiene parámetros.

Return Values

Devuelve un valor booleano que indica si el parachoques de la torre de señalización está siendo presionado en ese momento.

true — The Signal Tower’s bumper is currently being pressed.
false — The Signal Tower’s bumper is not being pressed.

pressed #

Registra una función que se llamará cuando se presione el parachoques de la torre de señalización.

Available Functions

void pressed( void (* callback)(void) );

Parameters

Parámetro	Tipo	Descripción
`callback`	`void (*)(void)`	Un puntero a una función que se llamará cuando se presione el parachoques.

Return Values

Esta función no devuelve ningún valor.

Examples

Define the callback function (outside of int main())

// Display a message when bumper is pressed
void towerBumperPressed() {
  Brain.Screen.print("tower bumper pressed");
}

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run towerBumperPressed when the tower bumper 
  // is pressed
  SignalTower.pressed(towerBumperPressed);
}

released #

Registra una función que se llamará cuando se suelte el parachoques de la torre de señalización.

Available Functions

void released( void (* callback)(void) );

Parameters

Parámetro	Tipo	Descripción
`callback`	`void (*)(void)`	Un puntero a una función que se llamará cuando se suelte el parachoques.

Return Values

Esta función no devuelve ningún valor.

Examples

Define the callback function (outside of int main())

// Display a message when bumper is pressed
void towerBumperReleased() {
  Brain.Screen.print("tower bumper pressed");
}

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run towerBumperReleased when the tower bumper 
  // is released
  SignalTower.pressed(towerBumperReleased);
}