manual.txt

050117 CD 修正分 iTRON hosroot

-------------------------------------------------------------------------------
 Hyper Oparating System V3 for Hitachi H8                                      
 儕僼傽儗儞僗儅僯儏傾儖                                                        
                                                                               
                                        Copyright (C) 1998-2002 by Project HOS 
-------------------------------------------------------------------------------



  偙偺儅僯儏傾儖偱偼 Hyper Oparating System V3 for Hitachi H8 (埲壓 HOS-H8)偺
棙梡偟偐偨傪愢柧偟傑偡丅



亙栚師亜

  戞侾復  HOS-H8 偺奣梫
  戞俀復  儔僀僽儔儕偺儊僀僋曽朄
  戞俁復  僐儞僼傿僊儏儗乕僞乕偺巊偄曽
  戞係復  僾儘僌儔儉偺儊僀僋曽朄
  晅榐俙  幱帿
  晅榐俛  嶲峫暥專




-------------------------------------------------------------------------------
 戞侾復  HOS-H8 偺奣梫
-------------------------------------------------------------------------------


  HOS-H8 偼兪ITRON3.0巇條偵弨嫆偟偨 擔棫 H8/300H 僔儕乕僘梡偺儕傾儖僞僀儉
俷俽偱偡丅庡偵屄恖儗儀儖偱偺儂價乕傪栚揑偲偟偨暔偱俼俷俵壔偡傞僔僗僥儉偵
儕儞僋偡傞偩偗偱娙扨偵慻傒崬傓偙偲偑弌棃傑偡丅僐儞僷僀儔偼桳尷夛幮廐寧揹巕
捠彜揳偐傜斕攧偝傟偰偄傞俠僐儞僷僀儔偲傾僙儞僽儔傪慜採偲偟偰偄傑偡偑丄嫲傜偔
makefike 傗 儕儞僋梡偺僼傽僀儖傪廋惓偡傞偩偗偱擔棫惢嶌強弮惓偺俠僐儞僷僀儔偱
棙梡偡傞帠偑壜擻偲巚偄傑偡丅



1.1 僔僗僥儉僐乕儖

  愙懕婡擻傪彍偔儗儀儖俽傑偱偲堦晹偺儗儀儖俤丄俠偺僔僗僥儉僐乕儖傪僒億乕僩
偟偰偄傑偡丅
  僒億乕僩偟偰偄傞僔僗僥儉僐乕儖偼埲壓偺捠傝丅

僞僗僋娗棟
  sta_tsk  ext_tsk  ter_tsk  dis_dsp  ena_dsp  chg_pri  rot_rdq  rel_wai
  get_tid  ref_tsk

僞僗僋晅懏摨婜婡擻
  sus_tsk  rsm_tsk  frsm_tsk slp_tsk  wup_tsk  can_wup

摨婜丒捠怣婡擻
  sig_sem  wai_sem  preq_sem ref_sem  set_flg  clr_flg  wai_flg  pol_flg
  ref_flg  snd_msg  rcv_msg  prcv_msg ref_mbx

妱傝崬傒娗棟婡擻
  ret_int  loc_cpu  unl_cpu

帪娫娗棟婡擻
  set_tim  get_tim  dly_tsk

儊儌儕僾乕儖
  get_blf  pget_blf rel_blf  ref_mpf

僔僗僥儉娗棟
  get_ver  ref_sys


  奺僆僽僕僃僋僩偼慡偰惷揑偵惗惉偟傑偡丅僐儞僼傿僊儏儗乕僞乕傪梡堄偟偰偍傝
傑偡偺偱娙扨偵惗惉偡傞偙偲偑壜擻偱偡丅



1.2 僗儁僢僋

  嵟戝僞僗僋悢           255
  SUSPEND嵟戝僱僗僩悢    65535
  婲彴梫媮嵟戝僱僗僩悢   65535
  嵟戝僙儅僼僅悢         255
  嵟戝僙儅僼僅僇僂儞僞   65535
  嵟戝僀儀儞僩僼儔僌悢   255
  僀儀儞僩僼儔僌偺庬椶   16 bit
  嵟戝儊僀儖儃僢僋僗悢   255




