ちょっと横道にそれて、ソースコードをクリーンアップしている。

開発初期では、あまり深く考えないで、安全確実なシンプルなコードで運転
していたが、もうそろそろ、気になっていた、柔軟性に欠ける部分を更新す
る時期なのかもしれない。

---

まず、ポート関係、ＲＸマイコンでは、非常に沢山のラインナップがあり、
パッケージによっても使えるポートが変化するので柔軟な創りが要求される。

ただ、全てのＲＸマイコンに対応させる品質にするのは大変だし、自分で使
うデバイスのみ定義を行い、新しいデバイスを使う必要性が生じ場合を考慮
して、「対応できるように」を目標に実装しておく。

とりあえず、カレントのデバイスは、ＲＸ６４Ｍ、ＲＸ２４Ｔなので、それ
らを中心に考える。
※最近は使わなくなった、ＲＸ６２１も（秋月＠９５０）なので、ＣＰはそ
れなりに高いから追加しておくべきかもしれない。

デバイスで異なる典型的なレジスタとして「ＯＤＲ」（オープンドレイン制
御）がある。
ＲＸ６４Ｍ、ＲＸ２４Ｔで以下のようになっている

            P0 P1 P2 P3 P4 P5 P6 P7 P8 P9 PA PB PC PD PE PF PG PJ
RX24T ODR0  o  o  o  o  x  x  x  o  o  o  o  o  x  o  o  -  -  -
      ODR1  x  x  o  x  x  x  x  o  x  o  o  o  x  o  o  -  -  -
RX64M ODR0  o  o  o  o  o  o  o  o  o  o  o  o  o  o  o  o  o  o
      ODR1  o  o  o  o  o  o  o  o  o  o  o  o  o  o  o  o  o  o

※o: 有効、x: 無効、-: ポート無し

この事実を踏まえ、ポートのテンプレートを以下のように定義して、

//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
/*!
    @brief  ポート定義基底クラス（PDR, PODR, PIDR, PMR, PCR, DSCR）
    @param[in]	base	ベースアドレス
    @param[in]	option	オプション
*/
//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
template <uint32_t base, class option>
struct port_t : public option {

...

};

ODR の定義は、option クラスとして継承させる事にすると・・

typedef port_t<0x0008C002, odr_oo_t<0x0008C084> > PORT2;
typedef port_t<0x0008C003, odr_oo_t<0x0008C086> > PORT3;
typedef port_t<0x0008C004, odr_oo_t<0x0008C088> > PORT4;
...

※ＲＸ６４Ｍ

...
typedef port_t<0x0008C002, odr_oo_t<0x0008C084> > PORT2;
typedef port_t<0x0008C003, odr_ox_t<0x0008C086> > PORT3;
typedef port_t<0x0008C004, odr_xx_t<0x0008C088> > PORT4;
...

※ＲＸ２４Ｔ
のように最終的な定義とした。

ここで、ODR 定義の option クラスは、

odr_oo_t    --->    ODR0、ODR1 の定義がある
odr_ox_t    --->    ODR0 のみ定義がある
odr_xx_t    --->    ODR0、ODR1 両方の定義が無い

とする。
※「odr_xx_t」は、中身の何も無いテンプレートとなっている。

あと、ポートのビット割り当ては、パッケージのピン数などでも変化があるの
で、今回は見送った（そこまでする必要があるか？）、しかしながら対応する
事は可能。

RX600/port.hpp

---

次にクロック関係の定義：

本来、特別な理由が無い限り、マイコンを定格より低いクロックで動作させる
事は稀（消費電力など）と思うが、一応定義はスマートに出来るようにしてお
きたい。
※初期のＲＸマイコンでは、ＵＳＢを使う場合、１２ＭＨｚのｎ倍にしか設定
できないので、ＲＸ６２１などでは、１００ＭＨｚまで動作が可能でも、９６
ＭＨｚでしか動かせない制限がある。
※最近のＲＸではＰＬＬの設定範囲や、構成を見直し、なるべく最大のパフォ
ーマンスが出せるような工夫がされている。

