Home
References
Language References

micros()

Beschreibung

Gibt die Anzahl der Mikrosekunden zurück, seit das Arduino-Board das aktuelle Programm gestartet hat. Diese Zahl läuft nach ca. 70 Minuten über (Nullstellen).

Auf 16-MHz-Arduino-Boards (z. B. Duemilanove und Nano) hat diese Funktion eine Auflösung von vier Mikrosekunden (d. H. Der zurückgegebene Wert ist immer ein Vielfaches von vier). Auf 8-MHz-Arduino-Boards (z. B. dem LilyPad) hat diese Funktion eine Auflösung von acht Mikrosekunden.

Syntax

time_us = micros()

Parameter

  • Keine.

Rückgabewert

Gibt die Anzahl der Mikrosekunden zurück, seit das Arduino-Board das aktuelle Programm gestartet hat. Datentyp: unsigned long.

Beispielcode

Beispielcode 1

Der Code gibt die Anzahl der Mikrosekunden seit dem Beginn des Arduino-Boards zurück.

unsigned long time_us; void setup() { Serial.begin(9600); } void loop() { Serial.print("Time: "); time_us = micros(); Serial.println(time_us); // gibt die Zeit seit dem Programmstart aus delay(1000); // Warte eine Sekunde, um keine riesigen Datenmengen zu senden }

Das ergebnis am seriellen monitor:

COM6
Send
Time: 52 Time: 1000220 Time: 2000612 Time: 3001008 Time: 4001404 Time: 5001788 Time: 6002180 Time: 7002568
Autoscroll Show timestamp
Clear output
9600 baud  
Newline  

Beispielcode 2

Print a text one time per second without blocking other codes

const unsigned long TIME_INTERVAL = 1000000; // 1000000us = 1s unsigned long previousMicros; void setup() { Serial.begin(9600); previousMicros = micros(); } void loop() { if (micros() - previousMicros >= TIME_INTERVAL) { previousMicros = micros(); Serial.println("Arduino References"); } }

※ Anmerkungen und Warnungen:

  • Es gibt 1.000 Mikrosekunden in einer Millisekunde und 1.000.000 Mikrosekunden in einer Sekunde.
  • Please note that the return value for micros() is of type unsigned long, logic errors may occur if a programmer tries to do arithmetic with smaller data types such as int. Even signed long may encounter errors as its maximum value is half that of its unsigned counterpart.
  • The return value of micros() function rolls over back to zero after roughly 71 minutes. If the sketch is intended to run for longer than that, It needs to make sure the rollover does not make the sketch fail. To solve it, write rollover-safe code. Let's compare the two following inequations:
    • micros() >= (previousMicros + TIME_INTERVAL)
    • (micros() - previousMicros) >= TIME_INTERVAL.
  • Mathematically, they are equivalent to each other. However, in programming, they are not. That is because the size of storage is unlimited in mathematics while it is limited to 4 bytes in Arduino programming. In programming, when the rollover happens, the first inequation makes the sketch fail while the second inequation does NOT. Therefore:
    • Do NOT use if (micros() >= (previousMicros + TIME_INTERVAL)),
    • Use if(micros() - previousMicros >= TIME_INTERVAL) instead

Siehe Auch

※ ARDUINO KAUFEMPFEHLUNG

Arduino UNO R3
Arduino Starter Kit
Bitte Beachten: Dies sind Partnerschaftslinks. Wenn Sie die Komponenten über diese Links Kaufen, können wir eine Provision erhalten, ohne weitere Kosten für Sie. Wir Schätzen es.

※ OUR MESSAGES

DISCLOSURE
ArduinoGetStarted.com is a participant in the Amazon Services LLC Associates Program, an affiliate advertising program designed to provide a means for sites to earn advertising fees by advertising and linking to Amazon.com, Amazon.it, Amazon.fr, Amazon.co.uk, Amazon.ca, Amazon.de, Amazon.es, Amazon.nl, Amazon.pl and Amazon.se
The Arduino Reference text is licensed under a Creative Commons Attribution-Share Alike 3.0 License. The content is modified based on Official Arduino References by: adding more example codes and output, adding more notes and warning, rewriting some parts, and re-formating
Email: ArduinoGetStarted@gmail.com