μITRON（SH2）組み込み学習キット
KED-SH101+
組み込み学習キットオプションカード
KED-EXT102

クイック・インストールガイド

2019/1/17

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル1１. キットに含まれる開発環境
本学習キットは、GNU（※）を使用した開発環境です。
GNUは一般的にLinux環境下で使用されるコンパイラです。
今回はWindows10環境上にGNUのクロス開発環境を構築する方法について説明します。
インストール対象のOS（オペレーティングシステム）：
Windows10 をインストールしたPCを対象としています
本教材で使用しているツールバージョンを記載します。
••
•
•
•
•••
•
•
•

Oracle VM VirtualBOX Ver4.2.6
CentOS Ver4.8
TOPPERS/JSP Ver1.4.2
TINET Ver1.3.2
Gcc Ver3.3.1
Binutils Ver2.14
Sh-hitachi-elf-gcc Ver2.95.3
Newlib Ver1.11.0
Perl Ver5.8.2-1Gdb 2003-09-20（Cygwin-special）
Sh-hitachi-elf-gdb Ver6.0

参考資料：
GNUプロジェクトのホームページ GNUプロジェクト http://www.gnu.org/
TOPPERSプロジェクトのホームページ http://www.toppers.jp/index.html

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル22. 本開発環境とターゲットボードとの関連
開発環境の全体の構成を以下に説明します
ホストOS（Windows10）配下の仮想マシン（Oracle VM VirtualBOX）にてlinuxを起動しソースコードのコンパイル等を行います
ソースコードの更新は、ホストOSから仮想マシン上のフォルダを、リモートドライブとしてアサインし、ホストOS上からエディタにて行います
ホストOS（Windows10）
テキストエディタ（メモ帳など）ターミナルソフト［1つ目の起動］（TeraTermなど）

Oracle VM VirtualBOX（ linux：CentOS Ver4.8 ）・開発環境一式（コンパイラなど）
・サンプルソースコード
・ライブラリ

ソースコードの作成＆更新
TCP/IPポートからSSHでLogin
CentOSのコンソールとして動作
コンパイルなど行い実行ファイルを生成する
Z: ドライブなどにリモートドライブとしてアサイン

仮想ドライブネットワークドライブとしてホストから参照＆更新

実行ファイルターミナルソフト［2つ目の起動］（TeraTermなど）

実行ファイルをRS232Cインターフェースでファイル転送機能でターゲットボードに書き込みターゲットボード

開発環境はホストOS上で起動された仮想環境（Oracle VM VirtualBOX）に構築されています
OSはLinuxで、CentOS Ver4.8になります

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル3

3. 開発環境インストール手順概要
学習キットでは、必要な開発環境を構築するため、セットアップディスクを用意しております。
これより、開発環境のインストール手順を説明します。
必要な容量とイントール時間の目安：
学習キットの開発環境をインストールするには、インストール先に6.7Gバイト以上の空き容量が必要です。
また、インストール作業に必要な時間はPCによって異なりますが、目安として、Intel(R) Core(TM)i5-3470 3.20GHz RAM 8.0GバイトのPCにて5分掛かります。
開発環境のインストール手順：① 最初に仮想マシン化ソフトウェア(VM VirtualBox)をインストール② 仮想マシン化ソフトウェア上で「仮想アプライアンスのインポート」により仮想マシン(CentOS)を作成します※CentOSの「仮想アプライアンスのインポート」では、サンプルプログラムも含めてインポートされます③ 仮想マシンを起動してターミナルソフトでSSH接続します④ ターミナルソフトでコマンドを実行してサンプルプログラム一式をコピーします

セットアップディスク

セットアップディスクに含まれるファイル一覧

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル4

3.1 仮想マシン化ソフトウェアのインストール
学習キットの添付DVD内から¥VirtualBox¥VirtualBox-4.2-82870-Win.exe
を実行して最初に仮想マシン化ソフトウェアをインストールします

インストール中の注意
１）仮想化ソフトウェアのインストールから、２）仮想マシンの作成まで、インストールする環境によっては、数分以上掛かります。
また、インストール動作が停止しているように見える時間が数分以上続く場合がありますが、問題はありません。そのままお待ちください。

必要な容量とイントール時間の目安：
学習キットの開発環境をインストールするには、インストール先に6.7Gバイト以上の空き容量が必要です。
また、インストール作業に必要な時間はPCによって異なりますが、目安として、Intel(R) Core(TM)i5-3470 3.20GHz RAM 8.0GバイトのPCにて5分掛かります。
開発環境のインストール手順：① 最初に仮想マシン化ソフトウェア(VM VirtualBox)をインストール② 仮想マシン化ソフトウェア上で「仮想アプライアンスのインポート」により仮想マシン(CentOS)を作成します※CentOSの「仮想アプライアンスのインポート」では、サンプルプログラムも含めてインポートされます③ 仮想マシンを起動してターミナルソフトでSSH接続します④ ターミナルソフトでコマンドを実行してサンプルプログラム一式をコピーします

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル5

3.2 仮想マシン化ソフトウェアインストール開始¥VirtualBox¥VirtualBox-4.2-82870-Win.exeを実行すると以下の画面が表示されますので、［Next］のボタンを押します

インストールフォルダの選択：
次に以下の画面にて、仮想マシン化ソフトウェアをインストールするフォルダを選択します。フォルダを選択したら［Next］のボタンを押してください

デフォルトのフォルダはC:¥Program Files¥Oracle¥VirtualBoxです
μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル6

3.3 ショートカット作成の確認
インストールするフォルダの選択が終了すると、ショートカットを作成するか確認しますので、問題が無ければ［Next］のボタンを押してください。

3.4 ネットワークインターフェースに関する注意確認
次に以下の画面で仮想マシンインストール中に現在接続中のネットワークが一時的に切断されることの確認を行います。このまま続けても問題がなければ、［Yes］ボタンを押してください。
インストール終了後に起動した仮想マシンは、Host-onlyなネットワークに繋がりますので、現在ご使用中のネットワークへの影響はありません。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル7

3.5 インストールの開始［Yes］ボタンを押した後は、以下の画面が表示されます。
［Install］ボタンを押すと仮想マシンのインストールを開始します。

［Install］ボタンを押すと以下の画面が表示されます。

このアプリがデバイスに変更を加えることを許可しますか？
□ Oracle VM VertualBox 4.2.6r82870［ はい ］［ いいえ ］と表示された場合は “はい” を選択してください
μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル8

3.6 インストールの開始（続き）
インストール中に以下の確認画面が表示された場合は、表示を確認し［インストール(I)］ボタンを押してインストールを続けてください

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル9

3.7 仮想マシン化ソフトウェアのインストール終了
以下の画面の表示で、仮想マシン化ソフトウェアのインストール終了です。

上記の画面が表示されたら “Finish” ボタンを押してください。
［Finish］ボタンを押すと仮想マシン化ソフトウェアが起動して、以下の画面を表示します。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル10

4. 仮想マシンの作成
仮想化ソフトウェア(VM VirtualBox)が起動されたあとに、「仮想アプライアンスのインポート」により仮想マシンを作成します。
VM VirtualBoxのメニューバーから［ファイル(F)］ → ［仮想アプライアンスのインポート(I) ］
を押してください

次の画面が表示されます。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル11

4. 仮想マシンの作成（続き）
この画面の［アプライアンスを開く］を選択し、添付DVDからインポートする¥VirtualAppliance¥KED-SH101.ova
を選択してください

選択すると次の画面に変わりますので、［次へ(N)］ボタンを押して次へ進んでください。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル12

4. 仮想マシンの作成（続き）
次の画面が表示されますので、［インポート］ボタンを押して、仮想アプライアンスのインポートを開始してください。

仮想アプライアンスのインポートを開始すると次の画面を表示します。

3～5分ほど経過すると次の仮想マシン化ソフトウェア画面が表示されます。
この画面が表示されれば仮想マシンの作成は終了です。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル13

5. ターミナルソフトのインストール
続いて、ターミナルソフトインストールを行います。
ここでは、代表的なソフトとして「Tera Term」を例に説明します。

オンラインソフトのダウンロードサイト（Vecter、窓の杜など）から、TeraTermのインストールファイルをダウンロードし、インストール用の実行ファイルをダブルクリックします。

（インストールファイルの例）［言語を選択］［同意する］→［次へ］を選択

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル

14

5. ターミナルソフトのインストール（続き）
画面の指示に従いインストールを続けます

そのまま［次へ］を選択

言語を選択し［次へ］を選択

そのまま［次へ］を選択

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル15

5. ターミナルソフトのインストール（続き）
画面の指示に従いインストールを続けます

そのまま［インストール］を選択［完了］を選択μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル16

6. 開発環境を使ってみよう
6.1 仮想マシンの起動
開発環境の（CentOS）の起動方法について説明します。
仮想マシンは、仮想マシン化ソフトウェア（Oracle VM VirtualBOX ）から起動します。
（起動前には他の仮想化ソフトが起動していないことを確認してください）

