aboutsummaryrefslogtreecommitdiffstats
path: root/source/arduino/micros.rst
diff options
context:
space:
mode:
Diffstat (limited to 'source/arduino/micros.rst')
-rw-r--r--source/arduino/micros.rst66
1 files changed, 66 insertions, 0 deletions
diff --git a/source/arduino/micros.rst b/source/arduino/micros.rst
new file mode 100644
index 0000000..cdee497
--- /dev/null
+++ b/source/arduino/micros.rst
@@ -0,0 +1,66 @@
+.. _arduino-micros:
+
+micros()
+========
+
+Description
+-----------
+
+Returns the number of microseconds since the Arduino board began
+running the current program. This number will overflow (go back to
+zero), after approximately 70 minutes. On 16 MHz Arduino boards
+(e.g. Duemilanove and Nano), this function has a resolution of four
+microseconds (i.e. the value returned is always a multiple of
+four). On 8 MHz Arduino boards (e.g. the LilyPad), this function
+has a resolution of eight microseconds.
+
+
+
+*Note*: there are 1,000 microseconds in a millisecond and 1,000,000
+microseconds in a second.
+
+
+
+Parameters
+----------
+
+None
+
+
+
+Returns
+-------
+
+Number of microseconds since the program started (*unsigned long*)
+
+
+
+Example
+-------
+
+::
+
+ unsigned long time;
+
+ void setup(){
+ Serial.begin(9600);
+ }
+ void loop(){
+ Serial.print("Time: ");
+ time = micros();
+ //prints time since program started
+ Serial.println(time);
+ // wait a second so as not to send massive amounts of data
+ delay(1000);
+ }
+
+
+
+See also
+--------
+
+
+- `millis <http://arduino.cc/en/Reference/Millis>`_\ ()
+- `delay <http://arduino.cc/en/Reference/Delay>`_\ ()
+- `delayMicroseconds <http://arduino.cc/en/Reference/DelayMicroseconds>`_\ ()
+