1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00

Merge pull request #2044 from LudwigOrtmann/rtt-fixes

periph/rtt: fix documentation
This commit is contained in:
Ludwig Ortmann 2014-11-19 09:03:49 -08:00
commit de2a8b2b49

View File

@ -28,13 +28,14 @@
extern "C" { extern "C" {
#endif #endif
/* guard file in case no RTC device was specified */ /* guard file in case no RTT device was specified */
#if RTT_NUMOF #if RTT_NUMOF
/** /**
* @brief Signature for alarm Callback * @brief Signature for the alarm callback
* *
* @param[in] arg optional argument to put the callback in the right context * @param[in] arg Optional argument which is passed to the
* callback
*/ */
typedef void(*rtt_cb_t)(void *arg); typedef void(*rtt_cb_t)(void *arg);
@ -59,7 +60,7 @@ void rtt_clear_overflow_cb(void);
/** /**
* @brief Get the current RTT counter. * @brief Get the current RTT counter.
* *
* @return Current value of the RTT counter. * @return Current value of the RTT counter
*/ */
uint32_t rtt_get_counter(void); uint32_t rtt_get_counter(void);
@ -73,18 +74,18 @@ void rtt_set_counter(uint32_t counter);
/** /**
* @brief Set an alarm for RTT to the specified value. * @brief Set an alarm for RTT to the specified value.
* *
* @param[in] alarm The value to trigger an alarm when hit. * @param[in] alarm The value to trigger an alarm when hit
* @param[in] cb Callback executed when alarm is hit. * @param[in] cb Callback executed when alarm is hit
* @param[in] arg Argument passed to callback when alarm is hit. * @param[in] arg Argument passed to callback when alarm is hit
*/ */
void rtt_set_alarm(uint32_t alarm, rtt_cb_t cb, void *arg); void rtt_set_alarm(uint32_t alarm, rtt_cb_t cb, void *arg);
/** /**
* @brief Get the value of a set alarm. * @brief Get the value of a set alarm.
* *
* If no alarm is set the return value is arbitrary. * If no alarm is set, the return value is arbitrary.
* *
* @return value the alarm is set to * @return Value the alarm is set to
*/ */
uint32_t rtt_get_alarm(void); uint32_t rtt_get_alarm(void);
@ -94,12 +95,12 @@ uint32_t rtt_get_alarm(void);
void rtt_clear_alarm(void); void rtt_clear_alarm(void);
/** /**
* @brief Turns the RTC hardware module on * @brief Turn the RTT hardware module on
*/ */
void rtt_poweron(void); void rtt_poweron(void);
/** /**
* @brief Turns the RTC hardware module off * @brief Turn the RTT hardware module off
*/ */
void rtt_poweroff(void); void rtt_poweroff(void);