Analoginen sisääntulo#

Johdanto#

analog_in -luokkaa käytetään analogisten tulosignaalien lukemiseen laitteista, jotka on kytketty VEX EXP 3-Wire -porttiin. Se mahdollistaa pääsyn nykyiseen analogiseen arvoon ja mahdollistaa takaisinkutsutoimintojen rekisteröinnin arvojen muutoksille.

Luokanrakentajat#

analog_in(
    triport::port &port );

Luokan tuhoaja#

Tuhoaa analog_in -objektin ja vapauttaa siihen liittyvät resurssit.

~analog_in();

Parametrit#

Parametri

Tyyppi

Kuvaus

port

triport::port&

3-johtiminen portti, johon analoginen tulo on kytketty, kirjoitetaan muodossa Brain.ThreeWirePort.X tai ExpanderName.X, jossa X on portin kirjain (esimerkiksi Brain.ThreeWirePort.A tai Expander1.A).

Esimerkki#

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

Jäsenten toiminnot#

analog_in -luokka sisältää seuraavat jäsenfunktiot:

  • value — Palauttaa analogisen tulolaitteen arvon.

  • changed — Rekisteröi takaisinkutsufunktion analogisen tulon arvon muuttuessa.

Ennen minkään analog_in -jäsenfunktion kutsumista on luotava analog_in -instanssi alla olevan mukaisesti:

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

Palauttaa analogisen tulon nykyisen arvon.

Available Functions
int32_t value(
  analogUnits units );

Parameters

Parametri

Tyyppi

Kuvaus

units

analogUnits

Arvoa edustava yksikkö:

  • range8bit — 8-bittinen analoginen arvo (arvo, jolla on 256 mahdollista tilaa)
  • range10bit — 10-bittinen analoginen arvo (arvo, jolla on 1024 mahdollista tilaa)
  • range12bit — 12-bittinen analoginen arvo (arvo, jolla on 4096 mahdollista tilaa)
  • pct — prosenttiosuus
  • mV — millivoltit

Return Values

Tämä funktio palauttaa analogiatulon nykyisen arvon.

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

changed#

Rekisteröi takaisinkutsufunktion, jota kutsutaan, kun analogisen tulon arvo muuttuu.

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

Parameters

Parametri

Tyyppi

Kuvaus

callback

void (* callback)(void)

Funktio, jota kutsutaan, kun analogisen tulon arvo muuttuu.

Return Values

Tämä funktio ei palauta arvoa.

Examples

Määrittele takaisinkutsufunktio ( int main())

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

Rekisteröi takaisinkutsu 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);
}