Context Navigation

← Previous Change
Next Change →

prc_config.h

Timestamp:

Mar 8, 2016, 8:37:45 PM (8 years ago)

Author:

coas-nagasima

Message:

MIMEにSJISを設定

File:

: 1 edited

UsbWattMeter/trunk/asp_dcre/arch/rx630_ccrx/prc_config.h (modified) (45 diffs, 1 prop)

Legend:

: Unmodified
: Added
: Removed

UsbWattMeter/trunk/asp_dcre/arch/rx630_ccrx/prc_config.h

Property svn:mime-type changed from text/x-chdr to text/x-chdr; charset=SHIFT_JIS

-              r164
+              r167
  *  Copyright (C) 2013      by Mitsuhiro Matsuura
+ *
+ *  ãLì ÒÍCÈºÌ(1)`(4)Ìðð½·êÉÀèC{\tgEF
+ *  Ai{\tgEFAðüÏµ½àÌðÜÞDÈº¯¶jðgpE¡»Eü
+ *  ÏEÄzziÈºCpÆÄÔj·é±Æð³Åø·éD
+ *  (1) {\tgEFAð\[XR[hÌ`Åp·éêÉÍCãLÌì
+ *       \¦C±Ìpð¨æÑºLÌ³ÛØKèªC»ÌÜÜÌ`Å\[
+ *      XR[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gip
+ *      Ò}j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºL
+ *      Ì³ÛØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉg
+ *      pÅ«È¢`ÅÄzz·éêÉÍCÌ¢¸ê©Ìðð½·±
+ *      ÆD
+ *    (a) ÄzzÉº¤hL
+gipÒ}j
+AÈÇjÉCãLÌ
+ *        ì \¦C±Ìpð¨æÑºLÌ³ÛØKèðfÚ·é±ÆD
+ *    (b) ÄzzÌ`ÔðCÊÉèßéû@ÉæÁÄCTOPPERSvWFNgÉ
+ *        ñ·é±ÆD
+ *  (4) {\tgEFAÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶é¢©Èé¹
+ *      Q©çàCãLì Ò¨æÑTOPPERSvWFNgðÆÓ·é±ÆD
+ *      Ü½C{\tgEFAÌ[UÜ½ÍGh[U©çÌ¢©Èé
+ *      RÉîÃ¿©çàCãLì Ò¨æÑTOPPERSvWFNgð
+ *      ÆÓ·é±ÆD
+ *  上記著作権者は，以下の(1)〜(4)の条件を満たす場合に限り，本ソフトウェ
+ *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
+ *  変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
+ *  (1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
+ *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
+ *      スコード中に含まれていること．
+ *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
+ *      用できる形で再配布する場合には，再配布に伴うドキュメント（利用
+ *      者マニュアルなど）に，上記の著作権表示，この利用条件および下記
+ *      の無保証規定を掲載すること．
+ *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
+ *      用できない形で再配布する場合には，次のいずれかの条件を満たすこ
+ *      と．
+ *    (a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
+ *        作権表示，この利用条件および下記の無保証規定を掲載すること．
+ *    (b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
+ *        報告すること．
+ *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
+ *      害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
+ *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
+ *      由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
+ *      免責すること．
+ *
  *  {\tgEFAÍC³ÛØÅñ³êÄ¢éàÌÅ éDãLì Ò¨
  *  æÑTOPPERSvWFNgÍC{\tgEFAÉÖµÄCÁèÌgpÚI
  *  ÉÎ·éK«àÜßÄC¢©ÈéÛØàsíÈ¢DÜ½C{\tgEF
  *  AÌpÉæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»
  *  ÌÓCðíÈ¢D
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者お
+ *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
+ *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
+ *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
+ *  の責任を負わない．
+ *
  *  @(#) $Id$
 …
 /*
+ *              vZbTË¶W
+[iRX630pj
+ *
+ *  ±ÌCN[ht@CÍCtarget_config.hiÜ½ÍC»±©çCN
+ *  [h³êét@CjÌÝ©çCN[h³êéD¼Ìt@C©ç
+ *  ¼ÚCN[hµÄÍÈçÈ¢D
+ *              プロセッサ依存モジュール（RX630用）
+ *
+ *  このインクルードファイルは，target_config.h（または，そこからインク
+ *  ルードされるファイル）のみからインクルードされる．他のファイルから
+ *  直接インクルードしてはならない．
  */
 …
 /*
  *  vZbTÌÁê½ßÌCCÖè`
