
test
Diff: mbed/platform/mbed_wait_api.h
- Revision:
- 12:406f75196a12
- Parent:
- 11:32eeb052cda5
- Child:
- 13:0c732e06d675
--- a/mbed/platform/mbed_wait_api.h Wed Aug 26 14:26:27 2020 +0530 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,93 +0,0 @@ - -/** \addtogroup platform */ -/** @{*/ -/** - * \defgroup platform_wait_api wait_api functions - * @{ - */ - -/* mbed Microcontroller Library - * Copyright (c) 2006-2013 ARM Limited - * SPDX-License-Identifier: Apache-2.0 - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ -#ifndef MBED_WAIT_API_H -#define MBED_WAIT_API_H - -#ifdef __cplusplus -extern "C" { -#endif - -/** 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); - * } - * } - * @endcode - */ - -/** Waits for a number of seconds, with microsecond resolution (within - * the accuracy of single precision floating point). - * - * @param s number of seconds to wait - * - * @note - * If the RTOS is present, this function spins to get the exact number of microseconds for - * microsecond precision up to 10 milliseconds. If delay is larger than 10 milliseconds and not in ISR, it is the same as - * `wait_ms`. We recommend `wait_us` and `wait_ms` over `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, it calls ThisThread::sleep_for(), which is same as CMSIS osDelay(). - * You can't call this from interrupts, and it doesn't lock hardware sleep. - */ -void wait_ms(int ms); - -/** Waits a number of microseconds. - * - * @param us the whole number of microseconds to wait - * - * @note - * This function always spins to get the exact number of microseconds. - * If RTOS is present, this will affect power (by preventing deep sleep) and - * multithread performance. Therefore, spinning for millisecond wait is not recommended. - */ -void wait_us(int us); - -#ifdef __cplusplus -} -#endif - -#endif - -/** @}*/ -/** @}*/