Numérique dans

Introduction

La classe digital_in permet au V5 Brain de lire un signal numérique provenant d’une source externe, comme un interrupteur ou un capteur. Elle détecte si la ligne d’entrée est à l’état haut (5 volts) ou bas (0 volt). Ceci peut servir à déterminer les états marche/arrêt ou à déclencher des événements dans un projet.

Constructeurs de classes

digital_in(
  triport::port &port );

Destructeur de classe

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

~digital_in();

Paramètres

Paramètre	Taper	Description
port	triport::port &	Le port à 3 fils auquel le périphérique d’entrée numérique est connecté, é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 digital_in instance on 3-Wire Port A
digital_in digin = digital_in(Brain.ThreeWirePort.A);

Fonctions des membres

La classe digital_in comprend les fonctions membres suivantes :

• value — Renvoie si le port Digital In reçoit un signal haut ou bas.

• high — Enregistre une fonction à appeler chaque fois que le périphérique Digital In envoie un signal haut.

• low — Enregistre une fonction à appeler chaque fois que le périphérique Digital In envoie un signal bas.

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

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

Indique si le port d’entrée numérique reçoit un signal haut ou bas.

Fonctions disponibles

int32_t value();

Paramètres

Cette fonction n’accepte aucun paramètre.

Valeurs de retour

Renvoie un int32_t int32_t représentant l’état actuel du signal numérique :

• 1 – Le port Digital In reçoit un signal élevé (environ 5 V).

• 0 – Le port Digital In reçoit un signal faible (environ 0 V).

high

Enregistre une fonction à appeler chaque fois que le périphérique Digital In envoie un signal haut (environ 5 V).

Available Functions

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

Parameters

Paramètre	Taper	Description
callback	void (* callback)(void)	Une fonction qui sera appelée lorsque l’entrée sera à l’état haut.

Return Values

Cette fonction ne renvoie aucune valeur.

Examples

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

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

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 inputHigh when the Digital Input is high
  DigitalInA.high(inputHigh);
}

low

Enregistre une fonction à appeler chaque fois que le périphérique Digital In envoie un signal bas (environ 0 V).

Available Functions

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

Parameters

Paramètre	Taper	Description
callback	void (* callback)(void)	Une fonction qui sera appelée lorsque l’entrée est basse.

Return Values

Cette fonction ne renvoie aucune valeur.

Examples

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

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

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 inputLow when the Digital Input is low
  DigitalInA.low(inputLow);
}