+ *  プロセッサの特殊命令のインライン関数定義
  */
 #include "prc_insn.h"
 …
 /*
  *  ñ^XNReLXgpÌX^bNúl
+ *  非タスクコンテキスト用のスタック初期値
  */
 …
 /*
  *  ^XNReLXgubNÌè`
+ *  タスクコンテキストブロックの定義
  */
 typedef struct task_context_block {
         void    *sp;            /* X^bN|C^ */
         FP              pc;                     /* vOJE^ */
+        void    *sp;            /* スタックポインタ */
+        FP              pc;                     /* プログラムカウンタ */
 } TSKCTXB;
 /*
  *  Ý¶ñðÛ¶·éÏ
+ *  割込み発生回数を保存する変数
  */
 extern uint16_t intnest;
 …
 /*
  *  CPUbNóÔÅÌÝDæx}XN
+ *
  *  TIPM_LOCKÍCCPUbNóÔÅÌÝDæx}XNC·Èí¿CJ[l
  *  ÇOÌàÌð·×ÄÌÝvð}XN·élÉè`·éD
+ *
  *  TMIN_INTPRIÏX·é±ÆÅÇOÝÌL³ðè·éD
  *  á¦ÎTMIN_INTPRIð-14ÉÝè·éÆCx15ÌÝªJ[lÇOÆ
  *  ÈéDTMIN_INTPRIð-15ÉÝè·éÆCNMIÈOÉJ[lÇOÌÝð
  *  Ý¯È¢±ÆÉÈéi±ÌêÉÍ-15ÉÝè·é±Æð§·éjD
+ *  CPUロック状態での割込み優先度マスク
+ *
+ *  TIPM_LOCKは，CPUロック状態での割込み優先度マスク，すなわち，カーネ
+ *  ル管理外のものを除くすべての割込み要求をマスクする値に定義する．
+ *
+ *  TMIN_INTPRI変更することで管理外割込みの有無を決定する．
+ *  例えばTMIN_INTPRIを-14に設定すると，レベル15の割込みがカーネル管理外と
+ *  なる．TMIN_INTPRIを-15に設定すると，NMI以外にカーネル管理外の割込みを
+ *  設けないことになる（この場合には-15に設定することを推奨する）．
  */
 #ifndef TIPM_LOCK
 …
 /*
  *  TOPPERSWÝfÌÀ»
  */
 /*
  *  ReLXgÌQÆ
+ *
  *  RXÅÍCÝÌßèæª^XN©Ç¤©ð»f·é½ßÉ intnest
  *  ðgpµÄ¢éD±êðp¢ÄReLXgð»f·éD
+ *  TOPPERS標準割込み処理モデルの実現
+ */
+/*
+ *  コンテキストの参照
+ *
+ *  RXでは，割込みの戻り先がタスクかどうかを判断するために intnest
+ *  を使用している．これを用いてコンテキストを判断する．
  */
 Inline bool_t
 sense_context( void )
+{
         /*  lXgJE^0æèåÈçñ^XNReLXg  */
+        /*  ネストカウンタ0より大なら非タスクコンテキスト  */
         return ( intnest > 0U );
+}
 …
 /*
  *  CPUbNtOÀ»Ì½ßÌÏ
+ *
  *  ±êçÌÏÍCCPUbNóÔÌÌÝ«·¦Äæ¢àÌÆ·éD
+ *  CPUロックフラグ実現のための変数
+ *
+ *  これらの変数は，CPUロック状態の時のみ書き換えてよいものとする．
  */
 #if TIPM_LOCK != -15
 extern bool_t   lock_flag;              /* CPUbNtOÌlðÛ·éÏ */
 extern uint32_t saved_ipl;              /* ÝDæxxðÛ¶·éÏ */
