Reformatting and documentation related fixes.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4147 35acf78f-673a-0410-8e92-d51de3d6d3f4
This commit is contained in:
gdisirio 2012-04-29 18:06:23 +00:00
parent a4283e0d49
commit 45591068e8
2 changed files with 36 additions and 41 deletions

View File

@ -36,12 +36,12 @@
/**
* @brief Converts from STM32 BCD to canonicalized time format.
*
* @param[out] timp pointer to a @p tm structure defined in time.h
* @param[out] timp pointer to a @p tm structure as defined in time.h
* @param[in] timespec pointer to a @p RTCTime structure
*
* @notapi
*/
void stm32_rtc_bcd2tm(struct tm *timp, RTCTime *timespec){
static void stm32_rtc_bcd2tm(struct tm *timp, RTCTime *timespec) {
uint32_t tv_time = timespec->tv_time;
uint32_t tv_date = timespec->tv_date;
@ -88,12 +88,12 @@ void stm32_rtc_bcd2tm(struct tm *timp, RTCTime *timespec){
/**
* @brief Converts from canonicalized to STM32 BCD time format.
*
* @param[in] timp pointer to a @p tm structure defined in time.h
* @param[in] timp pointer to a @p tm structure as defined in time.h
* @param[out] timespec pointer to a @p RTCTime structure
*
* @notapi
*/
void stm32_rtc_tm2bcd(struct tm *timp, RTCTime *timespec){
static void stm32_rtc_tm2bcd(struct tm *timp, RTCTime *timespec) {
uint32_t v = 0;
timespec->tv_date = 0;
@ -134,12 +134,13 @@ void stm32_rtc_tm2bcd(struct tm *timp, RTCTime *timespec){
* @brief Gets raw time from RTC and converts it to canonicalized format.
*
* @param[in] rtcp pointer to RTC driver structure
* @param[out] timp pointer to a @p tm structure defined in time.h
* @param[out] timp pointer to a @p tm structure as defined in time.h
*
* @api
*/
void rtcGetTimeTm(RTCDriver *rtcp, struct tm *timp) {
RTCTime timespec = {0,0,FALSE,0};
rtcGetTime(rtcp, &timespec);
stm32_rtc_bcd2tm(timp, &timespec);
}
@ -148,7 +149,7 @@ void rtcGetTimeTm(RTCDriver *rtcp, struct tm *timp){
* @brief Sets RTC time.
*
* @param[in] rtcp pointer to RTC driver structure
* @param[out] timp pointer to a @p tm structure defined in time.h
* @param[out] timp pointer to a @p tm structure as defined in time.h
*
* @api
*/
@ -163,7 +164,6 @@ void rtcSetTimeTm(RTCDriver *rtcp, struct tm *timp){
* @brief Gets raw time from RTC and converts it to unix format.
*
* @param[in] rtcp pointer to RTC driver structure
*
* @return Unix time value in seconds.
*
* @api
@ -182,7 +182,6 @@ time_t rtcGetTimeUnixSec(RTCDriver *rtcp){
* @brief Sets RTC time.
*
* @param[in] rtcp pointer to RTC driver structure
*
* @return Unix time value in seconds.
*
* @api
@ -200,7 +199,6 @@ void rtcSetTimeUnixSec(RTCDriver *rtcp, time_t tv_sec){
* @brief Gets raw time from RTC and converts it to unix format.
*
* @param[in] rtcp pointer to RTC driver structure
*
* @return Unix time value in microseconds.
*
* @api
@ -228,7 +226,7 @@ uint64_t rtcGetTimeUnixUsec(RTCDriver *rtcp){
* @brief Gets raw time from RTC and converts it to canonicalized format.
*
* @param[in] rtcp pointer to RTC driver structure
* @param[out] timp pointer to a @p tm structure defined in time.h
* @param[out] timp pointer to a @p tm structure as defined in time.h
*
* @api
*/
@ -244,7 +242,7 @@ void rtcGetTimeTm(RTCDriver *rtcp, struct tm *timp){
* @brief Sets RTC time.
*
* @param[in] rtcp pointer to RTC driver structure
* @param[out] timp pointer to a @p tm structure defined in time.h
* @param[out] timp pointer to a @p tm structure as defined in time.h
*
* @api
*/
@ -260,7 +258,6 @@ void rtcSetTimeTm(RTCDriver *rtcp, struct tm *timp){
* @brief Gets raw time from RTC and converts it to unix format.
*
* @param[in] rtcp pointer to RTC driver structure
*
* @return Unix time value in seconds.
*
* @api
@ -276,7 +273,6 @@ time_t rtcGetTimeUnixSec(RTCDriver *rtcp){
* @brief Sets RTC time.
*
* @param[in] rtcp pointer to RTC driver structure
*
* @return Unix time value in seconds.
*
* @api
@ -293,7 +289,6 @@ void rtcSetTimeUnixSec(RTCDriver *rtcp, time_t tv_sec){
* @brief Gets raw time from RTC and converts it to unix format.
*
* @param[in] rtcp pointer to RTC driver structure
*
* @return Unix time value in microseconds.
*
* @api
@ -317,7 +312,7 @@ uint64_t rtcGetTimeUnixUsec(RTCDriver *rtcp){
/**
* @brief Get current time in format suitable for usage in FatFS.
*
* @param[in] timespec pointer to time value structure
* @param[in] rtcp pointer to RTC driver structure
* @return FAT time value.
*
* @api

View File

@ -32,7 +32,7 @@
/**
* @brief Initializes a Mail Pool.
* @note The number of the mail objects in the mail pool should be at
* least <b>2+size(mailbox)<b>, this considering one writer and
* least <b>2+size(mailbox)</b>, this considering one writer and
* one reader, add one element for each extra reader or writer in
* order to avoid waiting on the mail pool. A smaller number of
* elements can be specified if waiting on the pool is acceptable.