OSDN Git Service

コメント、Doxygenコメント、E_PACKAGE等を整理。
[toppersasp4lpc/asp.git] / asp / arch / arm_m_gcc / lpc4300_gcc / chip_syssvc.h
1 /*
2  *  TOPPERS/ASP Kernel
3  *      Toyohashi Open Platform for Embedded Real-Time Systems/
4  *      Advanced Standard Profile Kernel
5  *
6  *  Copyright (C) 2007 by Embedded and Real-Time Systems Laboratory
7  *              Graduate School of Information Science, Nagoya Univ., JAPAN
8  *  Copyright (C) 2010 by TOPPERS/ASP for LPC project
9  *              http://sourceforge.jp/projects/toppersasp4lpc/
10  *
11  *  上記著作権者は,以下の(1)〜(4)の条件を満たす場合に限り,本ソフトウェ
12  *  ア(本ソフトウェアを改変したものを含む.以下同じ)を使用・複製・改
13  *  変・再配布(以下,利用と呼ぶ)することを無償で許諾する.
14  *  (1) 本ソフトウェアをソースコードの形で利用する場合には,上記の著作
15  *      権表示,この利用条件および下記の無保証規定が,そのままの形でソー
16  *      スコード中に含まれていること.
17  *  (2) 本ソフトウェアを,ライブラリ形式など,他のソフトウェア開発に使
18  *      用できる形で再配布する場合には,再配布に伴うドキュメント(利用
19  *      者マニュアルなど)に,上記の著作権表示,この利用条件および下記
20  *      の無保証規定を掲載すること.
21  *  (3) 本ソフトウェアを,機器に組み込むなど,他のソフトウェア開発に使
22  *      用できない形で再配布する場合には,次のいずれかの条件を満たすこ
23  *      と.
24  *    (a) 再配布に伴うドキュメント(利用者マニュアルなど)に,上記の著
25  *        作権表示,この利用条件および下記の無保証規定を掲載すること.
26  *    (b) 再配布の形態を,別に定める方法によって,TOPPERSプロジェクトに
27  *        報告すること.
28  *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
29  *      害からも,上記著作権者およびTOPPERSプロジェクトを免責すること.
30  *      また,本ソフトウェアのユーザまたはエンドユーザからのいかなる理
31  *      由に基づく請求からも,上記著作権者およびTOPPERSプロジェクトを
32  *      免責すること.
33  *
34  *  本ソフトウェアは,無保証で提供されているものである.上記著作権者お
35  *  よびTOPPERSプロジェクトは,本ソフトウェアに関して,特定の使用目的
36  *  に対する適合性も含めて,いかなる保証も行わない.また,本ソフトウェ
37  *  アの利用により直接的または間接的に生じたいかなる損害に関しても,そ
38  *  の責任を負わない.
39  *
40  */
41 /**
42  * \addtogroup TOPPERS_CHIP
43  * \{
44  */
45
46
47 /**
48  * \file chip_syssvc.h
49  * \brief システムサービスのチップ依存部(NXP LPC43xx用)
50  * \details
51  *  システムサービスのターゲット依存部のインクルードファイル.このファ
52  *  イルの内容は,コンポーネント記述ファイルに記述され,このファイルは
53  *  無くなる見込み.
54  */
55
56 #ifndef TOPPERS_CHIP_SYSSVC_H
57 #define TOPPERS_CHIP_SYSSVC_H
58
59 /*
60  *  ターゲットシステムのハードウェア資源の定義
61  */
62 #include "lpc4300.h"
63
64 /*
65  *  トレースログに関する設定
66  */
67 #ifdef TOPPERS_TRACE_ENABLE
68 #include "logtrace/trace_config.h"
69 #endif /* TOPPERS_TRACE_ENABLE */
70
71
72 /**
73  * \brief 起動メッセージ
74  * \details
75  *  起動メッセージにチップ依存部の著作権表示を
76  *  追加するためのマクロ.
77  */
78 #ifdef PRC_COPYRIGHT
79 #define CHIP_COPYRIGHT    PRC_COPYRIGHT "Copyright (C) 2010 by TOPPERS/ASP for LPC project\n            http://sourceforge.jp/projects/toppersasp4lpc/\n"
80 #else
81 #define CHIP_COPYRIGHT      "Copyright (C) 2012 by TOPPERS/ASP for LPC project\n            http://sourceforge.jp/projects/toppersasp4lpc/\n"
82 #endif /* CHIP_COPYRIGHT */
83
84
85 /**
86  * \brief UARTへの入力クロック
87  * \details
88  * 内蔵UARTのクロック周波数を指定する。単位はHz。LPC43xxはそれぞれのUARTに対して
89  * 独立した周波数を入力できるが、今回の実装ではtarget_serial.cはすべてのUARTに
90  * 同じクロックが入力されれると仮定している。
91  *
92  * この実装では、UARTに配分されるクロックは12Mhzであり、これはリセット値である。
93  */
94 #define SIO_UART_CLOCK    (12000000)
95
96 #ifndef TOPPERS_MACRO_ONLY
97
98 /**
99  * \brief システムログの低レベル出力のための文字出力
100  * \details
101  *  ターゲット依存の方法で,文字cを表示/出力/保存する.LPC43XXの実装では、
102  *  pdic/uartのポーリングによる出力ルーチンを呼ぶ。
103  *
104  *  このルーチンを呼ぶ前に、初期化として #target_uart_init()を一度呼ばなければ
105  *  ならない。ターゲット依存部の#target_initialize()で呼ぶとよい。
106  */
107 extern void    chip_fput_log(char_t c);
108
109 #endif /* TOPPERS_MACRO_ONLY */
110 #endif /* TOPPERS_CHIP_SYSSVC_H */
111
112 /**
113  * \}
114  */
115