mirror of
https://github.com/obgm/libcoap.git
synced 2026-11-03 08:25:47 +03:00
Olaf Bergmann
4ca91190d6
* Removed tne preprocessor defines for coap_tick() and coap_clock_init() -- this made the code less readable and seemed to be of little use. * Introduced the new type coap_time_t to represent wall clock time. On POSIX, this is the number of seconds since the epoch, while on embedded systems without a real time clock, this could be the number of seconds since the last reboot. The new function coap_ticks_to_rt() is used to convert coap_tick_t to coap_time.h. Currently, this is a division by COAP_TICKS_PER_SECOND on all platforms. * POSIX: coap_tick_t is now defined as unsigned long to avoid overflows in coap_ticks().
160 lines
3.3 KiB
C
160 lines
3.3 KiB
C
/* coap_time.h -- Clock Handling
|
|
*
|
|
* Copyright (C) 2010--2013 Olaf Bergmann <bergmann@tzi.org>
|
|
*
|
|
* This file is part of the CoAP library libcoap. Please see
|
|
* README for terms of use.
|
|
*/
|
|
|
|
/**
|
|
* @file coap_time.h
|
|
* @brief Clock Handling
|
|
*/
|
|
|
|
#ifndef _COAP_TIME_H_
|
|
#define _COAP_TIME_H_
|
|
|
|
/*
|
|
** Make sure we can call this stuff from C++.
|
|
*/
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
#include "coap_config.h"
|
|
|
|
/**
|
|
* @defgroup clock Clock Handling
|
|
* Default implementation of internal clock.
|
|
* @{
|
|
*/
|
|
|
|
#ifdef WITH_LWIP
|
|
|
|
#include <stdint.h>
|
|
#include <lwip/sys.h>
|
|
|
|
/* lwIP provides ms in sys_now */
|
|
#define COAP_TICKS_PER_SECOND 1000
|
|
|
|
typedef uint32_t coap_tick_t;
|
|
typedef uint32_t coap_time_t;
|
|
typedef int32_t coap_tick_diff_t;
|
|
|
|
static inline void coap_ticks_impl(coap_tick_t *t)
|
|
{
|
|
*t = sys_now();
|
|
}
|
|
|
|
static inline void coap_clock_init_impl(void)
|
|
{
|
|
}
|
|
|
|
#define coap_clock_init coap_clock_init_impl
|
|
|
|
#define coap_ticks coap_ticks_impl
|
|
|
|
static inline coap_time_t coap_ticks_to_rt(coap_tick_t t) {
|
|
return t / COAP_TICKS_PER_SECOND;
|
|
}
|
|
#endif
|
|
#ifdef WITH_CONTIKI
|
|
#include "clock.h"
|
|
|
|
typedef clock_time_t coap_tick_t;
|
|
typedef clock_time_t coap_time_t;
|
|
|
|
/**
|
|
* This data type is used to represent the difference between two
|
|
* clock_tick_t values. This data type must have the same size in
|
|
* memory as coap_tick_t to allow wrapping.
|
|
*/
|
|
typedef int coap_tick_diff_t;
|
|
|
|
#define COAP_TICKS_PER_SECOND CLOCK_SECOND
|
|
|
|
static inline void
|
|
coap_clock_init(void) {
|
|
clock_init();
|
|
}
|
|
|
|
static inline void
|
|
coap_ticks(coap_tick_t *t) {
|
|
*t = clock_time();
|
|
}
|
|
|
|
static inline coap_time_t coap_ticks_to_rt(coap_tick_t t) {
|
|
return t / COAP_TICKS_PER_SECOND;
|
|
}
|
|
#endif /* WITH_CONTIKI */
|
|
#ifdef WITH_POSIX
|
|
/**
|
|
* This data type represents internal timer ticks with
|
|
* COAP_TICKS_PER_SECOND resolution.
|
|
*/
|
|
typedef unsigned long coap_tick_t;
|
|
|
|
/** CoAP time in seconds since epoch. */
|
|
typedef time_t coap_time_t;
|
|
|
|
/**
|
|
* This data type is used to represent the difference between two
|
|
* clock_tick_t values. This data type must have the same size in
|
|
* memory as coap_tick_t to allow wrapping.
|
|
*/
|
|
typedef long coap_tick_diff_t;
|
|
|
|
/** Use ms resolution on POSIX systems */
|
|
#define COAP_TICKS_PER_SECOND 1000
|
|
|
|
/** Initializes the internal clock. */
|
|
static inline void coap_clock_init(void)
|
|
{
|
|
}
|
|
|
|
/** Sets @p t to the internal time with COAP_TICKS_PER_SECOND resolution. */
|
|
void coap_ticks(coap_tick_t *t);
|
|
|
|
/**
|
|
* Helper function that converts coap ticks to wallclock time. On POSIX,
|
|
* this function returns the number of seconds since the epoch. On other
|
|
* systems, it may be the calculated number of seconds since last reboot
|
|
* or so.
|
|
*
|
|
* @param t Internal system ticks
|
|
* @return The number of seconds that has passed since a specific reference
|
|
* point (seconds since epoch on POSIX).
|
|
*/
|
|
static inline coap_time_t coap_ticks_to_rt(coap_tick_t t) {
|
|
return t / COAP_TICKS_PER_SECOND;
|
|
}
|
|
#endif /* WITH_POSIX */
|
|
|
|
/**
|
|
* Returns @c 1 if and only if @p a is less than @p b where less is
|
|
* defined on a signed data type.
|
|
*/
|
|
static inline
|
|
int coap_time_lt(coap_tick_t a, coap_tick_t b) {
|
|
return ((coap_tick_diff_t)(a - b)) < 0;
|
|
}
|
|
|
|
/**
|
|
* Returns @c 1 if and only if @p a is less than or equal @p b where
|
|
* less is defined on a signed data type.
|
|
*/
|
|
static inline
|
|
int coap_time_le(coap_tick_t a, coap_tick_t b) {
|
|
return a == b || coap_time_lt(a,b);
|
|
}
|
|
|
|
/** @} */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif /* _COAP_TIME_H_ */
|