asp/target/lpc1768_generic_gcc/target_user.txt

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