=====================================================================
                         BCM283xチップ依存部
                                  Last Modified: '19/04/16
=====================================================================


(1) 対応しているターゲットシステムの種類・構成

bcm283xチップ依存部は，主に Raspberry Pi で使用される Broadcom製チップを
ターゲットとする．現時点では Raspberru Pi 3B に搭載されるBCM2837 をサポートする．

(2) 使用する開発環境と動作検証した条件（バージョン，オプション等）

カーネルはGCCを用いてコンパイルする．動作確認したバージョンは各ターゲ
ット依存部のドキュメントに記載する．

(3) ターゲット定義事項の規定

(3-1) 割込み処理に関する規定

(3-1-1) 概要

BCM283x は独自の割込みコントローラを搭載し，以下の特徴を持つ．
・割込み優先レベルはサポートしない．
・割込みは全てレベルトリガである．したがって割込み要求フラグは
  割込み発生元のデバイスを直接操作してクリアする必要がある．

BCM283x依存部では，IRQ をカーネル管理の割込み，FIQをカーネル管理外の割込みとする．


(3-1-2) 割込みハンドラ番号と割込み番号の割当て，両者の対応

割込みハンドラ番号と割込み番号は，BCM2835及びBCM2836の
ペリフェラルマニュアル(下記a及びb)から，ペンディングレジスタのビット位置に基づいて
0から127の番号を割り当てる．(個々の定義は bcm2837.h を参照)

 0 ... 31  Core interrupt (下記aのP16 「Core0 interrupt source」に対応)
32 ... 63  ARM peripherals interrupt(bのP113「Basic pending register」に対応)
64 ... 95  ARM peripherals interrupt(bのP115「GPU pending register 1」に対応)
96 ...127  ARM peripherals interrupt(bのP115「GPU pending register 2」に対応)

(a) QA7(ARM Quad A7 core)
https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2836/QA7_rev3.4.pdf

(b) BCM2835 ARM Peripherals 
https://www.raspberrypi.org/documentation/hardware/raspberrypi/bcm2835/BCM2835-ARM-Peripherals.pdf


(3-1-3) 割込み優先度の段階数（TMIN_INTPRIの値），その設定方法

割込み優先度の段階数は，ターゲット依存部毎に異なる．
BCM283x の割込みコントローラは優先度制御機能を持たないためソフトウェアで実現する．
そのため段階数を独自に設定することが可能である．

カーネル管理内の割込みに対する最高優先度(TMIN_INTPRI)はチップ依存部で
既定値を定義しているが，ターゲット依存部で設定することも可能である．

各割込みの割込み優先度は，CFG_INT で設定する．優先度は TMIN_INTPRI 以上の値
(優先度としては低い値)を指定する．

(3-1-4) dis_intとena_intのサポートの有無，その制限事項

dis_int と ena_int はサポートしない


(3-1-5) CFG_INTの制限事項と拡張（ターゲット定義で使用できる割込み属性）

レベル割込みしかサポートしないため，エッジ/レベルのトリガ設定は意味をもたない．
その他，ターゲット独自に使用可能な割込み属性はない．


(3-1-6) カーネル管理外の割込み

FIQ割込みをカーネル管理外の割込みとして扱う．

FIQ割込みが発生すると該当する割込みベクタからレジスタの退避を行なった後に
call_fiq_handler (core_config.c) が呼び出される．この関数は，
コアの全ての例外がマスクされた状態(ステータスレジスタのD,A,I,Fが全て1)で
呼び出される．

FIQを利用するための設定，発生したFIQ 割込みに対する要因判別，
及び対応するハンドラ等の処理は独自に実装する必要がある．

カーネル管理外の割込みを設定するためのAPIはサポートしない．


(3-2) CPUロック・割込みロック

CPUロックは，ステータスレジスタのIビットの値で判別する．
全割込みロックフラグの実装ではこれに加えFビットも使用する．

CPUロックフラグは割込みロックフラグとは独立したフラグとしてサポートする．
そのため，SIL_LOC_INT呼び出し時はIフラグの状態を記憶し，
SIL_UNL_INT呼び出し時に元の状態に戻している．


(3-3) 性能評価用システム時刻の参照に関する規定

get_utmをサポートしない．


(3-4) スタートアップルーチンでの初期化内容

スタートアップルーチンはターゲット依存部のドキュメントに記載する．


(4) ディレクトリ構成・ファイル構成
  ./arch/arm64_gcc/bcm283x/
    MANIFEST
    Makefile.chip
    bcm2837.h
    chip_cfg1_out.h
    chip_check.trb
    chip_config.c
    chip_config.h
    chip_design.txt
    chip_kernel.h
    chip_kernel.trb
    chip_rename.def
    chip_rename.h
    chip_serial.c
    chip_serial.cfg
    chip_serial.h
    chip_sil.h
    chip_stddef.h
    chip_support.S
    chip_sym.def
    chip_test.h
    chip_timer.cfg
    chip_timer.h
    chip_unrename.h
    chip_user.txt
    pl011.h

(12) バージョン履歴

2018/05/30
 ・最初のリリース
2019/04/15
 ・BCM283xチップ依存部の分離に合わせて修正