readme.txt

this is RealTimeOS(uITRON) for hitachi H8 processor.

劕劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劖
劔									    劔
劔	        彫摛偺傛偆偵彫偝偄儕傾儖僞僀儉俷俽 AzkiRTOS		    劔
劔	        -------------------------------------------		    劔
劔	             azreadme.txt - AzkiRTOS Document			    劔
劔	        Copyright (C) 1999-2001, 傾儞僇乕僔僗僥儉僘姅幃夛幮	    劔
劔	                   All rights reserved.				    劔
劔									    劔
劔                         仧       仧       仧				    劔
劔									    劔
劔	偙偺僼傽僀儖偼丄AzkiRTOS偺堦晹暘偱偡丅				    劔
劔	偙偺僼傽僀儖偺偺挊嶌尃偼傾儞僇乕僔僗僥儉僘姅幃夛幮偵懏偟傑偡偑丄    劔
劔	扤偱傕僼傽僀儖傪柍曄峏丄傑偨偼曄峏偟偰帺桼偵巊偆偙偲偑偱偒傑偡丅    劔
劔	傑偨柍彏偱嵞攝晍偡傞偙偲傕壜擻偱偡偑丄僆儕僕僫儖偺挊嶌尃昞帵傪	    劔
劔	偦偺傑傑偺宍偱娷傔偰偔偩偝偄丅					    劔
劔									    劔
劔	偨偩偟丄柍曄峏傑偨偼曄峏偟偨傕偺傪惢昳偺堦晹偲偟偰偱偼側偔丄	    劔
劔	儕傾儖僞僀儉OS偦偺傕偺偲偟偰柍抐偱嵞斕攧偡傞偙偲偼偱偒傑偣傫丅	    劔
劔									    劔
劔	傾儞僇乕僔僗僥儉僘(姅)偼丄柍曄峏傑偨偼曄峏偟偨AzkiRTOS傪慻傒崬傫偩  劔
劔	惢昳偺晄嬶崌偵懳偟偰堦愗愑擟傪晧偆傕偺偱偼偁傝傑偣傫丅AzkiRTOS傪    劔
劔	娷傔AzkiRTOS傪慻傒崬傫偩惢昳慡懱偺摦嶌曐徹偼丄AzkiRTOS傪慻傒崬傫偩  劔
劔	惢昳偺奐敪幰偺愑擟偲側傝傑偡丅					    劔
劔									    劔
劔				傾儞僇乕僔僗僥儉僘姅幃夛幮		    劔
劔				仹674-0082 暫屔導柧愇巗嫑廧挰拞旜337	    劔
劔				TEL: [phone]			    劔
劔				FAX: [phone]			    劔
劔				WEB: http://www2.noritz.co.jp/anchor/	    劔
劔				MAIL: [e-mail]		    劔
劔									    劔
劘劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劒劗

偙偺僼傽僀儖偱偼丄AzkiRTOS偺僨乕僞宆丄僔僗僥儉僐乕儖儕僼傽儗儞僗丄僗僞乕僩
傾僢僾儖乕僠儞偺曄峏曽朄側偳傪愢柧偟偰偄傑偡丅偛帺桼偵偍帋偟偔偩偝偄丅

亂拲堄亃儅儖僠僞僗僋懳墳偺僷僢僠傪摉偰偨儔僀僽儔儕偺嵞峔抸曽朄偼丄azlib.txt
	傪嶲徠偟偰偔偩偝偄丅

亂拲堄亃AzkiRTOS偲僒儞僾儖 main 儖乕僠儞偺僼傽僀儖拞偵偼丄AnchorPlace昗弨搵嵹
	偺僔儈儏儗乕僞偱僨僶僢僌偡傞偨傔偺摿庩側儅僋儘偑杽傔崬傑傟偰偄傑偡丅
	幚婡傗懠偺娐嫬偱摦嶌偝偣傞偵偼丄偙傟傪off偵偡傞偐丄娐嫬偵崌傢偣偰曄峏
	偟側偗傟偽側傝傑偣傫丅off偵偡傞偵偼丄azrtos.h 偺28峴栚偵偁傞#define傪
	僐儊儞僩傾僂僩偟偰偔偩偝偄丅AzkiRTOS 偺僒僀僘偼丄偙偺僨僶僢僌僗僀僢僠
	傪 off 偵偟偨忬懺偱偺僐乕僪検偱偡丅

