timeouts.h File Reference

#include "lwip/opt.h"
#include "lwip/err.h"
#include "lwip/sys.h"

Data Structures
struct	lwip_cyclic_timer

Macros
#define	SYS_TIMEOUTS_SLEEPTIME_INFINITE   0xFFFFFFFF

Typedefs
typedef void(*	lwip_cyclic_timer_handler) (void)
typedef void(*	sys_timeout_handler) (void *arg)

Functions
void	sys_timeouts_init (void)
void	sys_timeout (u32_t msecs, sys_timeout_handler handler, void *arg)
void	sys_untimeout (sys_timeout_handler handler, void *arg)
void	sys_restart_timeouts (void)
void	sys_check_timeouts (void)
u32_t	sys_timeouts_sleeptime (void)

Variables
const struct lwip_cyclic_timer	lwip_cyclic_timers []
const int	lwip_num_cyclic_timers

Detailed Description

Timer implementations

Macro Definition Documentation

SYS_TIMEOUTS_SLEEPTIME_INFINITE

#define SYS_TIMEOUTS_SLEEPTIME_INFINITE   0xFFFFFFFF

Returned by sys_timeouts_sleeptime() to indicate there is no timer, so we can sleep forever.

Typedef Documentation

lwip_cyclic_timer_handler

typedef void(* lwip_cyclic_timer_handler) (void)

Function prototype for a stack-internal timer function that has to be called at a defined interval

sys_timeout_handler

typedef void(* sys_timeout_handler) (void *arg)

Function prototype for a timeout callback function. Register such a function using sys_timeout().

Parameters

arg	Additional argument to pass to the function - set up by sys_timeout()

Function Documentation

sys_restart_timeouts()

void sys_restart_timeouts

(

void

)

Rebase the timeout times to the current time. This is necessary if sys_check_timeouts() hasn't been called for a long time (e.g. while saving energy) to prevent all timer functions of that period being called.

sys_timeout()

void sys_timeout	(	u32_t	msecs,
		sys_timeout_handler	handler,
		void *	arg
	)

Create a one-shot timer (aka timeout). Timeouts are processed in the following cases:

• while waiting for a message using sys_timeouts_mbox_fetch()
• by calling sys_check_timeouts() (NO_SYS==1 only)

Parameters

msecs	time in milliseconds after that the timer should expire
handler	callback function to call when msecs have elapsed
arg	argument to pass to the callback function

sys_timeouts_init()

void sys_timeouts_init

(

void

)

Initialize this module

sys_timeouts_sleeptime()

u32_t sys_timeouts_sleeptime

(

void

)

Return the time left before the next timeout is due. If no timeouts are enqueued, returns 0xffffffff

sys_untimeout()

void sys_untimeout	(	sys_timeout_handler	handler,
		void *	arg
	)

Go through timeout list (for this task only) and remove the first matching entry (subsequent entries remain untouched), even though the timeout has not triggered yet.

Parameters

handler	callback function that would be called by the timeout
arg	callback argument that would be passed to handler

Variable Documentation

lwip_cyclic_timers

const struct lwip_cyclic_timer lwip_cyclic_timers[]

This array contains all stack-internal cyclic timers. To get the number of timers, use lwip_num_cyclic_timers

This array contains all stack-internal cyclic timers. To get the number of timers, use LWIP_ARRAYSIZE()

lwip_num_cyclic_timers

const int lwip_num_cyclic_timers

Array size of lwip_cyclic_timers[]