Analoginis įėjimas#

Įvadas#

analog_in klasė naudojama analoginiams įvesties signalams nuskaityti iš įrenginių, prijungtų prie VEX V5 3 laidų prievado. Ji suteikia prieigą prie dabartinės analoginės vertės ir leidžia registruoti grįžtamojo ryšio funkcijas vertės pokyčiams.

Klasės konstruktoriai#

analog_in(
    triport::port &port );

Klasės destruktorius#

Sunaikina analog_in objektą ir išlaisvina susijusius išteklius.

~analog_in();

Parametrai#

Parametras

Tipas

Aprašymas

port

triport::port&

3 laidų prievadas, prie kurio prijungta analoginė įvestis, užrašomas kaip Brain.ThreeWirePort.X arba ExpanderName.X, kur X yra prievado raidė (pavyzdžiui, Brain.ThreeWirePort.A arba Expander1.A).

Pavyzdys#

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

Narių funkcijos#

analog_in klasė apima šias narines funkcijas:

  • value — Grąžina analoginio įvesties įrenginio reikšmę.

  • changed — Registruoja grįžtamojo ryšio funkciją, kai pasikeičia analoginio įėjimo vertė.

Prieš iškviečiant bet kokias analog_in narių funkcijas, reikia sukurti analog_in egzempliorių, kaip parodyta žemiau:

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

Grąžina dabartinę analoginio įėjimo reikšmę.

Available Functions
int32_t value(
  analogUnits units );

Parameters

Parametras

Tipas

Aprašymas

units

analogUnits

Vienetas, skirtas reikšmei išreikšti:

  • range8bit — 8 bitų analoginė reikšmė (reikšmė su 256 galimomis būsenomis)
  • range10bit — 10 bitų analoginė reikšmė (reikšmė su 1024 galimomis būsenomis)
  • range12bit — 12 bitų analoginė reikšmė (reikšmė su 4096 galimomis būsenomis)
  • pct — procentinė dalis
  • mV — milivoltai

Return Values

Ši funkcija grąžina dabartinę analoginio įėjimo vertę.

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

changed#

Registruoja grįžtamojo ryšio funkciją, kuri bus iškviečiama, kai pasikeičia analoginio įėjimo vertė.

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

Parameters

Parametras

Tipas

Aprašymas

callback

void (* callback)(void)

Funkcija, kuri bus iškviečiama, kai pasikeis analoginio įėjimo vertė.

Return Values

Ši funkcija negrąžina reikšmės.

Examples

Apibrėžkite grįžtamojo ryšio funkciją (už int main())

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

Registruokite atgalinį iškvietimą int main() viduje

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);
}