亂嶲徠亃M16C/62傪巊偭偨娙扨側奼挘壜擻側CPU儃乕僪偲丄摑崌奐敪娐嫬AnchorPlaceLite
	傪僙僢僩偵偟偨RTOS奐敪KIT傪梡堄偟偰偍傝傑偡丅徻偟偔偼儂乕儉傌乕僕傪偛棗
	偔偩偝偄丅


			仧仧仧	僨乕僞宆   仧仧仧


僿僢僟僼傽僀儖 azrtos.h 偺拞偱埲壓偺僨乕僞宆傪typedef偟偰偄傑偡丅傎偲傫偳偑
uITRON 巇條偱掕媊偝傟偰偄傞傕偺偲摨偠偱偡丅

typedef signed char	B;
typedef signed short	H;
typedef signed long	W;
typedef unsigned char	UB;
typedef unsigned short	UH;
typedef unsigned long	UW;

typedef unsigned char	VB;	/* 僨乕僞僞僀僾偑堦掕偱側偄8-bit僨乕僞 */
typedef unsigned short	VH;	/* 僨乕僞僞僀僾偑堦掕偱側偄16-bit僨乕僞 */
typedef unsigned long	VW;	/* 僨乕僞僞僀僾偑堦掕偱側偄32-bit僨乕僞 */
typedef void __azfar *	VP;	/* 僨乕僞僞僀僾偑堦掕偱側偄億僀儞僞 */
typedef void __aznear *	VNP;	/* 僨乕僞僞僀僾偑堦掕偱側偄near椞堟傊偺億僀儞僞 */

typedef void 		(*FP)(); /* 僾儘僌儔儉僗僞乕僩傾僪儗僗 */

typedef signed int	INT;	/* 晞崋晅偒惍悢 */
typedef unsigned int	UINT;	/* 晞崋側偟惍悢 */
typedef int		BOOL;	/* 僽乕儖抣 */
typedef int		FN;	/* 婡擻僐乕僪 */
typedef VNP		ID;	/* 僆僽僕僃僋僩幆暿巕(僆僽僕僃僋僩偺傾僪儗僗偱戙梡) */
typedef int		BOOL_ID; /* 僽乕儖抣傑偨偼ID斣崋 */
typedef int		HNO;	/* 僴儞僪儔斣崋 */
typedef int		RNO;	/* 儔儞僨僽斣崋 */
typedef int		NODE;	/* 僲乕僪斣崋 */
typedef unsigned	ATR;	/* 僆僽僕僃僋僩懏惈 */
typedef int		ER;	/* 僄儔乕僐乕僪 */
typedef int		PRI;	/* 僞僗僋桪愭弴埵 */
typedef int		TMO;	/* 僞僀儉傾僂僩帪娫 */
typedef int		DLYTIME; /* 僨傿儗僀帪娫 */


僨乕僞宆偵娭偟偰 uITRON 巇條偲偺憡堘揰偼埲壓偺偲偍傝偱偡丅

1. near椞堟偺傾僪儗僗偱偁傞偙偲傪柧帵偡傞億僀儞僞 VNP 傪捛壛偟傑偟偨丅
2. uITRON 巇條偱偼丄ID偼彫偝側惍悢偱偁傞偑丄AzkiRTOS偱偼 near 椞堟傊偺億僀儞僞
   偲側傝傑偡丅偙傟偵傛傝惍悢偲僞僗僋僐儞僩儘乕儖僽儘僢僋偺懳墳娗棟偑晄梫偵
   側傝丄慡懱偑僔儞僾儖偱彫偝偔丄懍偔側傝傑偡丅廬偭偰傪庴偗庢傞僔僗僥儉
   僐乕儖偵偼丄僞僗僋僐儞僩儘乕儖僽儘僢僋傗僙儅僼僅偺傾僪儗僗傪捈愙搉偟傑偡丅
   傑偁丄僞僗僋ID偲偄偆堄枴傪峀媊偵夝庍偡傞偲丄僞僗僋傪幆暿偱偒傞幆暿巕偱偡
   偐傜丄惍悢偱偁偭偰傕傾僪儗僗偱偁偭偰傕峔傢側偄偲峫偊傞偙偲傕偱偒傑偡偑...

   亂椺亃AzTCB task1;	/* AzkiRTOS 偺僞僗僋僐儞僩儘乕儖僽儘僢僋 */
	 ER ercd;	/* 僄儔乕僐乕僪傪庴偗庢傞曄悢 */
	 ...
	 ercd = sta_tsk(&task1, 0);




		仧仧仧	僔僗僥儉僐乕儖儕僼傽儗儞僗   仧仧仧


=============================================================================
vini_sys                                                 AzkiRTOS慡懱偺弶婜壔
-----------------------------------------------------------------------------

亂娭悢亃void vini_sys(void)

亂堷悢亃void

亂栠抣亃void (栠偭偰偒傑偣傫)

亂夝愢亃
AzkiRTOS 慡懱傪弶婜壔偟偨屻丄嵟弶偺僞僗僋傪婲摦偟傑偡丅嵟弶偺僞僗僋偺擖傝岥
娭悢柤偼丄僿僢僟僼傽僀儖 azconf.h 偺拞偺 AZ_IDLEENTRY 偱偡丅僨僼僅儖僩偱偼
main 偲側偭偰偄傞偨傔丄傑偢嵟弶偺僞僗僋偲偟偰 main 娭悢偐傜憱傝弌偟傑偡丅
main 埲奜偺娭悢傪嵟弶偺僞僗僋偲偟偰婲摦偟偨偄応崌偼丄暿偺娭悢傪巜掕偟偰偔偩
偝偄丅偙偺娭悢偼傝僞乕儞偟傑偣傫丅

捠忢偼丄傾僙儞僽儕尵岅偱婰弎偟偨僗僞乕僩傾僢僾張棟偺廔椆屻偵丄偙偺娭悢傪僒僽
儖乕僠儞僐乕儖偟偰偔偩偝偄丅傾僙儞僽儕尵岅偺儌僕儏乕儖偐傜屇傃弌偡帪偼丄娭悢
柤偺慜偵傾儞僟乕僗僐傾(_)偑昁梫偱偡丅

嵟弶偺僞僗僋偺僗僞僢僋椞堟偺戝偒偝偼丄摨偠偔 azconf.h 偺 AZ_IDLESTACKSIZE 偱
愝掕偟傑偡丅僨僼僅儖僩偼64僶僀僩偲彫偝傔偱偡丅嵟弶偺僞僗僋偱傛傝懡偔偺僗僞僢
僋偑昁梫偲側傞応崌偼丄偙偺悢抣傪戝偒偔偟偰偔偩偝偄丅

	#define AZ_IDLEENTRY		main
	#define AZ_IDLESTACKSIZE	64

亂椺亃	.glb	_vini_sys
	jsr.a	_vini_sys
	; 偙偙傊偼儕僞乕儞偟傑偣傫.

亂嶲徠亃vini_tsk


=============================================================================
vini_tsk                                   僞僗僋僐儞僩儘乕儖僽儘僢僋偺弶婜壔
-----------------------------------------------------------------------------

亂娭悢亃void vini_tsk(ID tskid, FP entry, PRI tskpri, VNP stack, UINT size)