-------------------------------------------------------------------------------
 戞俀復  僜乕僗僼傽僀儖偺儊僀僋曽朄
-------------------------------------------------------------------------------


  HOS-H8 偼僜乕僗偱攝晍偝傟傑偡偺偱棙梡偡傞偨傔偵偼傑偢僜乕僗傪儊僀僋偟偰
僆僽僕僃僋僩僼傽僀儖傪惗惉偡傞昁梫偑偁傝傑偡丅廐寧偐傜斕攧偝傟傞僐儞僷僀儔
偵偼儔僀僽儔儕傾儞偑偁傝傑偣傫偺偱儔僀僽儔儕僼傽僀儖偼嶌傟傑偣傫丅岠棪偼埆偄
偺偱偡偑俀偮偺僆僽僕僃僋僩僼傽僀儖偵偡傋偰傑偲傔偰偟傑偄傑偡丅偙偺復偱偼
僜乕僗偺儊僀僋曽朄傪愢柧偟傑偡丅



2.1 昁梫側傾僙儞僽儔丄僐儞僷僀儔

  HOS-H8 傪僐儞僷僀儖偡傞偨傔偵偼桳尷夛幮廐寧揹巕捠彜偐傜斕攧偝傟偰偄傞
AKI-H8梡偺俠僐儞僷僀儔偲傾僙儞僽儔偑昁梫偱偡丅晅懏儅僯儏傾儖偵増偭偰
偙傟傜傪僙僢僩傾僢僾偟偰偍偄偰壓偝偄丅傑偨 make 傕昁梫偲側傝傑偡丅巹偼
乽僄儖丒僄僗丒傾僀僕儍僷儞姅幃夛幮乿傛傝攝晍偝傟偰偄傞乽LSI C-86 Ver.3.30
帋怘斉乿晅懏偺 make 傪棙梡偟傑偟偨丅暿搑擖庤偟偰偄偨偩偗傑偡傛偆偍婅偄
偄偨偟傑偡丅

  埲屻偺愢柧偼傾僙儞僽儔偍傛傃僐儞僷僀儔偺僨傿儗僋僩儕偵僷僗偑捠傝丄棙梡
壜擻側忬懺偵側偭偰偄傞偙偲傪慜採偵恑傔傑偡丅



2.2 僿僢僟僼傽僀儖偺僐僺乕

  傑偢偼攝晍僼傽僀儖傪夝搥偟偨帪偵嶌傜傟傞 INCLUDE 偲偄偆僨傿儗僋僩儕偺
壓偵偁傞僼傽僀儖傪僐儞僷僀儖儔偺棙梡偡傞僨傿儗僋僩儕偵僐僺乕偟傑偡丅偙偺
僿僢僟僼傽僀儖偼僜乕僗偺儕儞僋帪偵傕巊梡偟傑偡偟丄屻偐傜HOS-H8傪棙梡
偟偨傾僾儕働乕僔儑儞傪嶌惢偡傞嵺偵傕僀儞僋儖乕僪偡傞昁梫偑偁傝傑偡丅



2.3 儊僀僋僼傽僀儖側偳偺愝掕

  夝搥帪偵弌棃偨 src 偲偄偆僨傿儗僋僩儕偵 makefile 偑弌棃傑偡偑丄僿僢僟
僼傽僀儖偺僷僗巜掕側偳堦晹娐嫬偵埶懚偡傞愝掕崁栚偑偁傝傑偡丅棙梡偝傟傞
娐嫬偵崌偣偰彂偒姺偊偰壓偝偄丅



2.4 儔僀僽儔儕偺儊僀僋

  慡偰偺愝掕偑廔偭偨傜偄傛偄傛儊僀僋偱偡丅夝搥帪偺 src 偵 makefile 偑