（１）外部接続のクリスタルを選べる事
（２）ＰＬＬ動作周波数の選択
（３）内部ペリフェラルのクロック選択

ＲＸマイコンでは、内部のペリファラルをグループ分けしてあり、それに対応
するクロックを個別に供給している。
※専用の分周期を持っている。

以前から、Makefile 内で、コンパイルオプションを利用して、変数定義として、
各モジュールのクロック周波数を定義していた。

-DF_ICLK=80000000 -DF_PCLKA=80000000 -DF_PCLKB=40000000
-DF_PCLKD=40000000 -DF_FCLK=20000000

※しかし、実際の分周非の設定は、適切な値を直接設定していた。

これは、（３）に相当する部分で、シリアルのボーレートや、タイマー周期、
時間待ちループなどの基数として利用してきた。
外部クリスタルの周波数を変更した場合、それに合わせて、適切な値を設定す
る必要があるので、イマイチ柔軟性に欠けるものの、通常は、クリスタルを頻
繁に交換する事も少ないので、特に仕様を変更せずにそのままにした。
※分周比の設定は、一応計算されるが、割り切れないような設定では問題とな
ってしまう。

（２）は、内部ＰＬＬの構成がより柔軟となったもので、ＲＸ６４Ｍなどは、
最大速度は１２０ＭＨｚだが、より広範囲の基底周波数を選択できるように、
内部ＰＬＬは倍の２４０ＭＨｚまで設定可能となっている。
そこで、クロック設定の際に、内部ＰＬＬをどの速度にするかを設定できるよ
うにした。
※ＰＬＬの倍率には、制限があるので、入れた数字がそのまま内部基数になる
訳ではないのだが・・

// 10MHz X-Tal, 80MHz
typedef device::system_io<10000000> SYSTEM_IO;
SYSTEM_IO::setup_system_clock(80000000);

※ＲＸ２４Ｔでは、内部ＰＬＬの最大速度は８０ＭＨｚなので、上記のように
使用する。

RX24T/system_io.hpp

最近ＲＸ６４Ｍ関係の仕事で、忙しかったが、ようやく何とかなった感じで、
やっと、ＲＸ２４Ｔ関係を再開する事ができた。

ＲＸ２４Ｔ用の汎用基板を作ろうと、回路図を引いていて、そういえば、
ＭＴＵ関係の実装が全く進んでいない事に気がつき、テンプレートを実装し
始めた。（なんか回路図引くのが、億劫）

ＭＴＵ３は、非常に高機能なので、全てを網羅するような、汎用性の高い
テンプレートを作るのはかなり大変なので、必要な機能を少しづつ実装して
ゆき、その都度改修するしかないと思われる。

とりあえず、インプットキャプチャー機能を試してみた。

今回実装した「mtu_io.hpp」は、テンプレートパラメーターとして、
「mtu.hpp」テンプレートを内包する。

typedef device::MTU0 MTU0;
typedef device::mtu_io<MTU0> MTU0_IO;
MTU0_IO mtu0_io_;

ＭＴＵは、９チャネルあるが、全てが同じ機能ではなく、微妙に違う部分が
あり、それらを吸収する構造を考えるのはパズルのようだがそれなりに楽し
い。
※ＭＴＵ５は、３相モーター用に特化しており、除外した。（指定すると
エラーになる）

「mtu.hpp」は、ルネサスのハードウェアーマニュアルに準拠したクラスな
ので、レジスターの名称は、マニュアルに準拠させている。
だが、割り込み、入出力ポートのマッピングなど、連携して動作する機構が
必要なので、それらの制御が簡潔に書けるように、ヘルパー関数を用意した。
※これは、ＳＣＩやＩ２Ｃ、ＳＰＩなどの知見を元に考えた構造で、さらに
ＭＴＵ用に色々と拡張した。

    uint8_t intr_level = 3;		
    if(!mtu0_io_.start_capture(MTU0::channel::A, MTU0_IO::capture_type::positive, intr_level)) {
        utils::format("MTU0 input capture start fail...\n");
    }

こんな感じで書けるようにした。

