Interruptor de pára-choques#

Introdução#

A classe bumper é utilizada para detetar quando o interruptor Bumper é pressionado e libertado.

Construtor de Classes#

bumper( 
  int32_t index );

Destrutor de classes#

Destrói o objeto bumper e liberta os recursos associados.

virtual ~bumper();

Parâmetros#

Parâmetro

Tipo

Descrição

index

int32_t

A Smart Port à qual o Bumper Switch está ligado, escrita como PORTx, em que x é o número da porta (por exemplo, PORT1).

Exemplo#

// Create a bumper instance in Port 1
bumper Bumper1 = bumper(PORT1);

Funções de membro#

A classe bumper inclui as seguintes funções membro:

  • pressing — Retorna se o interruptor Bumper estiver a ser premido.

  • pressed — Regista uma função a ser chamada quando o botão de protecção é premido.

  • released — Regista uma função a ser chamada quando o interruptor Bumper é libertado.

Antes de chamar qualquer função membro de bumper , deve ser criada uma instância bumper , como se mostra abaixo:

/* This constructor is required when using VS Code.
Bumper Switch configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a bumper instance in Port 1
bumper Bumper1 = bumper(PORT1);

pressing#

Retorna se o botão de proteção estiver premido.

Available Functions
int32_t pressing();

Parameters

Esta função não aceita qualquer parâmetro.

Return Values

Retorna um valor int32_t indicando se o botão de paragem está a ser premido.

  • 1 — O interruptor do pára-choques está a ser premido.

  • 0 — O interruptor do pára-choques não está a ser premido.

pressed#

Regista uma função a ser chamada quando o botão de proteção é premido.

Available Functions
void pressed( void (* callback)(void) );

Parameters

Parâmetro

Tipo

Descrição

callback

void (*)(void)

Um ponteiro para uma função que será chamada quando o botão do pára-choques for premido. A função não deve receber parâmetros e deve devolver void.

Return Values

Esta função não devolve qualquer valor.

Examples

Defina a função de callback (fora de int main())

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

Registe o callback dentro de int main()

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

  // Run BumperPressed when the value of the Bumper Switch is pressed.
  Bumper1.pressed(BumperPressed);
}

released#

Regista uma função a ser chamada quando o botão de proteção é libertado.

Available Functions
void released( void (* callback)(void) );

Parameters

Parâmetro

Tipo

Descrição

callback

void (*)(void)

Um ponteiro para uma função que será chamada quando o pára-choques for libertado. A função não deve receber parâmetros e deve devolver void.

Return Values

Esta função não devolve qualquer valor.

Examples

Defina a função de callback (fora de int main())

// Display a message when bumper is released
void BumperReleased() {
  Brain.Screen.print("Bumper released");
}

Registe o callback dentro de int main()

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

  // Run BumperReleased when the value of the Bumper Switch is released.
  Bumper1.released(BumperReleased);
}