andreika-git
/
ChibiOS
mirror of https://github.com/andreika-git/ChibiOS.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
os/various/chrtclib.c
View File

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

2
os/various/mail.c
View File

@ -32,7 +32,7 @@
/** /**
* @brief Initializes a Mail Pool. * @brief Initializes a Mail Pool.
* @note The number of the mail objects in the mail pool should be at * @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 * one reader, add one element for each extra reader or writer in
* order to avoid waiting on the mail pool. A smaller number of * order to avoid waiting on the mail pool. A smaller number of
* elements can be specified if waiting on the pool is acceptable. * elements can be specified if waiting on the pool is acceptable.