Analogā ieeja#

Ievads#

Klase analog_in tiek izmantota, lai nolasītu analogās ieejas signālus no ierīcēm, kas pievienotas VEX V5 3 vadu portam. Tā nodrošina piekļuvi pašreizējai analogajai vērtībai un ļauj reģistrēt atzvanīšanas funkcijas vērtību izmaiņām.

Klases konstruktori#

analog_in(
    triport::port &port );

Klases iznīcinātājs#

Iznīcina objektu analog_in un atbrīvo ar to saistītos resursus.

~analog_in();

Parametri#

Parametrs

Tips

Apraksts

port

triport::port&

3 vadu ports, kuram ir pievienota analogā ieeja, kas pierakstīts kā Brain.ThreeWirePort.X vai ExpanderName.X, kur X ir porta burts (piemēram, Brain.ThreeWirePort.A vai Expander1.A).

Piemērs#

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

Dalībnieku funkcijas#

Klasē analog_in ir iekļautas šādas dalībfunkcijas:

  • value — Atgriež analogās ievades ierīces vērtību.

  • changed — Reģistrē atzvanīšanas funkciju, kad mainās analogās ieejas vērtība.

Pirms jebkuru analog_in dalībfunkciju izsaukšanas ir jāizveido analog_in instance, kā parādīts zemāk:

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

Atgriež analogās ieejas pašreizējo vērtību.

Available Functions
int32_t value(
  analogUnits units );

Parameters

Parametrs

Tips

Apraksts

units

analogUnits

Vērtības attēlošanas mērvienība:

  • range8bit — 8 bitu analogā vērtība (vērtība ar 256 iespējamiem stāvokļiem)
  • range10bit — 10 bitu analogā vērtība (vērtība ar 1024 iespējamiem stāvokļiem)
  • range12bit — 12 bitu analogā vērtība (vērtība ar 4096 iespējamiem stāvokļiem)
  • pct — percent
  • mV — milivolti

Return Values

Šī funkcija atgriež analogās ieejas pašreizējo vērtību.

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

changed#

Reģistrē atzvanīšanas funkciju, kas tiks izsaukta, mainoties analogās ieejas vērtībai.

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

Parameters

Parametrs

Tips

Apraksts

callback

void (* callback)(void)

Funkcija, kas tiks izsaukta, mainoties analogās ieejas vērtībai.

Return Values

Šī funkcija neatgriež vērtību.

Examples

Definējiet atzvanīšanas funkciju (ārpus int main())

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

Reģistrējiet atzvanīšanas funkciju int main() iekšpusē

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