mbed OS 2 and mbed OS 5

This is the handbook for mbed OS 2. If you’re working with mbed OS 5, please see the new handbook and API References. For the latest Wait API, please see Wait.

/** Generic wait functions.
 * These provide simple NOP type wait capabilities.
 * Example:
 * @code
 * #include "mbed.h"
 * DigitalOut heartbeat(LED1);
 * int main() {
 *     while (1) {
 *         heartbeat = 1;
 *         wait(0.5);
 *         heartbeat = 0;
 *         wait(0.5);
 *     }
 * }

/** Waits for a number of seconds, with microsecond resolution (within
 *  the accuracy of single precision floating point).
 *  @param s number of seconds to wait
void wait(float s);

/** Waits a number of milliseconds.
 *  @param ms the whole number of milliseconds to wait
void wait_ms(int ms);

/** Waits a number of microseconds.
 *  @param us the whole number of microseconds to wait
void wait_us(int us);

OS delay

When you call wait the CPU of your mbed will be busy spinning in a loop waiting for the required time to pass. Using the mbed RTOS you can make a call to Thread::wait instead. In this way the OS scheduler will put the current thread in waiting state and it will allow another thread to execute, or even better, if there are not other threads in ready state, it can put the whole microcontroller to sleep saving energy.


The timer used to implement this functionality is:

  • On the LPC1768: Timer 3 (LPC_TIM3)
  • On the LPC11U24: 32-bit Counter/Timer B1 (LPC_CT32B1)