Analóg bemenet

Bevezetés

A analog_in osztály analóg bemeneti jelek olvasására szolgál a VEX V5 3-vezetékes portjához csatlakoztatott eszközökről. Hozzáférést biztosít az aktuális analóg értékhez, és lehetővé teszi a visszahívási függvények regisztrálását az értékváltozásokhoz.

Osztálykonstruktorok

analog_in(
    triport::port &port );

Osztálydestruktor

Megsemmisíti a analog_in objektumot és felszabadítja a hozzá tartozó erőforrásokat.

~analog_in();

Paraméterek

Paraméter	Típus	Leírás
port	triport::port&	Az analóg bemenethez tartozó 3 vezetékes port, amelyhez ez a következőképpen írható: Brain.ThreeWirePort.X vagy ExpanderName.X, ahol X a port betűjele (például Brain.ThreeWirePort.A vagy Expander1.A).

Példa

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

Tagfüggvények

A analog_in osztály a következő tagfüggvényeket tartalmazza:

• value — Visszaadja az analóg bemeneti eszköz értékét.

• changed — Visszahívó függvényt regisztrál, amikor az analóg bemenet értéke megváltozik.

Bármely analog_in tagfüggvény meghívása előtt létre kell hozni egy analog_in példányt, az alábbiak szerint:

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

Visszaadja az analóg bemenet aktuális értékét.

Available Functions

int32_t value(
  analogUnits units );

Parameters

Paraméter	Típus	Leírás
units	analogUnits	Az értéket ábrázoló mértékegység: range8bit — 8 bites analóg érték (egy érték 256 lehetséges állapottal) range10bit — 10 bites analóg érték (egy érték 1024 lehetséges állapottal) range12bit — 12 bites analóg érték (egy érték 4096 lehetséges állapottal) pct — százalék mV — millivolt

Return Values

Ez a függvény visszaadja az analóg bemenet aktuális értékét.

Examples

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

changed

Visszahívó függvényt regisztrál, amely meghívódik, amikor az analóg bemenet értéke megváltozik.

Available Functions

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

Parameters

Paraméter	Típus	Leírás
callback	void (* callback)(void)	Egy függvény, amely akkor hívódik meg, amikor az analóg bemenet értéke megváltozik.

Return Values

Ez a függvény nem ad vissza értéket.

Examples

Definiáljuk a visszahívó függvényt ( int main())

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

Regisztrálja a visszahívást a int main() függvényen belül.

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