Diff: platform/mbed_wait_api.h

Revision:

186:707f6e361f3e

Parent:

178:79309dc6340a

Child:

187:0387e8f68319

--- a/platform/mbed_wait_api.h	Thu Apr 19 17:12:19 2018 +0100
+++ b/platform/mbed_wait_api.h	Fri Jun 22 16:45:37 2018 +0100
@@ -53,18 +53,32 @@
  *  the accuracy of single precision floating point).
  *
  *  @param s number of seconds to wait
+ * 
+ *  @note
+ *    If the RTOS is present, this function always spins to get the exact number of microseconds, 
+ *    which potentially affects power (such as preventing deep sleep) and multithread performance. 
+ *    You can avoid it by using Thread::wait().
  */
 void wait(float s);
 
 /** Waits a number of milliseconds.
  *
  *  @param ms the whole number of milliseconds to wait
+ * 
+ *  @note
+ *    If the RTOS is present, this function always spins to get the exact number of microseconds, 
+ *    which potentially affects power (such as preventing deep sleep) and multithread performance. 
+ *    You can avoid it by using Thread::wait().
  */
 void wait_ms(int ms);
 
 /** Waits a number of microseconds.
  *
  *  @param us the whole number of microseconds to wait
+ * 
+ *  @note
+ *    If the RTOS is present, this function always spins to get the exact number of microseconds, 
+ *    which potentially affects power (such as preventing deep sleep) and multithread performance.
  */
 void wait_us(int us);