Analogique dans

Introduction

La classe analog_in permet de lire les signaux d’entrée analogiques des périphériques connectés à un port VEX EXP 3-Wire. Elle donne accès à la valeur analogique actuelle et permet d’enregistrer des fonctions de rappel pour les changements de valeur.

Constructeurs de classes

analog_in(
    triport::port &port );

Destructeur de classe

Détruit l’objet analog_in et libère les ressources associées.

~analog_in();

Paramètres

Paramètre	Taper	Description
port	triport::port&	Le port à 3 fils auquel l’entrée analogique est connectée, écrit comme Brain.ThreeWirePort.X ou ExpanderName.X, où X est la lettre du port (par exemple, Brain.ThreeWirePort.A ou Expander1.A).

Exemple

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

Fonctions des membres

La classe analog_in comprend les fonctions membres suivantes :

• value — Renvoie la valeur du périphérique d’entrée analogique.

• changed — Enregistre une fonction de rappel pour le moment où la valeur d’entrée analogique change.

Avant d’appeler une quelconque fonction membre de analog_in , une instance analog_in doit être créée, comme indiqué ci-dessous :

/* 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

Renvoie la valeur actuelle de l’entrée analogique.

Available Functions

int32_t value(
  analogUnits units );

Parameters

Paramètre	Taper	Description
units	analogUnits	Unité de représentation de la valeur : range8bit — Valeur analogique 8 bits (256 états possibles) range10bit — Valeur analogique 10 bits (1024 états possibles) range12bit — Valeur analogique 12 bits (4096 états possibles) pct — Pourcentage mV — Millivolts

Return Values

Cette fonction renvoie la valeur actuelle de l’entrée analogique.

Examples

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

changed

Enregistre une fonction de rappel qui sera appelée lorsque la valeur de l’entrée analogique change.

Available Functions

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

Parameters

Paramètre	Taper	Description
callback	void (* callback)(void)	Une fonction qui sera appelée lorsque la valeur de l’entrée analogique changera.

Return Values

Cette fonction ne renvoie aucune valeur.

Examples

Définissez la fonction de rappel (en dehors de int main())

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

Enregistrez le rappel à l’intérieur 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);
}