mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

api/rtc_time.h@635:a11c0372f0ba, 2015-09-30 (annotated)

Committer:
mbed_official
Date:
Wed Sep 30 17:00:09 2015 +0100
Revision:
635:a11c0372f0ba
Parent:
489:119543c9f674 
Synchronized with git revision d29c98dae61be0946ddf3a3c641c7726056f9452



Full URL: https://github.com/mbedmicro/mbed/commit/d29c98dae61be0946ddf3a3c641c7726056f9452/



Added support for SAMW25

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 13:0645d8841f51 1 /* mbed Microcontroller Library
bogdanm 13:0645d8841f51 2 * Copyright (c) 2006-2013 ARM Limited
bogdanm 13:0645d8841f51 3 *
bogdanm 13:0645d8841f51 4 * Licensed under the Apache License, Version 2.0 (the "License");
bogdanm 13:0645d8841f51 5 * you may not use this file except in compliance with the License.
bogdanm 13:0645d8841f51 6 * You may obtain a copy of the License at
bogdanm 13:0645d8841f51 7 *
bogdanm 13:0645d8841f51 8 * http://www.apache.org/licenses/LICENSE-2.0
bogdanm 13:0645d8841f51 9 *
bogdanm 13:0645d8841f51 10 * Unless required by applicable law or agreed to in writing, software
bogdanm 13:0645d8841f51 11 * distributed under the License is distributed on an "AS IS" BASIS,
bogdanm 13:0645d8841f51 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
bogdanm 13:0645d8841f51 13 * See the License for the specific language governing permissions and
bogdanm 13:0645d8841f51 14 * limitations under the License.
bogdanm 13:0645d8841f51 15 */
bogdanm 13:0645d8841f51 16
bogdanm 13:0645d8841f51 17 #include <time.h>
bogdanm 13:0645d8841f51 18
bogdanm 13:0645d8841f51 19 #ifdef __cplusplus
bogdanm 13:0645d8841f51 20 extern "C" {
bogdanm 13:0645d8841f51 21 #endif
bogdanm 13:0645d8841f51 22
bogdanm 13:0645d8841f51 23 /** Implementation of the C time.h functions
bogdanm 13:0645d8841f51 24 *
bogdanm 13:0645d8841f51 25 * Provides mechanisms to set and read the current time, based
bogdanm 13:0645d8841f51 26 * on the microcontroller Real-Time Clock (RTC), plus some
bogdanm 13:0645d8841f51 27 * standard C manipulation and formating functions.
bogdanm 13:0645d8841f51 28 *
bogdanm 13:0645d8841f51 29 * Example:
bogdanm 13:0645d8841f51 30 * @code
bogdanm 13:0645d8841f51 31 * #include "mbed.h"
bogdanm 13:0645d8841f51 32 *
bogdanm 13:0645d8841f51 33 * int main() {
bogdanm 13:0645d8841f51 34 * set_time(1256729737); // Set RTC time to Wed, 28 Oct 2009 11:35:37
bogdanm 13:0645d8841f51 35 *
bogdanm 13:0645d8841f51 36 * while(1) {
bogdanm 13:0645d8841f51 37 * time_t seconds = time(NULL);
bogdanm 13:0645d8841f51 38 *
bogdanm 13:0645d8841f51 39 * printf("Time as seconds since January 1, 1970 = %d\n", seconds);
bogdanm 13:0645d8841f51 40 *
bogdanm 13:0645d8841f51 41 * printf("Time as a basic string = %s", ctime(&seconds));
bogdanm 13:0645d8841f51 42 *
bogdanm 13:0645d8841f51 43 * char buffer[32];
bogdanm 13:0645d8841f51 44 * strftime(buffer, 32, "%I:%M %p\n", localtime(&seconds));
bogdanm 13:0645d8841f51 45 * printf("Time as a custom formatted string = %s", buffer);
bogdanm 13:0645d8841f51 46 *
bogdanm 13:0645d8841f51 47 * wait(1);
bogdanm 13:0645d8841f51 48 * }
bogdanm 13:0645d8841f51 49 * }
bogdanm 13:0645d8841f51 50 * @endcode
bogdanm 13:0645d8841f51 51 */
bogdanm 13:0645d8841f51 52
bogdanm 13:0645d8841f51 53 /** Set the current time
bogdanm 13:0645d8841f51 54 *
bogdanm 13:0645d8841f51 55 * Initialises and sets the time of the microcontroller Real-Time Clock (RTC)
bogdanm 13:0645d8841f51 56 * to the time represented by the number of seconds since January 1, 1970
bogdanm 13:0645d8841f51 57 * (the UNIX timestamp).
bogdanm 13:0645d8841f51 58 *
bogdanm 13:0645d8841f51 59 * @param t Number of seconds since January 1, 1970 (the UNIX timestamp)
bogdanm 13:0645d8841f51 60 *
bogdanm 13:0645d8841f51 61 * Example:
bogdanm 13:0645d8841f51 62 * @code
bogdanm 13:0645d8841f51 63 * #include "mbed.h"
bogdanm 13:0645d8841f51 64 *
bogdanm 13:0645d8841f51 65 * int main() {
bogdanm 13:0645d8841f51 66 * set_time(1256729737); // Set time to Wed, 28 Oct 2009 11:35:37
bogdanm 13:0645d8841f51 67 * }
bogdanm 13:0645d8841f51 68 * @endcode
bogdanm 13:0645d8841f51 69 */
bogdanm 13:0645d8841f51 70 void set_time(time_t t);
bogdanm 13:0645d8841f51 71
mbed_official 489:119543c9f674 72 /** Attach an external RTC to be used for the C time functions
mbed_official 489:119543c9f674 73 *
mbed_official 489:119543c9f674 74 * Do not call this function from an interrupt while an RTC read/write operation may be occurring
mbed_official 489:119543c9f674 75 *
mbed_official 489:119543c9f674 76 * @param read_rtc pointer to function which returns current UNIX timestamp
mbed_official 489:119543c9f674 77 * @param write_rtc pointer to function which sets current UNIX timestamp, can be NULL
mbed_official 489:119543c9f674 78 * @param init_rtc pointer to funtion which initializes RTC, can be NULL
mbed_official 489:119543c9f674 79 * @param isenabled_rtc pointer to function wich returns if the rtc is enabled, can be NULL
mbed_official 489:119543c9f674 80 */
mbed_official 489:119543c9f674 81 void attach_rtc(time_t (*read_rtc)(void), void (*write_rtc)(time_t), void (*init_rtc)(void), int (*isenabled_rtc)(void));
mbed_official 489:119543c9f674 82
bogdanm 13:0645d8841f51 83 #ifdef __cplusplus
bogdanm 13:0645d8841f51 84 }
bogdanm 13:0645d8841f51 85 #endif