デスクトップ上のアイコンかスタートメニューから［Oracle VM VirtualBox］を選択（起動）します

仮想マシン（Oracle VM VirtualBox）の起動画面

仮想マシン化ソフトウェアのを押すか、メニューバーの［仮想マシン(M)］→［起動(T)］を押して、仮想マシンを起動してください
以下のようなダイアログがいくつか表示される場合がありますが、いずれも［OK］を選択してください

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル17

6.1 仮想マシンの起動（つづき）
仮想マシンを起動すると次の画面が表示されます。

ここではログインを行いません。ログインはターミナルソフトでSSH接続する際に行います。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル18

6.2 仮想マシンへのログイン：SSH接続
本開発環境の仮想マシン（CentOS）は、Red Hat Enterprise Linuxとの完全互換を目指したフリーのLinuxディストリビューションです。
学習キットはCentOSが起動している状態で、ターミナルソフトからSSH接続して操作します。ここではターミナルソフトとしてTeraTerm(Ver4.101)を使用したSSH接続について説明します。
TeraTermを起動すると次の画面が表示されます。
TCP/IP、SSHを選択してホスト(T)にIPアドレス［192.168.56.123］を入力して、［OK］ボタンを押してください。

上記画面が表示されない場合は、メニューバーの［ファイル(F)］→［新しい接続(N)…］をクリックしてください。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル19

6.2 仮想マシンへのログイン：SSH接続（つづき）
次のようなSSH認証画面が表示されます。
ここでユーザー名とパスワードを入力後に［OK］ボタンを押して、ログインしてください。

ユーザー名：user
パスワード：KED-SH101※大文字、小文字に注意してください。

ログインに成功すると次の画面が表示されます。サンプルプログラムのコンパイル・リンクは、この画面にコマンドを入力して行います。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル20

6.2 仮想マシンへのログイン：SSH接続（つづき）
ログインに成功した後は、TeraTermのメニューバー［設定(S)］→［端末(T)…］を押して、改行コードと漢字コードの設定を行います。
［改行コード］の設定：［受信(R)］と［送信(M)］に［CR］を設定［漢字コード］の設定：［漢字-受信(K)］と［漢字-送信(J)］に［UTF-8］を設定
以上の設定が終了したら、［OK］ボタンを押してください。

以下が代表的なlinuxのコマンドですlsmkdir
mktempmv
pwd
rmrmdir
cdcp
clear
logoutexit

ファイルやディレクトリの情報を表示する
ディレクトリを作成する
適当なファイル名の空ファイルを作成する
ファイルやディレクトリの移動・名前の変更をする
現在のディレクトリの場所を確認する
ファイルやディレクトリを削除する

ディレクトリを削除する
ディレクトリを移動する
ファイルやディレクトリをコピーする
画面クリア（表示を消去する）
ログアウトする
終了する

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル21

6.3 linuxコマンドの実行例
以下、linuxコマンドの実行例です。

pwd
ls
ls -l

現在のディレクトリの場所を確認する

cd

カレントディレクトリの変更

ファイルやディレクトリの情報を表示する
ファイルやディレクトリの情報を表示する（詳細）μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル22

6.4 仮想マシンとホストOSとのファイル共有
仮想マシンを起動した後は、Windowsファイル共有（Samba）での制御が可能です。ここではWindows上でファイル共有する手順を説明します。
最初にWindowsエクスプローラで、仮想マシンのIPアドレスである¥¥192.168.56.123¥
を直接入力します。

入力すると次のような画面が表示されます。
ここでユーザー名とパスワードを入力して［OK］ボタンを押してください。

ユーザー名：user
パスワード：KED-SH101

これでWindowsエクスプローラからファイルへのアクセスが可能になります。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル23

6.5 仮想マシンの終了
仮想マシンの終了は、SSH接続を先に終了し、そのあとで行います。
SSH接続を終了するときには、ターミナルソフト上で［exit］コマンドを入力します。
（［logout］コマンドでも終了できます。）
SSH接続の終了：

仮想マシンの終了：
続いて、仮想マシンのツールバーから［仮想マシン］→［ACPIシャットダウン…］を押します。

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル

24

6.6. 開発環境のディレクトリ構造
仮想マシンを作成すると次のようなディレクトリ構造が展開されます。
/

homeuserjsp：サンプルプログラム（ワーキングディレクトリ）

