Diff: wait_api.h

Revision:

8:c14af7958ef5

Parent:

0:8024c367e29f

Child:

9:663789d7729f

--- a/wait_api.h	Tue Oct 23 09:20:18 2012 +0000
+++ b/wait_api.h	Fri Nov 09 11:33:53 2012 +0000
@@ -1,21 +1,21 @@
-/* Title: wait
- * Generic wait functions.
+/** Generic wait functions.
  *
  * These provide simple NOP type wait capabilities.
  *
  * Example:
- * > #include "mbed.h"
- * >
- * > DigitalOut heartbeat(LED1);
- * >
- * > int main() {
- * >     while (1) {
- * >         heartbeat = 1;
- * >         wait(0.5);
- * >         heartbeat = 0;
- * >         wait(0.5);
- * >     }
- * > }
+ * @code
+ * #include "mbed.h"
+ *
+ * DigitalOut heartbeat(LED1);
+ *
+ * int main() {
+ *     while (1) {
+ *         heartbeat = 1;
+ *         wait(0.5);
+ *         heartbeat = 0;
+ *         wait(0.5);
+ *     }
+ * }
  */
 
 /* mbed Microcontroller Library - wait_api
@@ -29,64 +29,25 @@
 extern "C" {
 #endif
 
-/* Function: wait
- *  Waits for a number of seconds, with microsecond resolution (within
+/** Waits for a number of seconds, with microsecond resolution (within
  *  the accuracy of single precision floating point).
  *
- * Variables:
- *  s - number of seconds to wait
+ *  @param s number of seconds to wait
  */
 void wait(float s);
 
-/* Function: wait_ms
- *  Waits a number of milliseconds.
+/** Waits a number of milliseconds.
  *
- * Variables:
- *  ms - the whole number of milliseconds to wait
+ *  @param ms the whole number of milliseconds to wait
  */
 void wait_ms(int ms);
 
-/* Function: wait_us
- *  Waits a number of microseconds.
+/** Waits a number of microseconds.
  *
- * Variables:
- *  us - the whole number of microseconds to wait
+ *  @param us the whole number of microseconds to wait
  */
 void wait_us(int us);
 
-#ifdef TARGET_LPC11U24
-/* Function: sleep
- *  Send the microcontroller to sleep
- * 
- * The processor is setup ready for sleep, and sent to sleep using __WFI(). In this mode, the
- * system clock to the core is stopped until a reset or an interrupt occurs. This eliminates 
- * dynamic power used by the processor, memory systems and buses. The processor, peripheral and 
- * memory state are maintained, and the peripherals continue to work and can generate interrupts.
- * 
- * The processor can be woken up by any internal peripheral interrupt or external pin interrupt.
- * 
- * Note: The mbed interface semihosting is disconnected as part of going to sleep, and can not be restored. 
- * Flash re-programming and the USB serial port will remain active, but the mbed program will no longer be
- * able to access the LocalFileSystem
- */
-void sleep(void);
-
-/* Function: deepsleep
- *  Send the microcontroller to deep sleep
- * 
- * This processor is setup ready for deep sleep, and sent to sleep using __WFI(). This mode
- * has the same sleep features as sleep plus it powers down peripherals and clocks. All state
- * is still maintained. 
- * 
- * The processor can only be woken up by an external interrupt on a pin or a watchdog timer.
- * 
- * Note: The mbed interface semihosting is disconnected as part of going to sleep, and can not be restored. 
- * Flash re-programming and the USB serial port will remain active, but the mbed program will no longer be
- * able to access the LocalFileSystem
- */
-void deepsleep(void);
-#endif
-
 #ifdef __cplusplus
 }
 #endif