Funktionen der Library MySerialRead
MySerialRead MySerialRead
Funktion: Erzeugt eine neue Instanz
Parameter: keine
bool readFloat(float* zahl, uint8_t modus )
Funktion: Liest eine Float-Zahl vom Seriellen Monitor
Parameter: zahl: Float-Zahl "call by pointer" (-3.4028235E+38 <= zahl <= +3.4028235E+38)
(Als Dezimalpunkt kann auch ein Beistrich verwendet werden -> Ziffernblockeingabe)
modus: Übergabemodus SERIAL_WAIT oder SERIAL_CONT
SERIAL_WAIT: es wird auf die Eingabe gewartet (Programmablauf wird gestoppt)
SERIAL_CONT: es wird nicht auf die Eingabe gewartet, die Funktion muss
kontinuierlich aufgerufen werden
Rückgabe: TRUE, wenn Lesen der Float-Zahl erfolgreich, sonst FALSE
Beispiel:
if (SerialRead.readFloat(&f_zahl, SERIAL_WAIT)) Serial.print(f_zahl);
//Achtung auf reference operator "&")
Bemerkung: Float-Zahlen haben nur eine Genauigkeit von 6-7 Digits. Das bedeutet die Gesamtanzahl der Digits, nicht die Anzahl der Digits auf der rechten Seite des Dezimalpunktes! (Siehe dazu: www.arduino.cc/en/Reference/Float , wo es heißt: Floats have only 6-7 decimal digits of precision. That means the total number of digits, not the number to the right of the decimal point.)
bool readByte(byte* zahl, uint8_t modus )
Funktion: Liest eine Integer-Zahl vom Seriellen Monitor
Parameter: zahl: Byte-Zahl "call by pointer" (0 <= zahl <= 255)
modus: Übergabemodus SERIAL_WAIT oder SERIAL_CONT
SERIAL_WAIT: es wird auf die Eingabe gewartet (Programmablauf wird gestoppt)
SERIAL_CONT: es wird nicht auf die Eingabe gewartet, die Funktion muss
kontinuierlich aufgerufen werden
Rückgabe: TRUE, wenn Lesen der Byte-Zahl erfolgreich, sonst FALSE
Beispiel:
if (SerialRead.readByte(&b_zahl, SERIAL_WAIT)) Serial.print(b_zahl);
//Achtung auf reference operator "&")
bool readInt8(int8_t* zahl, uint8_t modus )
Funktion: Liest eine 8-Bit Integer-Zahl vom Seriellen Monitor
Parameter: zahl: 8-Bit Integer-Zahl "call by pointer" (-128 <= zahl <= 127)
modus: Übergabemodus SERIAL_WAIT oder SERIAL_CONT
SERIAL_WAIT: es wird auf die Eingabe gewartet (Programmablauf wird gestoppt)
SERIAL_CONT: es wird nicht auf die Eingabe gewartet, die Funktion muss
kontinuierlich aufgerufen werden
Rückgabe: TRUE, wenn Lesen der 8-Bit Integer-Zahl erfolgreich, sonst FALSE
Beispiel:
if (SerialRead.readInt8(&i_zahl, SERIAL_WAIT)) Serial.print(i_zahl);
//Achtung auf reference operator "&")
bool readInt16(int* zahl, uint8_t modus )
Funktion: Liest eine 16-Bit Integer-Zahl vom Seriellen Monitor
Parameter: zahl: 16-Bit Integer-Zahl "call by pointer" (-32768 <= zahl <= +32767)
modus: Übergabemodus SERIAL_WAIT oder SERIAL_CONT
SERIAL_WAIT: es wird auf die Eingabe gewartet (Programmablauf wird gestoppt)
SERIAL_CONT: es wird nicht auf die Eingabe gewartet, die Funktion muss
kontinuierlich aufgerufen werden
Rückgabe: TRUE, wenn Lesen der 16-Bit Integer-Zahl erfolgreich, sonst FALSE
Beispiel:
if (SerialRead.readInt16(&i_zahl, SERIAL_WAIT)) Serial.print(i_zahl);
//Achtung auf reference operator "&")
bool readUInt16(unsigned int* zahl, uint8_t modus )
Funktion: Liest eine 16-Bit Unsigned-Integer-Zahl vom Seriellen Monitor
Parameter: zahl: 16-Bit Unsigned-Integer-Zahl "call by pointer", (0 <= zahl <= 65535)
modus: Übergabemodus SERIAL_WAIT oder SERIAL_CONT
SERIAL_WAIT: es wird auf die Eingabe gewartet (Programmablauf wird gestoppt)
SERIAL_CONT: es wird nicht auf die Eingabe gewartet, die Funktion muss
kontinuierlich aufgerufen werden
Rückgabe: TRUE, wenn Lesen der 16-Bit Unsigned-Integer-Zahl erfolgreich, sonst FALSE
Beispiel:
if (SerialRead.readUInt16(&ui_zahl, SERIAL_WAIT)) Serial.print(ui_zahl);
//Achtung auf reference operator "&")
bool readInt32(long* zahl, uint8_t modus )
Funktion: Liest eine 32-Bit Integer-Zahl (Long-Format) vom Seriellen Monitor
Parameter: zahl: 32-Bit Integer-Zahl "call by pointer", (-21474836480 <= zahl <= 2147483647)
modus: Übergabemodus SERIAL_WAIT oder SERIAL_CONT
SERIAL_WAIT: es wird auf die Eingabe gewartet (Programmablauf wird gestoppt)
SERIAL_CONT: es wird nicht auf die Eingabe gewartet, die Funktion muss
kontinuierlich aufgerufen werden
Rückgabe: TRUE, wenn Lesen der 32-Bit-Integer-Zahl erfolgreich, sonst FALSE
Beispiel:
if (SerialRead.readInt32(&l_zahl, SERIAL_WAIT)) Serial.print(l_zahl);
//Achtung auf reference operator "&")