sample_MAIN：学習キットKED-SH101（サンプルプログラムディレクトリ）

sample_OPTION：オプションカードKED-EXT102（サンプルプログラムディレクトリ）

sample：センサー実習機KED-EXT102-S2（サンプルプログラムディレクトリ）

sample：スマートグリッド学習キットKED-EXT102-SMG1（サンプルプログラムディレクトリ）

本開発環境では、(1) 該当するボードの［sample_～］ディレクトリ内のファイルを(2) 「jsp」 ディレクトリにコピーして(3) プログラムの修正、開発、コンパイルは［jsp］ディレクトリを対象に行いますオプションカードのサンプルプログラムを使う場合：
サンプルプログラム一式を、以下の手順で［jsp］ディレクトリへコピーします。
（1）コマンド［cd］で［sample_OPTION］ディレクトリへ移動し（2）コピーコマンド［cp］を実行して［sample_OPTION］ディレクトリ内にあるすべてのファイルを［jsp］ディレクトリへコピーします。

[user@localhost ~]$ cd ~/sample_OPTION[user@localhost sample_OPTION]$ cp -r * ../jsp

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル25

6.7. サンプルプログラムのビルド手順
サンプルプログラム［MLEDSAMPLE1］のモトローラS レコードフォーマットファイルを作成する場合を例にして説明します。
サンプルプログラム［MLEDSAMPLE1］の動作：
MLEDSAMPLE1のプログラムは、マトリクスLED の全LED を、左上から右下まで1 個ずつ順に点灯させます。
makeの手順：（1）最初にサンプルプログラム［MLEDSAMPLE1］ディレクトリへ移動します。
（2）続いて［make depend］で中間ファイルを生成します。
（3）中間ファイルを作成した後に、［make］を実行します[user@localhost ~]$ CD /jsp
[user@localhost jsp]$ cd MLEDSAMPLE1[user@localhost MLEDSAMPLE1]$ make depend[user@localhost MLEDSAMPLE1]$ make

これでコンパイル完了です。MLEDSAMPLE1 ディレクトリ内に［jsp.srec］というモトローラS レコードフォーマットファイルが作成されます。
中間ファイルも含めてクリーンアップする（ビルド作業前の状態に戻す）には、［make clean］を実行します
コマンドの［ls］で［jsp.srec］が出来ているか確認してみましょう

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル26

7. サンプルプログラムをターゲットボードへの書き込み
7.1 ターゲットボードへの書き込み手順について
ROM への書込み手順については、メインカードの技術解説書 12.2.1 にも同じ内容が説明してあります① メインカードとPCをシリアルケーブル（クロスケーブル）とメインカード付属の変換コネクタを使用して接続します。

ターゲットボードのシリアルポート接続部拡大写真② PC 上でターミナルソフトを起動させます
ここでは、Tera Term を（仮想マシン用のTeraTermとは別に）もう1つ起動します

設定する通信パラメータ：［設定(s)］→［シリアルポート(E)］から通信パラメータを設定します
ボーレート9600bps / 8bit / パリティなし / ストップビット:1bit / フロー制御なし

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル27

7.1 ターゲットボードへの書き込み手順について（つづき）③ メインカードのMODE S/W ボタンを押した状態で電源をON にします。
またはRESET S/W ボタンとMODE S/W ボタンを同時に押し、先にRESET S/W ボタンから指を放してください。
RESET S/W →MODE S/W →RESET
S/W →

MODE
S/W →

④ターミナルに［*File Load -->］というメッセージが表示されるので、ターミナルから書き込みを行いたいファームウェアファイルを送信します［ファイル(F)］→［ファイル送信(S)…］を選択

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル28

7.1 ターゲットボードへの書き込み手順について（つづき）
書き込みファイルの選択：
MLEDSAMPLE1ディレクトリ内の［jsp.srec］ファイルを選択します⑤ ファームウェアロード中は、④のメッセージの後ろにアスタリスク［*］が点滅します［*］が点滅していない場合は、正常にロードが出来ていない可能性がありますのでケーブル、ターミナル等を見直して下さい。

⑥ 書き込みが正常に終了すると、［.....Firm Update OK!!］と表示されます。
なお、メインカードがダウンロードするファームウェアファイルはモトローラＳレコード形式で作成してください。
ファイルの拡張子は srec もしくはS になります。
⑦ プログラムの実行
メインボードの［RESET S/W］を押すことでプログラムを実行します

μITRON(SH2) 組み込み学習キット・クイック インストールマニュアル

29