config.txt

嵌入式系统开发 TOPPERS and JSP Kernel Release 1.3 TOPPERS = Toyohashi Open Platform for Embedded Real-Tim

	♂ JSPカ〖ネル タ〖ゲット巴赂婶 インタフェ〖ス慌屯 ♂

             ∈Release 1.3滦炳·呵姜构糠: 10-Apr-2002∷

------------------------------------------------------------------------ 
 TOPPERS/JSP Kernel
     Toyohashi Open Platform for Embedded Real-Time Systems/
     Just Standard Profile Kernel

 Copyright (C) 2000-2002 by Embedded and Real-Time Systems Laboratory
                             Toyohashi Univ. of Technology, JAPAN

 惧淡螟侯涪荚は·Free Software Foundation によって给山されている 
 GNU General Public License の Version 2 に淡揭されている掘凤か·笆
 布の(1)×(4)の掘凤を塔たす眷圭に嘎り·塑ソフトウェア∈塑ソフトウェ
 アを猖恃したものを崔むˉ笆布票じ∷を蝗脱ˇ剩澜ˇ猖恃ˇ浩芹邵∈笆布·
 网脱と钙ぶ∷することを痰浸で钓满するˉ
 (1) 塑ソフトウェアをソ〖スコ〖ドの妨で网脱する眷圭には·惧淡の螟侯
     涪山绩·この网脱掘凤および布淡の痰瘦沮惮年が·そのままの妨でソ〖
     スコ〖ド面に崔まれていることˉ
 (2) 塑ソフトウェアを浩网脱材墙なバイナリコ〖ド∈リロケ〖タブルオブ
     ジェクトファイルやライブラリなど∷の妨で网脱する眷圭には·网脱
     に燃うドキュメント∈网脱荚マニュアルなど∷に·惧淡の螟侯涪山绩·
     この网脱掘凤および布淡の痰瘦沮惮年を非很することˉ
 (3) 塑ソフトウェアを浩网脱稍材墙なバイナリコ〖ドの妨または怠达に寥
     み哈んだ妨で网脱する眷圭には·肌のいずれかの掘凤を塔たすことˉ
   (a) 网脱に燃うドキュメント∈网脱荚マニュアルなど∷に·惧淡の螟侯
       涪山绩·この网脱掘凤および布淡の痰瘦沮惮年を非很することˉ
   (b) 网脱の妨轮を·侍に年める数恕によって·惧淡螟侯涪荚に鼠桂する
       ことˉ
 (4) 塑ソフトウェアの网脱により木儡弄または粗儡弄に栏じるいかなる禄
     巢からも·惧淡螟侯涪荚を倘勒することˉ

 塑ソフトウェアは·痰瘦沮で捏丁されているものであるˉ惧淡螟侯涪荚は·
 塑ソフトウェアに簇して·その努脱材墙拉も崔めて·いかなる瘦沮も乖わ
 ないˉまた·塑ソフトウェアの网脱により木儡弄または粗儡弄に栏じたい
 かなる禄巢に簇しても·その勒扦を砷わないˉ

 @(#) $Id: config.txt,v 1.14 2002/04/14 15:27:12 hiro Exp $
------------------------------------------------------------------------


このドキュメントでは·JSPカ〖ネルのタ〖ゲット巴赂婶で捏丁すべきデ〖タ
房や簇眶などについて豺棱するˉ

JSPカ〖ネルのタ〖ゲット巴赂婶は·巴赂婶の浩网脱拉を雇胃し·タ〖ゲット
プロセッサ巴赂婶とタ〖ゲットシステム巴赂婶に尸违してあるˉプロセッサ巴
赂婶とシステム巴赂婶の粗には汤澄な舔充尸么はないˉそのため笆布のデ〖タ
房や簇眶などは·プロセッサ巴赂婶とシステム巴赂婶のどちらで年盗してもか
まわないˉシミュレ〖ション茨董などの端眉なケ〖スでは·すべてをプロセッ
サ巴赂婶で年盗してもよいˉ


１ˉシステム菇蜜茨董

(1) タ〖ゲット巴赂婶のファイルを弥くためのディレクトリ

糠しいタ〖ゲット巴赂婶を侯喇する箕は·プロセッサ维疚とシステム维疚を年
め·config の布にプロセッサ巴赂婶のファイルを弥くためのディレクトリ·
プロセッサ巴赂婶ディレクトリの布にシステム巴赂婶のファイルを弥くための
ディレクトリを侯喇するˉこれらのディレクトリ叹に脱いる矢机は·毖井矢机·
眶机および "_" に嘎年するˉ

(2) システム菇蜜数恕の肋年

プロセッサ巴赂婶ディレクトリおよびシステム巴赂婶ディレクトリの布に·そ
れぞれ·コンパイル数恕を肋年するための Makefile.config ファイルを脱罢
する∈泼侍な肋年が涩妥ない眷圭には·脱罢しなくてもよい∷ˉこれらのファ
イルは·Makefile からインクル〖ドされるˉ

笆布では·タ〖ゲット巴赂婶の Makefile.config で年盗すべき恃眶について
棱汤するˉ

(2-1) TARGET

GNUの倡券茨董を configure する眷圭に回年するタ〖ゲット叹で·コンパイラ
霹のコマンド叹の黎片に烧涂される矢机误∈呵稿の "-" は稍妥∷に年盗するˉ
毋えば·TARGET が m68k-unknown-elf に年盗された眷圭には·コンパイラと
して m68k-unknown-elf-gcc が蝗われるˉこの恃眶が年盗されない眷圭には·
帽なる gcc が蝗われるˉ

(2-2) CPU_CDEFS		プロセッサ巴赂に涩妥なマクロ年盗
(2-3) CPU_CFLAGS	プロセッサ巴赂に涩妥なコンパイルオプション
(2-4) CPU_LDFLAGS	プロセッサ巴赂に涩妥なリンクオプション
(2-5) CPU_LIBS		プロセッサ巴赂に涩妥なライブラリ回年
(2-6) SYS_CDEFS		システム巴赂に涩妥なマクロ年盗
(2-7) SYS_CFLAGS	システム巴赂に涩妥なコンパイルオプション
(2-8) SYS_LDFLAGS	システム巴赂に涩妥なリンクオプション
(2-9) SYS_LIBS		システム巴赂に涩妥なライブラリ回年

タ〖ゲット巴赂に·マクロ年盗·コンパイルオプション·リンクオプション·
ライブラリ回年が涩妥な眷圭は·これらの恃眶に年盗するˉ

泼に·アセンブリ咐胳レベルの急侍叹が·C咐胳レベルの急侍叹の黎片に "_" 
が烧いたものになる眷圭には·CPU_CFLAGS∈または·SYS_CFLAGS∷に 
-DLABEL_ASM を年盗するˉ

また·Cコンパイラの int房が16ビットで·64ビット腊眶房がサポ〖トされて
いない眷圭には·CPU_CFLAGS∈または·SYS_CFLAGS∷に -D_16BIT_INT_ を年
盗するˉ

(2-10) TEXT_START_ADDRESS	テキストセクションの黎片戎孟
(2-11) DATA_START_ADDRESS	デ〖タセクションの黎片戎孟

称セクションの黎片戎孟の回年が涩妥な眷圭には·これらの恃眶に黎片戎孟を
年盗するˉ

(2-12) LDSCRIPT			リンカスクリプトのファイル叹

漓脱のリンカスクリプトを脱いる眷圭には·この恃眶にリンカスクリプトのファ
イル叹を年盗するˉファイル叹は·config ディレクトリからの陵滦パスで回
年するˉ

(3) オフセットファイルの栏喇

アセンブリ咐胳で淡揭されるプログラムから·C咐胳の菇陇挛にアクセスする
眷圭には·菇陇挛の称フィ〖ルドのオフセットを徊救することが涩妥であるˉ 
JSPカ〖ネルでは·涩妥なオフセット猛をファイル∈筛洁では offset.h∷に叫
蜗するための慌寥みとして·makeoffset.c と genoffset を脱罢しているˉ
makeoffset.c は·どのオフセット猛をファイルに叫蜗するかを回年するもの
で·タ〖ゲット巴赂婶で脱罢する涩妥があるˉ

makeoffset.c と genoffset を蝗うことで·毋えば·TCB 面の texptn フィ〖
ルドのオフセット猛を TCB_texptn にマクロ年盗することや·TCB 面のタスク
コンテキストブロック∈tskctxb∷に崔まれる pc フィ〖ルドのオフセット猛
を TCB_pc にマクロ年盗することができるˉまた·TCB 面の enatex フィ〖ル
ドのオフセット猛·ビット疤弥·ビットマスクを·それぞれ TCB_enatex·
TCB_enatex_bit·TCB_enatex_mask にマクロ年盗することができるˉ

makeoffset.c と genoffset に簇するマニュアルは·附箕爬ではできていないˉ
蝗い数がわからない眷圭や·怠墙が颅りない眷圭には·陵锰されたいˉ

(4) スタ〖トアップモジュ〖ル

カ〖ネル脱のスタ〖トアップモジュ〖ルを·タ〖ゲット巴赂婶で脱罢する涩妥
があるˉカ〖ネル脱のスタ〖トアップモジュ〖ルからは·main 簇眶ではなく· 
kernel_start 簇眶を弹瓢するˉ

(5) リンカスクリプト

倡券茨董に筛洁のリンカスクリプトが蝗脱できない眷圭には·タ〖ゲット巴赂
婶で脱罢するˉ


２ˉアプリケ〖ション脱のインクル〖ドファイル

タ〖ゲット巴赂婶で捏丁すべきアプリケ〖ション脱の年盗は肌の奶りであるˉ
これらの年盗は·cpu_defs.h または sys_defs.h∈またはそれらからインクル
〖ドされるファイル∷に崔めるˉ

(1) タイムティックの年盗

(1-1) TIC_NUME		タイムティックの件袋の尸灰∈帽疤: 1ミリ擅∷
(1-2) TIC_DENO		タイムティックの件袋の尸熟∈帽疤: 1ミリ擅∷

(2) 充哈みハンドラ】CPU毋嘲ハンドラ簇息の年盗

(2-1) INHNO		充哈みハンドラ戎规のデ〖タ房
(2-2) EXCNO		CPU毋嘲ハンドラ戎规のデ〖タ房

(3) 充哈みマスクと充哈みマスクの恃构】徊救簇息の年盗∈オプション∷

chg_ixx·get_ixx をタ〖ゲット巴赂にサポ〖トする眷圭には·笆布の年盗お
よび离咐をタ〖ゲット巴赂婶で捏丁するˉxx·xxxx·XXXX は·タ〖ゲット髓
に努磊な矢机误に年めるˉxxxx および XXXX は·4矢机でなくてもよいˉ

(3-1) IXXXX				充哈みマスクのデ〖タ房
(3-2) ER chg_ixx(IXXXX ixxxx)		chg_ixx のプロトタイプ离咐
(3-2) ER get_ixx(IXXXX *p_ixxxx)	get_ixx のプロトタイプ离咐

(4) 充哈み戎规と充哈みの敦贿】钓材簇息の年盗∈オプション∷

dis_int·ena_int をタ〖ゲット巴赂にサポ〖トする眷圭には·笆布の年盗お
よび离咐をタ〖ゲット巴赂婶で捏丁するˉ

(4-1) INTNO				充哈み戎规のデ〖タ房
(4-2) ER dis_int(INTNO intno)		dis_int のプロトタイプ离咐
(4-3) ER ena_int(INTNO intno)		ena_int のプロトタイプ离咐

(5) 拉墙删擦脱システム箕癸簇息の年盗∈オプション∷

JSPカ〖ネルは·甫垫への网脱を肩誊弄の办つとしていることから·タ〖ゲッ
ト巴赂に·拉墙删擦脱のサ〖ビスコ〖ル vxget_tim をサポ〖ト材墙としてい
るˉvxget_tim をサポ〖トする眷圭には·笆布の年盗および离咐をタ〖ゲット
巴赂婶で捏丁するˉ

(5-1) SYSUTIM				拉墙删擦脱システム箕癸のデ〖タ房
(5-2) ER vxget_tim(SYSUTIM *p_sysutim)	vxget_tim のプロトタイプ离咐

(6) タ〖ゲット急侍マクロの年盗

cpu_defs.h ではプロセッサ叹∈cpu_defs.h の弥かれているディレクトリ叹を
络矢机にしたもの∷·sys_defs.h ではシステム叹∈sys_defs.h の弥かれてい
るディレクトリ叹を络矢机にしたもの∷をマクロ年盗するˉ


３ˉカ〖ネル脱のデ〖タ房や簇眶など

タ〖ゲット巴赂婶で捏丁すべきカ〖ネル脱のデ〖タ房や簇眶などは肌の奶りで
あるˉこれらのデ〖タ房やマクロの年盗と簇眶のプロトタイプ离咐は·侍に淡
揭がない嘎り·cpu_config.h または sys_config.h∈またはそれらからインク
ル〖ドされるファイル∷に崔めるˉまた·簇眶の悸挛は·C咐胳の眷圭は 
cpu_config.c または sys_config.c に·アセンブリ咐胳の眷圭は 
cpu_support.S または sys_support.S に淡揭するˉ

(1) タスクコンテキストブロックのデ〖タ房

(1-1) CTXB

タ〖ゲット巴赂のタスクコンテキストを瘦赂するために·TCB 面に积つことが
涩妥なデ〖タ菇陇の房ˉ

(2) システム觉轮徊救

(2-1) BOOL sense_context(void)

附哼の悸乖コンテキストが·タスクコンテキストの眷圭は FALSE·润タスクコ
ンテキストの眷圭は TRUE を手す簇眶ˉ

(2-2) BOOL sense_lock(void)

附哼のシステム觉轮が·CPUロック觉轮の眷圭は TRUE·CPUロック豺近觉轮の
箕は FALSE を手す簇眶ˉ

(2-3) BOOL t_sense_lock(void)

タスクコンテキストにおいて·附哼のシステム觉轮が·CPUロック觉轮の眷圭
は TRUE·CPUロック豺近觉轮の箕は FALSE を手す簇眶ˉこの簇眶が·润タス
クコンテキストから钙ばれることはないˉ

(2-4) BOOL i_sense_lock(void)

润タスクコンテキストにおいて·附哼のシステム觉轮が·CPUロック觉轮の眷
圭は TRUE·CPUロック豺近觉轮の箕は FALSE を手す簇眶ˉこの簇眶が·タス
クコンテキストから钙ばれることはないˉ

ⅷ 付妄弄には·sense_lock が捏丁されていれば t_sense_lock と 
i_sense_lock は涩妥なく·嫡に t_sense_lock と i_sense_lock が捏丁され
ていれば sense_lock を悸附することはできるが·タ〖ゲットに巴赂せずに光
い悸乖跟唯を悸附するために·タ〖ゲット巴赂婶が3つの簇眶を捏丁すること
としているˉ

(3) CPUロックとその豺近

(3-1) BOOL t_lock_cpu(void)

タスクコンテキストにおいて·CPUロック豺近觉轮から·CPUロック觉轮に莲败
させる簇眶ˉこの簇眶が·CPUロック觉轮で钙ばれることはないˉまた·润タ
スクコンテキストから钙ばれることもないˉ

(3-2) BOOL t_unlock_cpu(void)

タスクコンテキストにおいて·CPUロック觉轮から·CPUロック豺近觉轮に莲败
させる簇眶ˉこの簇眶が·CPUロック豺近觉轮で钙ばれることはないˉまた·
润タスクコンテキストから钙ばれることもないˉ

(3-3) BOOL i_lock_cpu(void)

润タスクコンテキストにおいて·CPUロック豺近觉轮から·CPUロック觉轮に莲
败させる簇眶ˉこの簇眶が·CPUロック觉轮で钙ばれることはないˉまた·タ
スクコンテキストから钙ばれることもないˉ

(3-4) BOOL i_unlock_cpu(void)

润タスクコンテキストにおいて·CPUロック觉轮から·CPUロック豺近觉轮に莲
败させる簇眶ˉこの簇眶が·CPUロック豺近觉轮で钙ばれることはないˉまた·
タスクコンテキストから钙ばれることもないˉ

(4) タスクディスパッチャ

(4-1) void dispatch(void)

タスクディスパッチャ∈笆布·帽にディスパッチャと咐う∷を汤绩弄に钙ぶた
めの簇眶ˉタスクコンテキストから钙ばれたサ〖ビスコ〖ル借妄から·CPUロッ
ク觉轮で钙ばれるˉ

この簇眶が钙ばれると·簇眶を钙んだタスクのコンテキストを瘦赂し· 悸乖
できるタスクの面で呵光庭黎界疤のタスク∈schedtsk∷のコンテキストを牲耽