※チャネルとポートのマッピングは、現在の実装では、標準的ポート固定に
なっているので、変更できる仕組みを考えないといけないが、シンプルな方
法を思いつかないので、そのうちじっくり考える事にする・・

const auto& cap = mtu0_io_.get_capture();
float a = static_cast<float>(mtu0_io_.get_base_clock()) / static_cast<float>(cap.all_count_);
utils::format("Capture: %7.2f [Hz]\n") % a;

こんな感じで、キャプチャーした周期を表示できる。

ＲＸ２４Ｔでは、ＭＴＵモジュールの最大周波数は８０ＭＨｚなので、精度
が高いと思ったのだが、かなりずれている・・、ただ、リファレンスの周波数
の精度が悪いだけかもしれないので調査が必要・・・
※Ｒ８Ｃ／Ｍ１２０ＡＮで出力した信号（Ｒ８Ｃのクロックは内臓ＲＣオシレーター）
※正確なオシレーターを持っていない・・

次は、単純な波形出力を実装してみようと思う。
出力も、ほぼ、キャプチャーと同等なので、実装してみた。

typedef device::MTU1 MTU1;
typedef device::mtu_io<MTU1> MTU1_IO;
MTU1_IO mtu1_io_;

※実験では、MTU1 を使った。

// MTU1 設定
{
    uint32_t frq = 1000;
    if(!mtu1_io_.start_output(MTU1::channel::A, MTU1_IO::output_type::toggle, frq)) {
        utils::format("MTU1 output start fail...\n");
    }
}

MTU1 の出力「PA5/MTIOC1A (36)」を「PB3/MTIOC0A (32)」に繋いで１０００Ｈｚ
出力。
そしてキャプチャーしてみた。

概ね正確なようだ、昨日の「ズレ」は、Ｒ８Ｃ／Ｍ１２０ＡＮの周期が不正確
なのが原因だったようだ・・
それでも、真っ当な信号発生器は買うか、作る必要があるようだ・・・

ソースコードは GitHub にプッシュした
インプット・キャプチャー、サンプル
※ＲＸ６４ＭのＭＴＵもほぼ同等な機能なので、そのまま使えそうだが、割り
込み関係のハンドリングがかなり異なるので、それを吸収する仕組みを考えな
いとならない。

以前に、ＲＬ７８で実験したものをＲ８Ｃで焼きなおしたものです。

通常、マイコンの入力ポートは、非常にインピーダンスが高い入力元である事
を利用しています。

ガラスエポキシのユニバーサル基板上に、１０ｍｍ角の銅版を載せ、表面をポ
リイミドテープなどで絶縁します。
この銅版を入力ポートに接続しておきます。
この銅版は、１Ｍオームの抵抗でプルアップしておきます。

・この銅版は、等価的には微小なコンデンサと考える事ができます。
・まずポートを出力として、ＧＮＤに落とし、コンデンサの電荷をリセットします。
・次に、ポートを入力にすると、１Ｍオームの抵抗を通じて、コンデンサがチ
ャージされ、微小な時間差で「Ｈ」になります。
・この実験では、この時間は、数マイクロ秒～数十マイクロ秒だと考えられます。
※銅版の大きさ、ベースとなるユニバーサル基板の誘電率などの条件で変化する。
※ある程度再現性はあると思うが、環境によって調整が必要。
・上記で計測した時間の違いで、「タッチ」されているか、「開放」なのかを
判断する。
※サンプルでは、通常は常に出力、Ｌにしておき、コンデンサをショート状態
にしてあり、計測の時だけ、入力にしている。

プログラムを単純にする為、ＣＰＵループ数で計測している。

uint16_t count_input_()
{
    uint16_t n = 0;
    INPUT::DIR = 0;  // 検出する場合だけ、「入力」にする。
    do {
        ++n;
    } while(INPUT::P() == 0) ;
    INPUT::DIR = 1;  // 出力
    INPUT::P = 0;    // 仮想コンデンサをショートしてリセット
    return n;
}

実験では、「開放時１４」、「タッチ時１８以上」となった。

Github

※計測値を単純に表示する場合、「DISP_REF」を有効にする。