スマート・コンフィグレータの使用方法 - renesas/rx72n-envision-kit GitHub Wiki
- RX用スマート・コンフィグレータの使い方を概説する
- e2 studio 2020-07、及び、CS+ V8.03での操作を前提に記載する(CS+ 64-bit版で再確認予定)
- スマート・コンフィグレータをこのページではSCと呼称する
- SCは「ソフトウェアを自由に組み合わせられる」をコンセプトとしたユーティリティである
- SCは主に以下の機能を提供する
- RXマイコン周辺機能を活用したドライバソフトウェアやミドルウェアの導入や設定
(これらのソフト/ミドルウェアは以下のコンポーネントとして提供されている)- Firmware Integration Technology (FIT)モジュール
- コード生成(CG)モジュール
- GUIを用いたクロックや端子設定
- ソース生成機能
- RXマイコン周辺機能を活用したドライバソフトウェアやミドルウェアの導入や設定
- 詳細は以下のアプリケーションを参照
- CMTに代表されるタイマ系や、SCIに代表される通信系においては、自身に配線されているクロック信号のクロック速度に応じて自身への設定値をソフトウェアにより調整する必要がある
- このソフトウェアのコーディングは本来、マイコンのマニュアルを参照しながらユーザが行う必要があるが、非常に設定項目が多岐に渡るためSCのようなツールでこれを支援する機構を用意した
- ユーザ(特にアプリ設計者)はクロック源が何MHzであるとか、内部PLLの設定がどうなっているかを意識することなく、APIレベルでたとえば「ボーレートは115200bps」といった形でソフトウェアからハードウェアに対して指示をすることが可能となり、ソフトウェア開発効率が改善する
- また、RXファミリ製品を熟知した設計者がCMT、SCI、Ether、USB、SDHI等のRXファミリ内蔵回路用のドライバソフトウェアを主要RXグループに対し同一API設計にて「FITモジュール」という形式で開発・メンテナンス(継続的な不具合修正)を実施し、FITモジュールを1個のパッケージに同梱したものを「RX Driver Package」として配布をしている
- 従ってユーザはRXファミリ間の詳細なハードウェア差異やハードウェアエラッタ情報を意識することなくアプリケーション開発に注力できる
- プロジェクトを新規作成する
-
ファイル
->新規
->プロジェクト
-
ウィザード
->C/C++
->C/C++ プロジェクト
->次へ
-
All
->Renesas CC-RX C/C++ Executable Project
-
プロジェクト名
に任意の名前を入力 ->次へ
-
Device Settings
->ターゲット・デバイス
にて使用するデバイスを選択 -
Toolchain Settings
->RTOS
にて使用するRTOSとバージョンを選択 -
Configuration
->Hardware Debug 構成を生成
->使用するエミュレータを選択 - その他の設定はお好みで ->
次へ
-
スマート・コンフィグレータを使用する
にチェック ->終了
-
-
-
-
-
- 新規作成されたプロジェクトの
[プロジェクト名].scfg
をダブルクリック- SCが起動される
- プロジェクトを新規作成する
-
ファイル
->新しいプロジェクトを作成
-
ウィザード
->マイクロコントローラ
->RX
-
使用するマイクロコントローラ
-> 使用するデバイスを選択 -
プロジェクトの種類
->アプリケーション(CC-RX)
-
プロジェクト名
に任意の名前を入力 ->次へ
- その他の設定はお好みで ->
作成
-
-
- 新規作成されたプロジェクトの
スマート・コンフィグレータ (設計ツール)
をダブルクリック- SCが起動される
- SCの下部、
ボード
タブを押す -
ボード
項目で利用したいボードを選択する(ボードコンフィグレーションファイル(BDF)をプロジェクトに読み込み)
- ★将来改善★ BDF連携により e2 studio 2020-xx (将来バージョン)で不要になる見込み(e2 studio 2020-07以前では必要)
- SCの下部、
クロック
タブを押す - チェックボックスやプルダウンメニューの値を変更し、クロック設定を実施する
- ビルドエラーの確認(必須ではないがお勧め)
- 一旦コード生成を実行し、SCで設定した内容に応じたスケルトンプログラムが出力される
- プロジェクトのビルドを実行し、コンソールにエラー表示されないことを確認
- e2 studioの場合、e2 studio画面上部の
プロジェクト
->すべてをビルド
を実行してビルドできる
- e2 studioの場合、e2 studio画面上部の
- SCの下部、
コンポーネント
タブを押す - SCの左部、
コンポーネント
ペインにて、コンポーネントの追加
を押す - 表示されたウィンドウで追加したいコンポーネント(FITまたはCG)を選択する
(Ctrlキーを押しながらクリックで、複数選択できる) - SCの左部、
コンポーネント
ペインに上記で追加したコンポーネントが表示されることを確認する
-
ソフトウェアコンポーネントの選択
ウィンドウにおいて基本設定
を選択しすべてのFITモジュールを表示
にチェックを入れる - 上記の操作によっても目的のFITモジュールが表示されない場合、FITモジュールの保存先フォルダにモジュールが存在するかを確認する
- FITモジュールの保存先フォルダにアクセスする
- このファイルパスに目的のFITモジュールが存在していることを確認する
- 存在する場合、SCを閉じた後でIDEを再起動し、再度目的のモジュールが表示されるかを確認する
- 存在していない場合、FITモジュールを手動で導入する
公式ドキュメント:Firmware Integration Technology (FIT) -> RXファミリ Firmware Integration Technology モジュールの手動導入方法
- RX Driver Package (RDP)から目的のFITモジュールを入手する
- 入手した目的のFITモジュールをFITモジュールの保存先フォルダにコピーする
- SCを閉じた後でIDEを再起動し、再度目的のモジュールが表示されるかを確認する
- コンポーネント追加操作に表示されるFITモジュールは以下のフォルダ(FITモジュールの保存先フォルダ)を参照している
-
コンポーネントの追加
->基本設定
->Module Download
->Location (RX)
に設定されたファイルパス- e2 studioのデフォルト:
C:\Users\[ユーザ名]\.eclipse\org.eclipse.platform_download\FITModules
- e2 studioのデフォルト:
- 1つのFITモジュールは以下ファイルで構成されている(x: 機能名, n: バージョン)
-
r_xxx_vn.nn.zip
:ソースコードやドキュメントが圧縮されたモジュール本体 -
r_xxx_vn.nn.xml
:SC連携に必要なモジュール情報ファイル -
r_xxx_vn.nn.mdf
:SCのコンポーネント設定に利用される定義ファイル(一部のFITモジュールのみ) -
r_xxx_vn.nn_extend.mdf
:SCのコンポーネント設定に利用される定義ファイル(一部のFITモジュールのみ)
-
-
- FITモジュールを手動追加した直後はスマート・コンフィグレータに追加FITモジュールが認識されていない
- 一旦、e2 studioまたはCS+を再起動すること
-
RX Driver Package (RDP)とは、RXマイコン向けのBSP、ドライバ、ミドルウェアをまとめた無償のパッケージ
-
上記のソフトウェアはFITモジュールとして提供されている
-
RDPのバージョンごとに同梱されているFITモジュールのバージョンは異なる
- RDPの過去バージョンはページ下段の
旧バージョン情報
をクリックすることで、ダウンロードのリンク先を展開できる - RDP過去バージョンに同梱されているFITモジュールをスマート・コンフィグレータに認識させるためには、手動の操作が必要 ⇒ #FITモジュールの保存先フォルダ
- RDPの過去バージョンはページ下段の
-
SCからもRDPをダウンロード可能である(ただし、最新版RDPのみ)
-
RX64Mよりも前のMCU(RX63Nなど)はRDP V1.19同梱のFITモジュールを使用すること
- これらのMCUは最新のFITモジュールに対応していない
- 場合に応じて実行する
- SCの下部、
コンポーネント
タブを押す - SCの左部、
コンポーネント
ペインにて、バージョン変更したいコンポーネントを右クリックする - 表示されるコンテキストメニューにて、
バージョンの変更
を押す - 表示されるウィンドウにて、
変更後のバージョン
で変更先のバージョンを指定 ->次へ
- 次に表示される設定の変更内容画面で変更される設定項目を確認 -> 問題なければ
終了
- コード生成が自動で実行され、コンポーネントのバージョンが変更される
- SCの左部、
コンポーネント
ペインにて、バージョン変更したコンポーネントを右クリック ->バージョンの変更
を押し、バージョンが自動で変更されていることを確認する
- 場合に応じて実行する
- SCの下部、
コンポーネント
タブを押す - SCの左部、
コンポーネント
ペインにて、削除したいコンポーネントを選択する - SCの左部、
コンポーネント
ペインにて、コンポーネントの削除
を押す - 表示さる確認ウィンドウで
はい
を押す - SCの左部、
コンポーネント
ペインにて、目的のコンポーネントが削除されることを確認する
- SCの下部、
端子
タブを押す - SCの左部、
ハードウェアリソース
ペインにて、設定したい端子のリソースを選択する - SCの中央部、
端子機能
ペインにて、使用する
にチェックを入れ、使用したい端子を選択する - SCの中央部、
端子機能
ペインにて、端子割り当て
のプルダウンメニューを変更し、使用したい端子のポート番号を設定する
- [注意] FITの割り込み設定とは連携していない
- SCの下部、
割り込み
タブを押す - 利用したい割り込みを選択し、
割り込み
の機能や優先レベル
を設定する - 利用したい割り込みを選択し、
上へ移動
や下へ移動
を押してベクタ番号を変更する
- SC右上の
コードの生成
ボタンを押す - SCで設定した内容に応じたプログラムコードが自動生成される
- プロジェクトのビルドを実行し、コンソールにエラー表示されないことを確認
- e2 studioの場合、e2 studio画面上部の
プロジェクト
->すべてをビルド
を実行してビルドできる
- e2 studioの場合、e2 studio画面上部の
- ソース生成直前のSC管理対象ソースコード(.\src\smc_gen\配下のソースプログラム)は、ソース生成実行後に .\trash\フォルダへバックアップされる