2020-06-03 18:40:05 -04:00
|
|
|
// Copyright (c) 2016 Paul Sokolovsky
|
|
|
|
// SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
|
|
|
|
// SPDX-FileCopyrightText: Copyright (c) 2013-2016 Damien P. George
|
|
|
|
//
|
|
|
|
// SPDX-License-Identifier: MIT
|
2016-10-14 13:13:02 -04:00
|
|
|
|
|
|
|
#include "py/mpconfig.h"
|
|
|
|
#if MICROPY_PY_UTIME_MP_HAL
|
|
|
|
|
|
|
|
#include <string.h>
|
|
|
|
|
|
|
|
#include "py/obj.h"
|
|
|
|
#include "py/mphal.h"
|
|
|
|
#include "py/smallint.h"
|
2016-10-29 06:42:36 -04:00
|
|
|
#include "py/runtime.h"
|
2016-10-14 13:13:02 -04:00
|
|
|
#include "extmod/utime_mphal.h"
|
|
|
|
|
|
|
|
STATIC mp_obj_t time_sleep(mp_obj_t seconds_o) {
|
|
|
|
#if MICROPY_PY_BUILTINS_FLOAT
|
2017-06-30 19:23:29 -04:00
|
|
|
mp_hal_delay_ms((mp_uint_t)(1000 * mp_obj_get_float(seconds_o)));
|
2016-10-14 13:13:02 -04:00
|
|
|
#else
|
|
|
|
mp_hal_delay_ms(1000 * mp_obj_get_int(seconds_o));
|
|
|
|
#endif
|
|
|
|
return mp_const_none;
|
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_1(mp_utime_sleep_obj, time_sleep);
|
|
|
|
|
|
|
|
STATIC mp_obj_t time_sleep_ms(mp_obj_t arg) {
|
2016-10-14 15:19:45 -04:00
|
|
|
mp_int_t ms = mp_obj_get_int(arg);
|
2019-11-19 23:21:35 -05:00
|
|
|
if (ms >= 0) {
|
2016-10-14 15:19:45 -04:00
|
|
|
mp_hal_delay_ms(ms);
|
|
|
|
}
|
2016-10-14 13:13:02 -04:00
|
|
|
return mp_const_none;
|
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_1(mp_utime_sleep_ms_obj, time_sleep_ms);
|
|
|
|
|
|
|
|
STATIC mp_obj_t time_sleep_us(mp_obj_t arg) {
|
2016-10-14 15:19:45 -04:00
|
|
|
mp_int_t us = mp_obj_get_int(arg);
|
|
|
|
if (us > 0) {
|
|
|
|
mp_hal_delay_us(us);
|
|
|
|
}
|
2016-10-14 13:13:02 -04:00
|
|
|
return mp_const_none;
|
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_1(mp_utime_sleep_us_obj, time_sleep_us);
|
|
|
|
|
|
|
|
STATIC mp_obj_t time_ticks_ms(void) {
|
2016-10-29 20:02:07 -04:00
|
|
|
return MP_OBJ_NEW_SMALL_INT(mp_hal_ticks_ms() & (MICROPY_PY_UTIME_TICKS_PERIOD - 1));
|
2016-10-14 13:13:02 -04:00
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_0(mp_utime_ticks_ms_obj, time_ticks_ms);
|
|
|
|
|
|
|
|
STATIC mp_obj_t time_ticks_us(void) {
|
2016-10-29 20:02:07 -04:00
|
|
|
return MP_OBJ_NEW_SMALL_INT(mp_hal_ticks_us() & (MICROPY_PY_UTIME_TICKS_PERIOD - 1));
|
2016-10-14 13:13:02 -04:00
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_0(mp_utime_ticks_us_obj, time_ticks_us);
|
|
|
|
|
|
|
|
STATIC mp_obj_t time_ticks_cpu(void) {
|
2016-10-29 20:02:07 -04:00
|
|
|
return MP_OBJ_NEW_SMALL_INT(mp_hal_ticks_cpu() & (MICROPY_PY_UTIME_TICKS_PERIOD - 1));
|
2016-10-14 13:13:02 -04:00
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_0(mp_utime_ticks_cpu_obj, time_ticks_cpu);
|
|
|
|
|
extmod/utime_mphal: ticks_diff(): switch arg order, return signed value.
Based on the earlier discussed RFC. Practice showed that the most natural
order for arguments corresponds to mathematical subtraction:
ticks_diff(x, y) <=> x - y
Also, practice showed that in real life, it's hard to order events by time
of occurance a priori, events tend to miss deadlines, etc. and the expected
order breaks. And then there's a need to detect such cases. And ticks_diff
can be used exactly for this purpose, if it returns a signed, instead of
unsigned, value. E.g. if x is scheduled time for event, and y is the current
time, then if ticks_diff(x, y) < 0 then event has missed a deadline (and e.g.
needs to executed ASAP or skipped). Returning in this case a large unsigned
number (like ticks_diff behaved previously) doesn't make sense, and such
"large unsigned number" can't be reliably detected per our definition of
ticks_* function (we don't expose to user level maximum value, it can be
anything, relatively small or relatively large).
2016-10-28 22:02:24 -04:00
|
|
|
STATIC mp_obj_t time_ticks_diff(mp_obj_t end_in, mp_obj_t start_in) {
|
2016-10-14 13:13:02 -04:00
|
|
|
// we assume that the arguments come from ticks_xx so are small ints
|
2016-11-03 16:54:16 -04:00
|
|
|
mp_uint_t start = MP_OBJ_SMALL_INT_VALUE(start_in);
|
|
|
|
mp_uint_t end = MP_OBJ_SMALL_INT_VALUE(end_in);
|
2016-11-01 19:50:48 -04:00
|
|
|
// Optimized formula avoiding if conditions. We adjust difference "forward",
|
|
|
|
// wrap it around and adjust back.
|
2016-11-03 16:54:16 -04:00
|
|
|
mp_int_t diff = ((end - start + MICROPY_PY_UTIME_TICKS_PERIOD / 2) & (MICROPY_PY_UTIME_TICKS_PERIOD - 1))
|
2021-03-15 09:57:36 -04:00
|
|
|
- MICROPY_PY_UTIME_TICKS_PERIOD / 2;
|
extmod/utime_mphal: Fix implementation of new semantics of ticks_diff().
Now the function properly uses ring arithmetic to return signed value
in range (inclusive):
[-MICROPY_PY_UTIME_TICKS_PERIOD/2, MICROPY_PY_UTIME_TICKS_PERIOD/2-1].
That means that function can properly process 2 time values away from
each other within MICROPY_PY_UTIME_TICKS_PERIOD/2 ticks, but away in
both directions. For example, if tick value 'a' predates tick value 'b',
ticks_diff(a, b) will return negative value, and positive value otherwise.
But at positive value of MICROPY_PY_UTIME_TICKS_PERIOD/2-1, the result
of the function will wrap around to negative -MICROPY_PY_UTIME_TICKS_PERIOD/2,
in other words, if a follows b in more than MICROPY_PY_UTIME_TICKS_PERIOD/2 - 1
ticks, the function will "consider" a to actually predate b.
2016-10-29 20:07:22 -04:00
|
|
|
return MP_OBJ_NEW_SMALL_INT(diff);
|
2016-10-14 13:13:02 -04:00
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_2(mp_utime_ticks_diff_obj, time_ticks_diff);
|
|
|
|
|
2016-10-29 10:30:05 -04:00
|
|
|
STATIC mp_obj_t time_ticks_add(mp_obj_t ticks_in, mp_obj_t delta_in) {
|
|
|
|
// we assume that first argument come from ticks_xx so is small int
|
2016-11-03 16:54:16 -04:00
|
|
|
mp_uint_t ticks = MP_OBJ_SMALL_INT_VALUE(ticks_in);
|
|
|
|
mp_uint_t delta = mp_obj_get_int(delta_in);
|
2016-10-29 20:02:07 -04:00
|
|
|
return MP_OBJ_NEW_SMALL_INT((ticks + delta) & (MICROPY_PY_UTIME_TICKS_PERIOD - 1));
|
2016-10-29 10:30:05 -04:00
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_2(mp_utime_ticks_add_obj, time_ticks_add);
|
|
|
|
|
2020-09-23 22:37:02 -04:00
|
|
|
// Returns the number of nanoseconds since the Epoch, as an integer.
|
|
|
|
STATIC mp_obj_t time_time_ns(void) {
|
|
|
|
return mp_obj_new_int_from_ull(mp_hal_time_ns());
|
|
|
|
}
|
|
|
|
MP_DEFINE_CONST_FUN_OBJ_0(mp_utime_time_ns_obj, time_time_ns);
|
|
|
|
|
2016-10-14 13:13:02 -04:00
|
|
|
#endif // MICROPY_PY_UTIME_MP_HAL
|