Digital en #

Introducción #

The digital_in class is used to read digital input signals from devices connected to a VEX V5 3-Wire port. It provides access to the current signal state and allows callback functions to be registered for input state changes.

Constructores de clases #

digital_in( 
  triport::port &port );

Instructor de clase #

Destroys the digital_in object and releases associated resources.

~digital_in();

Parámetros #

Parámetro	Tipo	Descripción
`port`	`triport::port &`	The 3-Wire Port that the Digital Input device is connected to, written as `Brain.ThreeWirePort.X` or `ExpanderName.X`, where `X` is the port letter (for example, `Brain.ThreeWirePort.A` or `Expander1.A`).

Ejemplo #

// Create the digital_in instance on 3-Wire Port A
digital_in digin = digital_in(Brain.ThreeWirePort.A);

Funciones de los miembros #

The digital_in class includes the following member functions:

value — Returns the current state of the digital input.
high — Registers a function to be called whenever the Digital In device sends a high signal.
low — Registers a function to be called whenever the Digital Out device sends a low signal.

Before calling any digital_in member functions, a digital_in instance must be created, as shown below:

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

// Create the digital_in instance on 3-Wire Port A
digital_in DigitalInA = digital_in(Brain.ThreeWirePort.A);

value #

Devuelve el estado actual de la entrada digital.

Funciones disponibles

int32_t value();

Parámetros

Esta función no acepta ningún parámetro.

Valores de retorno

Returns an int32_t representing the current digital signal state:

1 – El puerto de entrada digital está recibiendo una señal alta (aproximadamente 5V).
0 – El puerto de entrada digital está recibiendo una señal baja (aproximadamente 0 V).

high #

Registra una función que se llamará cada vez que el dispositivo de entrada digital envíe una señal alta (aproximadamente 5 V).

Available Functions

void high( 
  void (* callback)(void) );

Parameters

Parámetro	Tipo	Descripción
`callback`	`void (* callback)(void)`	Una función que se llamará cuando la entrada sea alta.

Return Values

Esta función no devuelve ningún valor.

Examples

// Display that the input is high
void inputHigh() {
  Brain.Screen.print("digital input high");
}

// Run inputHigh when the Digital Input is high
DigitalInA.high(inputHigh);

low #

Registra una función que se llamará cada vez que el dispositivo de salida digital envíe una señal baja (aproximadamente 0 V).

Available Functions

void low( 
  void (* callback)(void) );

Parameters

Parámetro	Tipo	Descripción
`callback`	`function`	Una función que se llamará cuando la entrada sea baja.

Return Values

Esta función no devuelve ningún valor.

Examples

// Display that the input is low
void inputLow() {
  Brain.Screen.print("digital input low");
}


// Run inputLow when the Digital Input is low
DigitalInA.low(inputLow);