Context Navigation

porting.txt@ 315

Last change on this file since 315 was 315, checked in by coas-nagasima, 7 years ago
SVNプロパティを設定
Property svn:eol-style set to `native` Property svn:keywords set to `Id` Property svn:mime-type set to `text/plane; charset=UTF-8`
File size: 219.8 KB

Line
1
2	TOPPERS/ASPカーネル
3	ターゲット依存部ポーティングガイド
4
5	対応バージョン: Release 1.9.3
6	最終更新: 2014年11月17日
7
8	このドキュメントは，TOPPERS/ASPカーネルを，未サポートのターゲットシステ
9	ムにポーティングするために必要となるターゲット依存部の実装方法を説明す
10	るものである．
11
12	----------------------------------------------------------------------
13	TOPPERS/ASP Kernel
14	Toyohashi Open Platform for Embedded Real-Time Systems/
15	Advanced Standard Profile Kernel
16
17	Copyright (C) 2005-2013 by Embedded and Real-Time Systems Laboratory
18	Graduate School of Information Science, Nagoya Univ., JAPAN
19
20	上記著作権者は，以下の(1)～(4)の条件を満たす場合に限り，本ソフトウェ
21	ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
22	変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
23	(1) 本ソフトウェアをソースコードの形で利用する場合には，上記の著作
24	権表示，この利用条件および下記の無保証規定が，そのままの形でソー
25	スコード中に含まれていること．
26	(2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
27	用できる形で再配布する場合には，再配布に伴うドキュメント（利用
28	者マニュアルなど）に，上記の著作権表示，この利用条件および下記
29	の無保証規定を掲載すること．
30	(3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
31	用できない形で再配布する場合には，次のいずれかの条件を満たすこ
32	と．
33	(a) 再配布に伴うドキュメント（利用者マニュアルなど）に，上記の著
34	作権表示，この利用条件および下記の無保証規定を掲載すること．
35	(b) 再配布の形態を，別に定める方法によって，TOPPERSプロジェクトに
36	報告すること．
37	(4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
38	害からも，上記著作権者およびTOPPERSプロジェクトを免責すること．
39	また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
40	由に基づく請求からも，上記著作権者およびTOPPERSプロジェクトを
41	免責すること．
42
43	本ソフトウェアは，無保証で提供されているものである．上記著作権者お
44	よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
45	に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
46	アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
47	の責任を負わない．
48
49	$Id: porting.txt 315 2017-07-23 05:29:40Z coas-nagasima $
50	----------------------------------------------------------------------
51
52	○目次
53
54	１．共通事項
55	1.1 ターゲット依存部の構成
56	1.2 名前の衝突の防止
57	1.3 多重インクルードの防止
58	1.4 アセンブリ言語とのヘッダファイルの共用
59	1.5 インクルード記述の方法
60	1.6 クリティカルセクションの出入処理の実現に関する制約
61	２．システム構築環境のターゲット依存部
62	2.1 ターゲット略称とターゲット依存部のディレクトリ
63	2.2 Makefileのターゲット依存部
64	2.3 開発環境名とコマンド名の設定
65	2.4 コンパイルオプションとオブジェクトファイルの設定
66	2.5 オフセットファイルの生成方法
67	2.5.1 コンフィギュレータを用いる方法
68	2.5.2 makeoffset.cとgenoffsetを用いる方法
69	2.6 リンク方法の設定
70	2.7 依存関係の定義
71	2.8 その他の設定
72	３．TOPPERS共通定義のターゲット依存部
73	3.1 ターゲット識別マクロ
74	3.2 整数型の最大値・最小値・ビット数
75	3.3 サイズの指定された整数型，その最大値・最小値，整数定数を作るマクロ
76	3.4 サイズの指定された浮動小数点型，その最大値・最小値のマクロ
77	3.5 コンパイラの拡張機能のためのマクロ定義
78	3.6 標準的な定義の上書き
79	3.7 アサーションのための定義
80	４．システムインタフェースレイヤ（SIL）のターゲット依存部
81	4.1 全割込みロック状態の管理
82	4.2 微少時間待ち
83	4.3 プロセッサのエンディアン
84	4.4 メモリ空間アクセス関数
85	4.5 I/O空間アクセス関数
86	５．カーネルAPIのターゲット依存部
87	5.1 ターゲット定義でサポートする機能
88	5.2 割込み優先度の範囲
89	5.3 タイムティックの定義
90	5.4 メモリ領域確保のための型定義
91	5.5 ビットパターンのビット数
92	5.6 メモリ領域確保のためのマクロ
93	5.7 オーバランハンドラ機能拡張のための定義（オプション）
94	６．カーネル実装のターゲット依存部
95	6.1 カーネル実装のターゲット依存部の共通事項
96	6.1.1 カーネル実装のターゲット依存部の構成要素
97	6.1.2 ターゲット依存部の関数の命名規則
98	6.2 トレースログ機能への対応
99	6.3 システム状態の管理
100	6.3.1 全割込みロック状態の管理
101	6.3.2 コンテキストの管理
102	6.3.3 CPUロック状態の管理
103	6.4 割込みに関連するシステム状態の管理
104	6.4.1 割込み優先度マスクの管理
105	6.4.2 割込み要求禁止フラグの管理
106	6.4.3 割込み要求のクリア
107	6.4.4 割込み要求のプローブ
108	6.4.5 割込みハンドラの先頭処理と末尾処理
109	6.5 タスクディスパッチャ
110	6.5.1 タスクコンテキストブロックとタスク初期化コンテキストブロック
111	6.5.2 ディスパッチャ本体
112	6.5.3 タスクコンテキストからのディスパッチ
113	6.5.4 ディスパッチャの動作開始
114	6.5.5 現在のコンテキストを捨ててディスパッチ
115	6.5.6 タスクの起動処理
116	6.6 割込みハンドラ
117	6.6.1 割込みハンドラの出入口処理
118	6.6.2 割込みハンドラ毎の出入口処理の生成
119	6.6.3 割込みハンドラの設定
120	6.6.4 割込み要求ラインの属性の設定
121	6.6.5 割込み管理機能の初期化処理の変更
122	6.6.6 デフォルトの割込みハンドラ
123	6.6.7 カーネル管理外の割込み
124	6.6.8 割込みサービスルーチンの生成
125	6.7 CPU例外ハンドラとCPU例外発生時のシステム状態の参照
126	6.7.1 CPU例外ハンドラの出入口処理
127	6.7.2 CPU例外ハンドラの出入口処理の生成
128	6.7.3 CPU例外ハンドラの設定
129	6.7.4 CPU例外管理機能の初期化処理の変更
130	6.7.5 デフォルトのCPU例外ハンドラ
131	6.7.6 CPU例外発生時のシステム状態の参照
132	6.8 カーネルの起動・終了とスタック領域など
133	6.9 カーネル内部のチューニング
134	6.9.1 ビットマップサーチ
135	6.9.2 ビットフィールド
136	6.10 カーネル実装に関するその他の定義
137	6.10.1 オブジェクト属性の拡張
138	6.10.2 エラーチェック方法の指定
139	6.10.3 非タスクコンテキスト用のスタック領域
140	6.10.4 空ラベルの定義
141	6.11 トレースログ機能に関する設定
142	6.11.1 取得できるトレースログの種類とマクロ
143	6.11.2 トレースログ記録のサンプルコード
144	6.12 カーネル実装のターゲット依存部のためのリネーム記述
145	6.13 タイマドライバ
146	6.13.1 タイマドライバのファイル構成
147	6.13.2 タイマの初期化・終了処理・割込み処理
148	6.13.3 性能評価用システム時刻の参照のための機能
149	6.14 オーバランタイマドライバ（オプション）
150	6.14.1 オーバランタイマドライバのファイル構成
151	6.14.2 オーバランタイマの操作と割込み処理
152	6.15 動的メモリ管理（オプション）
153	6.15.1 TLSFを用いたメモリ管理モジュールの例
154	７．コンフィギュレータ設定ファイルのターゲット依存部
155	7.1 設定ファイルとターゲット依存部の位置付け
156	7.2 パス2のテンプレートファイルのターゲット依存部
157	7.2.1 ターゲット非依存部をインクルードする前に定義すべき変数
158	7.2.2 ターゲット非依存部で定義される変数
159	7.3 パス3のテンプレートファイルのターゲット依存部
160	7.3.1 ターゲット非依存部をインクルードする前に定義すべき変数
161	7.3.2 ターゲット依存部で行うべきエラーチェック
162	7.4 cfg1_out.cのリンクに必要なスタブの定義ファイル
163	８．システムサービス等のターゲット依存部
164	8.0 システムサービスのターゲット依存部
165	8.1 システムログ機能のターゲット依存定義
166	8.2 ログタスクのターゲット依存定義
167	8.3 シリアルインタフェースドライバのターゲット依存部
168	8.3.1 変数，データ型，管理関数
169	8.3.2 デバイスサービスルーチン
170	8.3.3 コールバックルーチン
171	8.4 カーネル起動メッセージの出力のターゲット依存定義
172	8.5 サンプルプログラムとテストプログラムのターゲット依存定義
173	8.6 実行時間分布集計モジュールのターゲット依存定義
174	９．その他
175	9.1 ドキュメント
176	9.2 パッケージ記述ファイル
177	１０．リファレンス
178	10.1 ターゲット依存部のファイル一覧
179
180
181	１．共通事項
182
183	1.1 ターゲット依存部の構成
184
185	ターゲット依存部は，targetディレクトリの下に，ターゲットハードウェアと
186	開発環境の組み合わせ毎に用意する．ただし，ターゲット依存部の再利用性を
187	考慮し，プロセッサ，チップ，開発環境のみに依存する部分を，プロセッサ依
188	存部，チップ依存部，開発環境依存部という形で切り分けてもよい．切り分け
189	方は，ターゲット依存部の実装に任されている．プロセッサ依存部，チップ依
190	存部，開発環境依存部は，archディレクトリの下に置く．
191
192	ASPカーネルのターゲット依存部は，システム構築環境（Makefile等）のターゲッ
193	ト依存部，TOPPERS共通定義（t_stddef.h）のターゲット依存部，システムイン
194	タフェースレイヤ（SIL，sil.h）のターゲット依存部，カーネルAPI（kernel.h）
195	のターゲット依存部，カーネル実装のターゲット依存部（コンフィギュレータ
196	設定ファイルのターゲット依存部を含む），システムサービスのターゲット依
197	存部，ターゲット依存部に関するドキュメント等で構成される．
198
199	1.2 名前の衝突の防止
200
201	TOPPERSプロジェクトが提供するソフトウェアのために，TOPPERS_で始まるシン
202	ボルを予約している．ヘッダファイル中に記述され，アプリケーションから参
203	照できる内部シンボルは，TOPPERS_で始まる名前とする．
204
205	また，_kernel_で始まるシンボルは，カーネル内部の変数や関数のために予約
206	している．カーネル内部の変数や関数の名前で，リンク時にアプリケーション
207	の名前と衝突する可能性があるものは，リネーム記述にリストアップすること
208	で，コンパイル時に_kernel_で始まる名前に置き換えることとしている．
209
210	1.3 多重インクルードの防止
211
212	すべてのヘッダファイルは，多重にインクルードされるのを防止するための条
213	件コンパイル記述を入れることとする．例えば，target_config.hであれば，ファ
214	イルの先頭に
215
216	#ifndef TOPPERS_TARGET_CONFIG_H
217	#define TOPPERS_TARGET_CONFIG_H
218
219	を，ファイルの末尾に
220
221	#endif /* TOPPERS_TARGET_CONFIG_H */
222
223	を記述する．
224
225	1.4 アセンブリ言語とのヘッダファイルの共用
226
227	ASPカーネルのヘッダファイルの多くは，アセンブリ言語のソースファイルから
228	もインクルードできるようにするために，次のルールに従って記述するものと
229	する．
230
231	・TOPPERS_MACRO_ONLYがマクロ定義されている場合には，アセンブリ言語では
232	解釈できない記述（マクロ定義以外の記述）を除くように記述する．
233
234	・符号無し整数型の定数値は，UINT_CやULONG_Cなどの整数定数を作るためのマ
235	クロを用いて記述する．ただし，アセンブリ言語のソースファイルからもイ
236	ンクルードできるファイル中であっても，C言語のみで用いる定数をこれらの
237	マクロを使って記述する必要はない．
238
239	また，カーネル実装においては，次のルールに従うものとする．
240
241	・アセンブリ言語からも用いる定数の定義中に型キャストを用いる場合には，
242	CASTマクロを用いて記述する．
243
244	アセンブリ言語からヘッダファイルをインクルードする際には，必要に応じて，
245	TOPPERS_MACRO_ONLY，UINC_C，ULONG_C，CASTをマクロ定義してから，インクルー
246	ドしなければならない．
247
248	1.5 インクルード記述の方法
249
250	開発環境で用意されている標準ヘッダファイルおよびincludeディレクトリ下の
251	標準ヘッダファイルは，「#include <...>」によりインクルードする．
252
253	その他のヘッダファイルは，「#include "..."」によりインクルードする．ヘッ
254	ダファイルが，カレントディレクトリやインクルードするファイルと同じディ
255	レクトリ以外のディレクトリに置かれている場合には，次のようにパス指定を
256	行う．
257
258	・ターゲット依存部（target/<ターゲット名>）のディレクトリに置かれている
259	場合は，パス指定を行わず，ファイル名のみを記述する．
260	例）#include "target_config.h"
261
262	・archディレクトリ下のディレクトリに置かれている場合には，archディレク
263	トリからの相対パスで記述する．
264	例）#include "m68k_gcc/prc_config.h"
265
266	・その他の場合には，ソースプログラムのルートディレクトリ（configureが置
267	かれているディレクトリ）からの相対パスで記述する．
268	例）#include "pdic/upd72001/upd72001.h"
269
270	・カーネルを構成するファイルから，kernelディレクトリ下のヘッダファイル
271	をインクルードする場合は，パス指定を行わず，ファイル名のみを記述する．
272	例）#include "kernel_impl.h"
273
274	1.6 クリティカルセクションの出入処理の実現に関する制約
275
276	カーネル内で用いるクリティカルセクションの出入処理を実現する場合には，
277	次の2つの条件を満たすように実装しなければならない．
278
279	(1-6-1) 出入処理から抜けた時点では，割込みの禁止／許可が完了していなけ
280	ればならない．例えば，割込み禁止／許可命令を実行してから実際に割込みが
281	禁止／許可されるまで何命令か遅延するプロセッサの場合には，出入処理の中
282	にNOP命令を入れるなどの方法で，出入処理を抜けた時点では，割込みが禁止／
283	許可された状態になっていることを保証しなければならない．
284
285	(1-6-2) メモリ上のデータ構造が書き変わる可能性があることを，何らかの方
286	法でコンパイラに知らせなければならない．GNU開発環境では，次のいずれかの
287	方法でこの制約を満たすことができる．
288
289	(a) クリティカルセクションの出入処理の全体または出入処理の本質的な部分
290	（具体的には，割込み禁止／許可する処理）を（インラインでない）通常
291	の関数により実現する．
292
293	(b) クリティカルセクションの出入処理の本質的な部分をインラインアセンブ
294	ラによって実現している場合には，そのインラインアセンブラのclobber変
295	数リストに"memory"を追加する．
296
297	(c) クリティカルセクションの出入処理の本質的な部分が，マクロやインライ
298	ン関数呼出しで実現している場合には，クリティカルセクションに入る処
299	理の最後と出る処理の先頭に，Asm("":::"memory")という記述を入れる．
300
301	このような制約を設ける理由については，「TOPPERS/ASPカーネル設計メモ」
302	の「カーネルのデータ構造に対するvolatile宣言について」の節を参照するこ
303	と．
304
305
306	２．システム構築環境のターゲット依存部
307
308	この章の説明は，GNU開発環境（GCC，GAS，BINUTILS，GNU Make）を用いること
309	を想定して記述してある．それ以外の開発環境を用いる場合には，開発環境に
310	あわせて修正する必要がある．
311
312	2.1 ターゲット略称とターゲット依存部のディレクトリ
313
314	新しいターゲット依存部を作成する時は，まず，ターゲット略称を定める．ター
315	ゲット略称は，システム略称と開発環境略称を"_"で連結したものとする．シス
316	テム略称に用いる文字は英小文字と数字と"_"に，開発環境略称に用いる文字は
317	英小文字と数字に限定する．GNU開発環境の開発環境略称は，"gcc"とする．例
318	えば，システム略称が"dve68k"で，GNU開発環境を用いる場合には，ターゲット
319	略称は"dve68k_gcc"となる．
320
321	ターゲット依存部のファイルを置くために，targetディレクトリの下に，ター
322	ゲット略称を名称とするディレクトリを作成する．これをターゲット依存部ディ
323	レクトリと呼ぶ．
324
325	ターゲット依存部からプロセッサ依存部やチップ依存部を切り分ける場合には，
326	依存部略称を定める．依存部略称は，プロセッサやチップの略称と開発環境略
327	称を"_"で連結したものとする．プロセッサやチップの略称に用いる文字は，英
328	小文字と数字と"_"に限定する．例えば，プロセッサ略称が"m68k"で，GNU開発
329	環境を用いる場合には，依存部略称は"m68k_gcc"となる．
330
331	また，ターゲット依存部から開発環境依存部を切り分ける場合には，開発環境
332	略称を依存部略称とする．例えば，GNU開発環境依存部の依存部略称は，"gcc"
333	となる．
334
335	これらの依存部のファイルを置くために，archディレクトリの下に，依存部略
336	称を名称とするディレクトリを作成する．
337
338	なお，GNU開発環境以外の開発環境を用いる場合には，コンフィギュレーション
339	スクリプト（configure），サンプルのMakefile（sample/Makefile），一部の
340	ユーティリティプログラム（utils/makedep）を，その開発環境用に用意する必
341	要がある場合がある．その場合には，これらのファイルを，ターゲット依存部
342	ディレクトリか開発環境依存部ディレクトリに置くものとする．また，開発環
343	境用のプロジェクトファイルが必要な場合には，ターゲット依存部ディレクト
344	リに置くものとする．
345
346	2.2 Makefileのターゲット依存部
347
348	Makefileのターゲット依存部は，ターゲット依存部ディレクトリに置いた
349	Makefile.targetまたはそこからインクルードされるファイル（プロセッサ・チッ
350	プ・開発環境依存部で用意されるファイルなど）に含める．
351
352	2.3 開発環境名とコマンド名の設定
353
354	開発環境名とコマンド名を設定するために，Makefileのターゲット依存部で次
355	の変数を定義する．
356
357	(2-3-1) TOOL 開発環境名
358
359	開発環境名に定義する．GNU開発環境を用いる場合には，gccに定義する．
360
361	(2-3-2) GCC_TARGET GNU開発環境のターゲット名
362
363	GNU開発環境を用いる場合に，GNU開発環境をconfigureする場合に指定するター
364	ゲット名に定義する．ここで指定したターゲット名は，開発環境のコマンド名
365	の先頭に付与される文字列となる．例えば，GCC_TARGETをm68k-unknown-elfに
366	定義した場合には，コンパイラとしてm68k-unknown-elf-gccが使われる．この
367	変数が定義されない場合には，単なるgccが使われる．
368
369	(2-3-3) CC Cコンパイラドライバの名称
370	(2-3-4) CXX C++コンパイラドライバの名称
371	(2-3-5) AS アセンブラの名称
372	(2-3-6) LD リンカの名称
373	(2-3-7) AR アーカイバの名称
374	(2-3-8) NM nmプログラムの名称
375	(2-3-9) RANLIB ranlibプログラムの名称
376	(2-3-10) OBJCOPY objcopyプログラムの名称
377	(2-3-11) OBJDUMP objdumpプログラムの名称
378
379	GNU開発環境以外の開発環境を用いる場合に，それぞれのコマンドの名称に定義
380	する．対応するコマンドがない場合や，コマンドパラメータが異なる場合には，
381	Makefile中でそのコマンドを呼び出している部分を変更する必要がある．
382
383	GNU開発環境では，これらはGCC_TARGETを用いて定義されるので，定義する必要
384	はない．
385
386	2.4 コンパイルオプションとオブジェクトファイルの設定
387
388	Makefileのターゲット依存部で以下で説明する変数を定義する時には，":="を
389	用いて，それまでの定義に追加する形で行う．例えば，コンパイラに対するそ
390	の他のオプションとして「-Wall -g -O2」を追加したい場合には，「COPTS :=
391	$(COPTS) -Wall -g -O2」という記述をMakefileのターゲット依存部に含める．
392
393	(2-4-1) COPTS コンパイラに対するその他のオプション
394	(2-4-2) CDEFS マクロ定義オプション（-Dオプション）
395	(2-4-3) INCLUDES ヘッダファイルの置かれたディレクトリ指定オ
396	プション（-Iオプション）
397	(2-4-4) LDFLAGS リンカに対するその他のオプション
398	(2-4-5) LIBS ライブラリリンク指定のためのオプション
399
400	ターゲットに依存して，すべてのソースファイルに共通するコンパイルオプショ
401	ンの追加が必要な場合には，オプションの種類毎に上に示した変数に定義する．
402
403	ほとんどの場合に，ターゲット依存部ディレクトリのMakefile.targetには，以
404	下の記述を含める必要がある．
405
406	----------------------------------------
407	INCLUDES := $(INCLUDES) -I$(TARGETDIR)
408	----------------------------------------
409
410	ここでTARGETDIRは，ターゲット依存部ディレクトリに定義されている．また
411	SRCDIRは，Makefileにおいて，ソースプログラムのルートディレクトリ
412	（configureが置かれているディレクトリ）に定義されている．
413
414	コンパイラの問題等で，警告メッセージが出ることを防げない状況以外では，
415	COPTSに-Werrorを追加することを推奨する．
416
417	----------------------------------------
418	COPTS := $(COPTS) -Werror
419	----------------------------------------
420
421	カーネルのコンパイル時に，dereferencing type-punned pointer will break
422	strict-aliasing rulesという警告が出る場合には，以下を追加するとよい．こ
423	の警告メッセージに関する詳細は，「TOPPERS/ASPカーネル設計メモ」の「型
424	キャストに伴う警告メッセージ」の節を参照すること．
425
426	----------------------------------------
427	KERNEL_CFLAGS := $(KERNEL_CFLAGS) -fno-strict-aliasing
428	----------------------------------------
429
430	また，アセンブリ言語レベルの識別名が，C言語レベルの識別名の先頭に"_"が
431	付いたものになる場合には，CDEFSに-DTOPPERS_LABEL_ASMを追加する．
432
433	(2-4-6) SYSSVC_DIR システムサービスのソースが置かれたディレクトリ
434	(2-4-7) SYSSVC_ASMOBJS アセンブリ言語で記述されたシステムサービスの
435	オブジェクト
436	(2-4-8) SYSSVC_COBJS C言語で記述されたシステムサービスのオブジェクト
437	(2-4-9) SYSSVC_CFLAGS システムサービスに対するコンパイルオプション
438	(2-4-10) SYSSVC_LIBS システムサービスに対するライブラリリンク指定
439
440	ターゲットに依存して，システムサービス（システムログタスクやデバイスド
441	ライバなど）のソースが置かれたディレクトリ，システムサービスを構成する
442	オブジェクトファイルのリスト，それらをコンパイルする際に適用するコンパ
443	イルオプション，その構成に必要なライブラリリンク指定を追加する場合には，
444	上に示した変数に定義する．
445
446	(2-4-11) KERNEL_DIR カーネルのソースが置かれたディレクトリ
447	(2-4-12) KERNEL_ASMOBJS アセンブリ言語で記述されたカーネルのオブジェクト
448	(2-4-13) KERNEL_COBJS C言語で記述されたカーネルのオブジェクト
449	(2-4-14) KERNEL_CFLAGS カーネルに対するコンパイルオプション
450
451	ターゲットに依存して，カーネルのソースが置かれたディレクトリ，カーネル
452	を構成するオブジェクトファイルのリスト，それらをコンパイルする際に適用
453	するコンパイルオプションを追加する場合には，上に示した変数に定義する．
454
455	ほとんどの場合に，ターゲット依存部ディレクトリのMakefile.targetには，以
456	下の記述を含める必要がある．
457
458	----------------------------------------
459	KERNEL_DIR := $(KERNEL_DIR) $(TARGETDIR)
460	KERNEL_ASMOBJS := $(KERNEL_ASMOBJS) target_support.o
461	KERNEL_COBJS := $(KERNEL_COBJS) target_config.o target_timer.o
462	----------------------------------------
463
464	(2-4-15) CFG_TABS コンフィギュレータに対するオプション
465
466	ターゲットに依存して，コンフィギュレータに対するオプションを追加する場
467	合には，上に示した変数に定義する．具体的には，コンフィギュレータの値取
468	得シンボルテーブルのターゲット依存部（target_def.csv）がある場合には，
469	それを指定するオプションを追加する必要がある．
470
471	ほとんどの場合に，ターゲット依存部ディレクトリのMakefile.targetには，以
472	下の記述を含める必要がある．
473
474	----------------------------------------
475	CFG_TABS := $(CFG_TABS) --cfg1-def-table $(TARGETDIR)/target_def.csv
476	----------------------------------------
477
478	(2-4-16) CFG1_OUT_LDFLAGS cfg1_out.cに対するリンクオプション
479
480	ターゲットに依存して，cfg1_out.cをリンクする際に適用するオプションを追
481	加する場合には，上に示した変数に定義する．
482
483	なお，LDFLAGSは，cfg1_out.cをリンクする際には適用されないため，LDFLAGS
484	に定義したオプションで，cfg1_out.cをリンクする際にも必要なものは，
485	CFG1_OUT_LDFLAGSにも定義する必要がある．
486
487	(2-4-17) CFG_ASMOBJS アセンブリ言語で記述されたシステムコンフィ
488	ギュレーションのためのオブジェクト
489	(2-4-18) CFG_COBJS C言語で記述されたシステムコンフィギュレー
490	ションのためのオブジェクト
491
492	ターゲットに依存して，システムコンフィギュレーションのためのオブジェク
493	トファイルを（kernel_cfg.o以外に）追加する場合には，上に示した変数に定
494	義する．この場合，追加したオブジェクトファイルの作成ルール（コンパイル／
495	アセンブルルールと依存関係作成ルール）を，Makefileのターゲット依存部に
496	記述する必要がある．
497
498	(2-4-19) CFG2_OUT_SRCS
499
500	ターゲットに依存して，コンフィギュレータのパス2でkernel_cfg.cと
501	kernel_cfg.h以外のファイルを生成する場合には，上に示した変数に定義する．
502
503	(2-4-20) OMIT_WARNING_ALL
504	(2-4-21) OMIT_OPTIMIZATION
505
506	サンプルのMakefileでは，コンパイラに対するオプションに「-Wall -g -O2」
507	を追加する．-Wallを追加したくない場合には，Makefileのターゲット依存部で
508	OMIT_WARNING_ALLを"true"に定義する．-O2を追加したくない場合には，
509	Makefileのターゲット依存部でOMIT_OPTIMIZATIONを"true"に定義する．
510
511	2.5 オフセットファイルの生成方法
512
513	アセンブリ言語で記述されるプログラムから，C言語の構造体にアクセスする場
514	合には，構造体の各フィールドのオフセット値を参照することが必要である．
515	ASPカーネルでは，必要なオフセット値を求めてファイル（標準ではoffset.h）
516	に生成するための仕組みを用意している．
517
518	この仕組みを用いることで，例えば，TCB中のtexptnフィールドのオフセット値
519	をTCB_texptnにマクロ定義することや，TCB中のタスクコンテキストブロック
520	（tskctxb）に含まれるpcフィールドのオフセット値をTCB_pcにマクロ定義する
521	ことができる．また，TCB中のenatexフィールドのオフセット値，ビット位置，
522	ビットマスクを，それぞれTCB_enatex，TCB_enatex_bit，TCB_enatex_maskにマ
523	クロ定義することができる．
524
525	offset.hを生成するための仕組みとして，現時点では，コンフィギュレータを
526	用いる方法と，makeoffset.cとgenoffsetを用いる方法を用意している．後者の
527	方法は，GNU開発環境にしか対応していないことから，将来のバージョンでは，
528	後者の方法のサポートをやめる計画である．新たにポーティングする場合には，
529	前者の方法を用いることを推奨する．
530
531	これらの仕組みでオフセットファイルを生成できない時には，offset.hをター
532	ゲット依存部で用意し，Makefileのターゲット依存部でOMIT_MAKEOFFSETを
533	"true"に定義する．
534
535	拡張パッケージの中には，TCBにフィールドを追加するものがあるため，TCB中
536	のフィールドのオフセット値は変化する．offset.hを生成する場合でも，ター
537	ゲット依存部で用意する場合でも，拡張パッケージに対応するためには，この
538	ことを考慮する必要がある．
539
540	2.5.1 コンフィギュレータを用いる方法
541
542	コンフィギュレータのパス1で生成するcfg1_out.cをコンパイルして生成したオ
543	ブジェクトファイルから，コンフィギュレータによってoffset.hを生成する方
544	法である．この方法を用いるためには，ターゲット依存部でオフセットファイ
545	ル生成用テンプレートファイルを用意し，target_cfg1_out.h（または，そこか
546	らインクルードされるファイル）とtarget_def.csv（または，同等の役割を持
547	つファイル）に記述を追加する必要がある．なお，これらのファイルを新たに
548	用意した際や修正した際には，offset.hに妥当な定義が生成されていることを
549	確認すべきである．
550
551	オフセットファイル生成用テンプレートファイルは，ターゲット依存部で，
552	target_offset.tf（または，プロセッサ依存部やチップ依存部で用意するそれ
553	に代わるファイル）に用意する．また，Makefileのターゲット依存部で，次の
554	例のように，OFFSET_TFにオフセットファイル生成用テンプレートファイルのファ
555	イル名を定義する．
556
557	----------------------------------------
558	# オフセットファイル生成のための定義
559	OFFSET_TF = $(TARGETDIR)/target_offset.tf
560	----------------------------------------
561
562	オフセットファイル生成用テンプレートファイルには，以下の内容を記述する．
563
564	(1) 標準テンプレートファイルのインクルード
565
566	オフセットファイル生成用の標準テンプレートファイル（kernel/genoffset.tf）
567	をインクルードする．標準テンプレートファイルには，以下で用いるDEFINE関
568	数やDEFINE_BIT関数の定義などが含まれている．
569
570	----------------------------------------
571	$ 標準テンプレートファイルのインクルード
572	$INCLUDE "kernel/genoffset.tf"$
573	----------------------------------------
574
575	(2) オフセット値のマクロ定義の生成
576
577	DEFINE関数を用いて，オフセット値のマクロ定義を生成する．例えば，TCB中の
578	タスクコンテキストブロック（tskctxb）に含まれるpcフィールドのオフセット
579	値を，TCB_pcにマクロ定義する場合には，次のように記述する．
580
581	----------------------------------------
582	$ オフセット値のマクロ定義の生成
583	$DEFINE("TCB_pc", offsetof_TCB_pc)$
584	----------------------------------------
585
586	ここで，DEFINE関数の第1パラメータはマクロ定義するシンボル，第2パラメー
587	タは，オフセット値を保持するコンフィギュレータの変数である．
588
589	また，コンフィギュレータが，オフセット値を保持する変数（上の例では
590	offsetof_TCB_pc）に値を設定するために，target_def.csv（または，同等の役
591	割を持つファイル）に次の例のような行を追加する．
592
593	----------------------------------------
594	offsetof_TCB_pc,"offsetof(TCB,tskctxb.pc)"
595	----------------------------------------
596
597	ただし，各オブジェクトの初期化ブロックのターゲット非依存のフィールドの
598	オフセット値を取得するための記述は，kernel/kernel_def.csvに含まれている．
599	kernel/kernel_def.csvに含まれている記述は，target_def.csv（または，同等
600	の役割を持つファイル）に追加する必要はない．
601
602	(3) ビットオフセット値等のマクロ定義の生成
603
604	DEFINE_BIT関数を用いて，ビットのオフセット値，ビット位置，ビットマスク
605	のマクロ定義を生成する．例えば，TCB中のenatexフィールドのオフセット値，
606	ビット位置，ビットマスクを，それぞれTCB_enatex，TCB_enatex_bit，
607	TCB_enatex_maskにマクロ定義する場合には，次のように記述する．
608
609	----------------------------------------
610	$DEFINE_BIT("TCB_enatex", sizeof_TCB, "B")$
611	----------------------------------------
612
613	ここで，DEFINE_BIT関数の第1パラメータはマクロ定義するシンボル（の先頭部
614	分），第2パラメータは構造体のサイズである．第3パラメータには，ビットの
615	オフセット，ビット位置，ビットマスクを，8ビット単位（バイト単位）で求め
616	る場合には"B"を，16ビット単位で求める場合には"H"を，32ビット単位で求め
617	る場合には"W"を指定する．なお，ビット位置は，LSBを0とした値（ビットリト
618	ルエンディアンを想定）を求める．
619
620	また，target_cfg1_out.h（または，そこからインクルードされるファイル）に，
621	ビットオフセット値等を求めるための構造体の変数定義を追加する．この構造
622	体の変数は，名称をマクロ定義するシンボル（DEFINE_BIT関数の第1パラメータ）
623	とし，対象のビットのみが1で，他のすべてのビットが0になるように初期化す
624	る．また，const修飾子を付加する．例えば，TCB中のenatexフィールドのビッ
625	トオフセット値等を求める場合には，次のような定義を追加する（tskctxbの初
626	期値は，ターゲット依存なので注意すること）．
627
628	----------------------------------------
629	const TCB TCB_enatex = {
630	{ NULL, NULL }, /* task_queue */
631	NULL, /* p_tinib */
632	0U, /* tstat */
633	#ifdef TOPPERS_SUPPORT_MUTEX
634	0U, /* bpriority */
635	#endif /* TOPPERS_SUPPORT_MUTEX */
636	0U, /* priority */
637	false, /* acqeue */
638	false, /* wupque */
639	true, /* enatex */
640	0U, /* texptn */
641	NULL, /* p_winifo */
642	#ifdef TOPPERS_SUPPORT_MUTEX
643	{ NULL, NULL }, /* mutex_queue */
644	#endif /* TOPPERS_SUPPORT_MUTEX */
645	#ifdef TOPPERS_SUPPORT_OVRHDR
646	0U, /* leftotm */
647	#endif /* TOPPERS_SUPPORT_OVRHDR */
648	{ NULL, NULL } /* tskctxb */
649	};
650	----------------------------------------
651
652	さらに，コンフィギュレータが，構造体のサイズ（上の例ではsizeof_TCB）に
653	値を設定するために，target_def.csv（または，同等の役割を持つファイル）
654	に次の例のような行を追加する．
655
656	----------------------------------------
657	sizeof_TCB,sizeof(TCB)
658	----------------------------------------
659
660	ただし，前述した通り，kernel/kernel_def.csvに含まれている記述は，
661	target_def.csv（または，同等の役割を持つファイル）に追加する必要はない．
662
663	最後に，target_cfg1_out.h（または，そこからインクルードされるファイル）
664	に，offset.hを生成する仕組みが正しく動作していることを確認するための次
665	の記述を追加する．
666
667	----------------------------------------
668	const uint8_t MAGIC_1 = 0x12;
669	const uint16_t MAGIC_2 = 0x1234;
670	const uint32_t MAGIC_4 = 0x12345678;
671	----------------------------------------
672
673	2.5.2 makeoffset.cとgenoffsetを用いる方法
674
675	makeoffset.cは，どのオフセット値をoffset.hに生成するかを指定するファイ
676	ルで，ターゲット依存部で用意する．genoffsetは，makeoffset.cをコンパイル
677	して得られるアセンブリソースファイルから，offset.hを生成するスクリプト
678	である．genoffsetは，GNU開発環境にのみ対応している．
679
680	makeoffset.cを記述する場合には，既存のターゲット依存部に含まれる
681	makeoffset.cを修正するのが近道である．標準的なmakeoffset.cは，以下の6つ
682	の部分で構成されている．なお，makeoffset.cを新たに記述した際には，
683	offset.hに妥当な定義が生成されていることを確認すべきである．
684
685	(1) 必要なファイルのインクルード
686
687	オフセット値を求めたいフィールドを含む構造体を定義するヘッダファイルを
688	インクルードする．TCB中のフィールドのオフセット値を求めたい場合には，以
689	下の3行を含めればよい．
690
691	#include "kernel_impl.h"
692	#include "task.h"
693	#include "sil.h"
694
695	(2) オフセット値出力用マクロの定義
696
697	構造体中のフィールドのオフセット値の定義を生成するために用いるマクロ
698	（OFFSET_DEFとOFFSET_DEF2）の定義．これらのマクロの定義は，修正する必要
699	がない．
700
701	(3) オフセット値出力用関数の定義
702
703	構造体中のフィールドのオフセット値の定義を生成するための関数
704	（makeoffset）の定義．オフセット値のマクロ定義を生成したいフィールド毎
705	に，次のいずれかのマクロを記述する．
706
707	(2-5-2-1) OFFSET_DEF(TYPE, FIELD)
708
709	TYPEに構造体のデータ型名，FIELDにその構造体中のフィールドを指定すると，
710	TYPE_FIELDという名前のシンボルに，そのフィールドのオフセット値をマクロ
711	定義する記述を生成する．
712
713	(2-5-2-2) OFFSET_DEF2(TYPE, FIELD, FIELDNAME)
714
715	TYPEに構造体のデータ型名，FIELDにその構造体中のフィールドを指定すると，
716	TYPE_FIELDNAMEという名前のシンボルに，そのフィールドのオフセット値をマ
717	クロ定義する記述を生成する．構造体に含まれる構造体中のフィールドのオフ
718	セット値を求めたい場合には，こちらのマクロを使用する．
719
720	(4) エンディアンを参照するための関数の定義
721
722	SILで定義されたエンディアンを参照するための関数（sil_endian）の定義．こ
723	の関数の定義は，修正する必要がない．
724
725	(5) ビットオフセット値出力のための参照定義
726
727	初期値を持った変数定義に対して，コンパイラが生成するアセンブリ命令を参
728	照するための変数（BIT_REF_4，BIT_REF_2，BIT_REF_1）の定義．これらの定義
729	は，ほとんどの場合に修正する必要がない．ただし，uint8_t型のサポートされ
730	ていないターゲットでは，BIT_REF_1の定義は削除する必要がある．また，ポイ
731	ンタが64ビットのターゲット等では，BIT_REF_8の定義を追加しなければならな
732	いと思われる．
733
734	(6) ビットオフセット値出力用変数の定義
735
736	ビットのオフセット値，ビット位置，ビットマスクの定義を生成するためのデー
737	タ型の定義．これらの定義を生成したいビットフィールド毎に，以下の説明す
738	る変数を定義する．
739
740	構造体のデータ型名がTYPE，その構造体中のビットフィールド名がFIELDの場合
741	に，データ型がTYPEで，変数名がBIT_xy_TYPE_FIELDの変数を定義する．また，
742	その変数を，対象のビットのみが1で，他のすべてのビットが0になるように初
743	期化する．ここで，xはエンディアンを指定する文字で，B（ビッグエンディア
744	ン）またはL（リトルエンディアン）を指定する．またyには，ビットのオフセッ
745	ト，ビット位置，ビットマスクを，8ビット単位（バイト単位）で求める場合に
746	はBを，16ビット単位で求める場合にはHを，32ビット単位で求める場合にはWを
747	指定する．
748
749	これにより，TYPE_FIELDという名前のシンボルにそのビットのオフセット，
750	TYPE_FIELD_bitという名前のシンボルにビット位置，TYPE_FIELD_maskという名
751	前のシンボルにビットマスクをマクロ定義する記述を生成する．なお，ビット
752	位置は，LSBを0とした値（ビットリトルエンディアンを想定）を求める．
753
754	2.6 リンク方法の設定
755
756	(2-6-1) LDSCRIPT リンカスクリプトのファイル名
757
758	開発環境に標準のリンカスクリプトが使用できない場合には，ターゲット依存
759	部でリンカスクリプトを用意し，そのファイル名をこの変数に定義する．
760
761	(2-6-2) TEXT_START_ADDRESS テキストセクションの先頭番地
762	(2-6-3) DATA_START_ADDRESS データセクションの先頭番地
763
764	各セクションの先頭番地の指定が必要な場合には，これらの変数に先頭番地を
765	定義する．
766
767	(2-6-4) START_OBJS 先頭にリンクすべきモジュール名
768	(2-6-5) END_OBJS 最後にリンクすべきモジュール名
769
770	ターゲットによっては，ロードモジュールの先頭と最後にリンクすべきモジュー
771	ルを，ターゲット依存部で用意する必要がある．多くの場合，スタートアップ
772	モジュールをロードモジュールの先頭にリンクする必要がある．
773
774	ロードモジュールの先頭にリンクすべきプログラムがある場合には，Makefile
775	のターゲット依存部において，そのオブジェクトファイル名をSTART_OBJSに定
776	義し，それに対するコンパイルルールと依存関係作成ルールを定義する．ロー
777	ドモジュールの最後にリンクすべきモジュールがある場合には，そのオブジェ
778	クトファイル名をEND_OBJSに定義し，それに対するコンパイルルールと依存関
779	係作成ルールを定義する．また，標準のスタートアップモジュール（crt0.o）
780	をリンクしないように，LDFLAGSとCFG1_OUT_LDFLAGSに-nostdlibを追加する必
781	要がある．さらに，-nostdlibをつけることで標準ライブラリがリンクされなく
782	なるため，LIBSに-lgccを追加しなければならない．
783
784	例えば，スタートアップモジュールのソースファイルがstart.Sの場合には，
785	Makefileのターゲット依存部に次のような記述を入れるとよい．
786
787	----------------------------------------
788	# スタートアップモジュールのオブジェクトファイル名
789	START_OBJS = start.o
790
791	# スタートアップモジュールのコンパイルルール
792	$(START_OBJS): %.o: %.S
793	$(CC) -c $(CFLAGS) $(KERNEL_CFLAGS) $<
794
795	# スタートアップモジュールの依存関係作成ルール
796	$(START_OBJS:.o=.d): %.d: %.S
797	@$(PERL) $(SRCDIR)/utils/makedep -C $(CC) $(MAKEDEP_OPTS) \
798	-O "$(CFLAGS) $(KERNEL_CFLAGS)" $< >> Makefile.depend
799
800	# リンカに対するオプション
801	LDFLAGS := -nostdlib $(LDFLAGS)
802	CFG1_OUT_LDFLAGS := -nostdlib $(CFG1_OUT_LDFLAGS)
803	LIBS := $(LIBS) -lgcc
804	----------------------------------------
805
806	また，GNU開発環境で，コンパイラに標準のcrtbegin.oとcrtend.oを用いる場合
807	には，Makefile のターゲット依存部に次のような記述を入れるとよい．
808
809	----------------------------------------
810	# オブジェクトファイル名
811	START_OBJS = $(shell $(CC) -print-file-name=crtbegin.o)
812	END_OBJS = $(shell $(CC) -print-file-name=crtend.o)
813
814	# 依存関係作成ルール
815	$(START_OBJS:.o=.d): %.d:
816	$(END_OBJS:.o=.d): %.d:
817
818	# リンカに対するオプション
819	LDFLAGS := -nostdlib $(LDFLAGS)
820	CFG1_OUT_LDFLAGS := -nostdlib $(CFG1_OUT_LDFLAGS)
821	LIBS := $(LIBS) -lgcc
822	----------------------------------------
823
824	この場合，これらのファイルをコンパイルすることはないため，コンパイルルー
825	ルは不要である．また，依存関係作成ルールはダミーでよい（依存関係作成ルー
826	ルがないとエラーになる）．
827
828	(2-6-6) HIDDEN_OBJS 指定しなくてもリンクされるモジュール名
829
830	ロードモジュールにリンクすべきモジュールを，リンカに対するパラメータで
831	はなく，リンカスクリプト中に（例えば，GNU開発環境のリンカスクリプトの
832	STARTUPを使って）記述する場合には，そのオブジェクトファイル名を，
833	（START_OBJSまたはEND_OBJSではなく）HIDDEN_OBJSに定義し，それに対するコ
834	ンパイルルールと依存関係作成ルールを定義する．HIDDEN_OBJSに定義したモ
835	ジュールは，リンカに対するパラメータからは除外される．LDFLAGSと
836	CFG1_OUT_LDFLAGS，LIBSについては，START_OBJSまたはEND_OBJSを用いる場合
837	と同様である．
838
839	例えば，スタートアップモジュールのソースファイルがstart.Sで，start.oを
840	リンクすることをリンカスクリプト中に記述する場合には，Makefileのターゲッ
841	ト依存部に次のような記述を入れるとよい．
842
843	----------------------------------------
844	# スタートアップモジュールのオブジェクトファイル名
845	HIDDEN_OBJS = start.o
846
847	# スタートアップモジュールのコンパイルルール
848	$(HIDDEN_OBJS): %.o: %.S
849	$(CC) -c $(CFLAGS) $(KERNEL_CFLAGS) $<
850
851	# スタートアップモジュールの依存関係作成ルール
852	$(HIDDEN_OBJS:.o=.d): %.d: %.S
853	@$(PERL) $(SRCDIR)/utils/makedep -C $(CC) $(MAKEDEP_OPTS) \
854	-O "$(CFLAGS) $(KERNEL_CFLAGS)" $< >> Makefile.depend
855
856	# リンカに対するオプション
857	LDFLAGS := -nostdlib $(LDFLAGS)
858	CFG1_OUT_LDFLAGS := -nostdlib $(CFG1_OUT_LDFLAGS)
859	LIBS := $(LIBS) -lgcc
860	----------------------------------------
861
862	2.7 依存関係の定義
863
864	コンフィギュレータの各パスに対して，ターゲット依存のファイルへの依存関
865	係を定義する．具体的には，パス1，パス2，パス3が依存するファイルを，それ
866	ぞれcfg1_out.c，kernel_cfg.timestamp，$(OBJFILE)に対する依存関係の形で
867	記述する．
868
869	ほとんどの場合に，ターゲット依存部ディレクトリのMakefile.targetには，以
870	下の記述を含める必要がある．
871
872	----------------------------------------
873	cfg1_out.c: $(TARGETDIR)/target_def.csv
874	kernel_cfg.timestamp: $(TARGETDIR)/target.tf
875	$(OBJFILE): $(TARGETDIR)/target_check.tf
876	----------------------------------------
877
878	2.8 その他の設定
879
880	(2-8-1) CLEAN_FILES cleanにより削除するファイル名
881
882	cleanにより削除するファイルをターゲット依存部で追加したい場合には，ファ
883	イル名をこの変数に追加定義する．
884
885	(2-8-2) REALCLEAN_FILES realcleanにより削除するファイル名
886
887	realcleanにより削除するファイルをターゲット依存部で追加したい場合には，
888	ファイル名をこの変数に追加定義する．
889
890
891	３．TOPPERS共通定義のターゲット依存部
892
893	TOPPERS共通定義（t_stddef.h）のターゲット依存部は，target_stddef.hまた
894	はそこからインクルードされるファイル（プロセッサ・チップ・開発環境依存
895	部で用意されるヘッダファイルなど）に含める．
896
897	3.1 ターゲット識別マクロ
898
899	アプリケーションやシステムサービスでターゲットを識別するために，
900	"TOPPERS_"にシステム略称を大文字にした文字列を連結したもの（例えば，
901	"TOPPERS_DVE68K"）をマクロ定義する．
902
903	また，ターゲット依存部からプロセッサ依存部やチップ依存部を切り分けた場
904	合には，"TOPPERS_"に依存部略称を大文字にした文字列を連結したもの（例え
905	ば，"TOPPERS_M68K"）をマクロ定義する．
906
907	3.2 整数型の最大値・最小値・ビット数
908
909	(3-2-1) INT_MAX intに格納できる最大値（C90準拠）
910	(3-2-2) INT_MIN intに格納できる最小値（C90準拠）
911	(3-2-3) UINT_MAX unsigned intに格納できる最大値（C90準拠）
912	(3-2-4) LONG_MAX longに格納できる最大値（C90準拠）
913	(3-2-5) LONG_MIN longに格納できる最小値（C90準拠）
914	(3-2-6) ULONG_MAX unsigned longに格納できる最大値（C90準拠）
915	(3-2-7) CHAR_BIT char型のビット数（C90準拠）
916
917	整数型の最大値・最小値・ビット数を，これらのシンボルにマクロに定義する．
918
919	これらのマクロは，C90に準拠したものである．開発環境にC90に準拠した
920	limits.hが用意されている場合には，これらのマクロを定義することに代えて，
921	limits.hをインクルードすればよい．
922
923	3.3 サイズの指定された整数型，その最大値・最小値，整数定数を作るマクロ
924
925	(3-3-1) int8_t 符号付き8ビット整数（オプション，C99準拠）
926	(3-3-2) uint8_t 符号無し8ビット整数（オプション，C99準拠）
927	(3-3-3) int16_t 符号付き16ビット整数（C99準拠）
928	(3-3-4) uint16_t 符号無し16ビット整数（C99準拠）
929	(3-3-5) int32_t 符号付き32ビット整数（C99準拠）
930	(3-3-6) uint32_t 符号無し32ビット整数（C99準拠）
931	(3-3-7) int64_t 符号付き64ビット整数（オプション，C99準拠）
932	(3-3-8) uint64_t 符号無し64ビット整数（オプション，C99準拠）
933	(3-3-9) int128_t 符号付き128ビット整数（オプション，C99準拠）
934	(3-3-10) uint128_t 符号無し128ビット整数（オプション，C99準拠）
935	(3-3-11) int_least8_t 8ビット以上の符号付き整数（C99準拠）
936	(3-3-12) uint_least8_t 8ビット以上の符号無し整数（C99準拠）
937	(3-3-13) intptr_t ポインタを格納できるサイズの符号付き整数（C99準拠）
938	(3-3-14) uintptr_t ポインタを格納できるサイズの符号無し整数（C99準拠）
939	(3-3-15) INT8_MAX int8_tに格納できる最大値（オプション，C99準拠）
940	(3-3-16) INT8_MIN int8_tに格納できる最小値（オプション，C99準拠）
941	(3-3-17) UINT8_MAX uint8_tに格納できる最大値（オプション，C99準拠）
942	(3-3-18) INT16_MAX int16_tに格納できる最大値（C99準拠）
943	(3-3-19) INT16_MIN int16_tに格納できる最小値（C99準拠）
944	(3-3-20) UINT16_MAX uint16_tに格納できる最大値（C99準拠）
945	(3-3-21) INT32_MAX int32_tに格納できる最大値（C99準拠）
946	(3-3-22) INT32_MIN int32_tに格納できる最小値（C99準拠）
947	(3-3-23) UINT32_MAX uint32_tに格納できる最大値（C99準拠）
948	(3-3-24) INT64_MAX int64_tに格納できる最大値（オプション，C99準拠）
949	(3-3-25) INT64_MIN int64_tに格納できる最小値（オプション，C99準拠）
950	(3-3-26) UINT64_MAX uint64_tに格納できる最大値（オプション，C99準拠）
951	(3-3-27) INT128_MAX int128_tに格納できる最大値（オプション，C99準拠）
952	(3-3-28) INT128_MIN int128_tに格納できる最小値（オプション，C99準拠）
953	(3-3-29) UINT128_MAX uint128_tに格納できる最大値（オプション，C99準拠）
954	(3-3-30) INT_LEAST8_MAX int_least8_tに格納できる最大値（C99準拠）
955	(3-3-31) INT_LEAST8_MIN int_least8_tに格納できる最小値（C99準拠）
956	(3-3-32) UINT_LEAST8_MAX uint_least8_tに格納できる最大値（C99準拠）
957	(3-3-33) INT8_C(val) int_least8_t型の定数を作るマクロ（C99準拠）
958	(3-3-34) UINT8_C(val) uint_least8_t型の定数を作るマクロ（C99準拠）
959	(3-3-35) INT16_C(val) int16_t型の定数を作るマクロ（C99準拠）
960	(3-3-36) UINT16_C(val) uint16_t型の定数を作るマクロ（C99準拠）
961	(3-3-37) INT32_C(val) int32_t型の定数を作るマクロ（C99準拠）
962	(3-3-38) UINT32_C(val) uint32_t型の定数を作るマクロ（C99準拠）
963	(3-3-39) INT64_C(val) int64_t型の定数を作るマクロ（オプション，C99準拠）
964	(3-3-40) UINT64_C(val) uint64_t型の定数を作るマクロ（オプション，C99準拠）
965	(3-3-41) INT128_C(val) int128_t型の定数を作るマクロ（オプション，C99準拠）
966	(3-3-42) UINT128_C(val) uint128_t型の定数を作るマクロ（オプション，C99準拠）
967
968	指定されたサイズの整数型を，これらのシンボルに型定義する．また，データ
969	型に格納できる最大値・最小値と，整数定数を作るマクロを，これらのシンボ
970	ルにマクロ定義する．
971
972	これらのデータ型およびマクロは，C99に準拠したものである．開発環境にC99
973	に準拠したstdint.hが用意されている場合には，これらのデータ型およびマク
974	ロを定義することに代えて，stdint.hをインクルードすればよい．
975
976	上でオプションと記述したものは，該当するデータ型がコンパイラでサポート
977	されている場合にのみ定義することを示す．
978
979	3.4 サイズの指定された浮動小数点型，その最大値・最小値のマクロ
980
981	(3-4-1) float32_t IEEE754準拠の32ビット単精度浮動小数点数（オプ
982	ション）
983	(3-4-2) double64_t IEEE754準拠の64ビット倍精度浮動小数点数（オプ
984	ション）
985	(3-4-3) FLOAT32_MIN float32_tに格納できる最小の正規化された正の浮
986	動小数点数（オプション）
987	(3-4-4) FLOAT32_MAX float32_tに格納できる表現可能な最大の有限浮動
988	小数点数（オプション）
989	(3-4-5) DOUBLE64_MIN double64_tに格納できる最小の正規化された正の浮
990	動小数点数（オプション）
991	(3-4-6) DOUBLE64_MAX double64_tに格納できる表現可能な最大の有限浮動
992	小数点数（オプション）
993
994	指定されたサイズ・表現形式の浮動小数点型を，これらのシンボルに型定義す
995	る．また，データ型に格納できる最大値・最小値を，これらのシンボルにマク
996	ロ定義する．
997
998	いずれも，該当するデータ型がコンパイラでサポートされている場合にのみ定
999	義する．
1000
1001	3.5 コンパイラの拡張機能のためのマクロ定義
1002
1003	コンパイラの拡張機能を用いるためのマクロとして，必要に応じて，以下のマ
1004	クロの定義を含める．
1005
1006	(3-5-1) inline（オプション，デフォルトは未定義）
1007	(3-5-2) Inline（オプション，デフォルトはstatic inline）
1008
1009	インライン関数であることを示す指定．Inlineは，コンパイル単位にローカル
1010	なインライン関数であることを示す．
1011
1012	(3-5-3) asm（オプション，デフォルトは未定義）
1013	(3-5-4) Asm（オプション，デフォルトは未定義）
1014
1015	インラインアセンブラを記述するための指定．Asmは，最適化により削除しては
1016	ならないことを示す．これらは，ターゲット依存部でのみ使うマクロであるた
1017	め，ターゲット依存部で使わないなら定義する必要はない．
1018
1019	(3-5-5) offsetof(structure, field)（オプション，デフォルトの定義あり）
1020
1021	構造体structureの中での，フィールドfieldのオフセットを求めるマクロ．
1022
1023	(3-5-6) alignof(type)（オプション，デフォルトの定義あり）
1024
1025	データ型typeのアラインメント単位を求めるマクロ．
1026
1027	(3-5-7) NoReturn（オプション，デフォルトは未定義）
1028
1029	リターンすることのない関数であることを示す指定．これは，ターゲット依存
1030	部のみ使うマクロであるため，ターゲット依存部で使わないなら定義する必要
1031	はない．
1032
1033	3.6 標準的な定義の上書き
1034
1035	t_stddef.hに含まれるTOPPERS共通定義の標準的な定義を上書きする場合には，
1036	以下のマクロを定義する．
1037
1038	(3-6-1) TOPPERS_bool（オプション，デフォルトはint）
1039	(3-6-2) TOPPERS_size（オプション，デフォルトはuintptr_t）
1040	(3-6-3) TOPPERS_fp（オプション，デフォルトは他と互換性のない関数ポインタ）
1041
1042	それぞれ，bool_t，SIZE，FPに型定義すべきデータ型．
1043
1044	(3-6-4) UINT_C(val)（オプション，デフォルトはUを付加）
1045	(3-6-5) ULONG_C(val)（オプション，デフォルトはULを付加）
1046
1047	それぞれ，unsigned uint型，unsigned long型の定数を作るためのマクロ．
1048
1049	(3-6-6) NULL（オプション，デフォルトは0）
1050
1051	C90準拠のC言語環境では，NULLの定義はstddef.hに含まれているため，これを
1052	インクルードしてもよい．
1053
1054	(3-6-7) ERCD(mercd, sercd)（オプション）
1055	(3-6-8) MERCD(ercd)（オプション）
1056	(3-6-9) SERCD(ercd)（オプション）
1057
1058	ERCD，MERCD，SERCDの標準の定義は，符号付き整数が2の補数で表現されており，
1059	右シフト演算子（>>）が算術シフトされることを仮定している．多くのコンパ
1060	イラでこの仮定が成り立つが，そうでない場合には，ターゲット依存部でこれ
1061	らの定義を上書きする必要がある．
1062
1063	(3-6-10) ALIGN_TYPE(addr, type)（オプション）
1064
1065	アドレスaddrが，データ型typeのアラインメント単位にアラインしているか
1066	チェックするマクロ．
1067
1068	3.7 アサーションのための定義
1069
1070	t_stddef.hには，assertの定義が含まれる．assertが失敗した場合（assertの
1071	パラメータがfalseになった場合）の処理を，ターゲット依存に用意する必要が
1072	ある．これらの定義は，assertマクロを使用する前であれば，t_stddef.h以降
1073	にインクルードされるファイルに含まれていてもよい．なお，assertを無効に
1074	する（NDEBUGをマクロ定義してコンパイルする）場合には，これらを用意する
1075	必要はない．
1076
1077	(3-7-1) TOPPERS_assert_abort(void)
1078
1079	assertが失敗した場合に，プログラムを停止させる関数．システム開発中はデ
1080	バッガに落とすのが理想的である．システム稼働時には例外処理を行わせるこ
1081	とになる．
1082
1083	(3-7-2) TOPPERS_assert_fail(exp, file, line)
1084
1085	assertが失敗した時の情報を表示/記録するためのマクロ．システムログ機能を
1086	用いる場合には，t_syslog.hにシステムログ機能に記録するための定義が含ま
1087	れているので，ターゲット依存部で用意する必要はない．
1088
1089
1090	４．システムインタフェースレイヤ（SIL）のターゲット依存部
1091
1092	システムインタフェースレイヤ（SIL，sil.h）のターゲット依存部の定義は，
1093	target_sil.hまたはそこからインクルードされるファイル（プロセッサ・チッ
1094	プ・開発環境依存部で用意されるヘッダファイルなど）に含める．
1095
1096	SILのサービスコールは，任意のシステム状態で呼び出すことができる．そのた
1097	め，SILのターゲット依存部の関数は，任意のシステム状態で呼び出せるように
1098	実装しなければならない．
1099
1100	4.1 全割込みロック状態の管理
1101
1102	SILのターゲット依存部では，全割込みロック状態へ遷移する機能と，元の状態
1103	へ戻す機能（元の状態を記憶するために変数を使う）を提供する．全割込みロッ
1104	ク状態であるかを判別する機能は提供する必要がない．
1105
1106	SILの機能は，カーネルを使用しない場合にも使用できる必要がある．そのため，
1107	全割込みロック状態への遷移と元の状態への復帰は，カーネルを用いず，プロ
1108	セッサのリソースを直接操作することによって実現する．また，全割込みロッ
1109	ク状態への遷移と元の状態への復帰は，全割込みロック状態やCPUロック状態で
1110	も行える必要がある．
1111
1112	保護機能を持ったカーネルでは，ユーザタスクからプロセッサのリソースを直
1113	接操作することができないため，ユーザタスクからはこれらの機能を用いるこ
1114	とができない．用いた場合の振舞いはターゲットプロセッサに依存するが，典
1115	型的には，特権命令違反などのCPU例外が発生することになる．
1116
1117	(4-1-1) SIL_PRE_LOC
1118
1119	全割込みロックフラグの状態を保存するための変数を定義するマクロ．型名の
1120	後に，変数名を続けたものに定義する．変数名は，他の名前と衝突しないよう
1121	に，"TOPPERS_"で始まる名前にする．
1122
1123	(4-1-2) SIL_LOC_INT()
1124
1125	現在の全割込みロックフラグの状態をSIL_PRE_LOCで定義した変数に保存し，全
1126	割込みロック状態に遷移させるマクロ．このマクロを実現する際には，「1.6
1127	クリティカルセクションの出入処理の実現に関する制約」の節に記述されてい
1128	る制約に従わなければならない．
1129
1130	(4-1-3) SIL_UNL_INT()
1131
1132	SIL_LOC_INT()によって変数に保存した状態に戻すマクロ．このマクロを実現す
1133	る際には，「1.6 クリティカルセクションの出入処理の実現に関する制約」の
1134	節に記述されている制約に従わなければならない．
1135
1136	4.2 微少時間待ち
1137
1138	(4-2-1) void sil_dly_nse(ulong_t dlytim)
1139
1140	dlytimで指定された以上の時間（単位はナノ秒），ループなどによって待つ関
1141	数．
1142
1143	以下の関数と等価な処理を，アセンブリ言語で記述する方法を，標準的な実装
1144	方法とする．アセンブリ言語で記述するのは，コンパイラの最適化に依存しな
1145	いようにするためである．またこの関数は，キャッシュ等の影響を受けないよ
1146	うに，できる限りメモリアクセスを行わないように実装すべきである．
1147
1148	void sil_dly_nse(ulong_t dlytim)
1149	{
1150	dlytim -= SIL_DLY_TIM1;
1151	if (結果が0より大きい) {
1152	do {
1153	dlytim -= SIL_DLY_TIM2;
1154	} while (結果が0より大きい);
1155	}
1156	}
1157
1158	この関数の動作は次の通りである．dlytimがSIL_DLY_TIM1以下の場合には，最
1159	初のif文の条件が成立せず，すぐに関数から抜ける．dlytimがSIL_DLY_TIM1よ
1160	り大きく，(SIL_DLY_TIM1+SIL_DLY_TIM2)以下の場合には，最初のif文の条件は
1161	成立するが，doループは1回も回らずに関数から抜ける．dlytimが
1162	(SIL_DLY_TIM1+SIL_DLY_TIM2)より大きく，(SIL_DLY_TIM1+SIL_DLY_TIM2*2)以
1163	下の場合には，doループを1回だけ回って関数から抜ける．その後，dlytimが
1164	SIL_DLY_TIM2大きくなる度に，whileループを回る回数が1回ずつ増える．
1165
1166	なお，この関数をアセンブリ言語（または，C言語）で記述する場合，どのファ
1167	イルに記述するかが問題になる．SILのターゲット依存部には，標準では，アセ
1168	ンブリ言語（または，C言語）の関数定義を記述するためのファイルを用意して
1169	いない．ターゲット依存で用意してもよいが，例外的に，カーネル実装のター
1170	ゲット依存モジュール（target_support.Sまたはtarget_config.c）に記述して
1171	もよいことにする．
1172
1173	(4-2-2) SIL_DLY_TIM1（オプション）
1174	(4-2-3) SIL_DLY_TIM2（オプション）
1175
1176	sil_dly_nseを上記の標準的な方法で実現した場合，この2つの定数をターゲッ
1177	ト依存部でマクロ定義する．
1178
1179	SIL_DLY_TIM2は，上記の関数において，doループ1回の実行時間（単位はナノ秒）
1180	に設定する．ターゲットプロセッサの命令セットにもよるが，おおよそ，減算
1181	命令と条件分岐命令各1回の実行時間になる．SIL_DLY_TIM2が決まれば，関数呼
1182	出しも含めた全体の時間がdlytimで指定された以上の時間になるように，
1183	SIL_DLY_TIM1を決める．
1184
1185	この2つの定数値の決定を支援するプログラムとして，testディレクトリに，
1186	test_dlynseを用意している．test_dlynseを実行すると，次のような出力が得
1187	られる．
1188
1189	-- for fitting parameters --
1190	sil_dly_nse(0): 430 OK
1191	sil_dly_nse(420): 430 OK
1192	sil_dly_nse(510): 520 OK
1193	sil_dly_nse(600): 610 OK
1194	<中略>
1195	-- for checking boundary conditions --
1196	sil_dly_nse(421): 520 OK
1197	sil_dly_nse(511): 610 OK
1198	sil_dly_nse(601): 700 OK
1199
1200	"for fitting parameters"に続く出力は，sil_dly_nse(dlytim)を呼び出した場
1201	合の待ち時間を測定した結果である．このプログラムを用いて，":"の右側の数
1202	値が，dlytimよりも大きい範囲でなるべく近い値になるように，2つの定数値を
1203	調整する．"for checking boundary conditions"に続く出力は，プログラムの
1204	妥当性をチェックするためのもので，":"の右側の数値が，dlytimよりも大きい
1205	ことを確認する（近い値になる必要はない）．
1206
1207	4.3 プロセッサのエンディアン
1208
1209	(4-3-1) SIL_ENDIAN_BIG
1210	(4-3-2) SIL_ENDIAN_LITTLE
1211
1212	プロセッサのエンディアンにより，いずれか片方のシンボルをマクロ定義する．
1213
1214	(4-3-3) TOPPERS_SIL_REV_ENDIAN_UINT16（オプション）
1215	(4-3-4) TOPPERS_SIL_REV_ENDIAN_UINT32（オプション）
1216
1217	それぞれ，16ビット，32ビットの符号無し整数のエンディアンを反転させるマ
1218	クロ．プロセッサがエンディアン反転のための命令を持つ場合には，その命令
1219	を用いて実現する．これらのシンボルをマクロ定義しない場合には，デフォル
1220	トの定義が使われる．
1221
1222	4.4 メモリ空間アクセス関数
1223
1224	(4-4-1) TOPPERS_OMIT_SIL_ACCESS
1225
1226	標準のメモリ空間アクセス関数を使用せず，ターゲット依存部で用意する場合
1227	には，このシンボルをマクロ定義する．
1228
1229	(4-4-2) TOPPERS_OMIT_SIL_REH_LEM
1230	(4-4-3) TOPPERS_OMIT_SIL_WRH_LEM
1231	(4-4-4) TOPPERS_OMIT_SIL_REH_BEM
1232	(4-4-5) TOPPERS_OMIT_SIL_WRH_BEM
1233	(4-4-6) TOPPERS_OMIT_SIL_REW_LEM
1234	(4-4-7) TOPPERS_OMIT_SIL_WRW_LEM
1235	(4-4-8) TOPPERS_OMIT_SIL_REW_BEM
1236	(4-4-9) TOPPERS_OMIT_SIL_WRW_BEM
1237
1238	それぞれ，標準のsil_reh_lem，sil_wrh_lem，sil_reh_bem，sil_wrh_bem，
1239	sil_rew_lem，sil_wrw_lem，sil_rew_bem，sil_wrw_bemを使用せず，ターゲッ
1240	ト依存部で用意する場合には，これらのシンボルをマクロ定義する．
1241
1242	4.5 I/O空間アクセス関数
1243
1244	メモリ空間とは別にI/O空間を持つプロセッサでは，I/O空間にあるデバイスレ
1245	ジスタをアクセスするための関数として，sil_reb_iop，sil_wrb_iop，
1246	sil_reh_iop，sil_wrh_iop，sil_reh_lep，sil_wrh_lep，sil_reh_bep，
1247	sil_wrh_bep，sil_rew_iop，sil_wrw_iop，sil_rew_lep，sil_wrw_lep，
1248	sil_rew_bep，sil_wrw_bepの中で必要なものを，ターゲット依存部で用意する．
1249
1250
1251	５．カーネルAPIのターゲット依存部
1252
1253	カーネルAPI（kernel.h）のターゲット依存部の定義は，target_kernel.hまた
1254	はそこからインクルードされるファイル（プロセッサ・チップ・開発環境依存
1255	部で用意されるヘッダファイルなど）に含める．
1256
1257	5.1 ターゲット定義でサポートする機能
1258
1259	(5-1-1) TOPPERS_TARGET_SUPPORT_DIS_INT dis_intをサポートする
1260	(5-1-2) TOPPERS_TARGET_SUPPORT_ENA_INT ena_intをサポートする
1261	(5-1-3) TOPPERS_TARGET_SUPPORT_GET_UTM get_utmをサポートする
1262
1263	dis_int，ena_int，get_utmをサポートする場合に，それぞれのシンボルをマク
1264	ロ定義する．
1265
1266	5.2 割込み優先度の範囲
1267
1268	(5-2-1) TMIN_INTPRI 割込み優先度の最小値（最高値）
1269	(5-2-2) TMAX_INTPRI 割込み優先度の最大値（最低値）
1270
1271	それぞれ，カーネル管理の割込み優先度の最小値（＝優先度が最高），カーネ
1272	ル管理の割込み優先度の最大値（優先度が最低）に定義する．TMAX_INTPRIは-1
1273	に固定されているが，対称性のために，ターゲット依存部で定義することにし
1274	ている．
1275
1276	5.3 タイムティックの定義
1277
1278	(5-3-1) TIC_NUME タイムティックの周期の分子
1279	(5-3-2) TIC_DENO タイムティックの周期の分母
1280
1281	タイムティックの周期（signal_timeを呼び出す周期）を，ミリ秒単位で，
1282	TIC_NUME/TIC_DENOに定義する．例えば，タイムティックの周期が1/30秒の場合
1283	には，TIC_NUMEを100に，TIC_DENOを3に定義すればよい．
1284
1285	タイムティックの周期は，1ミリ秒とする（つまり，TIC_NUME，TIC_DENOとも1
1286	に定義する）ことを推奨するが，シミュレーション環境や性能の低いプロセッ
1287	サでそれが適切でない場合には，それ以外の値としてもよい．その場合でも，
1288	可能な限り，1ミリ秒の倍数である（つまり，TIC_DENOを1に定義する）ことが
1289	望ましい．
1290
1291	TIC_NUMEとTIC_DENOの定義を変更することで，タイムティックの周期を変更で
1292	きるようにタイマドライバを実装する場合には，この2つの定数の定義はデフォ
1293	ルト値を与えていることになる．そこで，これらの定義を「#ifndef TIC_NUME」
1294	「#endif」で囲んで記述する．
1295
1296	5.4 メモリ領域確保のための型定義
1297
1298	(5-4-1) TOPPERS_STK_T スタック領域を確保するための型（オプション）
1299	(5-4-2) TOPPERS_MPF_T 固定長メモリプール領域を確保するための型（オプション）
1300
1301	スタック領域と固定長メモリプール領域は，標準では，intptr_t型の配列とし
1302	て確保するが，より大きい単位でアラインさせたいなどの理由で，それ以外の
1303	型の配列として確保する場合には，それぞれTOPPERS_STK_TとTOPPERS_MPF_Tを，
1304	配列のベースとなるデータ型にマクロ定義する．
1305
1306	5.5 ビットパターンのビット数
1307
1308	(5-5-1) TBIT_TEXPTN タスク例外要因のビット数（オプション）
1309	(5-5-2) TBIT_FLGPTN イベントフラグのビット数（オプション）
1310
1311	TBIT_TEXPTN，TBIT_FLGPTNの標準の定義では，整数型の有効ビット数が，その
1312	型のsizeofにCHAR_BITを乗じたものと一致していることを仮定している．多く
1313	のコンパイラでこの仮定が成り立つが，そうでない場合には，ターゲット依存
1314	部でこれらの定義を上書きする必要がある．ただし，これらの値は16以上でな
1315	ければならない．
1316
1317	5.6 メモリ領域確保のためのマクロ
1318
1319	(5-6-1) TOPPERS_ROUND_SZ（オプション）
1320	(5-6-2) TOPPERS_COUNT_SZ（オプション）
1321
1322	TOPPERS_COUNT_SZ(sz, unit)は，sz/unitを切り上げた値を求めるマクロで，サ
1323	イズがszのメモリ領域をサイズがunitのデータ型の配列で確保する場合の要素
1324	数を求めるために用いる．TOPPERS_ROUND_SZ(sz, unit)は，sz/unitを切り上げ
1325	たものにunitをかけた値を求めるマクロで，サイズがszのメモリ領域をサイズ
1326	がunitのデータ型の配列で確保する場合のトータルサイズを求めるために用い
1327	る．
1328
1329	それぞれ，標準のTOPPERS_ROUND_SZ，TOPPERS_COUNT_SZが適切でなく，ターゲッ
1330	ト依存部で用意する場合には，これらのシンボルを適切な値にマクロ定義する．
1331
1332	5.7 オーバランハンドラ機能拡張のための定義（オプション）
1333
1334	オーバランハンドラ機能拡張パッケージをサポートする（使用できるようにす
1335	る）場合には，次の3つを実施することが必要である．
1336
1337	・この節で説明する定義を行う．
1338	・６章に示すコード中で，TOPPERS_SUPPORT_OVRHDRがマクロ定義されている場
1339	合にのみ有効となるコードを実装する．
1340	・オーバランタイマドライバを用意する．オーバランタイマドライバについて
1341	は，「6.14 オーバランタイマドライバ」の節を参照すること．
1342
1343	(5-7-1) TOPPERS_TARGET_SUPPORT_OVRHDR
1344
1345	オーバランハンドラ機能拡張パッケージをサポートする場合には，このシンボ
1346	ルをマクロ定義する．
1347
1348	(5-7-2) TMAX_OVRTIM（オプション，デフォルトはULONG_MAX）
1349
1350	プロセッサ時間としてオーバランタイマに設定できる最大値（単位はマイクロ
1351	秒）にマクロ定義する．
1352
1353
1354	６．カーネル実装のターゲット依存部
1355
1356	6.1 カーネル実装のターゲット依存部の共通事項
1357
1358	6.1.1 カーネル実装のターゲット依存部の構成要素
1359
1360	カーネル実装のターゲット依存部は，以下の要素で構成される．
1361
1362	(a) カーネル実装のターゲット依存の定義
1363
1364	カーネル実装のターゲット非依存部から参照されるターゲット依存の定義は，
1365	target_config.hまたはそこからインクルードされるファイル（プロセッサ・チッ
1366	プ・開発環境依存部で用意されるヘッダファイルなど）に含める．
1367
1368	ターゲットのハードウェア資源（割込みハンドラ番号やCPU例外ハンドラ番号，
1369	デバイスレジスタの番地など）の定義は，システムサービスやアプリケーショ
1370	ンにも有用であるため，カーネル実装のみに有用な定義を含むファイルとは切
1371	り分けて，独立したヘッダファイルに含める．このヘッダファイルの標準的な
1372	名称を，システム略称.h（または，チップ略称.h，プロセッサ略称.h）とする．
1373
1374	(b) カーネル実装のターゲット依存モジュール
1375
1376	カーネル実装のターゲット依存の変数定義や関数を含むモジュール．C言語で記
1377	述される部分をtarget_config.c，アセンブリ言語で記述される部分を
1378	target_support.Sに含める．プロセッサ・チップ・開発環境依存部を切り分け
1379	ることや，ファイルが大きくなる場合に複数のファイルに分割することも可能
1380	である．
1381
1382	(c) カーネル実装のターゲット依存部のためのリネーム記述
1383
1384	カーネル実装のターゲット依存部の変数名や関数名を，先頭に_kernel_を付与
1385	した名前にリネームするためのモジュール．target_rename.defを用意し，ツー
1386	ル（utils/genrename）により，target_rename.hとtarget_unrename.hを生成す
1387	る．プロセッサ・チップ・開発環境依存部を切り分ける場合には，リネーム記
1388	述も切り分ける．
1389
1390	(d) タイマドライバ
1391
1392	カーネルにタイムティックを通知する（signal_timeを周期的に呼び出す）ため
1393	のタイマドライバのヘッダファイル，実装ファイル，システムコンフィギュレー
1394	ションファイルを，それぞれ，target_timer.h，target_timer.c，
1395	target_timer.cfgに含める．プロセッサ・チップ・開発環境依存部を切り分け
1396	ることも可能である．
1397
1398	また，オーバランハンドラ機能拡張パッケージをサポートする場合には，オー
1399	バランハンドラを起動する（call_ovrhdrを呼び出す）ためのオーバランタイマ
1400	ドライバも，同じファイルに含める．
1401
1402	なお，この章に示すコード中で，TOPPERS_SUPPORT_OVRHDRがマクロ定義されて
1403	いる場合にのみ有効となるコードは，オーバランハンドラ機能拡張パッケージ
1404	をサポートしない場合には，実装する必要がない．
1405
1406	(e) コンフィギュレータ設定ファイル
1407
1408	コンフィギュレータの設定ファイルのターゲット依存部を，target_def.csv，
1409	target.tf，target_check.tfに用意する．コンフィギュレータ設定ファイルの
1410	記述方法については，７章で説明する．
1411
1412	6.1.2 ターゲット依存部の関数の命名規則
1413
1414	カーネル実装のターゲット依存部を構成する関数の中で，t_で始まるものはタ
1415	スクコンテキスト専用，i_で始まるものは非タスクコンテキスト専用，x_で始
1416	まるものはいずれのコンテキストからでも呼び出すことができる関数である．
1417
1418	6.2 トレースログ機能への対応
1419
1420	カーネルのトレースログ機能の中で，ディスパッチャ，割込みハンドラ，CPU例
1421	外ハンドラの開始・終了のトレースログ取得は，ターゲット依存部で実装する
1422	必要がある．ほとんどのターゲットシステムにおいて，それらの処理はアセン
1423	ブリ言語で記述されており，ターゲット非依存部向けのトレースログマクロと
1424	同じ方法（トレースログマクロを，トレースログ取得処理のC言語記述にマクロ
1425	定義する方法）は，用いることができない．
1426
1427	そこで，アセンブリ言語で記述されている処理中にトレースログ取得を埋め込
1428	む場合には，トレースログマクロが定義されていれば，それが何に定義されて
1429	いるかは無視して，標準的なトレースログ関数がC言語で記述されていると想定
1430	して，それを呼び出すようにコーディングする．
1431
1432	具体的には，下の表の左側に示したトレースログマクロが定義されていれば，
1433	表の右側に示したC言語記述と同等の処理を行うようにコーディングする．
1434
1435	トレースログマクロトレースログ取得処理
1436	-----------------------------------------------
1437	LOG_DSP_ENTER log_dsp_enter(p_runtsk)
1438	LOG_DSP_LEAVE log_dsp_leave(p_runtsk)
1439	LOG_INH_ENTER log_inh_enter(inhno)
1440	LOG_INH_LEAVE log_inh_leave(inhno)
1441	LOG_EXC_ENTER log_exc_enter(excno)
1442	LOG_EXC_LEAVE log_exc_leave(excno)
1443
1444	6.3 システム状態の管理
1445
1446	ASPカーネルを新たなターゲットシステムにポーティングする際に，最も重要な
1447	作業は，カーネルが定義するシステム状態を，ハードウェア（プロセッサ）上
1448	でどのように実現するかである．以下の説明は，TOPPERS新世代カーネルにおけ
1449	るシステム状態の定義・意味を知っていることを前提に記述している．
1450
1451	6.3.1 全割込みロック状態の管理
1452
1453	全割込みロック状態は，NMIを除くすべての割込みをマスクした状態である．全
1454	割込みロック状態を管理する機能は，システムインタフェースレイヤ（SIL）に
1455	よって提供され，カーネルは全割込みロック状態を管理しない．
1456
1457	全割込みロック状態では，sns_kerとext_ker以外のカーネルのサービスコール
1458	を呼ぶことはできないものとしており，呼んだ場合には何が起こるか保証して
1459	いない．sns_kerとext_kerから呼び出す処理は，トレースログ取得処理とSILの
1460	サービスコールを除くと，call_exit_kernelのみである．そのため，
1461	call_exit_kernelから呼び出すものを除いて，カーネルのターゲット依存部の
1462	関数が，全割込みロック状態で呼び出される状況は考える必要がない．
1463
1464	6.3.2 コンテキストの管理
1465
1466	処理単位が実行されるコンテキストは，タスクコンテキストと非タスクコンテ
1467	キストに分類される．
1468
1469	ターゲット依存部は，実行中の処理単位が，タスクコンテキストで実行されて
1470	いるか非タスクコンテキストで実行されているかを判別する機能を提供する．
1471	また，CPU例外が発生したコンテキストについて判別する機能を提供する．
1472
1473	ターゲット依存部では，割込みハンドラとCPU例外ハンドラの入口処理で非タス
1474	クコンテキストに切り換え，それらの出口処理で元のコンテキストに戻す．ま
1475	た，ディスパッチャの内部で一時的に非タスクコンテキストに切り換える．
1476
1477	(6-3-2-1) bool_t sense_context(void)
1478
1479	実行中の処理単位が，タスクコンテキストで実行されている場合にはfalse，非
1480	タスクコンテキストで実行されている場合にはtrueを返す関数．この関数は，
1481	CPUロック状態でもCPUロック解除状態でも呼び出せるように実装しなければな
1482	らない．
1483
1484	6.3.3 CPUロック状態の管理
1485
1486	ターゲット依存部は，CPUロック状態へ遷移する機能，CPUロック解除状態へ遷
1487	移する機能，CPUロック状態であるかを判別する機能を提供する．
1488
1489	(6-3-3-1) void t_lock_cpu(void)
1490	(6-3-3-2) void i_lock_cpu(void)
1491	(6-3-3-3) void x_lock_cpu(void)
1492
1493	CPUロック解除状態から，CPUロック状態へ遷移させる関数．これらの関数は，
1494	CPUロック状態で呼び出されることはなく，呼び出された場合の動作は保証する
1495	必要がない．
1496
1497	これらの関数を実現する際には，「1.6 クリティカルセクションの出入処理の
1498	実現に関する制約」の節に記述されている制約に従わなければならない．
1499
1500	(6-3-3-4) void t_unlock_cpu(void)
1501	(6-3-3-5) void i_unlock_cpu(void)
1502	(6-3-3-6) void x_unlock_cpu(void)
1503
1504	CPUロック状態から，CPUロック解除状態へ遷移させる関数．これらの関数は，
1505	CPUロック解除状態で呼び出されることはなく，呼び出された場合の動作は保証
1506	する必要がない．
1507
1508	タスクコンテキストでCPUロック状態に遷移した場合には，CPUロック解除状態
1509	に戻るのはタスクコンテキストに限られ，非タスクコンテキストでCPUロック解
1510	除状態に戻ることはない．言い換えると，t_unlock_cpuが呼び出されるのは，
1511	t_lock_cpuによってCPUロック状態になっている時である．i_lock_cpuによって
1512	CPUロック状態になっている時には，t_unlock_cpuが呼び出されることはない．
1513
1514	同様に，非タスクコンテキストでCPUロック状態に遷移した場合には，CPUロッ
1515	ク解除状態に戻るのは非タスクコンテキストに限られ，タスクコンテキストで
1516	CPUロック解除状態に戻ることはない．言い換えると，i_unlock_cpuが呼び出さ
1517	れるのは，i_lock_cpuによってCPUロック状態になっている時である．
1518	t_lock_cpuによってCPUロック状態になっている時には，i_unlock_cpuが呼び出
1519	されることはない．
1520
1521	これらの関数を実現する際には，「1.6 クリティカルセクションの出入処理の
1522	実現に関する制約」の節に記述されている制約に従わなければならない．
1523
1524	(6-3-3-7) bool_t t_sense_lock(void)
1525	(6-3-3-8) bool_t i_sense_lock(void)
1526	(6-3-3-9) bool_t x_sense_lock(void)
1527
1528	現在のシステム状態が，CPUロック状態の場合はtrue，CPUロック解除状態の場
1529	合にはfalseを返す関数．
1530
1531	これらの関数が全割込みロック状態で呼び出される状況は考える必要がないこ
1532	とから，全割込みロック状態とCPUロック状態を区別できる必要はない．NMI以
1533	外にカーネルの管理外の割込みを設けない場合には，全割込みロック状態と
1534	CPUロック状態が全く同一の状態でもかまわない．
1535
1536	6.4 割込みに関連するシステム状態の管理
1537
1538	6.4.1 割込み優先度マスクの管理
1539
1540	ターゲット依存部は，割込み優先度マスクを設定する機能と，割込み優先度マ
1541	スクを参照する機能を提供する．
1542
1543	(6-4-1-1) bool_t VALID_INTPRI_CHGIPM(PRI intpri)（オプション）
1544
1545	intpriが，chg_ipmに対する割込み優先度として有効な値である場合にtrue，そ
1546	うでない場合にfalseを返すマクロ．標準では，TMIN_INTPRI以上，TIPM_ENAALL
1547	（＝0）以下の値がchg_ipmに対する割込み優先度として有効であるが，ターゲッ
1548	ト依存部でこのマクロを定義することで，TMIN_INTPRIよりも小さい値を有効と
1549	することができる（有効な値の範囲を狭めてはならない）．
1550
1551	(6-4-1-2) void x_set_ipm(PRI intpri)
1552	(6-4-1-3) void t_set_ipm(PRI intpri)
1553	(6-4-1-4) void i_set_ipm(PRI intpri)
1554
1555	割込み優先度マスクの値をintpriに設定する関数．
1556
1557	これらの関数は，CPUロック状態でもCPUロック解除状態でも呼び出せるように
1558	実装するのが望ましい．ただし，x_set_ipmとt_set_ipmは，ターゲット非依存
1559	部がCPUロック解除状態で呼び出すことはないため，CPUロック解除状態で呼び
1560	出された場合の動作は保証する必要がない．i_set_ipmは，CPUロック状態でも
1561	CPUロック解除状態でも呼び出せるように実装しなければならない．
1562
1563	また，これらの関数は，VALID_INTPRI_CHGIPM(intpri)がtrueを返すintpriに対
1564	してのみ呼ばれる．intpriにそうでない値が渡された場合の動作は保証する必
1565	要がない．
1566
1567	(6-4-1-5) PRI x_get_ipm(void)
1568	(6-4-1-6) PRI t_get_ipm(void)
1569	(6-4-1-7) PRI i_get_ipm(void)
1570
1571	割込み優先度マスクの値を参照して返す関数．
1572
1573	これらの関数は，CPUロック状態でもCPUロック解除状態でも呼び出せるように
1574	実装するのが望ましい．ただし，x_get_ipmとt_get_ipmは，ターゲット非依存
1575	部がCPUロック解除状態で呼び出すことはないため，CPUロック解除状態で呼び
1576	出された場合の動作は保証する必要がない．i_get_ipmは，CPUロック状態でも
1577	CPUロック解除状態でも呼び出せるように実装しなければならない．
1578
1579	割込み優先度マスクを用いてカーネル管理の割込みをすべてマスクした状態は，
1580	CPUロック状態と区別できることが必要である．具体的には，CPUロック解除状
1581	態において，x_set_ipmを用いてカーネル管理の割込みをすべてマスクした場合
1582	でも，x_sense_lockはfalseを返す．
1583
1584	それに対して，割込み優先度マスクを用いてNMIを除くすべての割込みをマスク
1585	できる場合，その状態と全割込みロック状態を区別できる必要はなく，全く同
1586	一の状態でもかまわない．
1587
1588	6.4.2 割込み要求禁止フラグの管理
1589
1590	ターゲット依存部は，割込み要求禁止フラグをセットする機能とクリアする機
1591	能を提供する．
1592
1593	(6-4-2-1) bool_t VALID_INTNO_DISINT(INTNO intno)
1594
1595	intnoが，dis_int／ena_intに対する割込み番号として有効な値である場合に
1596	true，そうでない場合にfalseを返すマクロ．割込み要求禁止フラグがセット／
1597	クリアできないintnoに対しては，このマクロがfalseを返すようにする．
1598
1599	(6-4-2-2) bool_t x_disable_int(INTNO intno)
1600	(6-4-2-3) bool_t t_disable_int(INTNO intno)
1601	(6-4-2-4) bool_t i_disable_int(INTNO intno)
1602
1603	intnoで指定された割込み要求ラインに対する割込み要求禁止フラグをセットし，
1604	trueを返す関数．指定された割込み要求ラインに対して，割込み属性が設定さ
1605	れていない場合には，falseを返す．
1606
1607	これらの関数は，ターゲット非依存部がCPUロック解除状態で呼び出すことはな
1608	いため，CPUロック解除状態で呼び出された場合の動作は保証する必要がない．
1609	ただし，ターゲット依存部からCPUロック解除状態で呼び出す場合には，保証す
1610	る必要がある．
1611
1612	また，これらの関数は，VALID_INTNO_DISINT(intno)がtrueとなるintnoに対し
1613	てのみ呼ばれる．intnoにそうでない値が渡された場合の動作は保証する必要が
1614	ない．
1615
1616	dis_intサービスコールをサポートする場合（TOPPERS_SUPPORT_DIS_INTをマク
1617	ロ定義する場合）には，t_disable_intが用意されていなければならない．
1618
1619	(6-4-2-5) bool_t x_enable_int(INTNO intno)
1620	(6-4-2-6) bool_t t_enable_int(INTNO intno)
1621	(6-4-2-7) bool_t i_enable_int(INTNO intno)
1622
1623	intnoで指定された割込み要求ラインに対する割込み要求禁止フラグをクリアし，
1624	trueを返す関数．指定された割込み要求ラインに対して，割込み属性が設定さ
1625	れていない場合には，falseを返す．
1626
1627	これらの関数は，ターゲット非依存部がCPUロック解除状態で呼び出すことはな
1628	いため，CPUロック解除状態で呼び出された場合の動作は保証する必要がない．
1629	ただし，ターゲット依存部からCPUロック解除状態で呼び出す場合には，保証す
1630	る必要がある．
1631
1632	また，これらの関数は，VALID_INTNO_DISINT(intno)がtrueとなるintnoに対し
1633	てのみ呼ばれる．intnoにそうでない値が渡された場合の動作は保証する必要が
1634	ない．
1635
1636	ena_intサービスコールをサポートする場合（TOPPERS_SUPPORT_ENA_INTをマク
1637	ロ定義する場合）には，t_enable_intが用意されていなければならない．
1638
1639	6.4.3 割込み要求のクリア
1640
1641	(6-4-3-1) void x_clear_int(INTNO intno)
1642	(6-4-3-2) void t_clear_int(INTNO intno)
1643	(6-4-3-3) void i_clear_int(INTNO intno)
1644
1645	intnoで指定された割込み要求ラインがエッジトリガである場合に，トリガされ
1646	た割込み要求をクリアする関数．intnoで指定された割込み要求ラインがレベル
1647	トリガである場合には何もしない．
1648
1649	ASPカーネルのターゲット非依存部では，これらの関数を呼び出していないが，
1650	ターゲット依存部やシステムサービスで呼び出す可能性が高いため，用意する
1651	こととしている．そのため，これらの関数がどのようなシステム状態で呼び出
1652	せるかは，ターゲット依存部内で一貫していればよい．
1653
1654	6.4.4 割込み要求のプローブ
1655
1656	(6-4-4-1) bool_t x_probe_int(INTNO intno)
1657	(6-4-4-2) bool_t t_probe_int(INTNO intno)
1658	(6-4-4-3) bool_t i_probe_int(INTNO intno)
1659
1660	intnoで指定された割込み要求ラインに対して，割込みが要求されている場合に
1661	true，そうでない場合にfalseを返す関数．
1662
1663	ASPカーネルのターゲット非依存部では，これらの関数を呼び出していないが，
1664	ターゲット依存部やシステムサービスで呼び出す可能性が高いため，用意する
1665	こととしている．そのため，これらの関数がどのようなシステム状態で呼び出
1666	せるかは，ターゲット依存部内で一貫していればよい．
1667
1668	6.4.5 割込みハンドラの先頭処理と末尾処理
1669
1670	(6-4-5-1) void i_begin_int(INTNO intno)
1671
1672	intnoで指定された割込み要求ラインに対する割込みハンドラの先頭で行うべき
1673	処理を行う関数．ここで行うべき処理としては，割込み要求ラインがエッジト
1674	リガである場合のトリガされた割込み要求のクリアが挙げられる．
1675
1676	intnoに対して登録された割込みサービスルーチンを呼び出す割込みハンドラの
1677	先頭で呼び出される．そのためこの関数は，割込みハンドラの先頭（通常は
1678	CPUロック解除状態）で呼び出せるように実装しなければならない．
1679
1680	(6-4-5-2) void i_end_int(INTNO intno)
1681
1682	intnoで指定された割込み要求ラインに対する割込みハンドラの末尾で行うべき
1683	処理を行う関数．ここで行うべき処理としては，割込みコントローラ（IRC）に
1684	対する割込み処理の終了通知が挙げられる．
1685
1686	intnoに対して登録された割込みサービスルーチンを呼び出す割込みハンドラの
1687	末尾で呼び出される．そのためこの関数は，割込みハンドラの末尾（通常は
1688	CPUロック解除状態）で呼び出せるように実装しなければならない．
1689
1690	ターゲットによっては，IRCに対する割込み処理の終了通知を行う前に，すべて
1691	の割込みを禁止しなければならない場合がある．この場合には，この関数の中
1692	で割込みを禁止し，その状態のまま，割込みハンドラからリターンする．割込
1693	みハンドラからのリターン前には，割込み禁止を解除するのが原則であるが，
1694	割込みハンドラの出口処理で元に戻す処理を行うので差し支えないはずである．
1695	割込みハンドラの出口処理が，これで差し支えない実装になっていることを確
1696	認するべきである．
1697
1698	6.5 タスクディスパッチャ
1699
1700	6.5.1 タスクコンテキストブロックとタスク初期化コンテキストブロック
1701
1702	(6-5-1-1) TSKCTXB
1703
1704	ターゲット依存のタスクコンテキストを保存するために，TCB中に持つことが必
1705	要なデータ構造の型を，TSKCTXBに定義する．標準的には，TSKCTXBには，タス
1706	クのスタックポインタと実行再開番地を格納する．
1707
1708	(6-5-1-2) USE_TSKINICTXB（オプション）
1709	(6-5-1-3) TSKINICTXB（オプション）
1710
1711	ターゲット依存の情報をタスク初期化ブロック（TINIB）に入れたい場合や，
1712	TINIB中のスタック領域のサイズと先頭番地の持ち方をターゲット依存に変更し
1713	たい場合には，USE_TSKINICTXBをマクロ定義し，TINIB中に持つことが必要なデー
1714	タ構造の型を，TSKINICTXBに定義する．
1715
1716	USE_TSKINICTXBをマクロ定義すると，TINIB中にスタック領域とサイズと先頭番
1717	地が含まれなくなるため，それに代わる情報をTSKINICTXB中に持つ必要がある．
1718	また，コンフィギュレータのパス2のテンプレートファイルのターゲット非依存
1719	部で，TSKINICTXBの初期化情報を生成するためのGENERATE_TSKINICTXBを，パス
1720	3のテンプレートファイルのターゲット非依存部で，TINIBからスタック領域の
1721	先頭番地を取り出すためのGET_STK_TSKINICTXBを定義する必要がある．
1722
1723	6.5.2 ディスパッチャ本体
1724
1725	ディスパッチャ本体（dispatcher）は，ターゲット非依存部から直接呼び出さ
1726	れることはなく，カーネルのターゲット依存部の内部からのみ呼び出される．
1727	dispatcherは，タスクコンテキスト・CPUロック状態・割込み優先度マスク全解
1728	除状態・ディスパッチ許可状態で呼び出される．
1729
1730	dispatcherの処理内容は次の通り．
1731
1732	----------------------------------------
1733	void
1734	dispatcher(void)
1735	{
1736	#ifdef LOG_DSP_ENTER
1737	log_dsp_enter(p_runtsk);
1738	#endif /* LOG_DSP_ENTER */
1739	dispatcher_0:
1740	while ((p_runtsk = p_schedtsk) == NULL) {
1741	割込みを許可したらCPUロック解除状態になるよう準備する
1742	非タスクコンテキストに切り換える … (*1)
1743	do {
1744	割込みをすべて許可し，割込み発生を待つ … (*2)
1745	割込み許可前の状態に戻す（＝カーネル管理の割込みを禁止する）
1746	} while (!reqflg);
1747	reqflg = false;
1748	タスクコンテキストに戻す … (*1)
1749	CPUロック状態に戻す ... (*3)
1750	}
1751	自タスク（p_runtsk）のTCBからスタックポインタを復帰する
1752	#ifdef LOG_DSP_LEAVE
1753	log_dsp_leave(p_runtsk);
1754	#endif /* LOG_DSP_LEAVE */
1755	自タスクのTCBから実行再開番地を復帰し，そこへ分岐する … (*a)
1756	}
1757	----------------------------------------
1758
1759	割込み発生を待つ間に非タスクコンテキストに切り換えるのは，この間に実行
1760	される割込みハンドラ内で，タスクディスパッチをしないようにするためであ
1761	る．この時，割込みハンドラが，非タスクコンテキスト用のスタックを使うよ
1762	うにしなければならない．通常は，非タスクコンテキストに切り換える際に非
1763	タスクコンテキスト用のスタックに切り換え，タスクコンテキストに戻す際に
1764	元のスタックに切り換える．
1765
1766	ターゲットによっては（特に，シミュレーション環境の場合），強制的に非タ
1767	スクコンテキストに切り換えることが難しい場合がある．その場合には，この
1768	間に実行される割込みハンドラ内でタスクディスパッチをしないような仕組み
1769	を実装することで，非タスクコンテキストへの切換えを省略することができる．
1770
1771	(*1)の非タスクコンテキストに切り換える処理とタスクコンテキストに戻す処
1772	理は，doループの中で行ってもよい（ターゲットによっては，割込みの許可／
1773	禁止とまとめて処理した方が効率が良い）．
1774
1775	(*2)において，割込みを許可する処理と，割込み発生を待つ処理とは，不可分
1776	に行なう必要がある．これを不可分に行なわない場合，割込みを許可した直後
1777	に割込みが入り，その中でタスクが実行可能状態になると，実行すべきタスク
1778	があるにもかかわらずプロセッサが割込み待ちになってしまう．
1779
1780	また，(*2)において，割込み発生を待つ命令が用意されていない場合や，それ
1781	を発行するのが不都合な場合には，割込みをすべて許可して割込みを受け付け
1782	られる状態になった後に，割込み発生を待たずに次に進んでもよい．この場合，
1783	その外側のdoループによって，割込み発生を待つことになる．
1784
1785	CPUロックを解除するための情報（例えば，CPUロック前の割込み優先度マスク）
1786	を変数に保持している場合には，(*3)でCPUロック状態に戻す際に，その変数の
1787	値も元に戻っている必要がある．特に，その変数が，割込み待ちの間に実行し
1788	た割込みハンドラ内で書き換えられる場合は，元の値に戻すことが必要である．
1789
1790	割込み待ちの間は，p_runtskをNULL（＝0）に設定しなければならない（上の処
1791	理内容をそのまま実装すればこうなる）．このように設定しないと，割込みハ
1792	ンドラからiget_tidを呼び出した際の動作が仕様に合致しなくなる．
1793
1794	dispatcherをアセンブリ言語で記述する場合には，トレースログ取得処理は，
1795	「6.2 トレースログ機能への対応」の節で記述した方法でコーディングするこ
1796	と．なお，log_dsp_enterは切換え前のタスクのスタックで，log_dsp_leave は
1797	切換え後のタスクのスタックで実行する．
1798
1799	6.5.3 タスクコンテキストからのディスパッチ
1800
1801	(6-5-3-1) void dispatch(void)
1802	(6-5-3-2) OMIT_CALLTEX（オプション）
1803
1804	タスクコンテキストからのディスパッチ（dispatch）は，タスクコンテキスト
1805	用のサービスコール処理においてタスク切換えが必要になった場合に，ターゲッ
1806	ト非依存部のサービスコール処理関数から呼び出される．
1807
1808	dispatchは，タスクコンテキスト・CPUロック状態・割込み優先度マスク全解除
1809	状態・ディスパッチ許可状態で呼び出される．
1810
1811	dispatchの処理内容は次の通り．
1812
1813	----------------------------------------
1814	void
1815	dispatch(void)
1816	{
1817	#ifdef TOPPERS_SUPPORT_OVRHDR
1818	ovrtimer_stop(); /* オーバランタイマの停止 */
1819	#endif /* TOPPERS_SUPPORT_OVRHDR */
1820	スクラッチレジスタ(*)を除くすべてのレジスタをスタックに保存する
1821	スタックポインタを自タスク（p_runtsk）のTCBに保存する
1822	dispatch_rを，実行再開番地として自タスクのTCBに保存する … (*a)
1823	dispatcherに分岐する
1824
1825	dispatch_r:
1826	スクラッチレジスタを除くすべてのレジスタをスタックから復帰する
1827	#ifdef TOPPERS_SUPPORT_OVRHDR
1828	ovrtimer_start(); /* オーバランタイマの動作開始 */
1829	#endif /* TOPPERS_SUPPORT_OVRHDR */
1830	calltex(); … (*b)
1831	}
1832	----------------------------------------
1833
1834	ここでスクラッチレジスタ(*)とは，関数呼出しにより保存されないレジスタの
1835	ことである．必要な場合には，関数を呼び出す側で保存しなければならないた
1836	め，caller saved registerと呼ばれる場合もある．
1837
1838	dispatchを呼び出したタスクが次に実行される時には，実行再開番地として登
1839	録したdispatch_rに戻ってくる．dispatch_rには，dispatcherのみから分岐し，
1840	その時の状態は，タスクコンテキスト・CPUロック状態・割込み優先度マスク全
1841	解除状態・ディスパッチ許可状態である．
1842
1843	(*b)でcalltexを呼ぶ代わりに，calltexの処理内容（p_runtsk->enatexがtrue
1844	で，p_runtsk->texptnが0でなく，ipmflgがtrueの場合に，call_texrtnを呼ぶ）
1845	をここにインライン展開した方が効率がよい．ターゲット非依存部のcalltexを
1846	使わない場合には，OMIT_CALLTEXをマクロ定義することで，ターゲット非依存
1847	部からcalltexを取り除くことができる．
1848
1849	6.5.4 ディスパッチャの動作開始
1850
1851	(6-5-4-1) void start_dispatch(void)
1852
1853	ディスパッチャの動作開始（start_dispatch）は，カーネル起動時に，カーネ
1854	ルの初期化処理から呼び出される．start_dispatchは，リターンすることのな
1855	い関数である．
1856
1857	start_dispatchは，非タスクコンテキストで，NMIを除くすべての割込みをマス
1858	クした状態（全割込みロック状態と同等の状態）で呼び出される．start_dispatch
1859	内で，タスクコンテキストに切り換え，CPUロック状態・割込み優先度マスク全
1860	解除状態にしなければならない．
1861
1862	start_dispatchの処理内容は次の通り．
1863
1864	----------------------------------------
1865	void
1866	start_dispatch(void)
1867	{
1868	タスクコンテキストに切り換える
1869	CPUロック状態・割込み優先度マスク全解除状態にする
1870	dispatcher_0に分岐する
1871	}
1872	----------------------------------------
1873
1874	6.5.5 現在のコンテキストを捨ててディスパッチ
1875
1876	(6-5-5-1) void exit_and_dispatch(void)
1877
1878	現在のコンテキストを捨ててディスパッチ（exit_and_dispatch）は，自タスク
1879	を終了させるサービスコール処理関数から呼び出される．exit_and_dispatchは，
1880	リターンすることのない関数である．
1881
1882	exit_and_dispatchは，タスクコンテキスト・CPUロック状態・割込み優先度マ
1883	スク全解除状態・ディスパッチ許可状態で呼び出される．
1884
1885	exit_and_dispatchの処理内容は次の通り．
1886
1887	----------------------------------------
1888	void
1889	exit_and_dispatch(void)
1890	{
1891	dispatcherに分岐する
1892	}
1893	----------------------------------------
1894
1895	6.5.6 タスクの起動処理
1896
1897	(6-5-6-1) void activate_context(TCB *p_tcb)
1898
1899	タスクの起動処理（activate_context）は，タスクを休止状態から実行できる
1900	状態にする時に呼ばれ，p_tcbで指定されたタスク（対象タスク）のTCB中のス
1901	タックポインタを初期化し，実行再開番地をタスク開始時処理（start_r）に設
1902	定する．この時点では，後述する理由で，対象タスクのスタック領域を使って
1903	はならない．
1904
1905	対象タスクが最初に実行される時には，対象タスクを自タスクとして，実行再
1906	開番地として登録したstart_rに分岐してくる．start_rには，dispatcherのみ
1907	から分岐し，その時の状態は，タスクコンテキスト・CPUロック状態・割込み優
1908	先度マスク全解除状態・ディスパッチ許可状態である．
1909
1910	start_rは，CPUロック状態を解除した後，タスクの起動番地を呼び出す．さら
1911	に，タスクの起動番地から戻ってきた場合には，ext_tskを呼び出す．
1912
1913	activate_contextとstart_rの処理内容は次の通り．
1914
1915	----------------------------------------
1916	void
1917	activate_context(TCB *p_tcb)
1918	{
1919	指定されたタスク（p_tcb）のTCB中のスタックポインタを初期化する
1920	start_rを，実行再開番地として自タスクのTCBに保存する … (*a)
1921	return;
1922
1923	start_r:
1924	#ifdef TOPPERS_SUPPORT_OVRHDR
1925	ovrtimer_start(); /* オーバランタイマの動作開始 */
1926	#endif /* TOPPERS_SUPPORT_OVRHDR */
1927	CPUロック解除状態にする
1928	自タスク（p_runtsk）の起動番地を，拡張情報をパラメータとして呼び出す
1929	ext_tskに分岐する ... (*c)
1930	}
1931	----------------------------------------
1932
1933	(*c)でext_tskを呼ぶ代わりに，自タスクの起動番地を呼び出す時の返り番地を
1934	ext_tskの番地としておく方法がある．
1935
1936	ここで，タスクの起動処理において対象タスクのスタック領域を使ってはなら
1937	ない理由は，次の通り．制約タスク拡張パッケージにおいて，複数の制約タス
1938	クがスタック領域を共有している場合に，タスクの起動時点では，そのタスク
1939	とスタック領域を共有しているタスクが，スタック領域を使用している可能性
1940	があるためである．
1941
1942	このポーティングガイドでは，タスクの実行再開番地をTCBに保存している
1943	(*a)。これをスタックに保存する方法も考えられるが，タスクの起動処理でス
1944	タック領域が使えないことから，タスクの起動処理だけは例外扱いしなければ
1945	ならない．例えば，タスクの起動処理においてはTCB中のスタックポインタを特
1946	殊な値（例えば0）に設定しておき，ディスパッチャ本体でTCB中のスタックポ
1947	インタがその値の場合にはstart_rに分岐させ，start_rにおいてスタックポイ
1948	ンタを初期化する方法が考えられる．
1949
1950	6.6 割込みハンドラ
1951
1952	6.6.1 割込みハンドラの出入口処理
1953
1954	カーネル管理の割込みの出入口処理の方法は，プロセッサによって大きく異な
1955	るが，おおよその処理内容は次の通り．
1956
1957	----------------------------------------
1958	void
1959	<割込みの出入口処理>(void)
1960	{
1961	少なくともカーネル管理の割込みを禁止した状態にする … (*f)
1962	スクラッチレジスタをスタックに保存する
1963	if (タスクコンテキストで割込み発生) {
1964	#ifdef TOPPERS_SUPPORT_OVRHDR
1965	ovrtimer_stop(); /* オーバランタイマの停止 */
1966	#endif /* TOPPERS_SUPPORT_OVRHDR */
1967	スタックを非タスクコンテキスト用のスタックに切り換え，
1968	非タスクコンテキストに切り換える
1969	}
1970	割込み優先度マスクを，受け付けた割込み要求の割込優先度に設定し，
1971	CPUロック解除状態にする（受け付けた割込みよりも
1972	優先度の高い割込みを受け付けるようにする）… (*i)
1973
1974
1975	#ifdef LOG_INH_ENTER
1976	log_inh_enter(割込みハンドラ番号);
1977	#endif /* LOG_INH_ENTER */
1978	割込みハンドラを呼び出す
1979	#ifdef LOG_INH_LEAVE
1980	log_inh_leave(割込みハンドラ番号);
1981	#endif /* LOG_INH_LEAVE */
1982
1983	ret_int:
1984	if (タスクコンテキストで割込み発生) {
1985	（少なくとも）カーネル管理の割込みを禁止した状態にする … (*d)
1986	スタックをタスク用のスタックに戻し，タスクコンテキストに切り換える
1987	… (*g)
1988	if (reqflg) {
1989	reqflg = false;
1990	CPUロック状態にする … (*e)
1991	割込み優先度マスクを，全解除状態（TIPM_ENAALL）に設定する … (*h)
1992	if (dspflg && p_runtsk != p_schedtsk) {
1993	スクラッチレジスタを除くすべてのレジスタをスタックに保存する
1994	スタックポインタを自タスク（p_runtsk）のTCBに保存する
1995	ret_int_rを，実行再開番地として自タスクのTCBに保存する … (*a)
1996	dispatcherに分岐する
1997
1998	ret_int_r:
1999	スクラッチレジスタを除くすべてのレジスタをスタックから復帰する
2000	}
2001	#ifdef TOPPERS_SUPPORT_OVRHDR
2002	ovrtimer_start(); /* オーバランタイマの動作開始 */
2003	#endif /* TOPPERS_SUPPORT_OVRHDR */
2004	calltex(); … (*b)
2005	}
2006	#ifdef TOPPERS_SUPPORT_OVRHDR
2007	else {
2008	ovrtimer_start(); /* オーバランタイマの動作開始 */
2009	}
2010	#endif /* TOPPERS_SUPPORT_OVRHDR */
2011	}
2012	割込み処理からのリターン後に，割込み優先度マスクが
2013	割込み処理前の値に戻るように準備する
2014	割込み処理からのリターン後に，CPUロック解除状態に戻るように準備する
2015	スクラッチレジスタをスタックから復帰する
2016	割込み処理からのリターン
2017	}
2018	----------------------------------------
2019
2020	割込みの受付けにより，スタックポインタが切り換わらず，すべての割込みが
2021	禁止されないプロセッサでは，(*f)において，少なくともカーネル管理の割込
2022	みを禁止する．この理由は次の通りである．
2023
2024	割込みの入口処理において，スタックを非タスクコンテキスト用のスタックに
2025	切り換える前に多重割込みが発生すると，タスクのスタック領域が使用される．
2026	上記のようなプロセッサでは，スタックの切換え前に，最大で割込み優先度の
2027	段数分の多重割込みが発生することを防ぐことはできず，各タスクのスタック
2028	領域を確保する際に，その分を見込んで確保しなければならない．各タスクの
2029	スタック領域をなるべく小さくするためには，スタックをなるべく使用しない
2030	内に，多重割込みを禁止するのが望ましい．そのため，スクラッチレジスタを
2031	スタックに保存する前に，割込みを禁止する．ただし，割込みの禁止処理に必
2032	要な最低限のレジスタについては，割込みの禁止に先立ってスタックに保存す
2033	る必要がある．
2034
2035	同様のことは，カーネル管理外の割込みにも当てはまる．すなわち，カーネル
2036	管理外の割込みについても，スタックをなるべく使用しない内に禁止するのが
2037	望ましい．このことから，カーネル管理外の割込みを使用する場合には，(*f)
2038	において，すべての割込みを禁止した状態にするのが望ましいことになる．一
2039	方で，カーネル管理外の割込みの禁止時間が長くなると，カーネル管理外の割
2040	込みの応答性が低下するため，ユーザに注意を促す必要がある．また，カーネ
2041	ル管理外の割込み処理においても，非タスクコンテキスト用のスタック（また
2042	は，カーネル管理外の割込み処理用のスタック）に切り換えることが望ましい
2043	が，これはカーネルの管轄外である．
2044
2045	(*i)に含まれる割込み優先度マスクを設定する処理は，プロセッサがハードウェ
2046	アで実現している場合も多い．
2047
2048	(*d)においては，カーネル管理の割込みを禁止するだけで，CPUロック状態にす
2049	る必要はない．例えば，CPUロック状態であることを示す変数を用意している場
2050	合には，(*d)の時点ではその変数をCPUロック状態を示す値に変更する必要はな
2051	く，(*e)において変更すればよい．
2052
2053	(*g)においてタスクコンテキストに切り換える処理は，割込み処理からのリター
2054	ンによりスタックとコンテキストが元に戻るプロセッサでは，reqflgがtrueの
2055	場合にのみ行えばよい．reqflgがfalseの時は，非タスクコンテキストのまま処
2056	理を続け，割込み処理からのリターンでタスクコンテキストに戻ることになる．
2057
2058	(e)においてCPUロック状態にするのは，dispatcherに分岐する際と，(b)にお
2059	いてcalltex（または，それを展開した場合にはcall_texrtn）を呼び出す際に，
2060	CPUロック状態になっている必要があるためである．
2061
2062	(*h)の処理が実行されるのは，割込み処理前に割込み優先度マスクが全解除状
2063	態（TIPM_ENAALL）であった場合に限られ，ここで割込み優先度マスクを全解除
2064	状態に設定するのは，割込み処理前の値に戻すのと等価である．ここでこの処
2065	理を行うのは，dispatcherに分岐する際と，(*b)においてcalltex（または，そ
2066	れを展開した場合にはcall_texrtn）を呼び出す際には，割込み優先度マスク全
2067	解除状態になっている必要があるためである．
2068
2069	タスクの実行中に割込みが発生し，上の処理中でdispatcherに分岐した場合，
2070	そのタスクが次に実行される時には，実行再開番地として登録したret_int_rに
2071	戻ってくる．ret_int_rには，dispatcherのみから分岐し，その時の状態は，タ
2072	スクコンテキスト・CPUロック状態・割込み優先度マスク全解除状態・ディスパッ
2073	チ許可状態である．
2074
2075	割込みの出入口処理をアセンブリ言語で記述する場合には，トレースログ取得
2076	処理は，「6.2 トレースログ機能への対応」の節で記述した方法でコーディン
2077	グすること．
2078
2079	6.6.2 割込みハンドラ毎の出入口処理の生成
2080
2081	割込みベクトルをハードウェアで実現している場合など，割込みハンドラ毎に
2082	出入口処理を用意した方が効率が良いターゲットのために，割込みハンドラ毎
2083	に出入口処理を生成する機構を用意している．
2084
2085	以下のマクロは，標準の割込み管理機能の初期化処理を用いた場合のみ，ター
2086	ゲット非依存部で使われる．割込み管理機能の初期化処理をターゲット依存部
2087	で用意し，その中でこれらのマクロを使わない場合には，これらのマクロを用
2088	意する必要はない．
2089
2090	(6-6-2-1) INT_ENTRY(inhno, inthdr)
2091
2092	割込みハンドラ番号がinhno，割込みハンドラの関数名がinthdrである割込みハ
2093	ンドラの出入口処理のラベルを作るマクロ．INTHDR_ENTRYを用いて割込みハン
2094	ドラ毎に出入口処理を生成する場合には，次のように定義する．
2095
2096	#define INT_ENTRY(inhno, inthdr) _kernel_##inthdr##_##inhno
2097
2098	割込みハンドラ毎に出入口処理を作る必要がない場合には，次のように定義し
2099	て，割込みハンドラの関数名をそのまま返す．
2100
2101	#define INT_ENTRY(inhno, inthdr) inthdr
2102
2103	(6-6-2-2) INTHDR_ENTRY(inhno, inhno_num, inthdr)
2104
2105	割込みハンドラ番号がinhno，割込みハンドラの関数名がinthdrである割込みハ
2106	ンドラの出入口処理を生成するマクロ．inhno_numには，アセンブリ言語記述用
2107	に，割込みハンドラ番号が数値で渡される．割込みハンドラ毎に出入口処理を
2108	作る必要がない場合には，空に定義する．
2109
2110	6.6.3 割込みハンドラの設定
2111
2112	(6-6-3-1) bool_t VALID_INHNO_DEFINH(INHNO inhno)（オプション）
2113
2114	inhnoが，DEF_INHに対する割込みハンドラ番号として有効な値である場合に
2115	true，そうでない場合にfalseを返すマクロ．
2116
2117	ASPカーネルのターゲット非依存部では，このマクロは使われていないため，ター
2118	ゲット依存部で使わないなら，用意する必要がない．
2119
2120	(6-6-3-2) void x_define_inh(INHNO inhno, FP int_entry)
2121
2122	inhnoで指定された割込みハンドラの出入口処理の番地をint_entryに設定する．
2123
2124	この関数は，標準の割込み管理機能の初期化処理を用いた場合のみ，ターゲッ
2125	ト非依存部から呼び出される．割込み管理機能の初期化処理をターゲット依存
2126	部で用意し，その中でこの関数を呼び出さない場合には，この関数を用意する
2127	必要はない．
2128
2129	この関数は，ターゲット非依存部のカーネル初期化処理から呼び出されるため，
2130	カーネルの初期化処理（NMIを除くすべての割込みがマスクされている）から呼
2131	び出せるように実装すればよい．
2132
2133	指定された割込みハンドラ番号がDEF_INHに対するものとして有効な値でない場
2134	合の動作は保証する必要がない（assertでエラーとするのが望ましい）．これ
2135	は，コンフィギュレータが，パス2のテンプレートファイルのターゲット依存部
2136	で定義するINHNO_DEFINH_VALIDを用いてエラーを検出するためである．
2137
2138	6.6.4 割込み要求ラインの属性の設定
2139
2140	(6-6-4-1) bool_t VALID_INTNO_CFGINT(INTNO intno)（オプション）
2141
2142	intnoが，割込み番号として有効な値である場合にtrue，そうでない場合に
2143	falseを返すマクロ．CFG_INTには，すべての割込み番号を指定することができ
2144	るため，このマクロは，intnoが有効な値の場合にはtrue，intnoが無効の値の
2145	場合にはfalseを返すようにする．
2146
2147	ASPカーネルのターゲット非依存部では，このマクロは使われていないため，ター
2148	ゲット依存部で使わないなら，用意する必要がない．
2149
2150	(6-6-4-2) void x_config_int(INTNO intno, ATR intatr, PRI intpri)
2151
2152	intnoで指定された割込み要求ラインの割込み属性を，intatrで指定された通り
2153	に設定する．また，割込み優先度を，intpriで指定された値に設定する．
2154
2155	この関数は，標準の割込み管理機能の初期化処理を用いた場合のみ，ターゲッ
2156	ト非依存部から呼び出される．割込み管理機能の初期化処理をターゲット依存
2157	部で用意し，その中でこの関数を呼び出さない場合には，この関数を用意する
2158	必要はない．
2159
2160	この関数は，ターゲット非依存部のカーネル初期化処理から呼び出されるため，
2161	カーネルの初期化処理（NMIを除くすべての割込みがマスクされている）から呼
2162	び出せるように実装すればよい．
2163
2164	intatrとして設定できる割込み属性は次の通り．
2165
2166	TA_ENAINT 0x01 割込み要求禁止フラグをクリア
2167	TA_EDGE 0x02 エッジトリガ
2168
2169	この他に，ターゲット定義で割込み属性を追加してもよい．ターゲット定義で
2170	追加するために，以下の属性名が予約されている．
2171
2172	TA_POSEDGE ポジティブエッジトリガ
2173	TA_NEGEDGE ネガティブエッジトリガ
2174	TA_BOTHEDGE 両エッジトリガ
2175	TA_LOWLEVEL ローレベルトリガ
2176	TA_HIGHLEVEL ハイレベルトリガ
2177
2178	これらの属性名をターゲット定義で追加する場合には，その属性値を決定し，
2179	定義をtarget_kernel.h（または，そこからインクルードされるファイル）に含
2180	める．また，コンフィギュレータテンプレートファイルから参照できるように，
2181	target_def.csv（または，同等の役割を持つファイル）に含め，コンフィギュ
2182	レータテンプレートファイルのターゲット非依存部でエラーとならないように，
2183	target.tf（または，そこからインクルードされるファイル）でTARGET_INTATR
2184	に設定する．
2185
2186	指定された割込み番号が有効な値でない場合や，その割込み要求ラインに対し
2187	て設定できない属性を指定した場合，設定できない割込み優先度を指定した場
2188	合の動作は保証する必要がない（assertでエラーとするのが望ましい）．この
2189	ようなケースは，コンフィギュレータでエラーを検出すべきである．コンフィ
2190	ギュレータテンプレートファイルのターゲット非依存部は，パス2のテンプレー
2191	トファイルのターゲット依存部で定義するINTNO_CFGINT_VALID，
2192	TARGET_INTATR，INTPRI_CFGINT_VALIDを用いてエラーを検出するが，標準の割
2193	込み属性（TA_ENAINT，TA_EDGE）が設定できない場合や，設定できない属性や
2194	割込み優先度が割込み要求ラインによって異なる場合には，コンフィギュレー
2195	タテンプレートファイルのターゲット依存部で検出しなければならない．
2196
2197	6.6.5 割込み管理機能の初期化処理の変更
2198
2199	(6-6-5-1) OMIT_INITIALIZE_INTERRUPT（オプション）
2200
2201	割込み管理機能の初期化処理をターゲット依存部で用意し，ターゲット非依存
2202	部に含まれる標準の割込み管理機能の初期化処理を用いない場合には，このシ
2203	ンボルをマクロ定義する．
2204
2205	このシンボルをマクロ定義すると，INHINIB，INTINIB，initialize_interrupt
2206	の定義が，カーネルのターゲット非依存部から取り除かれる．また，
2207	TNUM_INHNO，tnum_inhno，inhinib_table，TNUM_INTNO，tnum_intno，
2208	intinib_tableの定義と，割込みハンドラ毎の出入口処理を生成するための記述
2209	（INTHDR_ENTRYマクロのリスト）が，コンフィギュレータのパス2のテンプレー
2210	トファイルのターゲット非依存部によってkernel_cfg.cに生成されなくなる．
2211	ただし，コンフィギュレータのパス2のテンプレートファイルのターゲット依存
2212	部で，USE_INHINIB_TABLEとUSE_INTINIB_TABLEを設定することで，その一部
2213	分をkernel_cfg.cに生成することが可能である．
2214
2215	(6-6-5-2) void initialize_interrupt(void)（オプション）
2216
2217	OMIT_INITIALIZE_INTERRUPTをマクロ定義した場合には，この関数をターゲット
2218	依存部で用意する．OMIT_INITIALIZE_INTERRUPTをマクロ定義することにより取
2219	り除かれるその他のデータ型，変数，マクロは，この関数で使用する場合にの
2220	み用意すればよい．
2221
2222	6.6.6 デフォルトの割込みハンドラ
2223
2224	(6-6-6-1) void default_int_handler(void)（オプション）
2225
2226	コンフィギュレータにより割込みハンドラのテーブルを生成する場合などには，
2227	割込みハンドラを登録しなかった割込みハンドラ番号に対して，デフォルトの
2228	割込みハンドラとして，default_int_handlerを登録する．
2229
2230	default_int_handlerは，標準のものをターゲット依存部で用意するが，ユーザ
2231	が用意したもので置き換えられるように，OMIT_DEFAULT_INT_HANDLERをマクロ
2232	定義した場合には，ターゲット依存部で定義しないようにする．なお，ユーザ
2233	が用意する場合の名称は，_kernel_default_int_handlerとなる．
2234
2235	6.6.7 カーネル管理外の割込み
2236
2237	カーネル管理外の割込みハンドラは，カーネル内の割込み出入口処理を経由せ
2238	ずに実行するのが基本である．
2239
2240	ただし，すべての割込みで同じアドレスに分岐するプロセッサでは，カーネル
2241	内の割込み出入口処理を全く経由せずにカーネル管理外の割込みハンドラを実
2242	行することができないため，割込み出入口処理のなるべく早いタイミングで，
2243	カーネル管理外の割込みであるかを判別し，処理内容を分ける必要がある．具
2244	体的には，カーネル管理外の割込みの出入口処理では，オーバランハンドラの
2245	停止と動作開始を行ってはならない．また，reqflgをチェックし，タスク切換
2246	えやタスク例外処理ルーチンの呼出しを行う必要がない．さらに，NMIの出入口
2247	処理では，トレースログ取得処理（log_inh_enterおよびlog_inh_leave）を呼
2248	び出してはならない．
2249
2250	カーネル管理外の割込みハンドラを実行する際に，カーネル内の割込み出入口
2251	処理の一部分を経由する場合には，CPU例外が起こる可能性を極力減らすととも
2252	に，CPU例外を起こす可能性がある場合には，その可能性をターゲット依存部の
2253	ユーザーズマニュアルに記載しなければならない．
2254
2255	次に，カーネル管理外の割込みの設定方法に関して，「TOPPERS新世代カーネル
2256	統合仕様書」の「2.7.8 カーネル管理外の割込みの設定方法」の節の3つの方法
2257	のいずれを採用するかを決定する．
2258
2259	(a-1)または(a-2)を採用し，カーネル管理外とした割込みに対して，カーネル
2260	のAPIによる割込みハンドラの登録と割込み要求ラインの属性の設定をサポート
2261	しない場合には，それに代わる方法をターゲット依存部のユーザーズマニュア
2262	ルに記述する．
2263
2264	(a-1)または(a-2)を採用してカーネルのAPIによる割込みハンドラの登録や割込
2265	み要求ラインの属性の設定をサポートする場合や，(b)を採用した場合には，ター
2266	ゲット依存部においてそれを実現する必要がある．
2267
2268	カーネル管理外の割込みに対して，DEF_INHによる割込みハンドラの登録をサポー
2269	トするには，次の設定が必要になる．
2270
2271	・TARGET_INHATRに，TA_NONKERNELを設定する．
2272
2273	・(a-1)または(a-2)を採用した場合には，INHNO_DEFINH_VALIDに，カーネル管
2274	理外とした割込みに対応する割込みハンドラ番号を含める．また，
2275	VALID_INHNO_DEFINHを，カーネル管理外とした割込みハンドラ番号を有効な
2276	値と判定するようにする．
2277
2278	・(a-1)または(a-2)を採用した場合には，INHNO_FIX_KERNELにカーネル管理と
2279	した割込みハンドラ番号のリストを，INHNO_FIX_NONKERNELにカーネル管理外
2280	とした割込みハンドラ番号のリスト設定する．
2281
2282	・DEF_INHがカーネル管理外の割込みに対応できるようにする．標準の割込み管
2283	理機能の初期化処理を用いる場合には，x_define_inhをカーネル管理外の割
2284	込みに対応させる．
2285
2286	・必要な場合には，TA_NONKERNEL属性が設定された割込みハンドラをカーネル
2287	管理外と扱うように，カーネル内の割込み出入口処理を修正する．標準の割
2288	込み管理機能の初期化処理を用いる場合，カーネル管理外の割込みに対して
2289	は，カーネル内の割込み出入口処理を生成せず，アプリケーションが登録し
2290	た割込みハンドラを直接呼び出すように，ターゲット非依存部により設定さ
2291	れるため，ターゲット依存部では対応する必要がない．
2292
2293	カーネル管理外の割込みに対して，CFG_INTによる割込み要求ラインの属性の設
2294	定をサポートするには，次の設定が必要になる．
2295
2296	・(a-1)または(a-2)を採用した場合には，INTNO_CFGINT_VALIDに，カーネル管
2297	理外とした割込みに対応する割込み番号を含める．また，VALID_INTNO_CFGINT
2298	を，カーネル管理外とした割込み番号を有効な値と判定するようにする．
2299
2300	・(a-1)または(a-2)を採用した場合には，INTNO_FIX_KERNELにカーネル管理と
2301	した割込み番号のリストを，INTNO_FIX_NONKERNELにカーネル管理外とした割
2302	込み番号のリスト設定する．
2303
2304	・INTPRI_CFGINT_VALIDに，カーネル管理外の割込みとなる優先度を含める．
2305
2306	・CFG_INTがカーネル管理外の割込みに対応できるようにする．標準の割込み管
2307	理機能の初期化処理を用いる場合には，x_config_intをカーネル管理外の割
2308	込みに対応させる．
2309
2310	chg_ipmにより，（NMI以外の）カーネル管理外の割込みをマスクできるように
2311	する場合には，次の設定が必要になる．
2312
2313	・VALID_INTPRI_CHGIPMを，カーネル管理外の割込みとなる優先度を有効な値と
2314	判定するようにする．
2315
2316	・t_set_ipmを，カーネル管理外の割込みとなる優先度を扱えるようにする．
2317
2318	6.6.8 割込みサービスルーチンの生成
2319
2320	(6-6-8-1) bool_t VALID_INTNO_CREISR(INTNO intno)
2321
2322	intnoが，acre_isrに対する割込み番号として有効な値である場合にtrue，そう
2323	でない場合にfalseを返すマクロ．動的生成機能拡張パッケージを使用しない場
2324	合には，定義する必要がない．
2325
2326	6.7 CPU例外ハンドラとCPU例外発生時のシステム状態の参照
2327
2328	6.7.1 CPU例外ハンドラの出入口処理
2329
2330	CPU例外の出入口処理の方法はプロセッサによって大きく異なるが，おおよその
2331	処理内容は次の通り．
2332
2333	----------------------------------------
2334	void
2335	<CPU例外の出入口処理>(void)
2336	{
2337	スクラッチレジスタをスタックに保存する
2338	if (カーネル管理外のCPU例外) {
2339	if (タスクコンテキストでCPU例外発生) {
2340	スタックを非タスクコンテキスト用のスタックに切り換え，
2341	非タスクコンテキストに切り換える … (*j)
2342	}
2343	システム状態（コンテキストは除く）を，CPU例外発生時の状態にする
2344	CPU例外ハンドラを，CPU例外の情報を記憶している領域の先頭番地を
2345	パラメータ（p_excinf）として呼び出す
2346	if (タスクコンテキストでCPU例外発生) {
2347	スタックをタスク用のスタックに戻し，
2348	タスクコンテキストに切り換える … (*j)
2349	}
2350	CPU例外処理からのリターン後に，CPU例外発生時のシステム状態に
2351	戻るように準備する
2352	}
2353	else {
2354	if (タスクコンテキストでCPU例外発生) {
2355	（少なくとも）カーネル管理の割込みを禁止した状態にする
2356	#ifdef TOPPERS_SUPPORT_OVRHDR
2357	ovrtimer_stop(); /* オーバランタイマの停止 */
2358	#endif /* TOPPERS_SUPPORT_OVRHDR */
2359	スタックを非タスクコンテキスト用のスタックに切り換え，
2360	非タスクコンテキストに切り換える
2361	}
2362	割込み優先度マスクを，CPU例外発生時の値に設定し，
2363	CPUロック解除状態にする（CPU例外発生時の割込み優先度マスク
2364	よりも優先度の高い割込みを受け付けるようにする）
2365
2366	#ifdef LOG_EXC_ENTER
2367	log_exc_enter(CPU例外ハンドラ番号);
2368	#endif /* LOG_EXC_ENTER */
2369	CPU例外ハンドラを，CPU例外の情報を記憶している領域の先頭番地を
2370	パラメータ（p_excinf）として呼び出す
2371	#ifdef LOG_EXC_LEAVE
2372	log_exc_leave(CPU例外ハンドラ番号);
2373	#endif /* LOG_EXC_LEAVE */
2374
2375	ret_exc:
2376	if (タスクコンテキストでCPU例外発生) {
2377	（少なくとも）カーネル管理の割込みを禁止した状態にする … (*d)
2378	スタックをタスク用のスタックに戻し，タスクコンテキストに切り換える
2379	… (*g)
2380	if (reqflg) {
2381	reqflg = false;
2382	CPUロック状態にする … (*e)
2383	if (dspflg && p_runtsk != p_schedtsk) {
2384	スクラッチレジスタを除くすべてのレジスタをスタックに保存する
2385	スタックポインタを自タスク（p_runtsk）のTCBに保存する
2386	ret_exc_rを，実行再開番地として自タスクのTCBに保存する
2387	… (*a)
2388	dispatcherに分岐する
2389
2390	ret_exc_r:
2391	スクラッチレジスタを除くすべてのレジスタを
2392	スタックから復帰する
2393	}
2394	#ifdef TOPPERS_SUPPORT_OVRHDR
2395	ovrtimer_start(); /* オーバランタイマの動作開始 */
2396	#endif /* TOPPERS_SUPPORT_OVRHDR */
2397	calltex(); … (*b)
2398	}
2399	#ifdef TOPPERS_SUPPORT_OVRHDR
2400	else {
2401	ovrtimer_start(); /* オーバランタイマの動作開始 */
2402	}
2403	#endif /* TOPPERS_SUPPORT_OVRHDR */
2404	}
2405	CPU例外処理からのリターン後に，CPUロック解除状態に戻るように準備する
2406	}
2407	スクラッチレジスタをスタックから復帰する
2408	CPU例外処理からのリターン
2409	}
2410	----------------------------------------
2411
2412	CPU例外ハンドラは，非コンテキストに切り換えることを除いては，CPU例外発
2413	生時と同じシステム状態で呼び出さなければならない．例えば，CPU例外がCPU
2414	ロック状態で発生した場合にはCPUロック状態，CPUロック解除状態で発生した
2415	場合にはCPUロック解除状態で，CPU例外ハンドラを呼び出さなければならない．
2416	CPUロック状態で発生したCPU例外は，カーネル管理外のCPU例外となるため，カー
2417	ネル管理のCPU例外ハンドラについては，CPUロック解除状態で呼び出すことに
2418	なる．
2419
2420	ターゲットによっては，カーネル管理外のCPU例外を正確に判定するのが難しい
2421	場合がある．このような場合には，割込み優先度マスクが全解除でない状態で
2422	発生したCPU例外を，カーネル管理外のCPU例外と扱っても支障がない．これは，
2423	割込み優先度マスクが全解除でない場合には，xsns_dpn，xsns_xpnともtrueを
2424	返すため，アプリケーションからはカーネル管理外のCPU例外と区別できないた
2425	めである．
2426
2427	具体的には，全割込みロック（またはCPUロック）を小さいオーバヘッドで実現
2428	しようとすると，CPU例外ハンドラの中で，全割込みロック状態（またはCPUロッ
2429	ク状態）と割込み優先度マスクを高いレベルに設定した状態を区別できない場
2430	合がある．また，カーネル管理外の割込み処理中やカーネル実行中であること
2431	を正確に判断することも難しい場合がある．
2432
2433	カーネル管理外のCPU例外ハンドラを呼ぶ時に，(*j)において，スタックを非タ
2434	スクコンテキスト用のスタックに切り換え，非タスクコンテキストに切り換え
2435	ているが，この切換えはターゲット定義で省いても良い．これは，カーネル管
2436	理外のCPU例外は，カーネル内のクリティカルセクション中で発生する可能性が
2437	あるため，安全に切り換えられるとは限らないためである．また，カーネル管
2438	理外の割込みハンドラを呼ぶ時のコンテキストやスタックはターゲット依存な
2439	ので，カーネル管理外のCPU例外ハンドラもそれと同様に扱って良いと考えられ
2440	るためである．
2441
2442	上のコードでは，カーネル管理外のCPU例外に対して，トレースログ取得処理
2443	（log_exc_enterおよびlog_exc_leave）を呼び出していないが，全割込みロッ
2444	ク状態かNMIの処理中にCPU例外が発生した場合を除外すれば，呼び出してもか
2445	まわない．全割込みロック状態かNMIの処理中に発生したCPU例外の場合には，
2446	トレースログ取得処理を呼び出してはならない．
2447
2448	CPU例外ハンドラを実行する際に経由する部分では，CPU例外が起こる可能性を
2449	極力減らすとともに，CPU例外を起こす可能性がある場合（例えば，スクラッチ
2450	レジスタをスタックに保存する時に，バスエラーなどのCPU例外が発生する可能
2451	性が考えられる）には，その可能性をターゲット依存部のユーザーズマニュア
2452	ルに記載しなければならない．
2453
2454	ret_exc以降の処理は，割込みの出入口処理のret_int以降の処理とほぼ同じで
2455	あるため，ターゲットによっては，共通のルーチンを用いることができる可能
2456	性がある．
2457
2458	CPU例外の出入口処理をアセンブリ言語で記述する場合には，トレースログ取得
2459	処理は，「6.2 トレースログ機能への対応」の節で記述した方法でコーディン
2460	グすること．
2461
2462	6.7.2 CPU例外ハンドラの出入口処理の生成
2463
2464	CPU例外ベクトルをハードウェアで実現している場合など，CPU例外ハンドラ毎
2465	に出入口処理を用意した方が効率が良いターゲットのために，CPU例外ハンドラ
2466	毎に出入口処理を生成する機構を用意している．
2467
2468	以下のマクロは，標準のCPU例外管理機能の初期化処理を用いた場合のみ，ター
2469	ゲット非依存部で使われる．CPU例外管理機能の初期化処理をターゲット依存部
2470	で用意し，その中でこれらのマクロを使わない場合には，これらのマクロを用
2471	意する必要はない．
2472
2473	(6-7-2-1) EXC_ENTRY(excno, exchdr)
2474
2475	CPU例外ハンドラ番号がexcno，CPU例外ハンドラの関数名がexchdrであるCPU例
2476	外ハンドラの出入口処理のラベルを作るマクロ．EXCHDR_ENTRYを用いてCPU例外
2477	ハンドラ毎に出入口処理を生成する場合には，次のように定義する．
2478
2479	#define EXC_ENTRY(excno, exchdr) _kernel_##exchdr##_##excno
2480
2481	CPU例外ハンドラ毎に出入口処理を作る必要がない場合には，次のように定義し
2482	て，CPU例外ハンドラの関数名をそのまま返す．
2483
2484	#define EXC_ENTRY(excno, exchdr) exchdr
2485
2486	(6-7-2-2) EXCHDR_ENTRY(excno, excno_num, exchdr)
2487
2488	CPU例外ハンドラ番号がexcno，CPU例外ハンドラの関数名がexchdrであるCPU例
2489	外ハンドラの出入口処理を生成するマクロ．excno_numには，アセンブリ言語記
2490	述用に，CPU例外ハンドラ番号が数値で渡される．CPU例外ハンドラ毎に出入口
2491	処理を作る必要がない場合には，空に定義する．
2492
2493	6.7.3 CPU例外ハンドラの設定
2494
2495	(6-7-3-1) bool_t VALID_EXCNO_DEFEXC(EXCNO excno)（オプション）
2496
2497	excnoが，DEF_EXCに対するCPU例外ハンドラ番号として有効な値である場合に
2498	true，そうでない場合にfalseを返すマクロ．
2499
2500	ASPカーネルのターゲット非依存部では，このマクロは使われていないため，ター
2501	ゲット依存部で使わないなら，用意する必要がない．
2502
2503	(6-7-3-2) void x_define_exc(EXCNO excno, FP exc_entry)
2504
2505	excnoで指定されたCPU例外ハンドラの出入口処理の番地をexc_entryに設定する．
2506
2507	この関数は，標準のCPU例外管理機能の初期化処理を用いた場合のみ，ターゲッ
2508	ト非依存部から呼び出される．CPU例外管理機能の初期化処理をターゲット依存
2509	部で用意し，その中でこの関数を呼び出さない場合には，この関数を用意する
2510	必要はない．
2511
2512	この関数は，ターゲット非依存部のカーネル初期化処理から呼び出されるため，
2513	カーネルの初期化処理（NMIを除くすべての割込みがマスクされている）から呼
2514	び出せるように実装すればよい．
2515
2516	指定されたCPU例外ハンドラ番号がDEF_EXCに対するものとして有効な値でない
2517	場合の動作は保証する必要がない（assertでエラーとするのが望ましい）．こ
2518	れは，コンフィギュレータが，パス2のテンプレートファイルのターゲット依存
2519	部で定義するEXCNO_DEFEXC_VALIDを用いてエラーを検出するためである．
2520
2521	6.7.4 CPU例外管理機能の初期化処理の変更
2522
2523	(6-7-4-1) OMIT_INITIALIZE_EXCEPTION（オプション）
2524
2525	CPU例外管理機能の初期化処理をターゲット依存部で用意し，ターゲット非依存
2526	部に含まれる標準の割込み管理機能の初期化処理を用いない場合には，このシ
2527	ンボルをマクロ定義する．
2528
2529	このシンボルをマクロ定義すると，EXCINIBとinitialize_exceptionの定義が，
2530	カーネルのターゲット非依存部から取り除かれる．また，TNUM_EXCNO，
2531	tnum_excno，excinib_tableの定義と，CPU例外ハンドラ毎の出入口処理を生成
2532	するための記述（EXCHDR_ENTRYマクロのリスト）を，コンフィギュレータのパ
2533	ス2のテンプレートファイルのターゲット非依存部によってkernel_cfg.cに生成
2534	されなくなる．
2535
2536	(6-7-4-2) void initialize_exception(void)（オプション）
2537
2538	OMIT_INITIALIZE_EXCEPTIONをマクロ定義した場合には，この関数をターゲット
2539	依存部で用意する．OMIT_INITIALIZE_EXCEPTIONをマクロ定義することにより取
2540	り除かれるその他のデータ型，変数，マクロは，この関数で使用する場合にの
2541	み用意すればよい．
2542
2543	6.7.5 デフォルトのCPU例外ハンドラ
2544
2545	(6-7-5-1) void default_exc_handler(void *p_excinf)（オプション）
2546
2547	コンフィギュレータによりCPU例外ハンドラのテーブルを生成する場合などには，
2548	CPU例外ハンドラを登録しなかったCPU例外ハンドラ番号に対して，デフォルト
2549	のCPU例外ハンドラとして，default_exc_handlerを登録する．
2550
2551	default_exc_handlerは，標準のものをターゲット依存部で用意するが，ユーザ
2552	が用意したもので置き換えられるように，OMIT_DEFAULT_EXC_HANDLERをマクロ
2553	定義した場合には，ターゲット依存部で定義しないようにする．なお，ユーザ
2554	が用意する場合の名称は，_kernel_default_exc_handlerとなる．
2555
2556	6.7.6 CPU例外発生時のシステム状態の参照
2557
2558	(6-7-6-1) bool_t exc_sense_intmask(void *p_excinf)
2559
2560	CPU例外の発生した時のシステム状態が，カーネル実行中でなく，タスクコンテ
2561	キストであり，全割込みロック状態でなく，CPUロック状態でなく，割込み優先
2562	度マスク全解除状態である時にtrue，そうでない時にfalseを返す関数．
2563
2564	p_excinfには，CPU例外の情報を記憶している領域の先頭番地が渡される．
2565
2566	CPU例外がカーネル管理外の割込み処理中で発生した場合にもfalseを返さなけ
2567	ればならないことに注意すること．
2568
2569	6.8 カーネルの起動・終了とスタック領域など
2570
2571	(6-8-1) スタートアップモジュール
2572
2573	カーネルのスタートアップモジュールは，システムのリセット後に最初に実行
2574	されるプログラムである．スタートアップモジュールは，標準的には，プロセッ
2575	サ依存部またはチップ依存部で用意し以下の処理を行うが，それにこだわる必
2576	要はない．具体的には，開発環境に用意されているスタートアップモジュール
2577	を用いる方法（この場合，ターゲット依存部でmain関数を用意する必要がある）
2578	や，アプリケーションで用意する場合が考えられる．
2579
2580	(a) プロセッサ状態の初期化
2581
2582	プロセッサモード，スタックポインタ，フレームポインタ等，プロセッサの状
2583	態を初期化する．また，NMIを除くすべての割込みをマスクした状態（全割込み
2584	ロック状態と同等の状態）とする．DRAMコントローラの初期化など，メモリを
2585	アクセスするために必要な初期化処理をここで行ってもよい（次の
2586	hardware_init_hookで行ってもよい）．
2587
2588	(b) hardware_init_hookを呼び出す
2589
2590	システムのリセット後すぐに行う必要のあるターゲットシステム依存の初期化
2591	処理を行うために，hardware_init_hookを呼び出す．hardware_init_hookが用
2592	意されていない場合は，何もしない．GNU開発環境では，リンカスクリプト中の
2593	weak definitionにより，hardware_init_hookが用意されていない場合の値を0
2594	とすることで，これを実現できる．weak definitionの機能を持たない開発環境
2595	では，hardware_init_hookを必ず呼び出すことにする．
2596
2597	hardware_init_hookは，ターゲット依存部で用意するのが標準であるが，シス
2598	テムのリセット後すぐに行う必要のある初期化処理を追加するために，アプリ
2599	ケーションで用意したものを用いる場合もある．
2600
2601	メモリアクセスに必要な初期化処理をhardware_init_hookで行う場合には，こ
2602	れを呼び出す時点でメモリにアクセスすることができないため，関数（サブルー
2603	チン）を呼び出すためにスタックを使用するプロセッサでは，戻り番地を汎用
2604	レジスタに入れて呼び出すといった工夫が必要である．この場合，
2605	hardware_init_hookをC言語で記述することはできなくなるが，やむをえない．
2606
2607	(c) bssセクションとdataセクションの初期化
2608
2609	bssセクションをクリアし，dataセクションに初期値を設定する．
2610
2611	ただし，カーネル本体は，kerflgがfalse（＝0）に初期化されること以外に，
2612	これらのセクションが初期化されることに依存していないため，スタートアッ
2613	プモジュールをアプリケーションで用意する場合で，システムサービスやアプ
2614	リケーションがこれらのセクションが初期化されることに依存していない場合
2615	には，システムの起動時間を短縮するために，kerflgをfalseに初期化するだけ
2616	で十分である．
2617
2618	(d) software_init_hookを呼び出す
2619
2620	開発環境（特にライブラリ）に依存して必要な初期化処理を行うために，
2621	software_init_hookを呼び出す．software_init_hookが用意されていない場合
2622	は，何もしない．GNU開発環境では，リンカスクリプト中のweak definitionに
2623	より，software_init_hookが用意されていない場合の値を0とすることで，これ
2624	を実現できる．weak definitionの機能を持たない開発環境では，
2625	software_init_hookを必ず呼び出すことにする．
2626
2627	software_init_hookは，ターゲット依存部で用意するのが標準である．
2628
2629	(e) sta_kerへ分岐
2630
2631	sta_kerを呼び出す．sta_kerは，NMIを除くすべての割込みをマスクした状態
2632	（全割込みロック状態と同等の状態）で呼び出さなければならない．sta_kerか
2633	らはリターンすることがないため，スタートアップモジュールに戻ってくるこ
2634	とは考える必要がない．
2635
2636	(6-8-2) void target_initialize(void)
2637
2638	ターゲット依存部の初期化を行う関数．sta_kerの最初で呼び出される．プロセッ
2639	サ・チップ・開発環境依存の初期化処理を，それらの依存部に切り分けること
2640	も可能である．
2641
2642	この関数は，あくまでもカーネルのターゲット依存部の初期化処理を行うため
2643	のものである．アプリケーションに必要な初期化処理は，初期化ルーチンで行
2644	うのが基本であるが，システムのリセット後すぐに行う必要がある場合には，
2645	hardware_init_hookを用いる．
2646
2647	(6-8-3) void call_exit_kernel(void)
2648
2649	非タスクコンテキストに切り換えて，exit_kernelへ分岐する関数．ext_kerか
2650	ら呼び出される．exit_kernelからはリターンすることがないため，この関数に
2651	戻ってくることは考える必要がない．
2652
2653	非タスクコンテキストに切り換えるのは，終了処理ルーチンを，非タスクコン
2654	テキスト用のスタックで実行するためである．終了処理ルーチンをタスク用の
2655	スタックで実行すると，各タスクのスタック領域のサイズを決定する際に，終
2656	了処理ルーチンが使用するスタック領域を考慮しなければならない．これには，
2657	終了処理ルーチンが使用するスタック領域が大きい場合に各タスクのスタック
2658	領域を無駄に大きくしなければならないことに加えて，意図しないスタックオー
2659	バーフローが発生する可能性を高めるという問題がある．
2660
2661	この関数は，全割込みロック状態で呼ばれるため，全割込みロック状態から呼
2662	び出すことができない関数を呼ばないように実装しなければならない．
2663
2664	(6-8-4) void target_exit(void)
2665
2666	ターゲット依存部の終了処理を行う関数．この関数は，カーネル終了処理の最
2667	後に呼び出され，リターンしてはならない．プロセッサ・チップ・開発環境依
2668	存の終了処理を，それらの依存部に切り分けることも可能である．
2669
2670	この関数では，最初に，atexitによって登録された関数とデストラクタを呼び
2671	出すことを意図しており，標準的には，software_term_hookを呼び出す．
2672	software_term_hookが用意されていない場合は，何もしない．GNU開発環境では，
2673	リンカスクリプト中のweak definitionにより，software_term_hookが用意され
2674	ていない場合の値を0とすることで，これを実現できる．weak definitionの機
2675	能を持たない開発環境では，software_term_hookを必ず呼び出すことにする．
2676
2677	この関数は，全割込みロック状態で呼ばれるため，全割込みロック状態から呼
2678	び出すことができない関数を呼ばないように実装しなければならない．
2679
2680	6.9 カーネル内部のチューニング
2681
2682	6.9.1 ビットマップサーチ
2683
2684	(6-9-1-1) OMIT_BITMAP_SEARCH（オプション）
2685	(6-9-1-2) uint_t bitmap_search(uint16_t bitmap)（オプション）
2686
2687	ターゲット非依存部で，uint16_t型の整数値（bitmap）中の1のビットの内，最
2688	も下位（右）のものをサーチし，そのビット番号を返す関数bitmap_searchを用
2689	意している．ここで，ビット番号は最下位ビットを0とし，bitmapに0を指定し
2690	てはならないものとしている．
2691
2692	ビットサーチ命令を持つプロセッサでは，bitmap_searchを，ビットサーチ命令
2693	を使うように書き直した方が効率が良い場合がある．このような場合には，ター
2694	ゲット依存部でビットサーチ命令を使ったbitmap_searchを定義し，
2695	OMIT_BITMAP_SEARCHをマクロ定義する．
2696
2697	標準ライブラリにビットサーチ命令を用いたffsがある場合，bitmap_searchを
2698	(ffs(bitmap) - 1)に定義するとよい．
2699
2700	(6-9-1-3) uint16_t PRIMAP_BIT(PRI pri)（オプション）
2701
2702	ビットサーチ命令のサーチ方向が逆などの理由で，優先度とビットとの対応を
2703	変更したい場合には，PRIMAP_BITをマクロ定義する．
2704
2705	6.9.2 ビットフィールド
2706
2707	(6-9-2-1) BIT_FIELD_UINT（オプション）
2708
2709	8ビット以下の幅のビットフィールドで，符号無し整数値を保持したい場合に用
2710	いるべきデータ型．デフォルトの定義はunsigned intとなっているが，ターゲッ
2711	トやツール依存で，unsigned charまたはunsigned shortに定義した方が効率が
2712	良い場合がある．
2713
2714	(6-9-2-2) BIT_FIELD_BOOL（オプション）
2715
2716	1ビット幅のビットフィールドで，ブール値を保持したい場合に用いるべきデー
2717	タ型．デフォルトではBIT_FIELD_UINTと同一に定義しているが，ブール値を保
2718	持することを明示するために別の名前としている．
2719
2720	(6-9-2-3) TBIT_TCB_PRIORITY（オプション）
2721
2722	現在優先度（および，ミューテックス拡張におけるベース優先度）を保持する
2723	ためのTCB中のフィールドのビット数．デフォルトでは8ビットに定義している
2724	が，それ以外に定義したい場合に，ビット数をこの名前にマクロ定義する．
2725
2726	6.10 カーネル実装に関するその他の定義
2727
2728	6.10.1 ターゲット依存のオブジェクト属性
2729
2730	(6-10-1-1) TARGET_TSKATR（オプション）ターゲット定義のタスク属性
2731	(6-10-1-2) TARGET_ISRATR（オプション）ターゲット定義のISR属性
2732	(6-10-1-3) TARGET_INHATR（オプション）ターゲット定義の割込みハンドラ属性
2733	(6-10-1-4) TARGET_INTATR（オプション）ターゲット定義の割込み属性
2734	(6-10-1-5) TARGET_EXCATR（オプション）ターゲット定義のCPU例外ハンドラ属性
2735
2736	各オブジェクトの属性を，ターゲット定義に拡張する場合に，該当するオブジェ
2737	クト属性を示す変数に，拡張に使用するビットの論理和を定義する．これによ
2738	り，拡張に使用するビットが設定されている場合に，エラーになるのを防ぐ．
2739
2740	なお，TOPPERS新世代カーネル統合仕様書では，割込みサービスルーチン（ISR）
2741	属性をターゲット定義で拡張できる仕様とはなっていない．
2742
2743	6.10.2 エラーチェック方法の指定
2744
2745	(6-10-2-1) TARGET_MIN_STKSZ（オプション）
2746
2747	ターゲット定義で，タスクのスタックサイズの最小値を設定する場合には，こ
2748	の変数をスタックサイズの最小値に定義する．
2749
2750	(6-10-2-2) TARGET_MIN_ISTKSZ（オプション）
2751
2752	ターゲット定義で，非タスクコンテキストのスタックサイズの最小値を設定す
2753	る場合には，この変数をスタックサイズの最小値に定義する．
2754
2755	(6-10-2-3) CHECK_STKSZ_ALIGN（オプション）
2756
2757	スタック領域のサイズがある値（アライン単位）の倍数でなければならない場
2758	合に，この変数をアライン単位に定義する．この変数を定義することで，
2759	kernel.tfおよびacre_tsk（動的生成機能拡張パッケージのみ）において，スタッ
2760	ク領域のサイズが正しくない（この変数に定義した値の倍数でない）場合のエ
2761	ラーをチェックするようになる．チェックが必要ない場合には，この変数を定
2762	義しない．
2763
2764	(6-10-2-4) CHECK_FUNC_ALIGN（オプション）処理単位のアライン単位
2765	(6-10-2-5) CHECK_FUNC_NONNULL（オプション）処理単位の非NULLチェック
2766	(6-10-2-6) CHECK_STACK_ALIGN（オプション）スタック領域のアライン単位
2767	(6-10-2-7) CHECK_STACK_NONNULL（オプション）スタック領域の非NULLチェック
2768	(6-10-2-8) CHECK_MPF_ALIGN（オプション）固定長メモリプール領域のアライン単位
2769	(6-10-2-9) CHECK_MPF_NONNULL（オプション）固定長メモリプール領域の非NULLチェック
2770
2771	処理単位／スタック領域／固定長メモリプール領域の先頭番地がある値（アラ
2772	イン単位）の倍数でなければならない場合に，それぞれ，CHECK_FUNC_ALIGN／
2773	CHECK_STACK_ALIGN／CHECK_MPF_ALIGNをアライン単位に定義する．処理単位／
2774	スタック領域／固定長メモリプール領域の先頭番地がNULLでないかのチェック
2775	を行う場合には，それぞれCHECK_FUNC_NONNULL／CHECK_STACK_NONNULL／
2776	CHECK_MPF_NONNULLを定義する．
2777
2778	(6-10-2-10) CHECK_MB_ALIGN（オプション）管理領域のアライン単位
2779
2780	カーネル内の管理領域（具体的には，データキュー管理領域，優先度データ
2781	キュー管理領域，固定長メモリプール管理領域）の先頭番地がある値（アライ
2782	ン単位）の倍数でなければならない場合に，この変数をアライン単位に定義す
2783	る．動的生成機能拡張パッケージを使用しない場合には，定義する必要がない．
2784
2785	6.10.3 非タスクコンテキスト用のスタック領域
2786
2787	(6-10-3-1) DEFAULT_ISTKSZ
2788
2789	DEF_ICSにより非タスクコンテキスト用のスタック領域が指定されない場合の，
2790	デフォルトのスタック領域のサイズ．
2791
2792	(6-10-3-2) DEFAULT_ISTK（オプション）
2793
2794	DEF_ICSにより非タスクコンテキスト用のスタック領域が指定されない場合の，
2795	デフォルトのスタック領域の先頭番地．このマクロが定義されない場合には，
2796	サイズがDEFAULT_ISTKSZのスタック領域が，配列により確保される．
2797
2798	(6-10-3-3) STK_T TOPPERS_ISTKPT(STK_T istk, SIZE istksz)（オプション）
2799
2800	非タスクコンテキスト用のスタックポインタの初期値を保持する変数（istkpt）
2801	を用いる場合に，このシンボルに，スタック領域の先頭番地（istk）とスタッ
2802	ク領域のサイズ（istksz）から，スタックポインタの初期値を求めるマクロを
2803	定義する．
2804
2805	6.10.4 空ラベルの定義
2806
2807	(6-10-4-1) TOPPERS_EMPTY_LABEL(type, symbol)（オプション）
2808
2809	リンクエラーを防ぐために，データ型typeの配列である変数symbolに定義を与
2810	えるためのマクロ．与えた定義が参照されることはないため，どのような定義
2811	を与えてもよい．
2812
2813	デフォルトでは，symbolを，要素型がtypeでサイズが0の配列に定義している．
2814	サイズが0の配列がエラーとならないコンパイラ（GCCはこれに該当）を用いる
2815	場合には，ターゲット依存部で定義する必要はない．
2816
2817	6.11 トレースログ機能に関する設定
2818
2819	ASPカーネルのソースコードには，カーネルの実行トレースログを取得するため
2820	のマクロ等が埋め込んである．デフォルトでは，これらのマクロは空に定義さ
2821	れてトレースログの取得は行わないが，これらのマクロを適切に定義すること
2822	でトレースログの取得を行うことができる．
2823
2824	6.11.1 取得できるトレースログの種類とマクロ
2825
2826	取得できるトレースログの種類と，それを取得するために定義するマクロは次
2827	の通りである．
2828
2829	(a) カーネルの動作開始と終了
2830
2831	次のマクロを定義することで，カーネルの動作開始時と終了時のトレースログ
2832	を取得することができる．
2833
2834	LOG_KER_ENTER カーネルが動作を開始する直前（初期化の完了後）
2835	LOG_KER_LEAVE カーネルの終了（ext_ker）が呼ばれた直後（終了処
2836	理の実行前）
2837
2838	(b) 処理単位の実行開始と終了
2839
2840	次のマクロを定義することで，割込みハンドラ（INH），割込みサービスルーチ
2841	ン（ISR），周期ハンドラ（CYC），アラームハンドラ（ALM），CPU例外ハンド
2842	ラ（EXC），タスク例外処理ルーチン（TEX）の実行開始前と終了後のトレース
2843	ログを取得することができる．
2844
2845	LOG_<処理単位略号>_ENTER 処理単位の実行開始直前
2846	LOG_<処理単位略号>_LEAVE 処理単位の終了直後
2847
2848	割込みハンドラは，アプリケーションが登録したもののみを対象とし，割込み
2849	サービスルーチンを呼び出すためにカーネル内に生成されるものは対象としな
2850	い．タスクの実行開始と終了は，他の方法で取得できるため，この方法は用意
2851	していない．
2852
2853	なお，割込みハンドラとCPU例外ハンドラの実行開始と終了のトレースログ取得
2854	は，ターゲット依存部で実装する必要がある．詳しくは，「6.2 トレースログ
2855	機能への対応」「6.6.1 割込みハンドラの出入口処理」「6.7.1 CPU例外ハンド
2856	ラの出入口処理」の節を参照すること．
2857
2858	(c) タスク状態の変化
2859
2860	次のマクロを定義することで，タスク状態が変化した時のトレースログを取得
2861	することができる．ただし，実行状態と実行可能状態の間の遷移は，他の方法
2862	で取得できるため，このマクロでは取得できない．
2863
2864	LOG_TSKSTAT タスク状態の変化
2865
2866	(d) ディスパッチャの実行開始と終了
2867
2868	次のマクロを定義することで，ディスパッチャが実行開始する時と，終了する
2869	時のトレースログを取得することができる．
2870
2871	LOG_DSP_ENTER ディスパッチャの実行開始
2872	LOG_DSP_LEAVE ディスパッチャの終了
2873
2874	ディスパッチャの実行開始は，タスクが実行状態から実行可能状態に遷移する
2875	タイミングであるため，実行可能状態へ遷移するタスクのTCBへのポインタをパ
2876	ラメータとする．逆に，ディスパッチャの終了は，タスクが実行可能状態から
2877	実行状態に遷移するタイミングであるため，実行状態へ遷移するタスクのTCBへ
2878	のポインタをパラメータとする．
2879
2880	ASPカーネルでは，実行できるタスクがなく，カーネルがアイドル状態になる場
2881	合には，ディスパッチャの中に留まる．そのため，アイドル状態への遷移とア
2882	イドル状態から他の状態への遷移は，このマクロでは取得できない．
2883
2884	なお，ディスパッチャの実行開始と終了のトレースログ取得は，ターゲット依
2885	存部で実装する必要がある．詳しくは，「6.2 トレースログ機能への対応」と
2886	「6.5.2 ディスパッチャ本体」の節を参照すること．
2887
2888	(e) サービスコールの入口と出口
2889
2890	次のマクロを定義することで，各サービスコールの入口と出口のトレースログ
2891	を取得することができる．
2892
2893	LOG_<サービスコールの大文字表記>_ENTER サービスコール名の入口
2894	LOG_<サービスコールの大文字表記>_LEAVE サービスコール名の出口
2895
2896	それぞれのマクロの名称やパラメータの詳細については，カーネルのソースコー
2897	ドを参照すること．
2898
2899	6.11.2 トレースログ記録のサンプルコード
2900
2901	トレースログを記録する方法の一例として，メモリ上にトレースログを記録す
2902	るためのサンプルコードをarch/logtraceディレクトリに用意している．このサ
2903	ンプルコードは，システムログ機能と同様のトレースログ機能を用意し，トレー
2904	スログ情報をメモリ上に記録するとともに，それを読み出して表示する機能を
2905	実現している．
2906
2907	このサンプルコードを組み込む方法は次の通りである．
2908
2909	(1) target_config.hおよびtarget_syssvc.hに，次の記述を追加する．
2910
2911	#ifdef TOPPERS_ENABLE_TRACE
2912	#include "logtrace/trace_config.h"
2913	#endif /* TOPPERS_ENABLE_TRACE */
2914
2915	(2) Makefile.targetに，次の記述を追加する．
2916
2917	ifeq ($(ENABLE_TRACE),true)
2918	COPTS := $(COPTS) -DTOPPERS_ENABLE_TRACE
2919	KERNEL_DIR := $(KERNEL_DIR) $(SRCDIR)/arch/logtrace
2920	KERNEL_COBJS := $(KERNEL_COBJS) trace_config.o trace_dump.o
2921	endif
2922
2923	(3) スタートアップモジュールで，bssセクションのクリアを省略している場合
2924	には，trace_modeをTRACE_STOP（＝0）に初期化するコードを追加する．こ
2925	れは，トレースログ機能が初期化される前に書き込まれるトレースログを
2926	無視するためである．
2927
2928	このサンプルコードを用いて，トレースログを記録・ダンプする方法の例につ
2929	いては，「TOPPERS/ASPカーネルユーザーズマニュアル」の「11.6 トレースロ
2930	グ記録のサンプルコードの使用方法」の節を参照すること．
2931
2932	なお，このサンプルコードでは，ディスパッチャの出口，タスクの状態遷移，
2933	システムログの出力の3つのトレースログのみを記録している．他のトレースロ
2934	グを記録したい場合には，trace_config.h（およびtrace_dump.c）を修正する
2935	必要がある．なお，カーネルのトレースログを網羅的に記録するためのコード
2936	は，TLV（TraceLogVisualizer）の配布パッケージに含まれている．
2937
2938	6.12 カーネル実装のターゲット依存部のためのリネーム記述
2939
2940	カーネル内部に閉じて使われる関数や変数などの名称で，オブジェクトファイ
2941	ルのシンボル表に登録されて外部から参照できる名称は，C言語レベルで，先頭
2942	が"_kernel_"または"_KERNEL_"である名称としなければならないが，ASPカーネ
2943	ルでは，ソースコードをコンパクトに保ちつつこれを実現するために，リネー
2944	ム記述ファイルを導入している．
2945
2946	具体的には，リネームすべき名称をリストアップしたxxx_rename.defを用意し，
2947	このファイルからツール（utils/genrename）により，名称をリネームするため
2948	のマクロ定義を含むxxx_rename.hと，それらのマクロ定義を解除するための
2949	xxx_unrename.hを生成する．ツールの起動方法は次の通りである．
2950
2951	% genrename xxx
2952
2953	xxx_rename.defには，リネームすべき名称を1行に1つ記述する．xxxxという名
2954	称が記述されている場合，xxx_rename.hには次のような記述が生成される．
2955
2956	#define xxxx _kernel_xxxx
2957	#ifdef TOPPERS_LABEL_ASM
2958	#define _xxxx __kernel_xxxx
2959	#endif /* TOPPERS_LABEL_ASM */
2960
2961	また，xxx_unrename.hには次のような記述が生成される．
2962
2963	#undef xxxx
2964	#ifdef TOPPERS_LABEL_ASM
2965	#undef _xxxx
2966	#endif /* TOPPERS_LABEL_ASM */
2967
2968	xxx_rename.defの中には，他のリネーム記述を取り込むために，「INCLUDE
2969	"yyy"」または「INCLUDE <yyy>」という記述を含めることができる．この記述
2970	がされている場合，xxx_rename.hには「#include "yyy_rename.h"」または
2971	「#include <yyy_rename.h>」という記述が，xxx_unrename.hには「#include
2972	"yyy_unrename.h"」または「#include <yyy_unrename.h>」という記述が生成さ
2973	れる．
2974
2975	xxx_rename.defの中の"#"で始まる行はコメントとして読み飛ばされる．また，
2976	空行も無視される．
2977
2978	カーネルのターゲット非依存部で使われる名称をリネームするために，kernel
2979	ディレクトリに，kernel_rename.defと，そこから生成したkernel_rename.hお
2980	よびkernel_unrename.hが用意されている．kernel_rename.defには，
2981	「INCLUDE "target"」という記述が含まれており，ターゲット依存部のリネー
2982	ム記述を取り込むようになっている．ターゲット依存部で定義し，ターゲット
2983	非依存部で参照される名称は，ターゲット依存部のリネーム記述に含める．
2984
2985	ターゲット依存部では，ターゲット依存部で使われる名称をリネームするため
2986	に，target_rename.defと，そこから生成したtarget_rename.hおよび
2987	target_unrename.hを用意する．ターゲット依存部からプロセッサ・チップ・開
2988	発環境依存部を切り分ける場合には，target_rename.defにINCLUDE記述を入れ，
2989	プロセッサ・チップ・開発環境依存部のリネーム記述を取り込むようにする．
2990
2991	6.13 タイマドライバ
2992
2993	タイマドライバは，カーネルにタイムティックを通知するためのタイマドライ
2994	バである．
2995
2996	6.13.1 タイマドライバのファイル構成
2997
2998	タイマドライバを組み込むための静的APIを記述したシステムコンフィギュレー
2999	ションファイルを，target_timer.cfgに用意する．このファイルには，タイマ
3000	ドライバを初期化するための初期化ルーチンの追加，タイマドライバを終了さ
3001	せるための終了処理ルーチンの追加，タイマ割込みのための割込みハンドラの
3002	定義（または，割込みサービスルーチンの追加），タイマ割込みのための割込
3003	み要求ラインの属性の設定の静的APIなどを含むことになる．
3004
3005	タイマドライバを呼び出すために必要な定義を含むヘッダファイルを，
3006	target_timer.hに用意する．また，タイマドライバの実装ファイルを
3007	target_timer.cに用意する．
3008
3009	タイムティックの通知により行う処理の多くは，タスクの起動や待ち解除を行
3010	うものであるため，タイマ割込みの割込み優先度は，割込みの中で最低の優先
3011	度で十分である．ただし，周期ハンドラやアラームハンドラの実行開始遅れが
3012	問題になる場合には，タイマ割込みの割込み優先度をより高い値に設定したい．
3013	そこで，タイマ割込みの割込み優先度を変更する方法を，ターゲット依存部の
3014	ユーザーズマニュアルに記載すべきである．
3015
3016	6.13.2 タイマの初期化・終了処理・割込み処理
3017
3018	(6-13-2-1) void target_timer_initialize(intptr_t exinf)
3019
3020	タイマを初期化し，タイマ割込みを周期的に発生させる関数．タイマ割込みの
3021	周期は，TIC_NUMEとTIC_DENOで指定された時間と一致させる（「5.2 タイム
3022	ティックの定義」の節を参照）．
3023
3024	この関数は，target_timer.cfg中に記述する静的APIにより，初期化ルーチンと
3025	してカーネルに登録することを想定している．
3026
3027	(6-13-2-2) void target_timer_terminate(intptr_t exinf)
3028
3029	タイマの動作を停止させ，タイマ割込みを発生しないようにする関数．
3030
3031	この関数は，target_timer.cfg中に記述する静的APIにより，終了処理ルーチン
3032	としてカーネルに登録することを想定している．
3033
3034	(6-13-2-3) void target_timer_handler(void)
3035	または void target_timer_isr(intptr_t exinf)
3036
3037	タイマ割込みにより起動される割込み処理プログラム．割込みハンドラとして
3038	実現する場合にはtarget_timer_handler，割込みサービスルーチンとして実現
3039	する場合にはtarget_timer_isrの名称とする．ターゲット非依存部の
3040	signal_timeを呼び出す．
3041
3042	target_timer_handlerは，標準的には次のように定義する．
3043
3044	----------------------------------------
3045	void
3046	target_timer_handler(void)
3047	{
3048	i_begin_int(<タイマ割込みの割込み番号>);
3049	signal_time();
3050	i_end_int(<タイマ割込みの割込み番号>);
3051	}
3052	----------------------------------------
3053
3054	この関数は，target_timer.cfg中に記述する静的APIにより，割込みハンドラま
3055	たは割込みサービスルーチンとしてカーネルに登録することを想定している．
3056
3057	6.13.3 性能評価用システム時刻の参照のための機能
3058
3059	性能評価用システム時刻の参照機能（get_utm）をサポートする場合には，タイ
3060	マドライバで，以下のデータ型や関数などを用意する．
3061
3062	(6-13-3-1) OMIT_GET_UTM（オプション）
3063
3064	ターゲット非依存部のget_utmの実装を使用せず，ターゲット依存部でget_utm
3065	を用意する場合には，このシンボルをマクロ定義する．このシンボルをマクロ
3066	定義した場合，以下のデータ型や関数などを用意する必要はない．
3067
3068	(6-13-3-2) CLOCK
3069
3070	タイマ値の内部表現のためのデータ型．
3071
3072	(6-13-3-3) CLOCK target_timer_get_current(void)
3073
3074	タイマの現在値を読み出し，内部表現で返す関数．タイマ値は，時間の経過と
3075	ともに増加することを想定している．ハードウェアのタイマが，タイマ値が減
3076	少するものである場合には，この関数内で増加する値となるように変換する．
3077
3078	(6-13-3-4) bool_t target_timer_probe_int(void)
3079
3080	タイマ割込み要求をチェックする関数．タイマ割込みが要求されている場合に
3081	true，要求されていない場合にfalseを返す．
3082
3083	(6-13-3-5) TO_USEC(clock)
3084
3085	タイマ値の内部表現を，1μ秒単位に変換するためのマクロ（または関数）．
3086	targettimer_get_currentで読み出した値を，タイマ割込み発生からの経過時間
3087	（単位: 1μ秒）に変換するために用いる．
3088
3089	6.14 オーバランタイマドライバ（オプション）
3090
3091	オーバランタイマドライバは，オーバランハンドラを起動するためのタイマの
3092	ドライバである．オーバランハンドラ機能拡張パッケージをサポートしない場
3093	合には，オーバランタイマドライバを用意する必要はない．
3094
3095	6.14.1 オーバランタイマドライバのファイル構成
3096
3097	オーバランタイマドライバは，タイマドライバと同じファイルの中に記述する．
3098	オーバランタイマドライバのための記述は，TOPPERS_SUPPORT_OVRHDRがマクロ
3099	定義されている場合にのみ有効になるようにする．
3100
3101	すなわち，オーバランタイマドライバを組み込むための静的APIは
3102	target_timer.cfgの中に記述する．このファイルには，オーバランタイマドラ
3103	イバを初期化するための初期化ルーチンの追加，オーバランタイマドライバを
3104	終了させるための終了処理ルーチンの追加，オーバランタイマ割込みのための
3105	割込みハンドラの定義（または，割込みサービスルーチンの追加），オーバラ
3106	ンタイマ割込みのための割込み要求ラインの属性の設定の静的APIなどを含むこ
3107	とになる．
3108
3109	また，オーバランタイマドライバを呼び出すために必要な定義は
3110	target_timer.hの中に，オーバランタイマドライバの実装はtarget_timer.cの
3111	中に記述する．
3112
3113	オーバランハンドラは，タスクのオーバランに対する処理を行うものであるた
3114	め，オーバランタイマ割込みの割込み優先度は，割込みの中で最低の優先度で
3115	十分である．ただし，オーバランタイマ割込みの割込み優先度をより高い値に
3116	設定したい場合もないとは言えないため，オーバランタイマ割込みの割込み優
3117	先度を変更する方法を，ターゲット依存部のユーザーズマニュアルに記載すべ
3118	きである．
3119
3120	6.14.2 オーバランタイマの操作と割込み処理
3121
3122	(6-14-2-1) void target_ovrtimer_initialize(intptr_t exinf)
3123
3124	オーバランタイマの初期化処理を行う．タイマの動作開始は行わない．
3125
3126	この関数は，target_timer.cfg中に記述する静的APIにより，初期化ルーチンと
3127	してカーネルに登録することを想定している．
3128
3129	(6-14-2-2) void target_ovrtimer_terminate(intptr_t exinf)
3130
3131	オーバランタイマを停止させ，オーバランタイマ割込みを発生しないようにす
3132	る．
3133
3134	この関数は，target_timer.cfg中に記述する静的APIにより，終了処理ルーチン
3135	としてカーネルに登録することを想定している．
3136
3137	(6-14-2-3) void target_ovrtimer_start(OVRTIM ovrtim)
3138
3139	オーバランタイマに，残り時間ovrtimを設定し，動作開始する．ovrtimの単位
3140	はマイクロ秒とする．
3141
3142	(6-14-2-4) OVRTIM target_ovrtimer_stop(void)
3143
3144	オーバランタイマを停止し，タイマの残り時間を読み出す．もし残り時間が
3145	0（またはそれ未満）になっていた場合には，1を返す．また，オーバランタイ
3146	マからの割込みをクリアする．
3147
3148	(6-14-2-5) OVRTIM target_ovrtimer_get_current(void)
3149
3150	オーバランタイマの残り時間を読み出す．もし残り時間が0（またはそれ未満）
3151	になっていた場合には，0を返す．オーバランタイマからの割込みはクリアしな
3152	い．
3153
3154	(6-14-2-6) void target_ovrtimer_handler(void)
3155	または void target_ovrtimer_isr(intptr_t exinf)
3156
3157	オーバランタイマ割込みにより起動される割込み処理プログラム．割込みハン
3158	ドラとして実現する場合にはtarget_ovrtimer_handler，割込みサービスルーチ
3159	ンとして実現する場合にはtarget_ovrtimer_isrの名称とする．ターゲット非依
3160	存部のcall_ovrhdrを呼び出す．
3161
3162	target_timer_handlerは，標準的には次のように定義する．
3163
3164	----------------------------------------
3165	void
3166	target_ovrtimer_handler(void)
3167	{
3168	i_begin_int(<オーバランタイマ割込みの割込み番号>);
3169	オーバランタイマ割込み要求のクリア（必要なら）
3170	call_ovrhdr();
3171	i_end_int(<オーバランタイマ割込みの割込み番号>);
3172	}
3173	----------------------------------------
3174
3175	この関数は，target_timer.cfg中に記述する静的APIにより，割込みハンドラま
3176	たは割込みサービスルーチンとしてカーネルに登録することを想定している．
3177
3178	(6-14-2-7) OMIT_OVRTIMER_START
3179	(6-14-2-8) OMIT_OVRTIMER_STOP
3180
3181	ターゲット依存部から呼び出すovrtimer_startとovrtimer_stopを，アセンブリ
3182	言語のソースコード中に展開し，C言語の関数が不要になる場合には，それぞれ，
3183	OMIT_OVRTIMER_STARTとOMIT_OVRTIMER_STOPをマクロ定義する．
3184
3185	6.15 動的メモリ管理（オプション）
3186
3187	動的生成機能拡張パッケージを使用する場合には，カーネル内での動的メモリ
3188	管理の方法を決める必要がある．
3189
3190	動的生成機能拡張パッケージのターゲット非依存部では，メモリ領域を先頭か
3191	ら順に割り当て，解放されたメモリ領域を再利用しないメモリ管理モジュール
3192	のみを実装している．デフォルトでは，このメモリ管理モジュールが使用され
3193	る．
3194
3195	本格的な動的メモリ管理を行いたい場合には，ターゲット依存部またはユーザ
3196	側で，以下の関数を定義したメモリ管理モジュールを用意する必要がある．
3197
3198	(6-15-1) OMIT_KMM_ALLOCONLY（オプション）
3199
3200	ターゲット非依存部のメモリ管理モジュールを使用せず，ターゲット依存部ま
3201	たはユーザ側で用意する場合には，このシンボルをマクロ定義する．
3202
3203	(6-15-2) void initialize_kmm(void)（オプション）
3204
3205	メモリ管理モジュールを初期化する関数．カーネルの割り付けるメモリ領域の
3206	サイズと先頭番地は，それぞれkmmszとkmmによって参照できる．
3207
3208	(6-15-3) void *kernel_malloc(SIZE size)（オプション）
3209
3210	sizeで指定されたサイズのメモリ領域を割り付け，その先頭番地を返す関数．
3211	割り付けることができない場合には，NULLを返す．
3212
3213	(6-15-4) void kernel_free(void *ptr)（オプション）
3214
3215	ptrで指定されたメモリ領域を解放する関数．
3216
3217	6.15.1 TLSFを用いたメモリ管理モジュールの例
3218
3219	オープンソースのメモリ割付けライブラリであるTLSFを用いて動的メモリ管理
3220	を実現するには，OMIT_KMM_ALLOCONLYをマクロ定義し，以下の関数定義等をC言
3221	語ソースファイルに含めればよい．
3222
3223	----------------------------------------
3224	#include "tlsf.h"
3225
3226	static bool_t tlsf_initialized = false;
3227
3228	void
3229	initialize_kmm(void)
3230	{
3231	if (init_memory_pool(kmmsz, kmm) >= 0) {
3232	tlsf_initialized = true;
3233	}
3234	}
3235
3236	void *
3237	kernel_malloc(SIZE size)
3238	{
3239	if (tlsf_initialized) {
3240	return(malloc_ex(size, kmm));
3241	}
3242	else {
3243	return(NULL);
3244	}
3245	}
3246
3247	void
3248	kernel_free(void *ptr)
3249	{
3250	if (tlsf_initialized) {
3251	free_ex(ptr, kmm);
3252	}
3253	}
3254	----------------------------------------
3255
3256
3257	７．コンフィギュレータ設定ファイルのターゲット依存部
3258
3259	7.1 設定ファイルとターゲット依存部の位置付け
3260
3261	ASPカーネルのコンフィギュレータは，設定ファイルの記述に従ってファイルの
3262	生成およびエラーチェックを行う．コンフィギュレータの設定ファイルには，
3263	以下の4つがある．
3264
3265	(a) 静的APIテーブル
3266
3267	静的APIの一覧と，各静的APIのパラメータについて記述したファイル．静的
3268	APIを拡張する場合以外は変更する必要がないため，ターゲット非依存部で用意
3269	している（kernel/kernel_api.csv）．
3270
3271	(b) 値取得シンボルテーブル
3272
3273	コンフィギュレータのパス1において，パラメータ計算用C言語ファイルに出力
3274	し，値を求めたいシンボル（一般には式）を記述するためのファイル．ターゲッ
3275	ト非依存部では，ターゲットに依存せずに必要となるシンボルを記述したファ
3276	イルを用意している（kernel/kernel_def.csv）．
3277
3278	ターゲットに依存して必要となるシンボルがある場合には，targetディレクト
3279	リに置かれたtarget_def.csv中に記述する．target_def.csv中に記述して値を
3280	求めることができるシンボルは，kernel/kernel_int.hおよびそこからインクルー
3281	ドされるファイルで定義されていなければならない．kernel_int.hからは，
3282	target_stddef.h，target_kernel.h，target_config.hを（間接的に）インクルー
3283	ドしているため，これらのファイルおよびそこからインクルードされるファイ
3284	ルで定義されるターゲット依存のシンボルは，target_def.csv中に記述するこ
3285	とができる．
3286
3287	ここで値を求めたシンボルの値は，コンフィギュレータのパス2およびパス3の
3288	テンプレートファイル中で参照することができる．
3289
3290	(c) パス2のテンプレートファイル
3291
3292	コンフィギュレータのパス2は，テンプレートファイルに従って，カーネルの構
3293	成・初期化ファイル（kernel_cfg.c），構成・初期化ヘッダファイル
3294	（kernel_cfg.h）などを生成する．このテンプレートファイルは，ターゲット
3295	非依存部とターゲット依存部に切り分けてあるが，他のファイルのターゲット
3296	依存部とは逆に，ターゲット依存部からターゲット非依存部をインクルードす
3297	る形になっている．
3298
3299	具体的には，targetディレクトリに置かれたtarget.tfで，必要な変数を定義し
3300	た後，テンプレートファイルのターゲット非依存部（kernel/kernel.tf）をイ
3301	ンクルードする．kernel.tfでは，カーネルのターゲット非依存部で使用する変
3302	数定義等を生成する．kernel.tfをインクルードした後，target.tfでは，カー
3303	ネルのターゲット依存部で使用する変数定義等を生成する．target.tfから，プ
3304	ロセッサ依存部，チップ依存部を，開発環境依存部を切り分けてもよい．
3305
3306	(d) パス3のテンプレートファイル
3307
3308	コンフィギュレータのパス3は，テンプレートファイルに従って，静的APIの一
3309	般定数式パラメータのチェックを行う．このテンプレートファイルも，ターゲッ
3310	ト非依存部とターゲット依存部に切り分けてあり，ターゲット依存部からター
3311	ゲット非依存部をインクルードする形になっている．
3312
3313	具体的には，targetディレクトリに置かれたtarget_check.tfで，必要な変数を
3314	定義した後，テンプレートファイルのターゲット非依存部
3315	（kernel/kernel_check.tf）をインクルードする．kernel_check.tfでは，カー
3316	ネルのターゲット非依存部で初期化ブロックに出力した一般定数式パラメータ
3317	のチェックを行う．kernel_check.tfをインクルードした後，target_check.tf
3318	では，ターゲットに依存するチェックを行う．target_check.tfから，プロセッ
3319	サ依存部，チップ依存部を，開発環境依存部を切り分けてもよい．
3320
3321	なお，コンフィギュレータの詳細仕様と設定ファイルの記述方法については，
3322	別途PDFファイルの形で配布している「TOPPERS新世代カーネル用コンフィギュ
3323	レータ仕様」および「TOPPERS新世代カーネル用コンフィギュレータ内蔵マクロ
3324	プロセッサ仕様」を参照すること．
3325
3326	7.2 パス2のテンプレートファイルのターゲット依存部
3327
3328	以下では，パス2のテンプレートファイルのターゲット依存部を記述する上で必
3329	要な事項について説明する．
3330
3331	7.2.1 ターゲット非依存部をインクルードする前に定義すべき変数
3332
3333	target.tfからkernel.tfをインクルードする前に，次の変数を定義しておかな
3334	ければならない．
3335
3336	(7-2-1-1) INTNO_ATTISR_VALID ATT_ISRで使用できる割込み番号
3337	(7-2-1-2) INHNO_ATTISR_VALID INTNO_ATTISR_VALIDに対応する割込ハンドラ番号
3338	(7-2-1-3) INHNO_DEFINH_VALID DEF_INTで使用できる割込みハンドラ番号
3339	(7-2-1-4) EXCNO_DEFEXC_VALID DEF_EXCで使用できるCPU例外ハンドラ番号
3340	(7-2-1-5) INTNO_CFGINT_VALID CFG_INTで使用できる割込み番号
3341	(7-2-1-6) INTPRI_CFGINT_VALID CFG_INTで使用できる割込み優先度
3342
3343	APIで使用できる割込み番号／割込みハンドラ番号／CPU例外ハンドラ番号／割
3344	込み優先度のリストを，各変数に定義する．INHNO_ATTISR_VALIDには，
3345	INTNO_ATTISR_VALIDにリストアップした割込み番号に対応する割込みハンドラ
3346	番号のリストを定義する．CFG_INTには，すべての割込み番号を指定することが
3347	できるため，INTNO_CFGINT_VALIDには，有効な割込み番号をすべてリストアッ
3348	プする．
3349
3350	(7-2-1-7) INTNO_FIX_KERNEL（オプション）カーネル管理に固定されている
3351	割込み番号
3352	(7-2-1-8) INHNO_FIX_KERNEL（オプション）カーネル管理に固定されている
3353	割込みハンドラ番号
3354	(7-2-1-9) INHNO_FIX_NONKERNEL（オプション）カーネル管理外に固定されている
3355	割込み番号
3356	(7-2-1-10) INHNO_FIX_NONKERNEL（オプション）カーネル管理外に固定されている
3357	割込みハンドラ番号
3358
3359	カーネル管理またはカーネル管理外に固定されている割込みがある場合には，
3360	それらの割込み番号と割込みハンドラ番号のリストを，各変数に定義する．
3361
3362	(7-2-1-11) USE_INHINIB_TABLE（オプション）
3363
3364	OMIT_INITIALIZE_INTERRUPTを定義したが，割込みハンドラの初期化に必要な情
3365	報をkernel_cfg.cに生成したい場合には，この変数を1に設定する．具体的には，
3366	TNUM_INHNO，tnum_inhno，inhinib_tableの定義と，割込みハンドラ毎の出入口
3367	処理を生成するための記述（INTHDR_ENTRYマクロのリスト）が，ターゲット非
3368	依存部によって生成される．
3369
3370	(7-2-1-12) USE_INTINIB_TABLE（オプション）
3371
3372	OMIT_INITIALIZE_INTERRUPTを定義したが，割込み要求ラインの初期化に必要な
3373	情報をkernel_cfg.cに生成したい場合には，この変数を1に設定する．具体的に
3374	は，TNUM_INTNO，tnum_intno，intinib_tableの定義が，ターゲット非依存部に
3375	よって生成される．
3376
3377	(7-2-1-13) GENERATE_TSKINICTXB（オプション）
3378
3379	USE_TSKINICTXBをマクロ定義した場合，TSKINICTXBの初期化情報を生成するた
3380	めテンプレートファイル関数GENERATE_TSKINICTXBを定義する．
3381	GENERATE_TSKINICTXBには，タスクIDがパラメータとして渡される．
3382
3383	(7-2-1-14) ALLOC_STACK（オプション）
3384
3385	スタック領域の生成方法をデフォルトから変更したい場合には，スタック領域
3386	を生成するためのテンプレートファイル関数ALLOC_STACKを定義する．
3387	ALLOC_STACKには，スタック領域の変数名と丸める前のサイズがパラメータとし
3388	て渡されるので，スタック領域を生成するコードを生成し，大きい方に丸めた
3389	サイズを表す文字列を返す．
3390
3391	7.2.2 ターゲット非依存部で定義される変数
3392
3393	kernel.tfの中では次の変数が定義されるため，kernel.tfをインクルードした
3394	後，target.tfの中でこれらを参照することができる．
3395
3396	(7-2-2-1) INTNO[inhno] inhnoを対応するintnoに変換するための連想配列
3397	(7-2-2-2) INHNO[intno] intnoを対応するinhnoに変換するための連想配列
3398
3399	7.3 パス3のテンプレートファイルのターゲット依存部
3400
3401	以下では，パス3のテンプレートファイルのターゲット依存部を記述する上で必
3402	要な事項について説明する．
3403
3404	7.3.1 ターゲット非依存部をインクルードする前に定義すべき変数
3405
3406	target_check.tfからkernel_check.tfをインクルードする前に，必要に応じて，
3407	次の変数を定義しておかなければならない．
3408
3409	(7-3-1-1) GET_STK_TSKINICTXB（オプション）
3410
3411	USE_TSKINICTXBをマクロ定義した場合，TINIBからスタック領域の先頭番地を取
3412	り出すためのテンプレートファイル関数GET_STK_TSKINICTXBを定義する．
3413	GET_STK_TSKINICTXBには，タスク初期化ブロック（TINIB）の先頭番地がパラメー
3414	タとして渡される．CHECK_STACK_ALIGN，CHECK_STACK_NONNULLとも定義しない
3415	場合には，GET_STK_TSKINICTXBを定義する必要はない．
3416
3417	(7-3-1-2) LMA.ORDER_LIST（オプション）
3418	(7-3-1-3) LMA.START_DATA[lmano]（オプション）
3419	(7-3-1-4) LMA.END_DATA[lmano]（オプション）
3420	(7-3-1-5) LMA.START_IDATA[lmano]（オプション）
3421
3422	パス3のテンプレートファイルのターゲット依存部でdataセクションからデータ
3423	を取得する場合や，rodataセクションをRAMに置く場合（ユーザーズマニュアル
3424	の「11.8 rodataセクションをRAMに置く場合」の節を参照）には，これらのセ
3425	クションの内容を，配置アドレス（ROM内のアドレス，LMAと呼ぶ）からアクセ
3426	スアドレス（RAM内のアドレス，VMAと呼ぶ）にコピーする必要がある．
3427
3428	このコピーは，LMA.ORDER_LISTに，コピーするセクションの番号（lmano）のリ
3429	スト（番号は任意に付与してよい），LMA.START_DATA[lmano]にコピーするセク
3430	ションのアクセスアドレスの先頭のラベル，LMA.END_DATA[lmano]に末尾のラベ
3431	ル，LMA.START_IDATA[lmano]にその配置アドレスの先頭のラベルを設定するこ
3432	とで，パス3のテンプレートファイルのターゲット非依存部で実施する．
3433
3434	例えば，コピーするセクションのアクセスアドレスの先頭のラベルが
3435	"__data_start"，末尾のラベルが"__data_end"，その配置アドレスの先頭のラ
3436	ベルが"__idata_start"の場合には，パス3のテンプレートファイルのターゲッ
3437	ト依存部に以下の記述を含める．
3438
3439	----------------------------------------
3440	$LMA.ORDER_LIST = { 1 }$
3441	$LMA.START_DATA[1] = "__data_start"$
3442	$LMA.END_DATA[1] = "__data_end"$
3443	$LMA.START_IDATA[1] = "__idata_start"$
3444	----------------------------------------
3445
3446
3447	7.3.2 ターゲット依存部で行うべきエラーチェック
3448
3449	以下の先頭番地は，ターゲット非依存部で生成するテーブルに出力されないた
3450	め，パス3のターゲット非依存部（kernel_check.tf）では，プログラムの開始
3451	番地として正しくない場合のエラーをチェックしない．そのため，ターゲット
3452	依存部でエラーチェックを行う必要がある．
3453
3454	・割込みサービスルーチンの先頭番地（ATT_ISRのisr）
3455	・割込みハンドラの先頭番地（DEF_INHのinthdr）
3456	・CPU例外ハンドラの先頭番地（DEF_EXCのexchdr）
3457	・初期化ルーチンの先頭番地（ATT_INIのinirtn）
3458	・終了処理ルーチンの先頭番地（ATT_TERのterrtn）
3459
3460	ただし，ターゲット依存部においても，これらのエラーチェックを行えるとは
3461	限らないため，ユーザーズマニュアルの「1.5 既知の問題」の節には，ターゲッ
3462	ト依存でこれらのエラーが検出されないことがある旨を記載してある．
3463
3464	7.4 cfg1_out.cのリンクに必要なスタブの定義ファイル
3465
3466	コンフィギュレータに関してターゲット依存に用意する必要があるファイルと
3467	して，設定ファイル以外に，cfg1_out.cをリンクするために必要なスタブの定
3468	義ファイルがある．
3469
3470	コンフィギュレータのパス1では，静的APIの整数定数式パラメータの値をCコン
3471	パイラを用いて求めるために，cfg1_out.cを生成する．これをコンパイル，リ
3472	ンクしてオブジェクトファイルを生成する際に，スタートアップモジュールか
3473	ら参照されるシンボルの定義を与える必要がある．
3474
3475	この定義を与えるために，cfg1_out.cから，ターゲット依存部の
3476	target_cfg1_out.hをインクルードしている．target_cfg1_out.h（または，そ
3477	こからインクルードされるファイル）には，スタートアップモジュールから参
3478	照されるシンボルのスタブの定義を含める．典型的には，以下のような定義を
3479	含める必要がある．
3480
3481	----------------------------------------
3482	void sta_ker(void)
3483	{
3484	}
3485
3486	void hardware_init_hook(void)
3487	{
3488	}
3489
3490	void software_init_hook(void)
3491	{
3492	}
3493
3494	const SIZE _kernel_istksz = 0;
3495
3496	STK_T *const _kernel_istk = NULL;
3497	----------------------------------------
3498
3499	また，コンフィギュレータを用いてオフセットファイル（offset.h）を生成す
3500	る場合には，そのための記述をtarget_cfg1_out.h（または，そこからインクルー
3501	ドされるファイル）に追加する必要がある．詳しくは，「2.5.1 コンフィギュ
3502	レータを用いる方法」の節を参照すること．
3503
3504
3505	８．システムサービス等のターゲット依存部
3506
3507	8.0 システムサービスのターゲット依存部
3508
3509	シリアルポート数やシステムログタスク関連の定数など，システムサービスの
3510	構成を決定するための定義をtarget_syssvc.hまたはそこからインクルードされ
3511	るファイル（プロセッサ・チップ・開発環境依存部で用意されるヘッダファイ
3512	ルなど）に含める．
3513
3514	なお，TOPPERS組込みコンポーネントシステムが導入されると，このファイルの
3515	内容はコンポーネント記述ファイルに記述されることになり，このファイルは
3516	無くなる（または，大幅に縮小される）見込みである．
3517
3518	8.1 システムログ機能のターゲット依存定義
3519
3520	システムログ機能を使用する場合で，スタートアップモジュールでbssセクショ
3521	ンのクリアを省略している場合には，syslog_logmaskとsyslog_lowmask_notを
3522	0に初期化するコードを追加する．これは，システムログ機能が初期化される前
3523	に出力されたログ情報を，低レベル出力機能を用いて出力するためである．
3524
3525	ターゲット依存部で提供すべきシステムログ機能のための定義は次の通りであ
3526	る．
3527
3528	(8-1-1) TCNT_SYSLOG_BUFFER
3529
3530	システムログ機能のログバッファのサイズを定義するマクロ．定義しない場合
3531	のデフォルト値は32．
3532
3533	(8-1-2) void target_fput_log(char c)
3534
3535	システムログの低レベル出力のための文字出力関数．ターゲット依存の方法で，
3536	文字cを表示/出力/保存する．
3537
3538	この関数は，リエントラントに実装しなければならない．この関数内で排他制
3539	御が必要な場合には，SILを用いて全割込みロック状態にすること．また，全割
3540	込みロック状態で呼ばれる場合があるため，全割込みロック状態から呼び出す
3541	ことができない関数を呼ばないように実装しなければならない．
3542
3543	低レベル出力をシリアルポート経由で行う場合で，シリアルインタフェースド
3544	ライバとポートを共用しないことが望ましいが，ポート数が足りないためにや
3545	むをえず共用する場合には，両者が競合しないように注意が必要である．具体
3546	的には，両者が同じ設定でシリアルI/Oデバイスを使うようにし，シリアルイン
3547	タフェースドライバの動作中に低レベル出力が行われても差し支えないように
3548	設計する．また，低レベル出力が動作開始後にシリアルインタフェースドライ
3549	バがシリアルI/Oデバイスを初期化すると，文字化けが起こる可能性があるため，
3550	共用するポートは，低レベル出力機能側で初期化し，シリアルインタフェース
3551	ドライバでは初期化しないようにするとよい．
3552
3553	なお，この関数の本体を，どのファイルに記述するかが問題になる．システム
3554	サービスのターゲット依存部には，標準では，関数定義を記述するためのファ
3555	イルを用意していない．ターゲット依存で用意してもよいが，例外的に，カー
3556	ネル実装のターゲット依存モジュール（target_config.c）に記述してもよい．
3557	この場合，target_fput_logを，リネーム記述（target_rename.defなど）に含
3558	めてはならない．
3559
3560	8.2 ログタスクのターゲット依存定義
3561
3562	ターゲット依存部で提供すべきログタスクのための定義は次の通りである．こ
3563	れらの定義は，target_syssvc.hまたはそこからインクルードされるファイルに
3564	含める．
3565
3566	(8-2-1) LOGTASK_PRIORITY（オプション）
3567
3568	ログタスクの優先度を定義するマクロ．定義しない場合のデフォルト値は3．
3569
3570	(8-2-2) LOGTASK_STACK_SIZE（オプション）
3571
3572	ログタスクのスタックサイズを定義するマクロ．定義しない場合のデフォルト
3573	値は1024．
3574
3575	(8-2-3) LOGTASK_PORTID（オプション）
3576
3577	ログタスクの出力先のシリアルポート番号．定義しない場合のデフォルト値は1．
3578
3579	(8-2-4) LOGTASK_INTERVAL（オプション）
3580
3581	ログタスクの動作間隔（単位はミリ秒）．定義しない場合のデフォルト値は10．
3582
3583	(8-2-5) LOGTASK_FLUSH_WAIT（オプション）
3584
3585	ログ出力を待ち合わせる処理において，タスクを待たせる単位となる時間（単
3586	位はミリ秒）．定義しない場合のデフォルト値は1．
3587
3588	8.3 シリアルインタフェースドライバのターゲット依存部
3589
3590	ターゲット依存部で提供すべきシリアルインタフェースドライバのための定義
3591	は次の通りである．これらの定義は，別に指定がない限り，target_serial.hま
3592	たはそこからインクルードされるファイルに含め，必要なコンフィギュレーショ
3593	ン情報をtarget_serial.cfgに記述する．関数の実体が必要な場合には，
3594	target_serial.c等のファイルを用意する．
3595
3596	シリアルインタフェースドライバの中で，ターゲットのシリアルI/Oデバイスに
3597	依存する部分を，シリアルI/Oデバイスドライバと呼ぶ．シリアルI/Oデバイス
3598	ドライバは，おおよそ，ITRONデバイスドライバ設計ガイドラインのPDICに相当
3599	する．PDICに相当するファイルで，他のシステムにも共通に使える可能性があ
3600	る場合には，pdicディレクトリに置く．
3601
3602	8.3.1 変数，データ型，管理関数
3603
3604	(8-3-1-1) TNUM_PORT
3605
3606	シリアルインタフェースドライバがサポートするシリアルポート数を定義する
3607	マクロ．このマクロの定義は，target_syssvc.hまたはそこからインクルードさ
3608	れるファイルに含める．
3609
3610	(8-3-1-2) void sio_initialize(intptr_t exinf)（オプション）
3611
3612	シリアルI/Oデバイスドライバの初期化処理．target_serial.cfgに，この関数
3613	を初期化ルーチンとして登録する静的APIを含める．
3614
3615	(8-3-1-3) void sio_terminate(intptr_t exinf)（オプション）
3616
3617	シリアルI/Oデバイスドライバの終了処理．target_serial.cfgに，この関数を
3618	終了処理ルーチンとして登録する静的APIを含める．
3619
3620	(8-3-1-4) void sio_isr(intptr_t exinf)
3621
3622	シリアルI/Oデバイスの割込みサービスルーチン．target_serial.cfgに，この
3623	関数を割込みサービスルーチンとして登録する静的APIを含める．また，その静
3624	的APIに必要なシリアルI/Oデバイスの割込み番号などは，target_serial.hでマ
3625	クロ定義する．割込みサービスルーチンではなく，割込みハンドラとすること
3626	もできる．
3627
3628	(8-3-1-5) SIOPCB
3629
3630	シリアルI/Oポート管理ブロックのデータ型（target_serial.hには，データ型
3631	の宣言だけ含まれていればよい）．
3632
3633	(8-3-1-6) SIO_RDY_SNDとSIO_RDY_RCV
3634
3635	送信可能コールバックの識別番号をSIO_RDY_SNDに，受信通知コールバックの識
3636	別番号をSIO_RDY_RCVにマクロ定義する．コールバックの禁止／許可を行なうサー
3637	ビスコール（sio_ena_cbrとsio_dis_cbr）で用いる．
3638
3639	8.3.2 デバイスサービスルーチン
3640
3641	以下のデバイスサービルルーチンは，（少なくとも）シリアルI/Oポートからの
3642	割込みがマスクされた状態で呼び出される．また，タスクコンテキスト，非タ
3643	スクコンテキストのいずれで呼び出される場合もある（いずれで呼び出されて
3644	も動作するようにしなければならない）．
3645
3646	(8-3-2-1) SIOPCB *sio_opn_por(ID siopid, intptr_t exinf)
3647
3648	siopidで指定されるシリアルI/Oポートをオープンする関数．exinfはシリアル
3649	I/Oポートに対する拡張情報で，コールバックを呼ぶ時にポートを区別するた
3650	めに渡す．
3651
3652	(8-3-2-2) void sio_cls_por(SIOPCB *siopcb)
3653
3654	siopcbで指定されるシリアルI/Oポートをクローズする関数．
3655
3656	(8-3-2-3) bool_t sio_snd_chr(SIOPCB *siopcb, char c)
3657
3658	siopcbで指定されるシリアルI/Oポートに，cで示される文字を送信する関数．
3659	文字を送信レジスタに入れた場合にはtrueを，前に送信した文字の送信が終わっ
3660	ていないために，文字を送信レジスタに入れられなかった場合にはfalseを返す．
3661
3662	(8-3-2-4) int_t sio_rcv_chr(SIOPCB *siopcb)
3663
3664	siopcbで指定されるシリアルI/Oポートから文字を読む関数．文字を受信してい
3665	た場合，読んだ文字のコードは正の値として返し，文字を受信していない場合
3666	には-1を返す．
3667
3668	(8-3-2-5) void sio_ena_cbr(SIOPCB *siopcb, uint_t cbrtn)
3669
3670	siopcbで指定されるシリアルI/Oポートからの，cbrtnで指定されるコールバッ
3671	クを許可する．cbrtnには，SIO_RDY_SNDかSIO_RDY_RCVを指定できる．
3672
3673	(8-3-2-6) void sio_dis_cbr(SIOPCB *siopcb, uint_t cbrtn)
3674
3675	siopcbで指定されるシリアルI/Oポートからの，cbrtnで指定されるコールバッ
3676	クを禁止する．cbrtnには，SIO_RDY_SNDかSIO_RDY_RCVを指定できる．
3677
3678	8.3.3 コールバックルーチン
3679
3680	ターゲット依存部は，必要なタイミングで，シリアルインタフェースドライバ
3681	のターゲット非依存部に含まれる以下のコールバックルーチンを呼び出びださ
3682	なければならない．ただし，それぞれのコールバックが禁止されている時は，
3683	コールバックルーチンを呼び出してはならない．
3684
3685	コールバックルーチンは，（少なくとも）シリアルI/Oポートからの割込みが禁
3686	止された状態で，非タスクコンテキストで呼び出す．exinfには，シリアルI/O
3687	ポートのオープン時に指定された拡張情報を渡す．
3688
3689	(8-3-3-1) void sio_irdy_snd(intptr_t exinf)
3690
3691	送信可能コールバックルーチン．シリアルI/Oポートに対して文字が送信できる
3692	状態になった場合に呼び出す．シリアルインタフェースドライバは，このコー
3693	ルバックルーチンの中で，sio_snd_chrを呼び出して次の文字を送信するか，送
3694	信すべき文字がない場合には送信可能コールバックを禁止する．
3695
3696	(8-3-3-2) void sio_irdy_rcv(intptr_t exinf)
3697
3698	受信通知コールバックルーチン．シリアルI/Oポートから文字を受信した場合に
3699	呼び出す．シリアルインタフェースドライバは，このコールバックルーチンの
3700	中で，必ずsio_rcv_chrを呼び出して受信した文字を取り出す．
3701
3702	8.4 カーネル起動メッセージの出力のターゲット依存定義
3703
3704	ターゲット依存部で提供すべきカーネル起動メッセージの出力のための定義は
3705	次の通りである．
3706
3707	(8-4-1) TARGET_NAME
3708
3709	ターゲットの名称に定義する．
3710
3711	(8-4-2) TARGET_COPYRIGHT（オプション）
3712
3713	カーネル起動メッセージに，ターゲット依存部の著作権表示を追加するための
3714	マクロ．デフォルトでは，ターゲット依存部の著作権表示を追加しない．
3715
3716	8.5 サンプルプログラムとテストプログラムのターゲット依存定義
3717
3718	ターゲット依存部で提供すべきサンプルプログラムおよびテストプログラムの
3719	ための定義は次の通りである．これらの定義は，target_test.h（またはそれら
3720	からインクルードされるファイル）に含める．
3721
3722	(8-5-1) STACK_SIZE（オプション）
3723
3724	サンプルプログラムおよびテストプログラムのタスクのスタックサイズを定義
3725	するマクロ．定義しない場合のデフォルト値は4096．デフォルト設定ではメモ
3726	リが不足する場合や，シミュレーション環境などで大きいスタック領域が必要
3727	な場合には，ターゲット依存部でこのマクロを設定するスタックサイズに定義
3728	する．
3729
3730	(8-5-2) CPUEXC1（オプション）
3731
3732	サンプルプログラムおよびテストプログラムで用いるCPU例外のCPU例外ハンド
3733	ラ番号を定義するマクロ．このマクロを定義しない場合，CPU例外ハンドラを使
3734	う部分がサンプルプログラムから除外される．CPU例外ハンドラのテストをする
3735	テストプログラムはコンパイルできない．
3736
3737	(8-5-3) RAISE_CPU_EXCEPTION（オプション）
3738
3739	CPUEXC1に定義したCPU例外を発生させるC言語のプログラムを定義するマクロ．
3740	CPUEXC1を定義した場合には必ず定義しなければならない．
3741
3742	(8-5-4) CANNOT_RETURN_CPUEXC（オプション）
3743
3744	ターゲットシステムの制約により，CPU例外ハンドラからリターンした後に，タ
3745	スクの実行を継続できない場合に定義するマクロ．このマクロを定義すると，
3746	CPU例外ハンドラのテストをするテストプログラムから，CPU例外ハンドラから
3747	リターンした後の処理が除外される．サンプルプログラムの該当部分は正しく
3748	動作しない．
3749
3750	(8-5-5) TASK_PORTID（オプション）
3751
3752	サンプルプログラムにおいて，コマンド文字を読み込むシリアルポート番号を
3753	定義するマクロ．定義しない場合のデフォルト値は1．
3754
3755	(8-5-6) LOOP_REF（オプション）
3756
3757	サンプルプログラムにおいて，プロセッサの速度を計測するためのループ回数
3758	を定義するマクロ．定義しない場合のデフォルト値は1000000．デフォルト設定
3759	では，値が大き過ぎて計測に時間がかかりすぎる場合や，値が小さ過ぎて計測
3760	結果が安定しない場合に，ターゲット依存部でこのマクロを設定するループ回
3761	数に定義する．
3762
3763	(8-5-7) MEASURE_TWICE（オプション）
3764
3765	サンプルプログラムにおいて，プロセッサの速度を2度計測する場合に定義する
3766	マクロ．シミュレーション環境などプロセッサの速度が変動する環境で，1度の
3767	計測では計測結果が安定しない場合に定義する．
3768
3769	(8-5-8) TASK_LOOP（オプション）
3770
3771	サンプルプログラムにおいて，プロセッサの速度を計測せずに，タスク内での
3772	ループ回数を固定する場合に，ループ回数を定義するマクロ．ループ全体の実
3773	行時間が0.4秒程度になるようなループ回数を，このマクロに定義する．
3774
3775	8.6 実行時間分布集計モジュールのターゲット依存定義
3776
3777	実行時間分布集計モジュールの設定をターゲット依存部で変更する場合に，ター
3778	ゲット依存部で提供すべき実行時間分布集計モジュールのための定義は次の通
3779	りである．これらの定義は，target_test.h（またはそこからインクルードされ
3780	るファイル）に含める．この他に，ターゲット依存で必要な初期化処理がある
3781	場合にも，ターゲット依存部に含める．
3782
3783	(8-6-1) HISTTIM（オプション）
3784
3785	実行時間計測用の時刻のデータ型を定義するマクロ．定義しない場合のデフォ
3786	ルトはSYSUTM．
3787
3788	(8-6-2) void HIST_GET_TIM(HISTTIM *p_time)（オプション）
3789
3790	実行時間計測用の現在時刻を*p_timeに取得する処理に定義するマクロ．定義し
3791	ない場合のデフォルトはget_utm．
3792
3793	(8-6-3) uint_t HIST_CONV_TIM(HISTTIM time)（オプション）
3794
3795	実行時間計測用の時刻の差（時間）を，実行時間分布集計用の値に変換する処
3796	理に定義するマクロ．時刻が過去に戻ったかオーバフローしたかの区別がつか
3797	ない場合には，最上位ビットが1の値（INT_MAXよりも大きい値）を返す．定義
3798	しない場合のデフォルトは，timeをuint_tにキャストする処理．
3799
3800	(8-6-4) void HIST_BM_HOOK(void)（オプション）
3801
3802	実行時間計測直前に行うべき処理に定義するマクロ．キャッシュのパージやフィ
3803	ル，メモリバリア処理等を行いたい場合には，このマクロに定義する．定義し
3804	ない場合のデフォルトは，空の処理になる．
3805
3806
3807	９．その他
3808
3809	9.1 ドキュメント
3810
3811	ターゲット依存部のユーザーズマニュアルを，target_user.txtに用意する．プ
3812	ロセッサ・チップ・開発環境依存部のユーザーズマニュアルを切り分けてもよ
3813	いし，ファイルが大きくなる場合には複数のファイルに分割してよいが，その
3814	場合には，target_user.txt中にそれらのファイル名を記述すること．
3815
3816	ターゲット依存部のユーザーズマニュアルには，少なくとも次のような内容を
3817	記述することが望ましい．
3818
3819	(1) 対応しているターゲットシステムの種類・構成，バージョン番号
3820	・ターゲットハードウェア（ボード等）の名称と対応している構成
3821	・ターゲット略称
3822	・ターゲット非依存部のバージョン番号
3823	・プロセッサ，チップ，開発環境依存部の構成とバージョン番号
3824	・使用するPDICとバージョン番号
3825
3826	(2) 使用する開発環境と動作検証した条件（バージョン，オプション等）
3827	・言語処理系（コンパイラ，アセンブラ，リンカ等）
3828	・デバッグ環境
3829
3830	(3) ターゲット定義事項の規定
3831
3832	(3-1) データ型に関する規定
3833	・int_t型，long_t型のサイズ
3834	・char型，int_least8_t型，void *型，intptr_t型のサイズ
3835	・int8_t型，uint8_t型，int64_t型，uint64_t型，int128_t型，
3836	uint128_t型，float32_t型，double64_t型のサポートの有無
3837
3838	(3-2) 割込み処理に関する規定
3839	・割込みハンドラ番号と割込み番号の割当て，両者の対応
3840	・割込み優先度の段階数（TMIN_INTPRIの値）
3841	・dis_intとena_intのサポートの有無，その制限事項
3842	・CFG_INTの制限事項と拡張（ターゲット定義で使用できる割込み属性）
3843	・TOPPERS標準割込み処理モデルからのその他の逸脱
3844	・デフォルトの割込みハンドラ（default_int_handler）の有無と処理内容
3845
3846	(3-3) カーネル管理外の割込みに関する規定
3847	・TMIN_INTPRIは固定か設定できるか，その設定方法
3848	・NMI以外にカーネル管理外の割込みを設けるか（設けられるようにするか）
3849	・カーネル管理外の割込みの設定方法
3850	・カーネル管理外の割込みに対してDEF_INH，CFG_INTをサポートするか
3851	・カーネル管理外の割込みハンドラが実行開始される時のシステム状態と
3852	コンテキスト
3853	・割込みハンドラの終了時に行われる処理
3854	・カーネル管理外の割込みハンドラの記述方法
3855	・カーネル内の割込み出入口処理で起こる可能性のあるCPU例外
3856
3857	(3-4) CPU例外処理に関する規定
3858	・CPU例外ハンドラ番号の割当て
3859	・割込み優先度マスクをTMIN_INTPRIと同じかそれよりも高い値に設定して
3860	いる状態で発生したCPU例外を，カーネル管理外のCPU例外と扱うか
3861	・カーネル内のCPU例外出入口処理で起こる可能性のあるCPU例外
3862	・デフォルトのCPU例外ハンドラ（default_exc_handler）の有無と処理内容
3863
3864	(3-5) 性能評価用システム時刻の参照に関する規定
3865	・get_utmのサポートの有無，その制限事項
3866
3867	(3-6) 拡張パッケージに関する規定
3868	・各拡張パッケージのサポートの有無
3869	- ミューテックス機能拡張パッケージ
3870	- オーバランハンドラ機能拡張パッケージ
3871	- タスク優先度拡張パッケージ
3872	- 制約タスク拡張パッケージ
3873	- 動的生成機能拡張パッケージ
3874	・オーバランハンドラ機能拡張パッケージをサポートする場合に，プロセッ
3875	サ時間に指定できる値の最大値（TMAX_OVRTIMの値）
3876	・動的生成機能拡張パッケージをサポートする場合に，動的メモリ管理の
3877	方法
3878
3879	(3-7) その他
3880	・その他の制限事項
3881	・その他の拡張機能
3882
3883	(4) カーネルの起動／終了処理に関する情報
3884	・用意しているスタートアップモジュールの処理内容
3885	・スタートアップモジュールからhardware_init_hookを呼び出している場
3886	合には，hardware_init_hookをアプリケーションで用意する場合の作成
3887	方法や制限事項など
3888	・カーネルを終了した後の振舞い
3889
3890	(5) メモリマップ
3891	・デフォルトのメモリマップ，その変更方法
3892
3893	(6) タイマドライバ関連の情報
3894	・タイムティックの周期，その変更方法
3895	・使用するリソース（タイマ）
3896	・タイマ割込みの割込み優先度の変更方法
3897	・オーバランタイマ割込みの割込み優先度の変更方法
3898
3899	(7) シリアルインタフェースドライバの情報
3900	・使用するリソース（SIOコントローラ）
3901	・通信パラメータ（ボーレート，ビット数，パリティの有無，ストップビット）
3902
3903	(8) システムログ機能の情報
3904	・システムログの低レベル出力の実現方法
3905	・通信パラメータ（ボーレート，ビット数，パリティの有無，ストップビット）
3906
3907	(9) システム構築手順
3908
3909	(10) ターゲットシステム固有の注意事項
3910	・タスクコンテキストに含まれるレジスタ，含まれないレジスタ
3911
3912	(11) 類似のターゲットにポーティングする開発者向けの参考情報
3913
3914	(12) ディレクトリ構成・ファイル構成
3915
3916	(13) バージョン履歴
3917
3918	また，必要に応じて，ターゲット依存部の設計メモを，target_design.txtに用
3919	意する．プロセッサ・チップ・開発環境依存部に関する設計メモを切り分けて
3920	もよいし，ファイルが大きくなる場合には複数のファイルに分割してもよいが，
3921	その場合には，target_design.txt中にそれらのファイル名を記述すること．
3922
3923	9.2 パッケージ記述ファイル
3924
3925	リリースパッケージ（個別パッケージおよび簡易パッケージ）を作成するため
3926	に，パッケージに含めるファイルを記述したパッケージ記述ファイルを用意す
3927	る．パッケージ記述ファイルの名称は，個別パッケージ用をMANIFEST，簡易パッ
3928	ケージ用をE_PACKAGEとする．
3929
3930	例えば，arch/arm_gccディレクトリに置かれたMANIFESTファイルを用いて個別
3931	パッケージを作成する場合には，次のコマンドを実行する．
3932
3933	% utils/makerelease arch/arm_gcc/MANIFEST
3934
3935	このコマンドにより，RELEASE/asp_arch_arm_gcc-<バージョン番号>.tar.gzが
3936	作成される．また，target/at91skyeye_gccディレクトリに置かれたE_PACKAGE
3937	ファイルを用いて簡易パッケージを作成する場合には，次のコマンドを実行す
3938	る．
3939
3940	% utils/makerelease target/at91skyeye_gcc/E_PACKAGE
3941
3942	このコマンドにより，RELEASE/asp_at91skyeye_gcc-<バージョン番号>.tar.gz
3943	が作成される（RELEASEディレクトリがない場合には，ディレクトリが作られ
3944	る）．
3945
3946	なお，makereleaseユーティリティは，ASPカーネルのソースファイルが置かれ
3947	たディレクトリが，aspという名称であることを仮定している（異なる名称の場
3948	合でもパッケージは作成できるが，パッケージを展開した時に展開されるディ
3949	レクトリがaspでなくなる）．また，標準のtarコマンドがGNU tarであること
3950	（正確には，zオプションに対応していること）を想定している．
3951
3952	パッケージ記述ファイルには，パッケージに含めるファイル名を，パッケージ
3953	記述ファイルが置かれたディレクトリからの相対パス名で，1行に1つずつ記述
3954	する．また，必要に応じて，以下のディレクティブを含める．
3955
3956	(a) E_PACKAGE <簡易パッケージ名>
3957
3958	簡易パッケージ名を指定する．簡易パッケージ記述ファイル（E_PACKAGE）の先
3959	頭に記述する．簡易パッケージ名は，asp_<ターゲット略称>とする．例えば，
3960	ターゲット略称がat91skyeye_gccの場合には，asp_at91skyeye_gccとなる．個
3961	別パッケージと区別するために，簡易パッケージのファイル名には"target"を
3962	含めない．
3963
3964	(b) PACKAGE <個別パッケージ名>
3965
3966	個別パッケージ名を指定する．個別パッケージ記述ファイル（MANIFEST）の先
3967	頭に記述する．また，そこからインクルードされる各ファイルの先頭にも記述
3968	し，それをインクルードしている個別パッケージ名を指定する．ターゲット依
3969	存部の個別パッケージ名は，個別パッケージ記述ファイルが置かれたディレク
3970	トリの相対パス中の"/"を"_"に置き換えた文字列を，"asp_"の後につなげたも
3971	のとする．例えば，個別パッケージ記述ファイルがarch/arm_gcc/MANIFESTの場
3972	合には，asp_arch_arm_gccとなる．
3973
3974	(c) VERSION <バージョン番号>
3975
3976	パッケージのバージョン番号を指定する．簡易パッケージ記述ファイルおよび
3977	個別パッケージ記述ファイルの中に記述する．簡易パッケージにおいて，バー
3978	ジョン番号をパッケージ化した日付とする場合には，パッケージ番号の代わり
3979	に%dateと記述する．
3980
3981	バージョン番号の付与方法については，「TOPPERS/ASPカーネルユーザーズマ
3982	ニュアル」の「2.2 簡易パッケージ」および「2.3 個別パッケージ」の節を参
3983	照すること．
3984
3985	(d) INCLUDE <ファイル名>
3986
3987	別のパッケージ記述ファイルをインクルードする．簡易パッケージ記述ファイ
3988	ルからは，個別パッケージ記述ファイルのみをインクルードするのを原則とす
3989	る．個別パッケージ記述ファイルからインクルードされるファイル中で指定さ
3990	れる個別パッケージ名は，すべて一致していなければならない．
3991
3992
3993	１０．リファレンス
3994
3995	10.1 ターゲット依存部のファイル一覧
3996
3997	標準的なターゲット依存部のファイル構成は次の通りである．
3998
3999	Makefile.target Makefileのターゲット依存部（２章）．
4000	target_offset.tf オフセットファイル生成用テンプレートファイル（2.5.1節，
4001	オプション）
4002
4003	target_stddef.h TOPPERS共通定義（t_stddef.h）のターゲット依存部（３
4004	章）．アプリケーションとカーネルの両方からインクルー
4005	ドされる．
4006	target_sil.h システムインタフェースレイヤ（sil.h）のターゲット依
4007	存部（４章）．アプリケーションとカーネルの両方から
4008	インクルードされる．
4009	target_kernel.h カーネルAPI（kernel.h）のターゲット依存部（５章）．
4010	アプリケーションとカーネルの両方からインクルードさ
4011	れる．
4012
4013	target_config.h カーネル実装のターゲット依存部のヘッダファイル（６
4014	章）．カーネルのみからインクルードされる．
4015	target_config.c カーネル実装のターゲット依存部のC言語で記述される
4016	部分（６章，オプション）．
4017	target_support.S カーネル実装のターゲット依存部のアセンブリ言語で記
4018	述される部分（６章，オプション）．
4019	target_rename.def カーネル実装のターゲット依存部のためのリネーム記述
4020	（6.12節）．
4021	target_rename.h target_rename.defから生成されるファイル（6.12節）．
4022	target_unrename.h target_rename.defから生成されるファイル（6.12節）．
4023	target_timer.cfg タイマドライバのシステムコンフィギュレーションファ
4024	イル（6.13節）．
4025	target_timer.h タイマドライバのヘッダファイル（6.13節）．カーネル
4026	のみからインクルードされる．
4027	target_timer.c タイマドライバの実装ファイル（6.13節，オプション）．
4028	システム略称.h ターゲットのハードウェア資源（割込みハンドラ番号や
4029	CPU例外ハンドラ番号，デバイスレジスタの番地など）の
4030	定義を含むヘッダファイル．アプリケーションとカーネ
4031	ルの両方からインクルードされる（６章，オプション）．
4032
4033	target_def.csv コンフィギュレータの値取得シンボルテーブルのターゲッ
4034	ト依存部（７章，オプション）．
4035	target.tf コンフィギュレータのパス2のテンプレートファイルの
4036	ターゲット依存部（7.2節）．
4037	target_check.tf コンフィギュレータのパス3のテンプレートファイル（7.3
4038	節）．
4039	target_cfg1_out.h cfg1_out.cのリンクに必要なスタブの定義ファイル（7.4
4040	節）．
4041
4042	target_syssvc.h システムサービスのターゲット依存定義（8.0節）．
4043	target_serial.cfg シリアルドライバのシステムコンフィギュレーションファ
4044	イル（8.3節）．
4045	target_serial.h シリアルドライバのヘッダファイル（8.3節）．シリアル
4046	ドライバのみからインクルードされる．
4047	target_serial.c シリアルドライバの実装ファイル（8.3節，オプション）．
4048	target_test.h テストプログラムのターゲット依存定義（8.4節）．
4049
4050	target_user.txt ユーザーズマニュアル（9.1節）
4051	target_design.txt 設計メモ（9.1節，オプション）
4052	MANIFEST 個別パッケージに含めるファイルのリスト（9.2節，オプ
4053	ション）
4054	E_PACKAGE 簡易パッケージに含めるファイルのリスト（9.2節，オプ
4055	ション）
4056
4057	以上

Note: See TracBrowser for help on using the repository browser.

Context Navigation

source: rubycfg_asp/trunk/asp_dcre/doc/porting.txt@ 315

Download in other formats: