asp/target/lpc1830_generic_gcc/target_user.txt

   1 =====================================================================
   2              LPC1830 GENERICターゲット依存部 (asp-1.7対応）
   3                                   Last Modified: 2012/Oct/21
   4 =====================================================================
   5
   6 (1) 対応しているターゲットシステムの種類・構成，バージョン番号
   7
   8         ・ターゲットハードウェア（ボード等）の名称と対応している構成
   9                 NXP製LPC1830を使用したボード一般。発振器は内蔵発振器を使う。
  10
  11         ・ターゲット略称
  12                 lpc1830_generic_gcc
  13
  14         ・ターゲット非依存部のバージョン番号
  15                 1.7
  16
  17         ・プロセッサ，チップ，開発環境依存部の構成とバージョン番号
  18                 1.7.1
  19
  20         ・使用するPDICとバージョン番号
  21                 pdic/uart
  22
  23 (2) 使用する開発環境と動作検証した条件（バージョン，オプション等）
  24
  25         ・言語処理系（コンパイラ，アセンブラ，リンカ等）
  26                 gcc version 4.6.3 (Sourcery CodeBench Lite 2012.03-56)
  27
  28         ・デバッグ環境
  29                 GNU gdb (Sourcery G++ Lite 2010q1-188) 7.0.50.20100218-cvs
  30                 Open On-Chip Debugger 0.6.1
  31                 HJ/LINK USB
  32                 LPC1830 Xplorer
  33
  34 (3) ターゲット定義事項の規定
  35 (3-1) データ型に関する規定
  36 (3-2) 割込み処理に関する規定
  37 (3-3) カーネル管理外の割込みに関する規定
  38 (3-4) CPU例外処理に関する規定
  39 (3-5) 性能評価用システム時刻の参照に関する規定
  40 (3-6) オーバランハンドラ機能拡張のサポートに関する規定
  41 (3-7) その他
  42
  43 (4) カーネルの起動／終了処理に関する情報
  44         ・用意しているスタートアップモジュールの処理内容
  45                 target_initialize()では、PLLの設定、GPIOの設定、シリアル・ポートの設定を行う。
  46
  47         ・スタートアップモジュールからhardware_init_hookを呼び出している場
  48         　合には，hardware_init_hookをアプリケーションで用意する場合の作成
  49         　方法や制限事項など
  50                 chip_user.txtを参照。
  51
  52         ・カーネルを終了した後の振舞い
  53                 target_exit()はchip_exit()を呼び出したあと、無限ループを実行する。
  54
  55 (5) メモリマップ
  56
  57         ・SRAM版のメモリマップ
  58                 ram (rx) :  ORIGIN = 0x10000000, LENGTH = 96K
  59                         .vector, .text, .rodata, .data, .bss
  60
  61
  62         メモリマップを変更するには、*.ldの内容を変更する。
  63
  64 (6) タイマドライバ関連の情報
  65
  66         chip_user.txtを参照
  67
  68 (7) シリアルインタフェースドライバの情報
  69
  70         ・使用するリソース（SIOコントローラ）
  71                 UART0を使用する。
  72
  73         ・通信パラメータ（ボーレート，ビット数，パリティの有無，ストップビット）
  74                 57600baud, 8data bit, none-parity, 1stop bit
  75
  76 (8) システムログ機能の情報
  77
  78         ・システムログの低レベル出力の実現方法
  79                 target_config.hのtarget_fput_log()からUART0へポーリングをかけて出力している。
  80
  81         ・通信パラメータ（ボーレート，ビット数，パリティの有無，ストップビット）
  82                 57600baud, 8data bit, none-parity, 1stop bit
  83
  84 (9) システム構築手順
  85
  86         カーネルツリーが、アプリケーションのkernelサブディレクトリにあると仮定する。
  87
  88         $ cd kernel/cfg
  89         $ ./configure
  90         $ make
  91         $ cd ../..
  92         $ kernel configure -T lpc1768_generic_gcc
  93         $ make depend
  94         $ make
  95
  96         以上のコマンド列により、ROM化コードが生成される。SRAM実行用コードを生成するには最後のコマンドを
  97         以下に変更する。
  98
  99         $ make sram
 100
 101 (10) ターゲットシステム固有の注意事項
 102
 103 (10) 類似のターゲットにポーティングする開発者向けの参考情報
 104         LPC1830を使った他のボードにポーティングする場合には、以下のオブジェクトを修正する
 105
 106         lpc1830_generic.h               (名前をターゲット識別名に変更する)
 107                 SYS_CLOCK                                       CPUコアへの入力周波数[Hz]
 108
 109         target_config.h
 110                 DEFAULT_ISTKSZ                  割り込みスタックの領域のサイズ[BYTE]
 111
 112         target_config.c
 113                 target_initialize()             PLLやピンの初期化を行う。
 114
 115         target_stddef.h
 116                 TOPPERS_LPC1830_GENERIC ターゲット識別マクロ。ターゲット識別名を大文字にし、頭に
 117                                                                         TOPPERS_をつける。
 118
 119         target_syssvc.h
 120                 TARGET_NAME                             著作権表示用のターゲット識別文字列
 121                 SIO_PORTID                                      SIOとして使うポート番号(1から始まる整数)
 122                 SIO_BAUD_RATE_DEFAULT   ボーレートを変更したい場合
 123                 TARGET_COPYRIGHT                        著作権表示文字列
 124
 125         LPC1800シリーズの他のプロセッサにポーティングするには、上の修正に加えてターゲットのLDファイルの
 126         MEMORY宣言を変更する。一般にLPC1800シリーズはメモリ構成以外のプログラミングモデルは同じである。
 127
 128 (12) ディレクトリ構成・ファイル構成
 129 asp:
 130         arch:
 131                 arm_m_gcc:
 132                         MANIFEST
 133                         Makefile.prc
 134                         arm_m.h
 135                         makeoffset.c
 136                         prc.tf
 137                         prc_cfg1_out.h
 138                         prc_check.tf
 139                         prc_config.c
 140                         prc_config.h
 141                         prc_def.csv
 142                         prc_design.txt
 143                         prc_insn.h
 144                         prc_kernel.h
 145                         prc_rename.def
 146                         prc_rename.h
 147                         prc_sil.h
 148                         prc_stddef.h
 149                         prc_support.S
 150                         prc_test.h
 151                         prc_timer.c
 152                         prc_timer.cfg
 153                         prc_timer.h
 154                         prc_unrename.h
 155                         prc_user.txt
 156                         prc_user_annex.txt
 157                         start.S
 158         chip:
 159                 lpc1800_gcc:
 160                         MANIFEST
 161                         Makefile.chip
 162                         chip.tf
 163                         chip_cfg1_out.h
 164                         chip_check.tf
 165                         chip_config.c
 166                         chip_config.h
 167                         chip_kernel.h
 168                         chip_rename.def
 169                         chip_rename.h
 170                         chip_serial.cfg
 171                         chip_serial.h
 172                         chip_sil.h
 173                         chip_stddef.h
 174                         chip_syssvc.h
 175                         chip_test.h
 176                         chip_timer.cfg
 177                         chip_timer.h
 178                         chip_unrename.h
 179                         chip_user.txt
 180                         cmsis
 181                         lpc1800.h
 182
 183                         cmsis:
 184                                 LPC18xx.h
 185                                 core_cm3.h
 186                                 system_LPC18xx.h
 187
 188         pdic:
 189                 uart:
 190                         MANIFEST
 191                         serial_user.txt
 192                         uart.c
 193                         uart.h
 194
 195         target:
 196                 lpc1830_generic_gcc:
 197                         E_PACKAGE
 198                         MANIFEST
 199                         Makefile.target
 200                         asp.doxyfile
 201                         doxygen.css
 202                         html
 203                         lpc1830_generic.h
 204                         lpc1830_sram.ld
 205                         target.tf
 206                         target_cfg1_out.h
 207                         target_check.tf
 208                         target_config.c
 209                         target_config.h
 210                         target_def.csv
 211                         target_kernel.h
 212                         target_rename.def
 213                         target_rename.h
 214                         target_serial.cfg
 215                         target_serial.h
 216                         target_sil.h
 217                         target_stddef.h
 218                         target_syssvc.h
 219                         target_test.h
 220                         target_timer.cfg
 221                         target_timer.h
 222                         target_unrename.h
 223                         target_user.txt
 224
 225
 226 (13) ライセンス上の注意
 227 LDファイルはCodeSourcery社のLDファイルに手を加えているため、同社のライセンスにしたがう。
 228 また、cmsisサブディレクトリ内のファイルはARM/NXP社のものを使用している。
 229
 230 (14) バージョン履歴
 231
 232 2012/Oct/21
 233         ver 1.7.1
 234
 235
 236
 237
 238