Multi-threading library
[Contiki system]

The event driven Contiki kernel does not provide multi-threading by itself - instead, preemptive multi-threading is implemented as a library that optionally can be linked with applications. More...

Modules
	Architecture support for multi-threading
	The Contiki multi-threading library requires some architecture specific support for setting up and switching stacks.
Defines
#define	MT_OK 1
	No error.
Functions
void	mt_init (void)
	Initializes the multithreading library.
void	mt_remove (void)
	Uninstalls library and cleans up.
void	mt_start (struct mt_thread thread, void(function)(void ), void data)
	Starts a multithreading thread.
void	mt_exec (struct mt_thread *thread)
	Execute parts of a thread.
void	mt_yield (void)
	Voluntarily give up the processor.
void	mt_exit (void)
	Exit a thread.
void	mt_stop (struct mt_thread *thread)
	Stop a thread.

Detailed Description

The event driven Contiki kernel does not provide multi-threading by itself - instead, preemptive multi-threading is implemented as a library that optionally can be linked with applications.

This library consists of two parts: a platform independent part, which is the same for all platforms on which Contiki runs, and a platform specific part, which must be implemented specifically for the platform that the multi-threading library should run.

Function Documentation

void mt_exec ( struct mt_thread * thread )

Execute parts of a thread.

This function is called by a Contiki process and runs a thread. The function does not return until the thread has yielded, or is preempted.

Note:: The thread library must first be initialized with the mt_init() function.

Parameters:

thread

A pointer to a struct mt_thread block that must be allocated by the caller.

Definition at line 80 of file mt.c.

References mtarch_exec().

Referenced by main().

void mt_exit ( void )

Exit a thread.

This function is called from within an executing thread in order to exit the thread. The function never returns.

Definition at line 106 of file mt.c.

References mtarch_yield().

void mt_start	(	struct mt_thread *	thread,
		void()(void )	function,
		void *	data
	)

Starts a multithreading thread.

Parameters:

	thread	Pointer to an mt_thread struct that must have been previously allocated by the caller.
	function	A pointer to the entry function of the thread that is to be set up.
	data	A pointer that will be passed to the entry function.

Definition at line 70 of file mt.c.

References mtarch_start().

Referenced by main().

void mt_stop ( struct mt_thread * thread )

Stop a thread.

This function is called by a Contiki process in order to clean up a thread. The struct mt_thread block may then be discarded by the caller.

Parameters:

thread

A pointer to a struct mt_thread block that must be allocated by the caller.

Definition at line 114 of file mt.c.

References mtarch_stop().

void mt_yield ( void )