diff options
| author | gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4> | 2011-10-01 08:04:14 +0000 |
|---|---|---|
| committer | gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4> | 2011-10-01 08:04:14 +0000 |
| commit | 2950a0a7b8316a742a7a67b5acb4f224a98397ff (patch) | |
| tree | f3c81f2ad4202021f05d419d44f3876d9be01950 /os/hal/src | |
| parent | d2fa0e3fdee679a6cdd5dd6616aca527eca3f080 (diff) | |
| download | ChibiOS-2950a0a7b8316a742a7a67b5acb4f224a98397ff.tar.gz ChibiOS-2950a0a7b8316a742a7a67b5acb4f224a98397ff.tar.bz2 ChibiOS-2950a0a7b8316a742a7a67b5acb4f224a98397ff.zip | |
git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@3413 35acf78f-673a-0410-8e92-d51de3d6d3f4
Diffstat (limited to 'os/hal/src')
| -rw-r--r-- | os/hal/src/rtc.c | 95 |
1 files changed, 57 insertions, 38 deletions
diff --git a/os/hal/src/rtc.c b/os/hal/src/rtc.c index 24ccce84e..dda5a9c95 100644 --- a/os/hal/src/rtc.c +++ b/os/hal/src/rtc.c @@ -52,88 +52,107 @@ /*===========================================================================*/
/**
- * @brief Enable access to registers and initialize RTC if BKP domain
- * was previously reset.
+ * @brief RTC Driver initialization.
* @note This function is implicitly invoked by @p halInit(), there is
* no need to explicitly initialize the driver.
*
* @init
*/
void rtcInit(void) {
+
rtc_lld_init();
}
-#if RTC_SUPPORTS_CALLBACKS || defined(__DOXYGEN__)
/**
- * @brief Enables or disables callbacks.
- * @details This function enables or disables callbacks, use a @p NULL pointer
- * in order to disable a callback.
- * @pre To use this function you must set @p RTC_SUPPORTS_CALLBACKS
- * to @p TRUE.
+ * @brief Set current time.
*
* @param[in] rtcp pointer to RTC driver structure
- * @param[in] overflowcb overflow callback function
- * @param[in] secondcb every second callback function
- * @param[in] alarmcb alarm callback function
+ * @param[in] timespec pointer to a @p RTCTime structure
+ *
+ * @api
*/
-void rtcSetCallback(RTCDriver *rtcp, rtccb_t overflowcb,
- rtccb_t secondcb, rtccb_t alarmcb) {
+void rtcSetTime(RTCDriver *rtcp, const RTCTime *timespec) {
- chDbgCheck((rtcp != NULL), "rtcSetCallback");
+ chDbgCheck((rtcp != NULL) && (timespec != NULL), "rtcSetTime");
- rtc_lld_set_callback(rtcp, overflowcb, secondcb, alarmcb);
+ rtc_lld_set_time(rtcp, timespec);
}
-#endif /* RTC_SUPPORTS_CALLBACKS */
/**
- * @brief Set current time.
+ * @brief Get current time.
+ *
+ * @param[in] rtcp pointer to RTC driver structure
+ * @param[out] timespec pointer to a @p RTCTime structure
*
- * @param[in] timespec pointer to a @p RTCDateTime structure
+ * @api
*/
-void rtcSetTime(RTCDateTime *timespec) {
+void rtcGetTime(RTCDriver *rtcp, RTCTime *timespec) {
- chDbgCheck((timespec != NULL), "rtcSetTime");
+ chDbgCheck((rtcp != NULL) && (timespec != NULL), "rtcGetTime");
- rtc_lld_set_time(timespec);
+ rtc_lld_get_time(rtcp, timespec);
}
+#if (RTC_ALARMS > 0) || defined(__DOXYGEN__)
/**
- * @brief Get current time.
+ * @brief Set alarm time.
+ *
+ * @param[in] rtcp pointer to RTC driver structure
+ * @param[in] alarm alarm identifier
+ * @param[in] alarmspec pointer to a @p RTCAlarm structure or @p NULL
*
- * @param[in] timespec pointer to a @p RTCDateTime structure
+ * @api
*/
-void rtcGetTime(RTCDateTime *timespec) {
+void rtcSetAlarm(RTCDriver *rtcp,
+ rtcalarm_t alarm,
+ const RTCAlarm *alarmspec) {
- chDbgCheck((timespec != NULL), "rtcGetTime");
- rtc_lld_get_time(timespec);
+ chDbgCheck((rtcp != NULL) && (alarm < RTC_ALARMS), "rtcSetAlarm");
+
+ rtc_lld_set_alarm(rtcp, alarm, alarmspec);
}
/**
- * @brief Set alarm time.
+ * @brief Get current alarm.
+ * @note If an alarm has not been set then the returned alarm specification
+ * is not meaningful.
+ *
+ * @param[in] rtcp pointer to RTC driver structure
+ * @param[in] alarm alarm identifier
+ * @param[out] alarmspec pointer to a @p RTCAlarm structure
*
- * @param[in] timespec pointer to a @p RTCDateTime structure
+ * @api
*/
-void rtcSetAlarm(RTCDateTime *timespec) {
+void rtcGetAlarm(RTCDriver *rtcp,
+ rtcalarm_t alarm,
+ RTCAlarm *alarmspec) {
- chDbgCheck((timespec != NULL), "rtcSetAlarm");
+ chDbgCheck((rtcp != NULL) && (alarm < RTC_ALARMS) && (alarmspec != NULL),
+ "rtcGetAlarm");
- rtc_lld_set_alarm(timespec);
+ rtc_lld_get_alarm(rtcp, alarm, alarmspec);
}
+#endif /* RTC_ALARMS > 0 */
+#if RTC_SUPPORTS_CALLBACKS || defined(__DOXYGEN__)
/**
- * @brief Get current alarm.
+ * @brief Enables or disables RTC callbacks.
+ * @details This function enables or disables callbacks, use a @p NULL pointer
+ * in order to disable a callback.
+ *
+ * @param[in] rtcp pointer to RTC driver structure
+ * @param[in] callback callback function pointer or @p NULL
*
- * @param[in] timespec pointer to a @p RTCDateTime structure
+ * @api
*/
-void rtcGetAlarm(RTCDateTime *timespec){
+void rtcSetCallback(RTCDriver *rtcp, rtccb_t callback) {
- chDbgCheck((timespec != NULL), "rtcGetAlarm");
+ chDbgCheck((rtcp != NULL), "rtcSetCallback");
- rtc_lld_get_alarm(timespec);
+ rtc_lld_set_callback(rtcp, callback);
}
+#endif /* RTC_SUPPORTS_CALLBACKS */
#endif /* HAL_USE_RTC */
/** @} */
-
-
|