Skip to content
Snippets Groups Projects
Select Git revision
  • 732407f1bf12364375162e8fb73816532a5d139c
  • wip-bootstrap default
  • dualcore
  • ch3/leds
  • ch3/time
  • master
6 results

qstr.c

Blame
  • modutime.c 4.96 KiB
    /*
     * This file is part of the Micro Python project, http://micropython.org/
     *
     * The MIT License (MIT)
     *
     * Copyright (c) 2013, 2014 Damien P. George
     * Copyright (c) 2015 Josef Gajdusek
     *
     * Permission is hereby granted, free of charge, to any person obtaining a copy
     * of this software and associated documentation files (the "Software"), to deal
     * in the Software without restriction, including without limitation the rights
     * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
     * copies of the Software, and to permit persons to whom the Software is
     * furnished to do so, subject to the following conditions:
     *
     * The above copyright notice and this permission notice shall be included in
     * all copies or substantial portions of the Software.
     *
     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
     * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
     * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
     * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
     * THE SOFTWARE.
     */
    
    #include <stdio.h>
    #include <string.h>
    
    #include "py/nlr.h"
    #include "py/obj.h"
    #include "py/gc.h"
    #include "py/runtime.h"
    #include MICROPY_HAL_H
    #include "modpyb.h"
    #include "modpybrtc.h"
    #include "timeutils.h"
    #include "user_interface.h"
    
    /// \module time - time related functions
    ///
    /// The `time` module provides functions for getting the current time and date,
    /// and for sleeping.
    
    /// \function localtime([secs])
    /// Convert a time expressed in seconds since Jan 1, 2000 into an 8-tuple which
    /// contains: (year, month, mday, hour, minute, second, weekday, yearday)
    /// If secs is not provided or None, then the current time from the RTC is used.
    /// year includes the century (for example 2014)
    /// month   is 1-12
    /// mday    is 1-31
    /// hour    is 0-23
    /// minute  is 0-59
    /// second  is 0-59
    /// weekday is 0-6 for Mon-Sun.
    /// yearday is 1-366
    STATIC mp_obj_t time_localtime(mp_uint_t n_args, const mp_obj_t *args) {
        timeutils_struct_time_t tm;
        mp_int_t seconds;
        if (n_args == 0 || args[0] == mp_const_none) {
            seconds = pyb_rtc_get_us_since_2000() / 1000 / 1000;
        } else {
            seconds = mp_obj_get_int(args[0]);
        }
        timeutils_seconds_since_2000_to_struct_time(seconds, &tm);
        mp_obj_t tuple[8] = {
            tuple[0] = mp_obj_new_int(tm.tm_year),
            tuple[1] = mp_obj_new_int(tm.tm_mon),
            tuple[2] = mp_obj_new_int(tm.tm_mday),
            tuple[3] = mp_obj_new_int(tm.tm_hour),
            tuple[4] = mp_obj_new_int(tm.tm_min),
            tuple[5] = mp_obj_new_int(tm.tm_sec),
            tuple[6] = mp_obj_new_int(tm.tm_wday),
            tuple[7] = mp_obj_new_int(tm.tm_yday),
        };
        return mp_obj_new_tuple(8, tuple);
    }
    MP_DEFINE_CONST_FUN_OBJ_VAR_BETWEEN(time_localtime_obj, 0, 1, time_localtime);
    
    /// \function mktime()
    /// This is inverse function of localtime. It's argument is a full 8-tuple
    /// which expresses a time as per localtime. It returns an integer which is
    /// the number of seconds since Jan 1, 2000.
    STATIC mp_obj_t time_mktime(mp_obj_t tuple) {
        mp_uint_t len;
        mp_obj_t *elem;
        mp_obj_get_array(tuple, &len, &elem);
    
        // localtime generates a tuple of len 8. CPython uses 9, so we accept both.
        if (len < 8 || len > 9) {
            nlr_raise(mp_obj_new_exception_msg_varg(&mp_type_TypeError, "mktime needs a tuple of length 8 or 9 (%d given)", len));
        }
    
        return mp_obj_new_int_from_uint(timeutils_mktime(mp_obj_get_int(elem[0]),
                mp_obj_get_int(elem[1]), mp_obj_get_int(elem[2]), mp_obj_get_int(elem[3]),
                mp_obj_get_int(elem[4]), mp_obj_get_int(elem[5])));
    }
    MP_DEFINE_CONST_FUN_OBJ_1(time_mktime_obj, time_mktime);
    
    /// \function sleep(seconds)
    /// Sleep for the given number of seconds.
    STATIC mp_obj_t time_sleep(mp_obj_t seconds_o) {
        HAL_Delay(1000 * mp_obj_get_int(seconds_o));
        return mp_const_none;
    }
    MP_DEFINE_CONST_FUN_OBJ_1(time_sleep_obj, time_sleep);
    
    /// \function time()
    /// Returns the number of seconds, as an integer, since 1/1/2000.
    STATIC mp_obj_t time_time(void) {
        // get date and time
        return mp_obj_new_int(pyb_rtc_get_us_since_2000() / 1000 / 1000);
    }
    MP_DEFINE_CONST_FUN_OBJ_0(time_time_obj, time_time);
    
    STATIC const mp_map_elem_t time_module_globals_table[] = {
        { MP_OBJ_NEW_QSTR(MP_QSTR___name__), MP_OBJ_NEW_QSTR(MP_QSTR_utime) },
    
        { MP_OBJ_NEW_QSTR(MP_QSTR_localtime), (mp_obj_t)&time_localtime_obj },
        { MP_OBJ_NEW_QSTR(MP_QSTR_mktime), (mp_obj_t)&time_mktime_obj },
        { MP_OBJ_NEW_QSTR(MP_QSTR_sleep), (mp_obj_t)&time_sleep_obj },
        { MP_OBJ_NEW_QSTR(MP_QSTR_time), (mp_obj_t)&time_time_obj },
    };
    
    STATIC MP_DEFINE_CONST_DICT(time_module_globals, time_module_globals_table);
    
    const mp_obj_module_t utime_module = {
        .base = { &mp_type_module },
        .name = MP_QSTR_utime,
        .globals = (mp_obj_dict_t*)&time_module_globals,
    };