Context Navigation

← Previous Change
Next Change →

prc_config.h

Timestamp:

Jun 2, 2015, 3:39:53 PM (9 years ago)

Author:

nmir-saito

Message:

ファイルの mime-type 変更

File:

: 1 edited

ssp_qb_r5f100le_cs/trunk/arch/rl78_ca78k0r/prc_config.h (modified) (17 diffs, 1 prop)

Legend:

: Unmodified
: Added
: Removed

ssp_qb_r5f100le_cs/trunk/arch/rl78_ca78k0r/prc_config.h

Property svn:mime-type set to text/plain; charset=shift_jis

-              r93
+              r95
  *             Nagoya Municipal Industrial Research Institute, JAPAN
+ *
+ *  ã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»ÌÜÜÌ`Å\[X
+ *      R[hÉÜÜêÄ¢é±ÆD
+ *  (2) {\tgEFAðCCu`®ÈÇC¼Ì\tgEFAJÉgp
+ *      Å«é`ÅÄzz·éêÉÍCÄzzÉº¤hL
+gipÒ}
+ *      j
+AÈÇjÉCãLÌì \¦C±Ìpð¨æÑºLÌ³Û
+ *      ØKèðfÚ·é±ÆD
+ *  (3) {\tgEFAðC@íÉgÝÞÈÇC¼Ì\tgEFAJÉgp
+ *      Å«È¢`ÅÄ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{\tgEFAÌp
  *  Éæè¼ÚIÜ½ÍÔÚIÉ¶¶½¢©Èé¹QÉÖµÄàC»ÌÓCð
  *  íÈ¢D
+ *  本ソフトウェアは，無保証で提供されているものである．上記著作権者およ
+ *  びTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的に対す
+ *  る適合性も含めて，いかなる保証も行わない．また，本ソフトウェアの利用
+ *  により直接的または間接的に生じたいかなる損害に関しても，その責任を負
+ *  わない．
+ *
  */
 /*
+ *              vZbTË¶W
+[iRL78j
+ *
+ *  ±ÌCN[ht@CÍC"<vZbT^Ô>_config.h" ÌÝ©ç
+ *  CN[h³êéD¼Ìt@C©ç¼ÚCN[hµÄÍÈçÈ¢D
+ *              プロセッサ依存モジュール（RL78）
+ *
+ *  このインクルードファイルは，"<プロセッサ型番>_config.h" のみから
+ *  インクルードされる．他のファイルから直接インクルードしてはならない．
  */
 …
 /*
  *  (1) ReLXgÉÖ·éè`
  */
 /* ¤LX^bNÌæÌ½ßÌX^bN|C^úlð¶¬·é}N */
+ *  (1) コンテキストに関する定義
+ */
+/* 共有スタック領域のためのスタックポインタ初期値を生成するマクロ */
 #define TOPPERS_ISTKPT(istk, istksz) ((STK_T *)((char *)(istk) + (istksz)))
 /*
  *  (2) VXeóÔÉÖ·éè`
  */
 /*
  *  CPUbNóÔÅÌÝDæx}XN(IPM)Ìl
  *    TIPM_LOCKÍCCPUbNóÔð\»·éÝDæx}XN(IPM)Ìlð¦·D
  *    J[lÇÌÝÉÎ·éÝDæxÌÅ¬l(TMIN_INTPRI)Éµ¢D
+ *  (2) システム状態に関する定義
+ */
+/*
+ *  CPUロック状態での割込み優先度マスク(IPM)の値
+ *    TIPM_LOCKは，CPUロック状態を表現する割込み優先度マスク(IPM)の値を示す．
+ *    カーネル管理の割込みに対する割込み優先度の最小値(TMIN_INTPRI)に等しい．
  */
 #ifndef TIPM_LOCK
 …
 /*
  *  ÝDæx}XN(IPM) ÆvZbTÌÝDæx}XN(ISP) ÌÏ·
+ *
  *  RL78 ÅÍCPSWWX^ÌºÊ©ç¦Ärbg1¨æÑ 2 Ì 2 rbgÉ
  *  CT[rXEvCIeBEtO(ISP) Ìlªi[³êéD
+ *
  *  J[lÌÇ·éIPM (-1©çA±µ½Ìl) ðgÁÄ
  *  vZbTÌ ISP ð§ä·é½ßÉÏ·ªKvÆÈéD
+ *
  *  wèµ½xÈºÌÝð}XN·éêÍCISPÌÝèlð
  *  ÚIÌxæèêÂ¢Dæx(lÆµÄÍ¬³¢)lÉ·éKvª éD
+ *  割込み優先度マスク(IPM) とプロセッサの割込み優先度マスク(ISP) の変換
+ *
+ *  RL78 では，PSWレジスタの下位から数えてビット1および 2 の 2 ビットに
+ *  インサービス・プライオリティ・フラグ(ISP) の値が格納される．
+ *
+ *  カーネルの管理するIPM (-1から連続した負の値) を使って
+ *  プロセッサの ISP を制御するために変換が必要となる．
+ *
+ *  指定したレベル以下の割込みをマスクする場合は，ISPの設定値を
+ *  目的のレベルより一つ高い優先度(値としては小さい)値にする必要がある．
  */
 #define IPM2ISP(ipm)    (((uint8_t)(4-1+(ipm))) << 1U)  /* IPM-->ISP(ipm=-3,-2,-1,0) */
 …
 /*
  *  ÝDæx}XNÌÁÊÈlÉÎ·éà\»
  */
 #define ISP_LOCK        (IPM2ISP(TIPM_LOCK))    /* CPUbNóÔÅÌ ISP */
 #define ISP_ENAALL      (IPM2ISP(TIPM_ENAALL))  /* TIPM_ENAALL ÅÌ ISP */
 /*
  *  (3) Ýf(ÝvC)
  */
 /*
  * intnoªCdis_int^ena_intÉÎ·éÝÔÆµÄ
  * LøÈlÅ éêÉtrueC»¤ÅÈ¢êÉfalseðÔ·}N
+ *  割込み優先度マスクの特別な値に対する内部表現
+ */
+#define ISP_LOCK        (IPM2ISP(TIPM_LOCK))    /* CPUロック状態での ISP */
+#define ISP_ENAALL      (IPM2ISP(TIPM_ENAALL))  /* TIPM_ENAALL での ISP */
+/*
+ *  (3) 割込み処理モデル(割込み要求ライン)
+ */
+/*
+ * intnoが，dis_int／ena_intに対する割込み番号として
+ * 有効な値である場合にtrue，そうでない場合にfalseを返すマクロ
  */
 #define VALID_INTNO_DISINT(intno)       VALID_INTNO(intno)
 …
 /*
  *  IPM ©çÝ§äWX^ÅÌ\»ÉÏ··é}N
+ *  IPM から割込み制御レジスタでの表現に変換するマクロ
  */
 #define IPM2ILVL(ipm)   ((ipm)+4)       // ipm=-1,-2,-3,-4
 …
 /*
  *  (4) Ýf(Ýnh)
  */
 /*
  *  ÝnhÌüûÌ¶¬}N
+ *  (4) 割込み処理モデル(割込みハンドラ)
+ */
+/*
+ *  割込みハンドラの入口処理の生成マクロ
  */
 #define _INT_ENTRY(inhno, inthdr)                               _kernel_##inthdr##_##inhno##_entry
 …
 /*
  *  (5) CPUáOf
  */
 /*
  *  CPUáOnhÌüûÌ¶¬}N
+ *  (5) CPU例外処理モデル
+ */
+/*
+ *  CPU例外ハンドラの入口処理の生成マクロ
  */
 #define _EXC_ENTRY(excno , exchdr)      _kernel_##exchdr##_##excno##_entry
 …
 /*
  *  (6) ú»EI¹
  */
 // è`Èµ
+ *  (6) 初期化・終了処理
+ */
+// 定義なし
 #ifndef TOPPERS_MACRO_ONLY
 /*
  *  (1) ReLXgÉÖ·éè`
  */
 /*
  *  ReLXgÌQÆ
+ *  (1) コンテキストに関する定義
+ */
+/*
+ *  コンテキストの参照
  */
 extern bool_t sense_context(void);
 /*
  *  (2) VXeóÔÉÖ·éè`
  */
 /*
  *  CPUbNtOÀ»Ì½ßÌÏ (prc_config.c)
  */
 extern bool_t   lock_flag;      /* CPUbNtOÌl */
 extern uint8_t  saved_psw;      /* CPUbNóÔÚsOÌÝDæxx */
 /*
  *  CPU bNóÔÖÌÚs
  *      ±ÌÖÍCCPU bNóÔÌÆ«ÉÄÑ¾³êÈ¢±ÆðOñÆ·éD
+ *  (2) システム状態に関する定義
+ */
+/*
+ *  CPUロックフラグ実現のための変数 (prc_config.c)
+ */
+extern bool_t   lock_flag;      /* CPUロックフラグの値 */
+extern uint8_t  saved_psw;      /* CPUロック状態移行前の割込み優先度レベル */
+/*
+ *  CPU ロック状態への移行
+ *      この関数は，CPU ロック状態のときに呼びだされないことを前提とする．
  */
 extern void t_lock_cpu(void);
 …
 /*
  *  CPUbNóÔÌð
  *      ±ÌÖÍCCPU bNóÔÌÆ«ÉÌÝÄÑ¾³êé±ÆðOñÆ·éD
+ *  CPUロック状態の解除
+ *      この関数は，CPU ロック状態のときにのみ呼びだされることを前提とする．
  */
 extern void t_unlock_cpu(void);
 …
 /*
  *  CPUbNóÔÌQÆ
+ *  CPUロック状態の参照
  */
 extern bool_t x_sense_lock(void);
 …
 /*
  *  ÝDæx}XN(IPM) ÌÝè
  *    wèµ½ÝDæx(-1, -2, ..., TMIN_INTPRI) ð³É
  *    vZbTÌÝDæxx (IPL) ðÝè·éD
+ *  割込み優先度マスク(IPM) の設定
+ *    指定した割込み優先度(-1, -2, ..., TMIN_INTPRI) を元に
+ *    プロセッサの割込み優先度レベル (IPL) を設定する．
  */
 extern void x_set_ipm(PRI intpri);
 …
 /*
  *  (3) Ýf(ÝvC)
  */
 /*
  *  ÝvöÌxè`e[u (kernel_cfg.c ÉæéoÍ)
  *    ÝÔ(INTNO) ©çÝDæxðæ¾·é½ßÉgpD
+ *  (3) 割込み処理モデル(割込み要求ライン)
+ */
+/*
+ *  割込み要因毎のレベル定義テーブル (kernel_cfg.c による出力)
+ *    割込み番号(INTNO) から割込み優先度を取得するために使用．
  */
 extern const PRI intpri_table[];
 /*
  *  ÝvÖ~tOÌZbg(prc_config.c)
  *    wèµ½ÝÔÉÎ·éÝvCÌÝvtOðZbg·éD
  *    Ý®«ªÝè³êÄ¢È¢ÝvCÌÝÔðwèµ½
  *    êÍCPÉ FALSE ðÔ·D
+ *  割込み要求禁止フラグのセット(prc_config.c)
+ *    指定した割込み番号に対応する割込み要求ラインの割込み要求フラグをセットする．
+ *    割込み属性が設定されていない割込み要求ラインの割込み番号を指定した
+ *    場合は，単に FALSE を返す．
  */
 extern bool_t x_disable_int(INTNO intno);
 …
 /*
  *  ÝvÖ~tOÌNA(prc_config.c)
  *    wèµ½ÝÔÉÎ·éÝvCÌÝvtOðNA·éD
  *    Ý®«ªÝè³êÄ¢È¢ÝvCÌÝÔðwèµ½
  *    êÍCPÉ FALSE ðÔ·D
+ *  割込み要求禁止フラグのクリア(prc_config.c)
+ *    指定した割込み番号に対応する割込み要求ラインの割込み要求フラグをクリアする．
+ *    割込み属性が設定されていない割込み要求ラインの割込み番号を指定した
+ *    場合は，単に FALSE を返す．
  */
 extern bool_t x_enable_int(INTNO intno);
 …
 /*
  *  ÝvÌNA(prc_config.c)
+ *  割込み要求のクリア(prc_config.c)
  */
 extern void x_clear_int(INTNO intno);
 …
 /*
  *  ÝvÌ`FbN(prc_config.c)
+ *  割込み要求のチェック(prc_config.c)
  */
 extern bool_t x_probe_int(INTNO intno);
 …
 /*
  *  ÝvCÌ®«ÌÝè (prc_config.c)
+ *  割込み要求ラインの属性の設定 (prc_config.c)
  */
 extern void     x_config_int(INTNO intno, ATR intatr, PRI intpri);
 /*
  *  (4) Ýf(Ýnh)
  */
 /*
  *  ÝnhÌÝè
+ *
  *  RL78ÍROMÉÝxN^ðzu·é½ßC{ÖÍóÉè`·éD
+ *  (4) 割込み処理モデル(割込みハンドラ)
+ */
+/*
+ *  割込みハンドラの設定
+ *
+ *  RL78はROMに割込みベクタを配置するため，本関数は空に定義する．
  */
 #define x_define_inh(inhno, inthdr)
 /*
  *  ÝnhÌüûÅKvÈ
  */
 #define i_begin_int(intno)              /* ÁÉs¤×«ÍÈ¢ */
 /*
  *  ÝnhÌoûÅKvÈ
  */
 #define i_end_int(intno)                /* ÁÉs¤×«ÍÈ¢ */
 /*
  *  (5) CPUáOf
  */
 /*
  *  CPUáOnhÌÝè
  *    RL78 Í ROM ÉxN^ðzu·é½ßC{ÖÍóÉè`·éD
+ *  割込みハンドラの入口で必要な処理
+ */
+#define i_begin_int(intno)              /* 特に行うべき処理はない */
+/*
+ *  割込みハンドラの出口で必要な処理
+ */
+#define i_end_int(intno)                /* 特に行うべき処理はない */
+/*
+ *  (5) CPU例外処理モデル
+ */
+/*
+ *  CPU例外ハンドラの設定
+ *    RL78 は ROM にベクタを配置するため，本関数は空に定義する．
  */
 #define x_define_exc(excno, exchdr)
 /*
  *  (6) ú»EI¹
  */
 /*
  *  vZbTË¶Ìú»(prc_config.c)
+ *  (6) 初期化・終了処理
+ */
+/*
+ *  プロセッサ依存の初期化(prc_config.c)
  */
 extern void     prc_initialize(void);
 /*
  *  dispatcher ÄÑoµOÉ^[QbgË¶ÅKvÈðs¤½ßÌÖ
+ *  dispatcher 呼び出し前にターゲット依存で必要な処理を行うための関数
  *    (prc_support.asm)
  */
 …
 /*
  *  J[lÌI¹ÌÄoµiprc_support.asmj
+ *
  *  call_exit_kernelÍCJ[lÌI¹ÉÄÑo³êCX^bN|C^ð
  *  ú»µCJ[lÌI¹iexit_kerneljðÄÑo·D
+ *  カーネルの終了処理の呼出し（prc_support.asm）
+ *
+ *  call_exit_kernelは，カーネルの終了時に呼び出され，スタックポインタを
+ *  初期化し，カーネルの終了処理（exit_kernel）を呼び出す．
  */
 extern void call_exit_kernel(void);
 /*
  *  vZbTË¶ÌI¹(prc_config.c)
+ *  プロセッサ依存の終了時処理(prc_config.c)
  */
 extern void     prc_terminate(void);
 /*
  *  (7) dispacher ÅÌÝÒ¿
+ *  (7) dispacher での割込み待ち
  */
 extern void idle_loop(void);

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

Context Navigation

Changeset 95 for ssp_qb_r5f100le_cs/trunk/arch/rl78_ca78k0r/prc_config.h

Legend:

ssp_qb_r5f100le_cs/trunk/arch/rl78_ca78k0r/prc_config.h

Download in other formats: