user.txt

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

システムログ怠墙の捏丁する橙磨サ〖ビスコ〖ルは肌の奶りであるˉ

(1) ER syslog_write(UINT prio, SYSLOG *p_syslog)

システムログ怠墙に·脚络刨 prio でログ攫鼠を1つ叫蜗する∈ログバッファ
へ淡峡するか你レベル叫蜗怠墙を脱いて叫蜗する∷ˉSYSLOG は·ログ攫鼠を
呈羌するためのデ〖タ房で·この橙磨サ〖ビスコ〖ルには·叫蜗するログ攫鼠
へのポインタを畔すˉ

(2) ER_UINT syslog_read(SYSLOG *p_syslog)

ログバッファからログ攫鼠を1つ艰り叫すˉログバッファが鄂の箕は E_OBJ·
そうでない眷圭は·己われたログ攫鼠の眶∈ログ攫鼠が己われていない眷圭は 
0∷を手すˉシステムログタスクが脱いることを鳞年している∈システムログ
怠墙柒婶でも脱いている∷ˉ

(3) ER syslog_setmask(UINT logmask, UINT lowmask)

淡峡または叫蜗すべきログ攫鼠の脚络猛のビットマスク∈logmask∷と·你レ
ベル叫蜗怠墙を脱いて叫蜗すべきログ攫鼠の脚络猛のビットマスク∈lowmask∷
を肋年するˉlowmask で·logmask に肋年されていないビットが肋年されてい
ても·罢蹋を积たない∈エラ〖にもならない∷ˉ

4.5 システムログ怠墙のためのライブラリ簇眶とマクロ

システムログ怠墙は·惧淡のサ〖ビスコ〖ルに裁えて·肌のライブラリ簇眶と
マクロを捏丁するˉ

(1) void syslog_n(UINT prio, const char *format, arg1, ..., argn)
    ⅷ n は 0×5 のいずれかˉ

format 矢机误およびそれに鲁く苞眶から侯喇されるメッセ〖ジを·脚络刨 
prio でログ攫鼠として叫蜗するためのマクロˉformat はメッセ〖ジのフォ〖
マット淡揭·arg1×argn はフォ〖マット淡揭面で徊救される猛で·printf の
フォ〖マット淡揭のサブセットとなっているˉarg1×argn は VP_INT房にキャ
ストされるため·VP_INT房に房恃垂できる扦罢の房を畔すことができ·房チェッ
クはされないˉformat および arg1×argn には·肌の扩嘎があるˉ

ˇformat のフォ〖マット淡揭は·このマクロから提った稿も恃步してはなら
ないˉ

ˇformat 面に蝗えるフォ〖マット回年は肌の奶りˉ

    %d    苞眶を射规烧き腊眶とみなし·10渴眶で山绩
    %u    苞眶を射规痰し腊眶とみなし·10渴眶で山绩
    %x    苞眶を射规痰し腊眶とみなし·16渴眶∈毖矢机は井矢机∷で山绩
    %X    苞眶を射规痰し腊眶とみなし·16渴眶∈毖矢机は络矢机∷で山绩
    %c    苞眶を矢机コ〖ドとみなし·矢机を山绩
    %s    苞眶を矢机误を绩すポインタとみなし·矢机误を山绩
    %%    '%' を山绩∈苞眶は艰らない∷

%d, %u, %x, %X においては·'%' の木稿に山绩峰眶を回年する10渴眶猛を淡揭
することができるˉその眷圭·山绩すべき矢机误が回年した峰眶に塔たない眷
圭には·回年した峰眶柒に宝低めで山绩するˉ10渴眶猛が '0' で幌まる眷圭
には·その粗に '0' を虽めるˉ

ˇarg1×argn にポインタを畔す眷圭∈%s に滦炳する苞眶の眷圭∷に·ポイン
タの回すデ〖タは·このマクロから提った稿も恃步してはならないˉ

(2) void _syslog_n(UINT prio, const char *format,
				VP_INT arg1, ..., VP_INT argn)
    ⅷ n は 0×5 のいずれかˉ

format 矢机误およびそれに鲁く苞眶から侯喇されるメッセ〖ジを·脚络刨 
prio でログ攫鼠として叫蜗するためのライブラリ簇眶ˉformat および arg1
×argn には·syslog_n と票屯の扩嘎があるˉ

(3) void syslog(UINT prio, const char *format, ...)

format 矢机误およびそれに鲁く苞眶から侯喇されるメッセ〖ジを·脚络刨 
prio でログ攫鼠として叫蜗するためのライブラリ簇眶で·苞眶の眶を材恃に
したものˉformat に鲁く苞眶は呵络5改までˉformat およびそれに鲁く苞眶
には·syslog_n と票屯の扩嘎があるˉ

このライブラリ簇眶は·材恃眶苞眶を借妄するために柒婶で矢机误をスキャン
するˉそのため·悸乖箕粗が墓くなる材墙拉があり·充哈み敦贿觉轮で钙び叫
すべきではないˉ肩にアプリケ〖ションプログラムが脱いることを鳞年してい
るˉそのため·このライブラリ簇眶のソ〖スファイルは·サポ〖トライブラリ
のディレクトリに弥いているˉ

(4) UINT LOG_MASK(UINT prio)

脚络刨 prio のみセットされたビットマップを侯るマクロˉsyslog_setmask 
に畔す苞眶を侯るために脱いるˉ

(5) UINT LOG_UPTO(UINT prio)

脚络刨 prio 笆惧の脚络刨がすべてセットされたビットマップを侯るマクロˉ
syslog_setmask に畔す苞眶を侯るために脱いるˉ

(6) void syslog_printf(SYSLOG *p_syslog, void (*putc)(char))

システムログ怠墙脱のフォ〖マット叫蜗するためのライブラリ簇眶ˉシステム
ログタスクが脱いることを鳞年しているが·システムログ怠墙柒婶でも脱いて
いる∈そのため·このライブラリ簇眶のソ〖スファイルは·カ〖ネルのディレ
クトリに弥かれている syslog.c に崔めている∷ˉ

4.6 システムログ怠墙の肋年数恕

JSPカ〖ネルのシステムログ怠墙の鳞年されている肋年数恕は·笆布の奶りで
あるˉ

(a) 脚络な佰撅祸据を绩すログ攫鼠は你レベル叫蜗怠墙を脱いて叫蜗し·そう
でないログ攫鼠の叫蜗はシステムログタスクに扦せるˉ

ログバッファに淡峡するログ攫鼠の脚妥刨と·你レベル叫蜗を脱いて叫蜗する
ログ攫鼠の脚妥刨を努磊に肋年するˉまた·ログバッファからログ攫鼠を粕み
叫して嘲婶へ奶梦するシステムログタスクと·你レベルの矢机叫蜗簇眶を脱罢
するˉ

(b) すべてのログ攫鼠を·你レベル叫蜗怠墙を脱いて叫蜗するˉ

涩妥なログ攫鼠はすべて你レベル叫蜗怠墙を脱いて叫蜗するよう肋年
∈syslog_setmask の尉パラメ〖タを票じ猛に肋年∷するˉまた·你レベルの
矢机叫蜗簇眶を脱罢するˉ

(c) ログ攫鼠はメモリ惧に淡峡するだけで·システム嘲婶には叫蜗しないˉ

涩妥なログ攫鼠はすべてログバッファへ淡峡するように肋年∈syslog_setmask 
の妈2パラメ〖タを 0 に肋年∷するˉシステムログタスクは稍妥ˉ

(d) ログ攫鼠は淡峡も叫蜗もしないˉ

いずれのログ攫鼠も淡峡】叫蜗しないように肋年∈syslog_setmask の尉パラ
メ〖タともに 0 に肋年∷するˉ


５ˉシステムサ〖ビス

この泪では·JSPカ〖ネルが筛洁弄に瓢侯させるシステムタスクおよびドライ
バと·それらを网脱するためのインタフェ〖スについて棱汤するˉこの泪の柒
推は·幻年弄な慌屯であり·海稿恃构される材墙拉があるˉ

5.1 システムクロックドライバ

システムクロックドライバは·ハ〖ドウェアタイマを脱いて件袋弄に充哈みを
券栏させ·isig_tim を钙び叫してカ〖ネルにタイムティックを丁惦するˉ

システムクロックドライバは·タイマの弹瓢借妄·タイマ充哈みハンドラ·タ
イマの匿贿借妄の话つの簇眶で菇喇されるˉタイマの弹瓢借妄は·カ〖ネルに
介袋步ル〖チンとして判峡するˉタイマ充哈みハンドラは·矢机奶り·カ〖ネ
ルに充哈みハンドラとして判峡するˉ

タイマの匿贿借妄は·附バ〖ジョンではうまく寥み哈む数恕ができないˉカ〖
ネルに滦して姜位箕ル〖チンを判峡する数恕を脱罢すべきかもしれないˉ

(1) void timer_initialize(VP_INT exinf)

タイマの弹瓢借妄ˉタイマを介袋步し·件袋弄なタイマ充哈み妥滇を券栏させ
るˉexinf は痰浑するˉ

(2) void timer_handler(void)

タイマ充哈みハンドラˉタイマ充哈み妥滇をクリアした稿·isig_tim を钙び
叫してタイムティックを丁惦するˉ

(3) void timer_terminate(void)

タイマの匿贿借妄ˉ件袋弄なタイマ充哈み妥滇を匿贿させるˉ

5.2 シリアルインタフェ〖スドライバ

シリアルインタフェ〖スドライバは·シリアルI/Oポ〖トを胺うためのドライ
バであるˉ

シリアルインタフェ〖スドライバは·介袋步借妄·充哈みハンドラと·皋つの
サ〖ビスコ〖ルで菇喇されるˉ介袋步借妄は·カ〖ネルに介袋步ル〖チンとし
て判峡するˉ充哈みハンドラは·カ〖ネルに充哈みハンドラとして判峡すべき
ものであるˉ

筛洁Cライブラリの你レベル掐叫蜗ル〖チンを·シリアルインタフェ〖スドラ
イバを钙び叫すものにすることで·タスクの筛洁掐叫蜗をシリアルインタフェ〖
スドライバ沸统に磊り仑えることができるˉ恶挛弄な数恕は·脱いる筛洁Cラ
イブラリに巴赂するˉ

5.2.1 シリアルインタフェ〖スドライバの介袋步借妄

(1) void serial_initialize(VP_INT portid)

portid で绩されるシリアルポ〖トに滦して·シリアルインタフェ〖スドライ
バを弹瓢するˉ柒婶弄には·稿揭の serial_open を钙び叫しているˉ

5.2.2 シリアルインタフェ〖スドライバの充哈みハンドラ

シリアルインタフェ〖スデバイスの硷梧によって·流慨充哈みと减慨充哈みで
侍」の充哈みハンドラが弹瓢されるものと·票じ充哈みハンドラが弹瓢される
ものがあるˉシリアルインタフェ〖スドライバでは·SEPARATE_SIO_INT を年
盗するかどうかで·この般いを帝箭している∈侍」の充哈みハンドラが弹瓢さ
れる眷圭に年盗する∷ˉ

(1) void serial_in_handler(void)

SEPARATE_SIO_INT を年盗した眷圭の·减慨充哈みハンドラˉ

(2) void serial_out_handler(void)

SEPARATE_SIO_INT を年盗した眷圭の·流慨充哈みハンドラˉ

(3) void serial_handler(void)

SEPARATE_SIO_INT を年盗しない眷圭の·シリアルインタフェ〖ス充哈みハン
ドラˉ

5.2.3 シリアルインタフェ〖スドライバのサ〖ビスコ〖ル

シリアルインタフェ〖スドライバを钙び叫すサ〖ビスコ〖ルの慌屯は布淡の奶
りであるˉこの面で·シリアルポ〖トのID戎规∈portid∷の豺坚はタ〖ゲット
巴赂となるˉなお·これらのサ〖ビスコ〖ルを·润タスクコンテキストから钙
び叫すことはできないˉまた·serial_read と serial_write は·ディスパッ
チ瘦伪觉轮で钙び叫すことはできないˉいずれも·钙び叫した眷圭には·
E_CTXエラ〖となるˉ

(1) ER serial_open(ID portid)

portid で绩されるシリアルポ〖トをオ〖プンし·粕み哈み】今き叫しが材墙
な觉轮にするˉ

(2) ER serial_close(ID portid, BOOL flush)

portid で绩されるシリアルポ〖トのシャットダウン借妄をするˉflush が 0 
笆嘲の眷圭は·流慨バッファの柒推が鄂になるまでル〖プで略つˉ

(3) ER_INT serial_read(ID portid, char *buf, UINT len)

portid で绩されるシリアルポ〖トから·呵络 lenバイトの矢机误を粕み哈み·
buf からの挝拌に掐れるˉ悸狠に粕み哈んだ矢机眶を手す∈赖または 0∷ˉ
portid に 0 を回年すると·デフォルトのシリアルポ〖トを回年したことにな
るˉ

(4) ER_INT serial_write(ID portid, char *buf, UINT len)

portid で绩されるシリアルポ〖トに·buf からの lenバイトの矢机误を今き
叫すˉ悸狠に今き叫した矢机眶を手す∈赖または 0∷ˉportid に 0 を回年す
ると·デフォルトのシリアルポ〖トを回年したことになるˉ

(5) ER serial_ioctl(ID portid, UINT ioctl)

portid で绩されるシリアルポ〖トの扩告攫鼠を·ioctl で绩される猛に肋年
するˉportid に 0 を回年すると·デフォルトのシリアルポ〖トを回年したこ
とになるˉ

ioctl には·笆布の扩告攫鼠を山す年眶を·ビット髓に侠妄下をとったものを
回年するˉ

    IOCTL_ECHO∈エコ〖バックモ〖ド∷
	このビットを肋年すると·シリアルインタフェ〖スドライバがエコ〖
	バックを乖うˉ恶挛弄には·バッファから矢机を艰り叫す刨に·その
	矢机を今き叫すˉ

    IOCTL_CRLF