+extern bool_t   lock_flag;              /* CPUロックフラグの値を保持する変数 */
+extern uint32_t saved_ipl;              /* 割込み優先度レベルを保存する変数 */
 #endif  /* TIPM_LOCK != -15     */
 …
 /*
  *  ÝDæx}XNÌO\»Æà\»ÌÏ·
+ *
  *  RX630ÅÍCvZbTXe[^X[hWX^iPSWjÌº©ç
  *  24`27rbgÚÌ4rbgÉÝDæxxiIPLjªu©êÄ¢éD
  *  J[lÇOÝðÀ·éêÉIPLðgpµ½§äðs¤D
  *  J[lÍÝDæx}XNi-1©çA±µ½ÌljÅÇ³êÄ
  *  ¢é½ßIPLÆÌÏ·ªKvÆÈéD
  */
 #define IPL_TO_IPM( ipl )       (-(( PRI )(( ipl ) >> 24U )))           /* IPLðIPMÉ   */
 #define IPM_TO_IPL( ipm )       ((( uint32_t )(-( ipm ))) << 24U )      /* IPMðIPLÉ   */
 /*
  *  CPUbNóÔÅÌÝDæx}XNÌIPL
+ *  割込み優先度マスクの外部表現と内部表現の変換
+ *
+ *  RX630では，プロセッサステータスワードレジスタ（PSW）の下から
+ *  24〜27ビット目の4ビットに割込み優先度レベル（IPL）が置かれている．
+ *  カーネル管理外割込みを実装する場合にIPLを使用した制御を行う．
+ *  カーネルは割込み優先度マスク（-1から連続した負の値）で管理されて
+ *  いるためIPLとの変換が必要となる．
+ */
+#define IPL_TO_IPM( ipl )       (-(( PRI )(( ipl ) >> 24U )))           /* IPLをIPMに     */
+#define IPM_TO_IPL( ipm )       ((( uint32_t )(-( ipm ))) << 24U )      /* IPMをIPLに     */
+/*
+ *  CPUロック状態での割込み優先度マスクのIPL
  */
 #define IPL_LOCK                ( IPM_TO_IPL( TIPM_LOCK ) )
 /*
  *  TIPM_ENAALLiÝDæx}XNSðjÌIPL
+ *  TIPM_ENAALL（割込み優先度マスク全解除）のIPL
  */
 #define IPL_ENAALL              ( IPM_TO_IPL( TIPM_ENAALL ) )
 …
 /*
  *  ÝvöÌx & ®«è`e[u
  *  (ev[gt@CÉæéoÍ)
+ *  割込み要因毎のレベル & 属性定義テーブル
+ *  (テンプレートファイルによる出力)
  */
 typedef struct cfg_int_info {
 …
 /*
+ *  ÝÔÌÍÍÌ»è
+ *
+ *  ÝÔªLøÈl©µ§É`FbN·é½ß,
+ *  RtBM
+[^oÍe[uðQÆ·é.
+ *  割込み番号の範囲の判定
+ *
+ *  割込み番号が有効な値か厳密にチェックするため,
+ *  コンフィギュレータ出力テーブルを参照する.
  */
 #define VALID_INTNO( intno )    \
 …
 #define VALID_INTNO_CFGINT( intno )     VALID_INTNO( intno )
 /* cre_intÅLøÈÝÔÌwè  */
+/* cre_intで有効な割込み番号の指定  */
 #define VALID_INTNO_CREINT          VALID_INTNO_CFGINT((intno))
 /* cre_isrÅLøÈÝÔÌwè  */
+/* cre_isrで有効な割込み番号の指定  */
 #define VALID_INTNO_CREISR(intno)       VALID_INTNO_CFGINT((intno))
 /*
  *  Ý§äWX^ÖAÌè`
+ *  割込み制御レジスタ関連の定義
  */
 #define IRQ_POSEDGE                     ( 0x08U )
 …
 /*
  *  CPUbNóÔÖÌÚs
+ *
  *  IPMin[hEFAÌÝDæx}XNjðCsaved_iipmÉÛ¶µCJ[
  *  lÇOÌàÌð·×ÄÌÝvð}XN·éliTIPM_LOCKj
  *  ÉÝè·éDÜ½Clock_flagðTRUEÉ·éD
+ *
  *  IPMªCÅ©çTIPM_LOCKÆ¯¶©»êæè¢êÉÍC»êð
  *  saved_iipmÉÛ¶·éÌÝÅCTIPM_LOCKÉÍÝèµÈ¢D±êÍCf
  *  ãÌÝDæx}XNªCTIPM_LOCKÆ¯¶©»êæè¢xÉÝè
  *  ³êÄ¢éóÔÉ ½éD
+ *
  *  ±ÌÖÍCCPUbNóÔilock_flagªTRUEÌóÔjÅÄÎêé±ÆÍ
  *  È¢àÌÆzèµÄ¢éD
+ *  CPUロック状態への移行
+ *
+ *  IPM（ハードウェアの割込み優先度マスク）を，saved_iipmに保存し，カー
+ *  ネル管理外のものを除くすべての割込み要求をマスクする値（TIPM_LOCK）
+ *  に設定する．また，lock_flagをTRUEにする．
+ *
+ *  IPMが，最初からTIPM_LOCKと同じかそれより高い場合には，それを
+ *  saved_iipmに保存するのみで，TIPM_LOCKには設定しない．これは，モデル
+ *  上の割込み優先度マスクが，TIPM_LOCKと同じかそれより高いレベルに設定
+ *  されている状態にあたる．
+ *
+ *  この関数は，CPUロック状態（lock_flagがTRUEの状態）で呼ばれることは
+ *  ないものと想定している．
  */
 Inline void
 …
         /*
          *  current_ipl()ÌÔèlð¼Úsaved_iplÉÛ¶¹¸CêÏipl
          *  ðp¢Ä¢éÌÍCcurrent_ipl()ðÄñ¾¼ãÉÝª¶µC
          *  N®³ê½ÝÅsaved_iplªÏX³êéÂ\«ª é½ßÅ
          *   éD
+         *  current_ipl()の返り値を直接saved_iplに保存せず，一時変数ipl
+         *  を用いているのは，current_ipl()を呼んだ直後に割込みが発生し，
+         *  起動された割込み処理でsaved_iplが変更される可能性があるためで
+         *  ある．
          */
         ipl = current_ipl();
 …
 /*
  *  CPUbNóÔÌð
+ *
  *  lock_flagðFALSEÉµCIPMin[hEFAÌÝDæx}XNjðC
  *  saved_iipmÉÛ¶µ½lÉß·D
+ *
  *  ±ÌÖÍCCPUbNóÔilock_flagªtrueÌóÔjÅÌÝÄÎêéà
  *  ÌÆzèµÄ¢éD
+ *  CPUロック状態の解除
+ *
+ *  lock_flagをFALSEにし，IPM（ハードウェアの割込み優先度マスク）を，
+ *  saved_iipmに保存した値に戻す．
+ *
+ *  この関数は，CPUロック状態（lock_flagがtrueの状態）でのみ呼ばれるも
+ *  のと想定している．
  */
 Inline void
 …
 /*
  *  CPUbNóÔÌQÆ
+ *  CPUロック状態の参照
  */
 Inline bool_t
 …
 /*
  * ifãÌjÝDæx}XNÌÝè
+ *
  *  CPUbNtOªNA³êÄ¢éÍCn[hEFAÌÝDæx}
  *  XNðÝè·éDCPUbNtOªZbg³êÄ¢éÍCsaved_iipm
  *  ðÝèµC³çÉCn[hEFAÌÝDæx}XNðCÝèµæ¤Æ
  *  µ½ifãÌjÝDæx}XNÆTIPM_LOCKÌ¢ûÉÝè·éD
+ * （モデル上の）割込み優先度マスクの設定
+ *
+ *  CPUロックフラグがクリアされている時は，ハードウェアの割込み優先度マ
+ *  スクを設定する．CPUロックフラグがセットされている時は，saved_iipm
+ *  を設定し，さらに，ハードウェアの割込み優先度マスクを，設定しようと
+ *  した（モデル上の）割込み優先度マスクとTIPM_LOCKの高い方に設定する．
  */
 Inline void
 …
 /*
  * ifãÌjÝDæx}XNÌQÆ
+ *
  *  CPUbNtOªNA³êÄ¢éÍn[hEFAÌÝDæx}
  *  XNðCZbg³êÄ¢éÍsaved_iipmðQÆ·éD
+ * （モデル上の）割込み優先度マスクの参照
+ *
+ *  CPUロックフラグがクリアされている時はハードウェアの割込み優先度マ
+ *  スクを，セットされている時はsaved_iipmを参照する．
  */
 Inline PRI
 …
 /*
  *  ÝvÖ~tOÌZbg
+ *
  *  Ý®«ªÝè³êÄ¢È¢ÝvCÉÎµÄÝvÖ~
  *  tOðZbgµæ¤Æµ½êÉÍCFALSEðÔ·D
+ *  割込み要求禁止フラグのセット
+ *
+ *  割込み属性が設定されていない割込み要求ラインに対して割込み要求禁止
+ *  フラグをセットしようとした場合には，FALSEを返す．
  */
 Inline bool_t
 …
+{
         /*
          *  xè`ª0Å éêÍCFG_INT³êÄ¢È¢
+         *  レベル定義が0である場合はCFG_INTされていない
          */
         if( cfg_int_table[intno].intpri == 0 ){
 …
 /*
  *  ÝvÖ~tOÌNA
+ *
  *  Ý®«ªÝè³êÄ¢È¢ÝvCÉÎµÄÝvÖ~
  *  tOðNAµæ¤Æµ½êÉÍCFALSEðÔ·D
+ *  割込み要求禁止フラグのクリア
+ *
+ *  割込み属性が設定されていない割込み要求ラインに対して割込み要求禁止
+ *  フラグをクリアしようとした場合には，FALSEを返す．
  */
 Inline bool_t
 …
+{
         /*
          *  xè`ª0Å éêÍCFG_INT³êÄ¢È¢
+         *  レベル定義が0である場合はCFG_INTされていない
          */
         if( cfg_int_table[intno].intpri == 0 ){
 …
 /*
  *  ÝvÌNA
+ *  割込み要求のクリア
  */
 Inline void
 …
 /*
  *  ÝvÌ`FbN
+ *  割込み要求のチェック
  */
 Inline bool_t
 …
+{
         /*
          *  ÝvWX^Í0 or 1Åµ©È¢½ß,
          *  »ÌÜÜÌlðÔ·.
+         *  割込み要求レジスタは0 or 1でしかないため,
+         *  そのままの値を返す.
          */
         return ( *IR_REG(intno) );
 …
 /*
  *  ÝvCÌ®«ÌÝè
+ *  割込み要求ラインの属性の設定
  */
 extern void     x_config_int( INTNO intno, ATR intatr, PRI intpri );
 …
 /*
  *  ÝnhÌüûÅKvÈIRCì
+ *  割込みハンドラの入口で必要なIRC操作
+ *
  */
 …
         /*
          *  xoÌÝÉÎµÄÍÝXe[^X
          *  tOðNA·é.
+         *  レベル検出の割込みに対しては割込みステータス
+         *  フラグをクリアする.
          */
         if( ( cfg_int_table[intno].intatr & TA_LOWLEVEL ) > 0 ){
                 if( *IR_REG(intno) > 0U ){
                         /*
                          *  OÝÌê, IRQ[qªHighÉßÁÄ¢é
                          *  ±ÆðmF·é|ªLÚ³êÄ¢éª, Èª·é.
+                         *  外部割込みの場合, IRQ端子がHighに戻っている
+                         *  ことを確認する旨が記載されているが, 省略する.
                          */
                 //      *ir_reg_addr[intno] = 0U;
                         /*
+                         *  n[hEFA}j
+AÉ0ÉÈÁ½±Æð
+                         *  mF·é|ªLÚ é½ß, WX^lðÇÝo·.
+                         *  ハードウェアマニュアルに0になったことを
+                         *  確認する旨が記載あるため, レジスタ値を読み出す.
                          */
                 //      reg = *ir_reg_addr[intno];
 …
 /*
  *  ÝnhÌoûÅKvÈIRCì
+ *  割込みハンドラの出口で必要なIRC操作
+ *
  */
 …
 i_end_int( INTNO intno )
+{
         /* ÁÉs¤×«ÍÈ¢ */
+}
 /*
  *  ÅDæÊ^XNÖÌfBXpb`iprc_support.a30j
+ *
  *  dispatchÍC^XNReLXg©çÄÑo³ê½T[rXR[©
  *  çÄÑo·×«àÌÅC^XNReLXgECPUbNóÔEfBXpb
  *  `ÂóÔEifãÌjÝDæx}XNSðóÔÅÄÑo³È
  *  ¯êÎÈçÈ¢D
+        /* 特に行うべき処理はない */
+}
+/*
+ *  最高優先順位タスクへのディスパッチ（prc_support.a30）
+ *
+ *  dispatchは，タスクコンテキストから呼び出されたサービスコール処理か
+ *  ら呼び出すべきもので，タスクコンテキスト・CPUロック状態・ディスパッ
+ *  チ許可状態・（モデル上の）割込み優先度マスク全解除状態で呼び出さな
+ *  ければならない．
  */
 extern void     dispatch( void );
 /*
  *  fBXpb`Ì®ìJniprc_support.a30j
+ *
  *  start_dispatchÍCJ[lN®ÉÄÑo·×«àÌÅC·×ÄÌ
  *  ÝðÖ~µ½óÔiSÝbNóÔÆ¯ÌóÔjÅÄÑo³È¯êÎ
  *  ÈçÈ¢D
+ *  ディスパッチャの動作開始（prc_support.a30）
+ *
+ *  start_dispatchは，カーネル起動時に呼び出すべきもので，すべての割込
+ *  みを禁止した状態（全割込みロック状態と同等の状態）で呼び出さなければ
+ *  ならない．
  */
 extern void     start_dispatch( void ) NoReturn;
 /*
  *  »ÝÌReLXgðÌÄÄfBXpb`iprc_support.a30j
+ *
  *  exit_and_dispatchÍCext_tsk©çÄÑo·×«àÌÅC^XNReL
  *  XgECPUbNóÔEfBXpb`ÂóÔEifãÌjÝDæ
  *  x}XNSðóÔÅÄÑo³È¯êÎÈçÈ¢D
+ *  現在のコンテキストを捨ててディスパッチ（prc_support.a30）
+ *
+ *  exit_and_dispatchは，ext_tskから呼び出すべきもので，タスクコンテキ
+ *  スト・CPUロック状態・ディスパッチ許可状態・（モデル上の）割込み優先
+ *  度マスク全解除状態で呼び出さなければならない．
  */
 #define _kernel_exit_and_dispatch();    \
 …
 /*
  *  J[lÌI¹ÌÄoµiprc_support.a30j
+ *
  *  call_exit_kernelÍCJ[lÌI¹ÉÄÑo·×«àÌÅCñ^XN
  *  ReLXgÉØè·¦ÄCJ[lÌI¹iexit_kerneljðÄÑo
  *  ·D
+ *  カーネルの終了処理の呼出し（prc_support.a30）
+ *
+ *  call_exit_kernelは，カーネルの終了時に呼び出すべきもので，非タスク
+ *  コンテキストに切り換えて，カーネルの終了処理（exit_kernel）を呼び出
+ *  す．
  */
 extern void call_exit_kernel( void ) NoReturn;
 /*
  *  ^XNReLXgÌú»
+ *
  *  ^XNªx~óÔ©çÀsÅ«éóÔÉÚs·éÉÄÎêéD±Ì_
  *  ÅX^bNÌæðgÁÄÍÈçÈ¢D
+ *
  *  activate_contextðCCCÖÅÍÈ}Nè`ÆµÄ¢éÌÍC
  *  ±Ì_ÅÍTCBªè`³êÄ¢È¢½ßÅ éD
+ *  タスクコンテキストの初期化
+ *
+ *  タスクが休止状態から実行できる状態に移行する時に呼ばれる．この時点
+ *  でスタック領域を使ってはならない．
+ *
+ *  activate_contextを，インライン関数ではなくマクロ定義としているのは，
+ *  この時点ではTCBが定義されていないためである．
  */
 extern void     start_r( void );
 …
         {                                                                                                                                                                       \
+                                                                                                                                                                                \
                 /*  X^bN|C^úlÌÝè  */                                                                                    \
+                /*  スタックポインタ初期値の設定  */                                                                                  \
                 ( p_tcb )->tskctxb.sp = ( void * )((( uint32_t ) ( p_tcb )->p_tinib->stk ) +    \
                                                                 ( p_tcb )->p_tinib->stksz );                                                    \
                 /* N®ÔnÌÝè */                                                                                                                    \
+                /* 起動番地の設定 */                                                                                                                   \
                 ( p_tcb )->tskctxb.pc = ( FP ) start_r;                                                                                 \
         }                                                                                                                                                                       \
 …
 /*
  *  calltexÍgpµÈ¢
+ *  calltexは使用しない
  */
 #define OMIT_CALLTEX
 …
 /*
  *  ÝnhÌÝè
+ *
  *  RX630ÍROMÉÝxN^ðzu·é½ßC{ÖÍóÖÅÀ·éD
+ *  割込みハンドラの設定
+ *
+ *  RX630はROMに割込みベクタを配置するため，本関数は空関数で実装する．
  */
 Inline void
 …
 /*
  *  CPUáOnhÌÝè
+ *
  *  RX630ÍROMÉáOxN^ðzu·é½ßC{ÖÍóÖÅÀ·éD
+ *  CPU例外ハンドラの設定
+ *
+ *  RX630はROMに例外ベクタを配置するため，本関数は空関数で実装する．
  */
 Inline void
 …
 /*
  *  Ý/áOnhÌüûÌ¶¬}N
+ *
  *  ev[gt@CÉæè¶¬·é½ßó}NÆ·éD
+ *  割込み/例外ハンドラの入口処理の生成マクロ
+ *
+ *  テンプレートファイルにより生成するため空マクロとする．
  */
 #define HDR_ENTRY(hdr, intexc_num , tobejmp)
 /*
  *  ÝnhÌüûÌ¶¬}N
+ *  割込みハンドラの入口処理の生成マクロ
  */
 #define _INT_ENTRY(inhno, inthdr)                               _kernel_##inthdr##_##inhno##_entry
 …
 /*
  *  CPUáOnhÌüûÌ¶¬}N
+ *  CPU例外ハンドラの入口処理の生成マクロ
  */
 #define _EXC_ENTRY(excno , exchdr)                                      _kernel_##exchdr##_##excno##_entry
 …
 /*
  *  CPUáOÌ¶µ½ÌReLXgÌQÆ
+ *
  *  CPUáOÌ¶µ½ÌReLXgªC^XNReLXgÌÉFALSEC
  *  »¤ÅÈ¢ÉtrueðÔ·D
+ *  CPU例外の発生した時のコンテキストの参照
+ *
+ *  CPU例外の発生した時のコンテキストが，タスクコンテキストの時にFALSE，
+ *  そうでない時にtrueを返す．
  */
 Inline bool_t
 …
+{
         /*
          *  lXgJE^ª1æèåÈçñ^XNReLXg
+         *  ネストカウンタが1より大なら非タスクコンテキスト
          */
         return( intnest > 1U );
 …
 /*
  *  CPUáOîñ p_excinf ©ç PSW Ìlðæ¾·é½ßÌItZbgl
  *  EXCNO + ACC + FPSW + R1`R15 + PC
+ *  CPU例外情報 p_excinf から PSW の値を取得するためのオフセット値
+ *  EXCNO + ACC + FPSW + R1〜R15 + PC
  */
 #define EXC_GET_PSW_OFFSET      (4+8+4+60+4)
 /*
  *  CPUáOÌ¶µ½ÌIPLÌQÆ
+ *  CPU例外の発生した時のIPLの参照
  */
 Inline uint32_t
 …
 /*
  *  CPUáOÌ¶µ½ÌReLXgÆÝÌ}XNóÔÌQÆ
+ *
  *  CPUáOÌ¶µ½ÌVXeóÔªCJ[lÀsÅÈC^XNR
  *  eLXgÅ èCSÝbNóÔÅÈCCPUbNóÔÅÈCi
  *  fãÌjÝDæx}XNSðóÔÅ éÉtrueC»¤ÅÈ¢
  *  ÉFALSEðÔ·iCPUáOªJ[lÇOÌÝÅ¶µ½ê
  *  ÉàFALSEðÔ·jD
+ *  CPU例外の発生した時のコンテキストと割込みのマスク状態の参照
+ *
+ *  CPU例外の発生した時のシステム状態が，カーネル実行中でなく，タスクコ
+ *  ンテキストであり，全割込みロック状態でなく，CPUロック状態でなく，（モ
+ *  デル上の）割込み優先度マスク全解除状態である時にtrue，そうでない時
+ *  にFALSEを返す（CPU例外がカーネル管理外の割込み処理中で発生した場合
+ *  にもFALSEを返す）．
+ *
  *  J[lÀsÅÈ¢¨ (TIPM_LOCK== -15) ItO == 1
+ *  カーネル実行中でない→ (TIPM_LOCK== -15) Iフラグ == 1
  *                         (else)           IPL < IPL_LOCK
  *  ^XNReLXgÅ é¨intnest == 0
  *  SÝbNÅÈ¢¨ ItO == 1
  *  ÝDæx}XNªSð¨IPL == 0
+ *  タスクコンテキストである→intnest == 0
+ *  全割込みロックでない→ Iフラグ == 1
+ *  割込み優先度マスクが全解除→IPL == 0
+ *
+ *
 …
 /*
  *  CPUáOÌ¶µ½ÌReLXgÆÝ^CPUbNóÔÌQÆ
+ *
  *  CPUáOÌ¶µ½ÌVXeóÔªCJ[lÀsÅÈC^XNR
  *  eLXgÅ èCSÝbNóÔÅÈCCPUbNóÔÅÈ¢É
  *  trueC»¤ÅÈ¢ÉfalseðÔ·iCPUáOªJ[lÇOÌÝ
  *  Å¶µ½êÉàfalseðÔ·jD
+ *  CPU例外の発生した時のコンテキストと割込み／CPUロック状態の参照
+ *
+ *  CPU例外の発生した時のシステム状態が，カーネル実行中でなく，タスクコ
+ *  ンテキストであり，全割込みロック状態でなく，CPUロック状態でない時に
+ *  true，そうでない時にfalseを返す（CPU例外がカーネル管理外の割込み処
+ *  理中で発生した場合にもfalseを返す）．
+ *
  *  J[lÀsÅÈ¢¨ (TIPM_LOCK== -15) ItO == 1
+ *  カーネル実行中でない→ (TIPM_LOCK== -15) Iフラグ == 1
  *                         (else)           IPL < TIPM_LOCK
  *  ^XNReLXgÅ é¨intnest < 1
  *  SÝbNÅÈ¢¨ ItO == 1
  *  CPUbNóÔÅÈ¢¨(TIPM_LOCK== -15) ItO == 1
+ *  タスクコンテキストである→intnest < 1
+ *  全割込みロックでない→ Iフラグ == 1
+ *  CPUロック状態でない→(TIPM_LOCK== -15) Iフラグ == 1
  *                         (else)           IPL < TIPM_LOCK
  */
 …
 /*
  *  vZbTË¶Ìú»
+ *  プロセッサ依存の初期化
  */
 extern void     prc_initialize( void );
 /*
  *  vZbTË¶ÌI¹
+ *  プロセッサ依存の終了時処理
  */
 extern void     prc_terminate( void );
 …
 #ifndef OMIT_DEFAULT_INT_HANDLER
 /*
  *  ¢o^ÌÝª¶µ½êÉÄÑo³êé
+ *  未登録の割込みが発生した場合に呼び出される
  */
 void default_int_handler( void );
 …
 #ifndef OMIT_DEFAULT_EXC_HANDLER
 /*
  *  ¢o^ÌáOª¶µ½êÉÄÑo³êé
+ *  未登録の例外が発生した場合に呼び出される
  */
 void default_exc_handler( void );

Note: See TracChangeset for help on using the changeset viewer.

Context Navigation

Changeset 167 for UsbWattMeter/trunk/asp_dcre/arch/rx630_ccrx/prc_config.h

Legend:

UsbWattMeter/trunk/asp_dcre/arch/rx630_ccrx/prc_config.h

Download in other formats: