WebSVN - shark - Blame - Rev 1086 - /demos/trunk/myapp/mymod.c

Rev	Author	Line No.	Line
1085	pj	1	/*
		2	* Project: HARTIK (HA-rd R-eal TI-me K-ernel)
		3	*
		4	* Coordinators: Giorgio Buttazzo <giorgio@sssup.it>
		5	* Gerardo Lamastra <gerardo@sssup.it>
		6	*
		7	* Authors : Paolo Gai <pj@hartik.sssup.it>
		8	* (see authors.txt for full list of hartik's authors)
		9	*
		10	* ReTiS Lab (Scuola Superiore S.Anna - Pisa - Italy)
		11	*
		12	* http://www.sssup.it
		13	* http://retis.sssup.it
		14	* http://hartik.sssup.it
		15	*/
		16
		17	/*
		18	* Copyright (C) 2000 Paolo Gai
		19	*
		20	* This program is free software; you can redistribute it and/or modify
		21	* it under the terms of the GNU General Public License as published by
		22	* the Free Software Foundation; either version 2 of the License, or
		23	* (at your option) any later version.
		24	*
		25	* This program is distributed in the hope that it will be useful,
		26	* but WITHOUT ANY WARRANTY; without even the implied warranty of
		27	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
		28	* GNU General Public License for more details.
		29	*
		30	* You should have received a copy of the GNU General Public License
		31	* along with this program; if not, write to the Free Software
		32	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
		33	*
		34	*/
		35
		36
		37	#include "mymod.h"
		38	#include <ll/string.h>
		39	#include <kernel/model.h>
		40	#include <kernel/descr.h>
		41	#include <kernel/var.h>
		42	#include <kernel/func.h>
		43
		44	// other include files if needed
		45
		46	// NOTE: NO GLOBAL OR STATIC VARIABLES!!!
		47	// (put them inside the level descriptor!)
		48
		49	/* Statuses used in the level */
		50	#define MYMOD_READY MODULE_STATUS_BASE
		51	#define MYMOD_WAIT MODULE_STATUS_BASE+3
		52	#define MYMOD_IDLE MODULE_STATUS_BASE+4
		53
		54	/* the level redefinition for the Module */
		55	typedef struct {
		56	level_des l; /* the standard level descriptor */
		57
		58	int myvar[100]; /* other local (private) variables of the module */
		59
		60	} MYMOD_level_des;
		61
		62	// example of OSLib event
		63	static void MYMOD_timer_deadline(void *par)
		64	{
		65	// usually the void *par is a pointer to a structure or a PID
		66	// if it is a PID, you can do that to retrieve it and the correspondent
		67	// level descriptor
		68	PID p = (PID) par;
		69	MYMOD_level_des *lev;
		70
		71	lev = (MYMOD_level_des *)level_table[proc_table[p].task_level];
		72
		73	// now you know the PID of the task and the level descriptor
		74	// ... so, you know all the things you need
		75	}
		76
		77	static int MYMOD_level_accept_task_model(LEVEL l, TASK_MODEL *m)
		78	{
		79	// your code here
		80	return 0; // dummy number
		81	}
		82
		83	static int MYMOD_level_accept_guest_model(LEVEL l, TASK_MODEL *m)
		84	{
		85	// your code here
		86	return 0; // dummy number
		87	}
		88
		89	static void MYMOD_level_status(LEVEL l)
		90	{
		91	}
		92
		93	/* The scheduler only gets the first task in the queue */
		94	static PID MYMOD_level_scheduler(LEVEL l)
		95	{
		96	return 0; // dummy number
		97	}
		98
		99	/* The on-line guarantee is enabled only if the appropriate flag is set... */
		100	static int MYMOD_level_guarantee(LEVEL l, bandwidth_t *freebandwidth)
		101	{
		102	return 0; // dummy number
		103	}
		104
		105	static int MYMOD_task_create(LEVEL l, PID p, TASK_MODEL *m)
		106	{
		107	return 0; // dummy number
		108	}
		109
		110	static void MYMOD_task_detach(LEVEL l, PID p)
		111	{
		112	}
		113
		114	static int MYMOD_task_eligible(LEVEL l, PID p)
		115	{
		116	return 0; // dummy number
		117	}
		118
		119	static void MYMOD_task_dispatch(LEVEL l, PID p, int nostop)
		120	{
		121	}
		122
		123	static void MYMOD_task_epilogue(LEVEL l, PID p)
		124	{
		125	}
		126
		127	static void MYMOD_task_activate(LEVEL l, PID p)
		128	{
		129	}
		130
		131	static void MYMOD_task_insert(LEVEL l, PID p)
		132	{
		133	}
		134
		135	static void MYMOD_task_extract(LEVEL l, PID p)
		136	{
		137	}
		138
		139	static void MYMOD_task_endcycle(LEVEL l, PID p)
		140	{
		141	}
		142
		143	static void MYMOD_task_end(LEVEL l, PID p)
		144	{
		145	}
		146
		147	static void MYMOD_task_sleep(LEVEL l, PID p)
		148	{
		149	}
		150
		151	static void MYMOD_task_delay(LEVEL l, PID p, TIME usdelay)
		152	{
		153	}
		154
		155	static int MYMOD_guest_create(LEVEL l, PID p, TASK_MODEL *m)
		156	{
		157	return 0; // dummy number
		158	}
		159
		160	static void MYMOD_guest_detach(LEVEL l, PID p)
		161	{
		162	}
		163
		164	static void MYMOD_guest_dispatch(LEVEL l, PID p, int nostop)
		165	{
		166	}
		167
		168	static void MYMOD_guest_epilogue(LEVEL l, PID p)
		169	{
		170	}
		171
		172	static void MYMOD_guest_activate(LEVEL l, PID p)
		173	{
		174	}
		175
		176	static void MYMOD_guest_insert(LEVEL l, PID p)
		177	{
		178	}
		179
		180	static void MYMOD_guest_extract(LEVEL l, PID p)
		181	{
		182	}
		183
		184	static void MYMOD_guest_endcycle(LEVEL l, PID p)
		185	{
		186	}
		187
		188	static void MYMOD_guest_end(LEVEL l, PID p)
		189	{
		190	}
		191
		192	static void MYMOD_guest_sleep(LEVEL l, PID p)
		193	{
		194	}
		195
		196	static void MYMOD_guest_delay(LEVEL l, PID p, TIME usdelay)
		197	{
		198	}
		199
		200
		201
		202
		203	/* Registration functions */
		204
		205	/*+ Registration function:
		206	int flags the init flags ... see MYMOD.h +*/
		207	void MYMOD_register_level(int flags)
		208	{
		209	LEVEL l; /* the level that we register */
		210	MYMOD_level_des lev; / for readableness only */
		211	PID i; /* a counter */
		212
		213	/* request an entry in the level_table */
		214	l = level_alloc_descriptor();
		215
		216	/* alloc the space needed for the MYMOD_level_des */
		217	lev = (MYMOD_level_des *)kern_alloc(sizeof(MYMOD_level_des));
		218
		219	/* update the level_table with the new entry */
		220	level_table[l] = (level_des *)lev;
		221
		222	/* fill the standard descriptor */
		223	strncpy(lev->l.level_name, MYMOD_LEVELNAME, MAX_LEVELNAME);
		224	lev->l.level_code = MYMOD_LEVEL_CODE;
		225	lev->l.level_version = MYMOD_LEVEL_VERSION;
		226
		227	lev->l.level_accept_task_model = MYMOD_level_accept_task_model;
		228	lev->l.level_accept_guest_model = MYMOD_level_accept_guest_model;
		229	lev->l.level_status = MYMOD_level_status;
		230	lev->l.level_scheduler = MYMOD_level_scheduler;
		231	lev->l.level_guarantee = MYMOD_level_guarantee;
		232
		233	lev->l.task_create = MYMOD_task_create;
		234	lev->l.task_detach = MYMOD_task_detach;
		235	lev->l.task_eligible = MYMOD_task_eligible;
		236	lev->l.task_dispatch = MYMOD_task_dispatch;
		237	lev->l.task_epilogue = MYMOD_task_epilogue;
		238	lev->l.task_activate = MYMOD_task_activate;
		239	lev->l.task_insert = MYMOD_task_insert;
		240	lev->l.task_extract = MYMOD_task_extract;
		241	lev->l.task_endcycle = MYMOD_task_endcycle;
		242	lev->l.task_end = MYMOD_task_end;
		243	lev->l.task_sleep = MYMOD_task_sleep;
		244	lev->l.task_delay = MYMOD_task_delay;
		245
		246	lev->l.guest_create = MYMOD_guest_create;
		247	lev->l.guest_detach = MYMOD_guest_detach;
		248	lev->l.guest_dispatch = MYMOD_guest_dispatch;
		249	lev->l.guest_epilogue = MYMOD_guest_epilogue;
		250	lev->l.guest_activate = MYMOD_guest_activate;
		251	lev->l.guest_insert = MYMOD_guest_insert;
		252	lev->l.guest_extract = MYMOD_guest_extract;
		253	lev->l.guest_endcycle = MYMOD_guest_endcycle;
		254	lev->l.guest_end = MYMOD_guest_end;
		255	lev->l.guest_sleep = MYMOD_guest_sleep;
		256	lev->l.guest_delay = MYMOD_guest_delay;
		257
		258	/* fill the MYMOD descriptor part */
		259	for (i=0; i<100; i++)
		260	lev->myvar[i] = 0;
		261	}
		262
		263	// put here the other interface functions added
		264
		265
		266
		267
		268
		269
		270

Subversion Repositories shark

(root)/demos/trunk/myapp/mymod.c - Rev 1086