偁傝傑偡偺偱丄偙偺僨傿儗僋僩儕偵堏摦偟 make 傪幚峴偟偰偔偩偝偄丅僄儔乕偑
柍偗傟偽 hos_c.obj 偲 hos_asm.obj 偲偄偆僆僽僕僃僋僩僼傽僀儖偑惗惉偝傟傞
偼偢偱偡丅儔僀僽儔儕傾儞偑偁傟偽儔僀僽儔儕傪嶌惉偡傞偲偙傠側偺偱偡偑丄
廐寧偐傜偼斕攧偝傟偰偄側偄傛偆偱偡偺偱丄俠尵岅晹暘偲傾僙儞僽儔晹暘偱偦傟
偧傟嫮堷偵侾偮偵傑偲傔偰偄傑偡丅
  HOS-H8 偺巊梡偵嵺偟偰偙傟傜偺俀偮偺僆僽僕僃僋僩傪儕儞僋偟傑偡丅



2.3 僐儞僼傿僊儏儗乕僞乕偺僐僺乕

  config 偲偄偆僨傿儗僋僩儕偵 hcfgh8h.c 偲偄偆僐儞僼傿僊儏儗乕僞乕偺僜乕僗
偲 hcfgh8h.exe 偲偄偆 hcfgh8h.c 傪 Borland-C++ 5.01J 偱僐儞僷僀儖偟偨暔傪
梡堄偟偰偄傑偡丅傾僾儕働乕僔儑儞嶌惉帪偵 hcfgh8h.exe 傪棙梡偟傑偡偺偱丄偙傟
傪僷僗偺捠偭偨僨傿儗僋僩儕偵僐僺乕偟偰偍偄偰偔偩偝偄丅

  偙傟偱 HOS-H8 傪棙梡偟偨傾僾儕働乕僔儑儞傪嶌惢偡傞弨旛偑惍偄傑偟偨丅




-------------------------------------------------------------------------------
 戞俁復 僐儞僼傿僊儏儗乕僞乕偺巊偄曽
-------------------------------------------------------------------------------


  偙偺復偱偼 HOS-H8h 偺僐儞僼傿僊儏儗乕僞乕偺巊偄曽傪愢柧偟傑偡丅



3.1 僐儞僼傿僊儏儗乕僞乕偲偼

  HOS-H8 偱偼僞僗僋傪偼偠傔丄僙儅僼僅丄僀儀儞僩僼儔僌側偳偼惷揑偵惗惉偝傟傑
偡丅偦偺偨傔偙傟傜傪婰弎偟偨僾儘僌儔儉彂偒僐儞僷僀儖丄儕儞僋傪峴側偆昁梫偑
偁傝傑偡丅偟偐偟偙傟傜偺僾儘僌儔儉傪枅夞婰弎偡傞偺偼柺搢偱偁傞偨傔丄昁梫側
崁栚偺傒傪彂偄偨僼傽僀儖傪梡堄偟丄僐儞僼傿僊儏儗乕僞乕傪巊偄偙偺僼傽僀儖偐傜
昁梫側僜乕僗傪惗惉偝偣傑偡丅



3.2 僐儞僼傿僊儏儗乕僞乕偺婡擻

  僐儞僼傿僊儏儗乕僞乕偼師偺婡擻傪帩偪傑偡丅

  丒嵟戝桪愭搙偺巜掕
  丒妱傝崬傒僴儞僪儔偺搊榐
  丒僗僞僢僋僾乕儖偺搊榐
  丒僞僗僋偺搊榐
  丒僙儅僼僅偺搊榐
  丒僀儀儞僩僼儔僌偺搊榐
  丒儊僀儖儃僢僋僗偺搊榐



3.3 僐儞僼傿僊儏儗乕僞乕偺摦嶌

  僐儞僼傿僊儏儗乕僞乕偼儐乕僓乕偑梡堄偟偨 "hos.cfg" 偲偄偆僼傽僀儖傪撉傒崬
傫偱夝愅偟丄"cfg_c.c"丄"cfg_asm.asm"丄"defid.h"偲偄偆俁偮偺僼傽僀儖傪弌椡偟
傑偡丅儐乕僓乕偼奺僾儘僌儔儉偺拞偱 "defid.h" 傪僀儞僋儖乕僪偟偰巊偄丄儊僀僋
帪偵偼 "cfg_c.c"丄"cfg_asm.asm" 傪偦傟偧傟僐儞僷僀儖偟偰儕儞僋偡傞昁梫偑偁傝
傑偡丅

