ジェネレータ実行

• [1] ECU Configuration Description File
  • Mcu向けのEcucValsを指定します。
  • 複数モジュール向けのEcucValsを1つのarxmlで定義しても問題ありません。
• [2] Translation XML File
  • ジェネレータを実行するフォルダからの相対パスが同じであれば、Portのジェネレータで使用したものと同じファイルを使用できます。
• [3] BSWMDT File
  • Mcu用のBSWMDT Fileは、以下に用意されています。
    • <インストールフォルダ>\X1X\F1x\modules\mcu\generator\R422_MCU_F1x_BSWMDT.arxml
• [4] Configuration XML File
  • Port同様、省略可能です。

実装

クロックを設定するのみであれば、Mcuは初期化処理を行うのみとなります。ただし、Mcu_Init以外にも初期化処理が必要となるので注意が必要です。まず、Mcu_Initの引数は、ハードウェアやMCAL実装に依存して定義される構造体型であるMcu_ConfigTypeへのポインタとなります。ルネサス製MCALでは、ジェネレータで生成したMcu_PBcfg.cに対象の構造体が生成されます。また、Mcu_Cfg.hに以下のマクロが定義されますので、こちらをMcu_Initの引数として使用することができます。

/* Configuration Set Handles */
#define McuModuleConfiguration  (&Mcu_GstConfiguration[0])

そして、Mcu_InitClockによりクロックの初期化を行い、今回はPLLを使用するのでMcu_DistributePllClockによりPLLからのクロック供給を有効にします。具体的には、以下のようなコードとなります。

#include "Mcu.h"
    ：
sint32
main(void) {
        ：
    /* Mcu初期化 */
    Mcu_Init(McuModuleConfiguration);

    /* クロック初期化 */
    (void) Mcu_InitClock(McuConf_McuClockSettingConfig_McuClockSettingConfig);

    /* PLL起動 */
    while (Mcu_GetPllStatus() != MCU_PLL_LOCKED);
    (void) Mcu_DistributePllClock();
        ：
}

Mcu_InitClockの引数は、McuClockSettingIdで設定したクロック設定の識別子です。McuClockSettingConfigコンテナは、複数設定することができますので、複数のクロック設定を用意しておき、Mcu_InitClock呼出し時にどのクロック設定とするか選択できるわけです。なお、McuClockSettingIdには、SymbolicNameValue属性が付いていますので、上記のように引数をマクロで指定することも可能です。Dioの識別子用パラメータとは異なり、McuClockSettingIdは0からの連番でしか設定不可となっているため、設定値を直接書いても問題ありません。クロック初期化後、Mcu_GetPllStatusによりPLLがロックされるのを待ちます。PLLがロックされたことを確認した上で、Mcu_DistributePllClockにより、PLLからのクロック供給を有効にします。
上記例では、Mcu_InitClockとMcu_DistributePllClockの返り値を読み捨てていますが、何らかのエラーが発生することを考慮する場合は、返り値に応じた処理が必要となります。

なお、Mcuのソースコードには、アセンブリ言語で実装されたMcu_RRamCopy_asm.850が存在しますが、これは次バージョンで削除されるとのことです。現バージョンにおいても、Mcu_RRamCopy_asm.850をリンクしなくてもビルドは可能で、クロックの初期化も問題ありませんでした。

Port

ルネサス製Portの使用方法については、既に「ルネサス製MCALのPortとDioを使ってみた」で説明していますので、ここではATK2で行っているUART(RLIN3)のポート初期化処理に対応するコンフィギュレーションについてのみ説明します。

HSBRH850F1K100では、ポートP10_11、P10_12に、USBシリアル変換ICのRXD、TXDが接続されています。RH850/F1Kのマニュアル(右図)に書かれているように、P10_11、P10_12は、第2兼用モードとすることで、RLIN31RX、RLIN31TXとして使用することができます。このコンフィギュレーションをYAML形式(※2)で記載すると以下のようになります。(該当パラメータの抜粋となります)

Port:
  PortConfigSet:
    PortGroup10:
      PortPin11:
        PortPinDirection: PORT_PIN_IN       # 入力モード
        PortPinInitialMode: RLIN31RX_AT2IN  # 第2兼用モード(RLIN31RX)
        PortInputBufferControl: true        # 入力バッファ許可
      PortPin12:
        PortPinDirection: PORT_PIN_OUT                      # 出力モード
        PortPinInitialMode: RLIN31TX_AT2OUT_PFC_PFCE_PMCSR  # 第2兼用モード(RLIN31TX)
        PortInputBufferControl: false                       # 入力バッファ禁止

※2　YAML形式によるEcucValsの表記については「ABREXの使い方」をご参照ください。

HSBRH850F1K100向けコードでは、上記のポートの初期化処理が含まれてしまっているので、Portによるポート設定の振舞いを確認するために、ATK2を使用する場合は削除もしくはコメントアウトする必要があります。具体的には、target_config.cに実装されている関数target_port_initializeの後半の処理(PFC10/PMC10/PM10/PIBC10の設定)が該当します。 なお、ルネサス製Linでは、RLIN3をUARTモードで使用するための設定はできないようです。ですので、RLIN3の初期化処理はATK2のマイコン依存部処理をそのまま使用しました。

動作確認

ルネサス製Mcu、Portを用いて初期化を行い、ATK2付属のサンプルプログラム(sample1)を使って動作確認を行いました。以下の通り、UARTによるシリアル通信ができていること(ボーレート等の設定が合っていること)、TAUJを使用したアラームの1秒周期(16MHz)が実時間で1秒となっていることを確認できました。