亂堷悢亃ID tskid	弶婜壔偡傞僞僗僋僐儞僩儘乕儖僽儘僢僋傊偺億僀儞僞
	FP entry	僞僗僋偺婲摦傾僪儗僗
	PRI tskpri	僞僗僋偺桪愭弴埵
	VNP stack	僞僗僋偺僗僞僢僋椞堟傊偺億僀儞僞
	UINT size	僗僞僢僋椞堟偺僶僀僩悢

亂栠抣亃void

亂婡擻亃
僞僗僋僐儞僩儘乕儖僽儘僢僋 AzTCB 傪弶婜壔偟傑偡丅AzkiRTOS 偵偼儊儌儕娗棟婡擻
偑側偄偨傔丄僟僀僫儈僢僋偵僞僗僋僐儞僩儘乕儖僽儘僢僋傪惗惉偱偒傑偣傫丅戙傝偵
僞僗僋僐儞僩儘乕儖僽儘僢僋傪C尵岅偺峔憿懱偲偟偰儐乕僓偺C僾儘僌儔儉偺偳偙偐偱
掕媊偟丄偦傟傪偙偺娭悢偱弶婜壔偟偰丄AzkiRTOS偑巊偊傞忬懺偵偟傑偡丅僞僗僋僐儞
僩儘乕儖僽儘僢僋偼丄AzTCB 偲偄偆峔憿懱偱偡丅

僞僗僋偺桪愭弴埵偼丄1乣AZ_NPRIORITIES 偺抣偱偡丅彫偝偄曽偑崅偄桪愭弴埵偱偡丅
AZ_NPRIORITIES 偼丄azconf.h 偺拞偱掕媊偝傟偰偄偰丄僨僼僅儖僩偼4偱偡丅 傕偭偲
嵶偐偔暘偗偨偄応崌偼丄偙偺抣傪廋惓偟偰偔偩偝偄丅偨偩偟戝偒偔偡傞偲丄偦傟偩偗
儊儌儕偲僨傿僗僷僢僠偵昁梫側CPU僒僀僋儖偑憹壛偟傑偡丅 壗儗儀儖偺桪愭弴埵偑昁
梫偐傪傛偔専摙偟丄嵟彫尷偵偲偳傔偨曽偑岠棪傛偔側傝傑偡丅

摨條偵僗僞僢僋椞堟傕儐乕僓偑妋曐偟傑偡丅僗僞僢僋椞堟傪妋曐偡傞傕偭偲傕娙扨側
曽朄偼丄C尵岅偺攝楍偲偟偰偲傞曽朄偱偡丅

亂椺亃	AzTCB task1;		/* 僞僗僋1偺TCB */
	UB stack1[128];		/* 僞僗僋1偺僗僞僢僋 */
	...
	/* 僞僗僋僐儞僩儘乕儖僽儘僢僋傪弶婜壔偟 */
	vini_tsk(&task1, task1_main, 2, stack1, sizeof(stack1));
	/* 僞僗僋傪婲摦偡傞 */
	sta_tsk(&task1, 0);

亂嶲徠亃vini_sem, sta_tsk


=============================================================================
vini_sem                                                     僙儅僼僅偺弶婜壔
-----------------------------------------------------------------------------

亂娭悢亃void vini_sem(ID semid, INT inival)

亂堷悢亃ID semid	弶婜壔偡傞僙儅僼僅傊偺億僀儞僞
	INT inival	僙儅僼僅偺弶婜抣

亂栠抣亃void

亂婡擻亃
僙儅僼僅 AzSemaphore 傪弶婜壔偟傑偡丅AzkiRTOS 偵偼儊儌儕娗棟婡擻偑側偄偨傔丄
僟僀僫儈僢僋偵僙儅僼僅傪惗惉偱偒傑偣傫丅戙傝偵僙儅僼僅傪C尵岅偺峔憿懱偲偟偰
儐乕僓偺C僾儘僌儔儉偺偳偙偐偱掕媊偟丄偦傟傪偙偺娭悢偱弶婜壔偟偰丄AzkiRTOS偑
巊偊傞忬懺偵偟傑偡丅僙儅僼僅偼丄AzSemaphore 偲偄偆柤慜偺峔憿懱偱偡丅