乮拲丗尰僶乕僕儑儞偱偼僼傽僀儖柤偑屌掕偱偡丅乯



3.4 僐儞僼傿僊儏儗乕僔儑儞僼傽僀儖偺彂偒曽

  僐儞僼傿僊儏儗乕僔儑儞僼傽僀儖("hos.cfg")偺彂偒曽傪愢柧偟傑偡丅

僼傽僀儖拞偵偼侾峴偵侾柦椷偺傒偍偔偙偲偑弌棃傑偡丅傑偨柦椷偼堦峴偵慡偰彂偄偰
偟傑偆昁梫偑偁傝傑偡丅
  棙梡偱偒傞柦椷傪埲壓偵婰偟傑偡丅

  INCLUDE_C     "cfg_c.c" 偱撉傒崬傓僼傽僀儖偺巜掕
  USE_TIMER     帪娫娗棟婡擻傪棙梡偡傞偙偲傪愰尵
  NOUSE_TIMER   帪娫娗棟婡擻傪棙梡偟側偄偙偲傪愰尵
  MAX_TSKPRI    嵟戝僞僗僋桪愭搙傪巜掕
  SYSTEM_STACK  僔僗僥儉梡偺僗僞僢僋億僀儞僞偺巜掕
  CRE_SPL       僗僞僢僋僾乕儖偺嶌惉
  CRE_TSK       僞僗僋偺搊榐
  CRE_TSKSP     僗僞僢僋僾乕儖傪巊偆僞僗僋偺搊榐
  CRE_SEM       僙儅僼僅偺搊榐
  CRE_FLG       僀儀儞僩僼儔僌偺搊榐
  CRE_MBX       儊僀儖儃僢僋僗偺搊榐
  CRE_MPF       屌掕挿儊儌儕僾乕儖偺搊榐
  DEF_INT       妱傝崬傒僴儞僪儔偺搊榐


  嬶懱揑側椺偼夝搥帪偵弌棃偨 sample 偲偄偆僨傿儗僋僩儕偵偁傝傑偡偺偱嶲徠偟偰
偔偩偝偄丅偙偙偱偼屄乆偺柦椷傪娙扨偵愢柧偟傑偡丅


INCLUDE_C  俠尵岅僼傽僀儖梡僀儞僋儖乕僪僼傽僀儖巜掕
  暥朄丗 INCLUDE_C("filename.h")

  "cfg_c.c" 偱僀儞僋儖乕僪偡傞僼傽僀儖傪巜掕偟傑偡丅"cfg_c.c" 偱偼僞僗僋
奐巒帪偺娭悢側偳偑棙梡偝傟傑偡偺偱丄偦傟傜傪愰尵偟偨僿僢僟僼傽僀儖偺僀儞
僋儖乕僪偑昁梫偱偡丅偙偺柦椷偵偰巜掕偟偰偔偩偝偄丅
  側偍丄<ITRON.h> 偼帺摦揑偵愭摢偵撉傒崬傑傟傑偡丅


USE_TIMER  僞僀儅棙梡
  暥朄丗 USE_TIMER (僨僼僅儖僩)

  帪娫娗棟婡擻傪巊偆偙偲傪愰尵偟傑偡丅偨偩偟幚嵺偵婡擻傪巊偆偵偼掕婜揑偵
__time_handler 傪屇傃弌偡傛偆偵偡傞昁梫偑偁傝傑偡丅
  帪娫娗棟梡偺僔僗僥儉僐乕儖傪屇傃弌偝側偗傟偽 USE_TIMER 傪巜掕偟偰傕栤戣偼
柍偄偺偱僨僼僅儖僩偲側偭偰偄傑偡丅


NOUSE_TIMER  僞僀儅枹巊梡
  暥朄丗 NOUSE_TIMER

  帪娫娗棟婡擻傪巊傢側偄偙偲傪愰尵偟傑偡丅帪娫娗棟梡偺儊儌儕傪妋曐偟側偔
側傝傑偡丅