Lines Matching +full:cancel +full:- +full:in +full:- +full:progress
4 * SPDX-License-Identifier: Apache-2.0
9 * @brief Real-time clock control based on the DS3231 counter API.
12 * DS3231](https://www.maximintegrated.com/en/products/analog/real-time-clocks/DS3231.html)
13 * is a high-precision real-time clock with temperature-compensated
28 * functionality exposed by this header to access the real-time-clock
46 /** @brief Bit in ctrl or ctrl_stat associated with alarm 1. */
49 /** @brief Bit in ctrl or ctrl_stat associated with alarm 2. */
52 /* Constants corresponding to bits in the DS3231 control register at
96 /** @brief ctrl bit to write to enable square wave output in battery mode. */
118 /** @brief Flag indicating a temperature conversion is in progress. */
131 /** @brief Control alarm behavior on match in seconds field.
142 * Bit maps to A1M1 and is used in
147 /** @brief Control alarm behavior on match in minutes field.
156 * Bit maps to A1M2 or A2M2 and is used in
161 /** @brief Control alarm behavior on match in hours field.
169 * Bit maps to A1M3 or A2M3 and is used in
174 /** @brief Control alarm behavior on match in day/date field.
183 * Bit maps to A1M4 or A2M4 and is used in
193 * Bit maps to DY/DTn in corresponding
200 * Set the flag in the maxim_ds3231_alarm_configuration::alarm_flags
210 * @brief RTC DS3231 Driver-Specific API
243 * @param notify the notification structure provided in the call
267 * component hours, minutes, seconds, day-of-week, and
268 * day-of-month fields, mediated by the corresponding #flags.
271 * determines day-of-week based on calendar date. Decoded
272 * alarm times will fall within 1978-01 since 1978-01-01
281 * in using the DS3231 to trigger a wake from deep sleep. The
289 * will be cleared in the device before the handler is
296 /** @brief User-provided pointer passed to alarm callback. */
304 * if a unit is not ignored, higher-precision units must also
316 * This captures the same instant in both the RTC time scale and a
323 * This maybe in UTC, TAI, or local offset depending on how
332 * microsecond to millisecond accuracy in synchronization.
339 * Synchronization aligns the DS3231 real-time clock with a stable
348 * frequency of the target-specific clock is provided by
352 * kernel extensions may make a higher-resolution clock available.
354 * @note This function is *isr-ok*.
367 * Provides the frequency of the clock used in maxim_ds3231_read_syncclock().
379 * @brief Set and clear specific bits in the control register.
388 * That return value is cached for use in subsequent operations.
392 * @return the non-negative updated value of the register, or a
400 * @brief Read the ctrl_stat register then set and clear bits in it.
404 * (regardless of whether there appears to be a change in value).
407 * do not appear in either @p set_bits or @p clear_bits. This ensures
424 * @return the non-negative register value as originally read
447 * @return a non-negative value indicating successful conversion, or a
458 * To cancel an alarm use counter_cancel_channel_alarm().
471 * @return a non-negative value on success, or a negative error code
480 * The RTC advances one tick per second with no access to sub-second
481 * precision. Synchronizing clocks at sub-second resolution requires
482 * enabling a 1pps signal then capturing the system clocks in a GPIO
485 * Synchronization is performed in asynchronously, and may take as
499 * @retval non-negative on success
500 * @retval -EBUSY if a synchronization or set is currently in progress
501 * @retval -EINVAL if notify is not provided
502 * @retval -ENOTSUP if the required interrupt is not configured
514 * @param signal pointer to a valid and ready-to-be-signalled
518 * @retval non-negative on success
519 * @retval -EBUSY if a synchronization or set is currently in progress
520 * @retval -ENOTSUP if the required interrupt is not configured
534 * @retval non-negative on success
535 * @retval -ENOENT if no syncpoint has been captured
543 * The RTC advances one tick per second with no access to sub-second
546 * clock while retaining as much sub-second accuracy as possible. It
547 * requires a synchronization point that pairs sub-second resolution
562 * @retval non-negative on success
563 * @retval -EINVAL if syncpoint or notify are null
564 * @retval -ENOTSUP if the required interrupt signal is not configured
565 * @retval -EBUSY if a synchronization or set is currently in progress
576 * been configured with a callback are not represented in the return
585 * @return a non-negative value that may have MAXIM_DS3231_ALARM1 and/or