亂椺亃	AzSemaphore sem1;
	...
	vini_sem(&sem1);
	er = wai_sem(&sem1);

亂嶲徠亃vini_tsk


=============================================================================
sta_tsk                                                            僞僗僋婲摦
-----------------------------------------------------------------------------

亂娭悢亃ER sta_tsk(ID tskid, INT stacd)

亂堷悢亃ID tskid	僞僗僋僐儞僩儘乕儖僽儘僢僋傊偺億僀儞僞
	INT stacd	僞僗僋婲摦僐乕僪

亂栠抣亃僄儔乕僐乕僪

亂婡擻亃
tskid偱巜掕偝傟偨僞僗僋傪婲摦偟傑偡丅uITRON巇條偲偺堘偄偼丄tskid偑彫偝側惍悢
抣偱偼側偔丄儐乕僓偑C尵岅偺僌儘乕僶儖曄悢偲偟偰掕媊偟偨 AzTCB 峔憿懱傊偺億僀
儞僞偱偁傞偙偲偱偡丅

偙偺僔僗僥儉僐乕儖偱僞僗僋傪婲摦偡傞慜偵丄梊傔僞僗僋僐儞僩儘乕儖僽儘僢僋傪
vini_tsk()娭悢偱弶婜壔偟偰偍偐側偗傟偽側傝傑偣傫丅

亂椺亃	AzTCB task1;		/* 僞僗僋1偺TCB */
	UB stack1[128];		/* 僞僗僋1偺僗僞僢僋 */
	...
	/* 僞僗僋僐儞僩儘乕儖僽儘僢僋傪弶婜壔偟 */
	vini_tsk(&task1, task1_main, 2, stack1, sizeof(stack1));
	/* 僞僗僋傪婲摦偡傞 */
	sta_tsk(&task1, 0);

亂嶲徠亃ext_tsk, ter_tsk


=============================================================================
ext_tsk                                                          帺僞僗僋廔椆
-----------------------------------------------------------------------------

亂娭悢亃void ext_tsk(void)

亂堷悢亃void

亂栠抣亃void (栠偭偰偒傑偣傫)

亂婡擻亃
帺僞僗僋傪廔椆偟丄DOMANT忬懺傊堏傝傑偡丅僞僗僋偑廔椆偟偰偟傑偆偨傔丄偙偺娭悢
偐傜偼栠偭偰偒傑偣傫丅

僞僗僋傪廔椆偡傞偲丄巊梡偟偰偄偨僞僗僋僐儞僩儘乕儖僽儘僢僋傪懠偺僞僗僋偺婲摦
偵巊偆偙偲傕偱偒傑偡偟丄偦偺傑傑嵞搙摨偠僞僗僋傪婲摦偡傞偙偲傕壜擻偱偡丅

亂椺亃	ext_tsk();

亂嶲徠亃sta_tsk, ter_tsk


=============================================================================
ter_tsk                                                    懠僞僗僋偺嫮惂廔椆
-----------------------------------------------------------------------------

亂娭悢亃ER ter_tsk(ID tskid)

亂堷悢亃ID tskid	廔椆偝偣偨偄僞僗僋偺僞僗僋僐儞僩儘乕儖僽儘僢僋傊偺
			億僀儞僞

亂栠抣亃僄儔乕僐乕僪

亂婡擻亃
tskid偱巜掕偟偨僞僗僋傪嫮惂揑偵廔椆偝偣傑偡丅uITRON巇條偲偺憡堘揰偼丄ID 偑
僞僗僋傪幆暿偡傞偨傔偺惍悢偱偼側偔丄僞僗僋僐儞僩儘乕儖僽儘僢僋峔憿懱傊偺
億僀儞僞偱偁傞揰偱偡丅

亂椺亃	AzTCB your_task;

	/* your_task 傪嫮惂廔椆偝偣傑偡 */
	er = ter_tsk(&your_task);