Entrada analógica

Introducción

La clase analog_in se utiliza para leer señales de entrada analógicas de dispositivos conectados a un puerto VEX V5 de 3 hilos. Proporciona acceso al valor analógico actual y permite registrar las funciones de devolución de llamada para los cambios de valor.

Constructores de clase

analog_in(
    triport::port &port );

Destructor de clase

Destruye el objeto analog_in y libera los recursos asociados.

~analog_in();

Parámetros

Parámetro	Tipo	Descripción
port	triport::port&	El puerto de 3 cables al que está conectada la entrada analógica, escrito Brain.ThreeWirePort.X Brain.ThreeWirePort.X ExpanderName.X, donde X es la letra del puerto (por ejemplo, Brain.ThreeWirePort.A o Expander1.A).

Ejemplo

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

Funciones de los miembros

La clase analog_in incluye las siguientes funciones de miembro:

• value — Devuelve el valor del dispositivo de entrada analógica.

• changed — Registra una función de devolución de llamada para cuando cambia el valor de entrada analógica.

Antes de llamar a cualquier función de miembro analog_in, se debe crear una instancia analog_in, como se muestra a continuación:

/* This constructor is required to use an
Analog Input device. Replace the values
as needed. */

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

value

Devuelve el valor actual de la entrada analógica.

Available Functions

int32_t value(
  analogUnits units );

Parameters

Parámetro	Tipo	Descripción
units	analogUnits	La unidad para representar el valor: rango8bit range8bit - valor analógico de 8 bits (un valor con 256 estados posibles) range10bit — valor analógico de 10 bits (un valor con 1024 estados posibles) range12bit — valor analógico de 12 bits (un valor con 4096 estados posibles) pct — porcentaje mV — milivoltios

Return Values

Esta función devuelve el valor actual de la entrada analógica.

Examples

// Get the current value of the Analog Input
int32_t value = AnalogInA.value();

changed

Registra una función de devolución de llamada que se llamará cuando cambie el valor de la entrada analógica.

Available Functions

void changed( void (* callback)(void) );

Parameters

Parámetro	Tipo	Descripción
callback	void (* callback)(void)	Una función que se llamará cuando cambie el valor de la entrada analógica.

Return Values

Esta función no devuelve un valor.

Examples

Defina la función de devolución de llamada (fuera de int main())

// Display a message when the input changes
void AnalogInputChanged() {
  Brain.Screen.print("analog input changed");
}

Registrar la devolución de llamada dentro de int main()

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

  // Run AnalogInputChanged when the value of the
  // Analog Input changes
  AnalogInA.changed(AnalogInputChanged);
}